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
ls_data = dw1.Describe("emp_status.ddlb.AllowEdit")
dw1.Modify("emp_status.ddlb.Case='Any'")
dw1.Modify("emp_status.ddlb.Limit=30")
string ls_data
ls_data = dw1.Object.emp_status.ddlb.AllowEdit
dw1.Object.emp_status.ddlb.Case = "Any"