|
MULTI_LINE Rich Text Properties |
In addition to the MULTI_LINE Properties, the table below lists properties that are used with Rich Text Format word processor controls. See MULTI_LINE Rich Text Word Processor Control directive.
Use the links in the Property column to access the PxPlus Help page for a selected property. The Help page may provide additional details, particularly if the property can be used to define other controls.
The 'Selxxxxxx properties can be used to change the format of the current selected text, or if no text is selected, the changes affect the current text being entered.
For a complete list of all the properties available, see Properties List.
|
Property |
Description | ||||||||
|
When set, the control will generate a 'Change' event whenever its value changes as opposed to the default Off state where the control will only generate the change event when losing focus. Possible values are:
| |||||||||
|
Background color. For information on valid color names and color specifications, see Color Properties. (Default: "DEFAULT") | |||||||||
|
Add border: 1 - Border; 0 - No border (Default: 1) Note: | |||||||||
|
This property is used to define how the ENTER key will be processed with the control. For the multi-line, the EnterMode property defines whether the ENTER key is to be allowed within the control or considered a TAB to exit the control. When 0 (zero), it indicates that the ENTER key will not be considered as a TAB; thus, depending on the type of multi-line, it will signal the input complete for a 1-line field or insert a line feed on a control with multiple input lines. (Default for Multi-line: The default setting reflects the '+E' mnemonic setting.) | |||||||||
|
Last change terminator. See also MULTI_LINE directive. | |||||||||
|
Controls RTF word processor Find option: This property controls access to the Find text dialogue box within the RTF word processor control. When this control is set to 1, the user can press CTRL-F to initiate a find within the control. Setting the control to 0 disables CTRL-F. (Default: 1 - CTRL-F enabled) This property also controls the F3 key for Find Next. If desired, the property can be set to 2, which will cause the Find dialogue box to be initiated under program control. Note: | |||||||||
|
Focus indicator: 1 = Control has focus (Default: 0) | |||||||||
|
Input length of line. | |||||||||
|
Lock status: Possible values are:
(The Lock status of 2 was added in PxPlus 2019.) | |||||||||
|
This property reports/sets the CTL value to generate when an object is selected on a right-click of the mouse. | |||||||||
|
Message line text for the control. | |||||||||
|
On Focus CTL event: 0 is returned if no On Focus CTL value is set up for the control. | |||||||||
|
RTF word processor Alignment: This property controls the font for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. Paragraph alignment: "R"ight, "L"eft, "C"entered. (Default: The default setting is the control font.) | |||||||||
|
RTF word processor BOLD setting: This property reflects whether the text will be bold for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. 0 if not bold, 1 if bold. (Default: The default setting is the control font.) | |||||||||
|
RTF word processor bullet number setting: This property reflects the bullet number for the current text in a RTF word processor Multi_Line style control. Changing this number will change the current bullet sequence number and those following. (Default: The default setting starts at 1 and increments by 1 for each paragraph.) | |||||||||
|
RTF word processor bullets setting: This property reflects whether the text will be bulleted for the currently selected text in a RTF word processor Multi_Line style control. (0 = None, 1 = Yes, 2 = Numbers) | |||||||||
|
RTF word processor bullet style setting: This property reflects the bullet style for the current text in a RTF word processor Multi_Line style control. | |||||||||
|
RTF word processor Font selector: This property controls access to the Font selection dialogue box within the RTF word processor Multi_Line style control. When this control is set to 1, the user can press Ctrl-Shift-Insert to initiate a Font selector within the control. Setting the control to 0 disables Ctrl-Shift-Insert. If desired, the property can be set to 2, which will cause the Font selection dialogue box to be initiated under program control. (Default: The default setting is 1 - Ctrl-Shift-Insert enabled). | |||||||||
|
Length of selected item: This reports the number of characters currently highlighted. This allows for cut, copy and paste within a GUI input region. | |||||||||
|
This property indicates where the highlight begins within the data or, if nothing is highlighted, the current cursor location. This allows for cut, copy and paste within a GUI input region. | |||||||||
|
Text contained within the highlight: This allows for cut, copy and paste within a GUI input region. See Multiple Selections. | |||||||||
|
RTF word processor Emboss setting: This property reflects whether the text will be Embossed for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. 0 if not Embossed, 1 if Embossed. (Default: The default setting is the control font.) | |||||||||
|
RTF word processor Font setting: This property reflects the Font to be used for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. (Default: The default setting comes from the control's default Font specification.) See 'FONT' mnemonic. Example: To set the font to Arial, 1.5 times normal size, and Bold, the format would be xxx'Font$="Arial,1.5,B" (comma-separated). | |||||||||
|
RTF word processor Font Size setting: This property reflects the Font Size to be used for the currently selected text in a RTF word processor Multi_Line style control. | |||||||||
|
RTF word processor Indentation setting: This property reflects the Indentation to be used for the currently selected paragraph(s) in a RTF word processor Multi_Line style control. If no paragraph is currently selected, the current text entry will be affected. (Default: 0) The indentation is measured in TWIPS, which is 1/1440 of an inch (or 1/20th of a POINT). To create an indentation of 1/2 an inch, use 720. | |||||||||
|
RTF word processor Italics setting: This property reflects whether the text will be in Italics for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. 0 if not in italics, 1 if in italics. (Default: The default setting is the control font.) | |||||||||
|
RTF word processor Paragraph Undent setting: This property reflects the amount of indentation to be eliminated from the contents of the currently selected paragraph(s) in a RTF word processor Multi_Line style control. If no paragraph is currently selected, the current text entry will be affected. (Default: 0) The Indentation is measured in TWIPS, which is 1/1440 of an inch (or 1/20th of a POINT). To create an indentation of 1/2 an inch, use 720. The Undentation only affects the body of the paragraph that follows the first line. Example: If you wanted to indent the first line by 1/2 an inch yet leave the rest of the paragraph un-indented, you would set both the 'Indent and 'ParaUndent properties to 720. | |||||||||
|
RTF word processor Right Indentation setting: This property reflects the right side indentation to be used for the currently selected paragraph(s) in a RTF word processor Multi_Line style control. If no paragraph is currently selected, the current text entry will be affected. (Default: 0) The Indentation is measured in TWIPS, which is 1/1440 of an inch (or 1/20th of a POINT). To create an indentation of 1/2 an inch, use 720. | |||||||||
|
RTF word processor Strikeout setting: This property reflects whether the text will be "Striked Out" for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. (Default: 0 - No Strikeout) | |||||||||
|
RTF word processor Text Color setting: This property reflects the color of the text that is currently selected in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. For information on valid color names and color specifications, see Color Properties. (Default: The default setting is "DEFAULT" (normally BLACK)). | |||||||||
|
RTF word processor Underline setting: This property reflects whether the text will be underlined for the currently selected text in a RTF word processor Multi_Line style control. If no text is currently selected, the current text entry will be affected. 0 if not underlined, 1 if underlined. (Default: The default setting is the control font.) | |||||||||
|
Controls whether a 'Change' signal will be generated when the control (or region of a grid control) is exited regardless of whether the control's value changes. Normally, controls only signal changes when the control loses focus and the contents have changed. Setting 'SignalOnExit allows a change signal to also be generated whenever focus leaves the control (or region for grid).
| |||||||||
|
Text of item. Note: | |||||||||
|
Tip message for control. | |||||||||
|
Current item value. Note: |
MULTI_LINE Properties
Color Properties
'COLOUR' & '_COLOUR' Mnemonic
Using Property Names
Compound Properties