WinStudio

DropDownCap Property

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.

TIP: You can confirm the return value or that the value has been correctly set using the Settings window (View menu > Settings > Runtime tab).

Example

The following 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

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

Sub Main()
   Application.DropDownCap = 100
End Sub