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.
Send comments about this topic to Microsoft
Build date: 8/13/2009
© 2009 Microsoft Corporation. All rights reserved.