Edit

ScrollableText Control

  • Article

This control displays a long string of text that cannot fit entirely on the page. A common use for this control is displaying the license agreement.

Note that the string of text used with this control cannot contain an embedded property. To display text with embedded properties use instead the Text Control.

Control Attributes

You can use the following attributes with this control. To change the value of an attribute using an event, subscribe the control to a ControlEvent in the EventMapping table and list the attribute's identifier in the Attribute column. Enter the identifier of the ControlEvent in the Event column.

Attribute identifier Hexadecimal bit Description
Position Position of control in the dialog box. Enter the control's width, height, and coordinates of the control's left corner into the Width, Height, X, and Y columns of the Control table or BBControl table. Use installer units for length and distance.
Text Text displayed by the control. Enter the RTF text string into the Text column of the Control table.
Visible 0x00000000 0x00000001
 Hidden control. Visible control.
To make the control visible or hidden on its creation, include this bit in the bit word of the Attributes column in the Control table or BBControl table.
You can also hide or show a control by using the ControlCondition table.
Enabled 0x00000000 0x00000002
 Control in a disabled state. Control in an enabled state.
Include this bit in the Attributes column of the Control or BBControl tables to enable the control on creation.
You can also enable or disable a control by using the ControlCondition table.
Sunken 0x00000000 0x00000004
 Display the default visual style. Display the control with a sunken, 3D, look.
Include these bits in the bit word in the Attributes column of the Control table.
RTLRO 0x00000000 0x00000020
 Text in the control is displayed in a left-to-right reading order. Text in the control is displayed in a right-to-left reading order.
RightAligned 0x00000000 0x00000040
 Text in the control is aligned on the left. Text in the control is aligned on the right.
LeftScroll 0x00000000 0x00000080
 The scroll bar is located on the right side of the control. The scroll bar is located on the left side of the control.
BiDi 0x000000E0 Set this value for a combination of the RTLRO, RightAligned, and LeftScroll attributes.

 

Remarks

This control can be created from the RICHEDIT class by using the CreateWindowEx function. It has the ES_MULTILINE, WS_VSCROLL, ES_READONLY, WS_TABSTOP, ES_AUTOVSCROLL, WS_CHILD, WS_GROUP, and ES_NOOLEDRAGDROP styles.