Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
 
                   The Resource Compiler RTEXT Statement
 
RTEXT text, id, x, y, width, height[, style]
 
The RTEXT statement creates a right-aligned text control. The control is a
simple rectangle displaying the given text right-aligned in the rectangle.
The text is formatted before it is displayed. Words that would extend past
the end of a line are automatically wrapped to the beginning of the next
line. The RTEXT statement, which you can use only in a DIALOG or WINDOW
statement, defines the text, identifier, dimensions, and attributes of the
control. The predefined class for the control is WC_STATIC. If you do not
specify a style, the default style is SS_TEXT, DT_RIGHT, and WS_GROUP.
 
Field   Description
────────────────────────────────────────────────────────────────────────────
 
text    Specifies text that is right-aligned in the rectangular area of the
        control. This field must contain zero or more characters enclosed in
        double quotation marks. Character values must be in the range 1
        through 255. If a double quotation mark is required in the text, you
        must include the double quotation mark twice.
 
id      Specifies the control identifier. This value must be an integer in
        the range 0 through 65,535, or a simple expression that evaluates to
        a value in that range.
 
x       Specifies the x-coordinate of the lower-left corner of the control.
        This value must be an integer in the range 0 through 65,535 or an
        expression consisting of integers and the addition (+) or
        subtraction (-) operator. The coordinate is assumed to be in dialog
        units and is relative to the origin of the dialog box, window, or
        control containing the specified control.
 
y       Specifies the y-coordinate of the lower-left corner of the control.
        This value must be an integer in the range 0 through 65,535 or an
        expression consisting of integers and the addition (+) or
        subtraction (-) operator. The coordinate is assumed to be in dialog
        units and is relative to the origin of the dialog box, window, or
        control containing the specified control.
 
width   Specifies the width of the control. This value must be an integer in
        the range 1 through 65,535 or an expression consisting of integers
        and the addition (+) or subtraction (-) operator. The width is in
        ¼-character units.
 
height  Specifies the height of the control. This value must be an integer
        in the range 1 through 65,535 or an expression consisting of
        integers and the addition (+) or subtraction (-) operator. The
        height is in 1/8-character units.
 
style   Specifies the control styles. For a list of possible styles, see the
        topic ◄Static styles►. You can use the bitwise OR (|) operator to
        combine styles.
 
Example
 
This example creates a right-aligned text control that is labeled
"Filename".
 
RTEXT "Filename", 101, 10, 10, 100, 100
 
See Also
 
CTEXT, CONTROL, DIALOG, LTEXT, WINDOW
 
                                      ♦