Description
Settings that affect the appearance and behavior of columns whose edit style is RichText.
Applies to
Column controls
Syntax
PowerBuilder dot notation:
dw_control.Object.columnname.RichEdit.property
Describe and Modify argument:
"columnname.RichEdit.property { = value }"SyntaxFromSql:
Column ( RichEdit.property = value )
|
Parameter |
Description |
|---|---|
|
columnname |
The column with the RichText edit style for which you want to get or set property values. You can specify the column name or a pound sign (#) and the column number. |
|
property |
A property for the column's Edit style. Properties and their settings are listed in the table below. The table identifies the properties you can use with SyntaxFromSql. |
|
value |
The value to be assigned to the property. |
|
Property for RichEdit |
Value |
|---|---|
|
AutoSelect |
Whether to select the contents of the column control automatically when it receives focus. Values are: Yes -- Select automatically. No -- Do not select automatically. You can use AutoSelect with SyntaxFromSql. The setting applies to all the columns in the generated syntax. Painter: Auto Selection option |
|
DisplayOnly |
Whether the column is display only. Values are: Yes -- Do not allow the user to enter data; make the column display only. No -- Allow the user to enter data. Painter: Display Only option For conditional control over column editing, use the Protect property. |
|
FocusRectangle |
Whether a dotted rectangle (the focus rectangle) surrounds the current row of the column when the column has focus. Values are: Yes -- Display the focus rectangle. No -- Do not display the focus rectangle. You can use FocusRectangle with SyntaxFromSql. The setting applies to all the columns in the generated syntax. Painter: Show Focus Rectangle option |
|
Limit |
A number specifying the maximum number of characters (0 to 32,767) that the user can enter. 0 means unlimited. Painter: Limit option. |
|
NilIsNull |
Whether to set the value of the column control to null when the user leaves it 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 -- It is required. No -- It is not required. Painter: Required option. |
|
VScrollBar |
Whether a vertical scroll bar displays in the column control. Values are: Yes -- Display vertical scroll bars. No -- Do not display vertical scroll bars. Painter: Vertical Scroll Bar option. |
Usage
In the painter
Select the control and set values in the Properties view, Edit tab, when Style Type is RichText.
Examples
string setting
setting = &
dw_1.Object.rte_description.RichEdit.AutoSelect
dw_1.Object.rte_description.RichEdit.VScrollBar="yes"
setting = dw_1.Describe(&
"rte_description.RichEdit.VScrollBar")
dw_1.Modify("rte_description.RichEdit.Required=no")