DropDownCap property (WinStudio scripts)

Applies To

IWSApplication interface

Definition

Returns or sets an integer that indicates the maximum number of items to be retrieved and displayed in a drop-down list.

Get Syntax

Application.DropDownCap

Set Syntax

Application.DropDownCap = integer

Remarks

A return value of 0 indicates that there is no limit to the number of items that can be retrieved. A value of -1 indicates that the system default drop-down list cap is to be used.

Note: You can confirm the return value or that the value has been correctly set using the User Preferences window (Runtime tab).

Examples

This example displays a message box that tells what the current collection cap is.

Sub Main()
   Dim dropCap As String
   dropCap = Application.DropDownCap.ToString()
   Application.ShowMessage("The current drop-down list cap is " & dropCap & ".")
End Sub

This example shows how to use this property to set the collection cap programmatically.

Sub Main()
   Application.DropDownCap = 100
End Sub