ddlb.property

Description

Properties that control the appearance and behavior of a column with the DropDownListBox edit style.

Applies to

Column controls

Syntax

PowerBuilder dot notation:

dw_control.Object.columnname.ddlb.property

Describe and Modify argument:

"columnname.ddlb.property { = value }"

Parameter	Description
columnname	The name of a column that has the DropDownListBox edit style.
property	A property for the DropDownListBox column. Properties and their settings are listed in the table below.
value	The value to be assigned to the property. For ddlb properties, value cannot be a DataWindow expression.

Property for ddlb	Value
AllowEdit	Whether the user can type a value as well as choose from the DropDownListBox’s list. Values are: Yes – Typing is allowed. No – (Default) Typing is not allowed. Painter: Allow Editing option.
AutoHScroll	Whether the DropDownListBox automatically scrolls horizontally when the user enters or deletes data. Values are: Yes – (Default) Scroll horizontally automatically. No – Do not scroll automatically. Painter: Auto Horizontal Scroll option.
Case	The case of the text in the DropDownListBox. Values are: Any – Character of any case allowed. Upper – Characters converted to uppercase. Lower – Characters converted to lowercase. Painter: Case option.
Limit	An integer from 0 – 32767 specifying the maximum number of characters that can be entered in the DropDownListBox. Zero means unlimited. Painter: Limit option.
NilIsNull	Whether to set the data value of the DropDownListBox to null when the user leaves the edit box blank. Values are: Yes – Make the empty string null. No – Do not make the empty string null. Painter: Empty string is null option.
Required	Whether the column is required. Values are: Yes – Required. No – (Default) Not required. Painter: Required option.
ShowList	Whether the ListBox portion of the DropDownListBox displays when the column has focus. A down arrow does not display at the right end of the DropDownListBox when ddlb.ShowList is yes. Values are: Yes – Display the list whenever the column has focus. No – Do not display the list until the user selects the column. Painter: Always Show List option.
Sorted	Whether the list in the DropDownListBox is sorted. Values are: Yes – The list is sorted. No – The list is not sorted. Painter: Sorted option.
UseAsBorder	Whether a down arrow displays at the right end of the DropDownListBox. Values are: Yes – Display the arrow. No – Do not display the arrow. Note that if ShowList is set to Yes, the column ignores the UseAsBorder property and the arrow never displays. Painter: Always Show Arrow option.
VScrollBar	Whether a vertical scroll bar displays in the DropDownListBox for long lists. Values are: Yes – Display a vertical scroll bar. No – Do not display a vertical scroll bar. Painter: Vertical Scroll Bar option.

Usage

In the painter

Select the control and set the value in the Properties view, Edit tab, when Style Type is DropDownListBox.

Examples

Example 1

ls_data = dw1.Describe("emp_status.ddlb.AllowEdit")

dw1.Modify("emp_status.ddlb.Case='Any'")

dw1.Modify("emp_status.ddlb.Limit=30")

Example 2

string ls_data

ls_data = dw1.Object.emp_status.ddlb.AllowEdit

dw1.Object.emp_status.ddlb.Case = "Any"