The Put Text with Multiple Renditions to Display routine writes text with multiple renditions to the virtual display. Format SMG$PUT_CHARS_MULTI display-id ,text [,start-row] [,start-column] [,flags] [,rendition-string] [,rendition-complement] [,character-set]
1 – Returns
OpenVMS usage:cond_value type: longword (unsigned) access: write only mechanism: by value
2 – Arguments
display-id OpenVMS usage:identifier type: longword (unsigned) access: read only mechanism: by reference Identifier of the virtual display to be affected. The display-id argument is the address of an unsigned longword that contains this identifier. text OpenVMS usage:char_string type: character string access: read only mechanism: by descriptor Text to be output. The text argument is the address of a descriptor pointing to the output string. start-row OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by reference Optional row number at which to start output. The start-row argument is the address of a signed longword containing this number. If omitted, the current row number is used. start-column OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by reference Optional column number at which to start output. The start-column argument is the address of a signed longword containing this number. If omitted, the current column number is used. flags OpenVMS usage:mask_longword type: longword (unsigned) access: read only mechanism: by reference Optional bit mask that specifies the action to take before the specified text is output. The flags argument is the address of an unsigned longword that contains the flag. The flags argument accepts the following values: 0 Does not erase line (the default). SMG$M_ERASE_TO_ Erases the remaining part of the line. EOL SMG$M_ERASE_LINE Erases the entire line. rendition-string OpenVMS usage:char_string type: character string access: read only mechanism: by descriptor Optional bit mask string that controls the video attributes. The rendition-string argument is the address of a descriptor pointing to the bit mask string. Each attribute set causes the corresponding attribute to be set for the corresponding byte in the text string in the display. The following attributes can be specified for each byte using the rendition-string argument: SMG$M_BLINK Displays blinking characters. SMG$M_BOLD Displays characters in higher-than-normal intensity. SMG$M_REVERSE Displays characters in reverse video; that is, using the opposite of the default rendition of the virtual display. SMG$M_ Displays underlined characters. UNDERLINE SMG$M_ Specifies invisible characters; that is, the INVISIBLE characters exist in the virtual display but do not appear on the pasteboard. rendition-complement OpenVMS usage:char_string type: character string access: read only mechanism: by descriptor Optional bit mask string that controls the video attributes. The rendition-complement is the address of a descriptor pointing to the bit mask string. Each attribute set causes the corresponding attribute to be complemented for the corresponding byte in the text string in the display. If the same bit in the same byte is specified in both the rendition-string and rendition-complement arguments, rendition- string is evaluated first, followed by rendition-complement. By using these two parameters together, you can independently control each attribute in a single routine call. On a single- attribute basis, you can cause the following transformations: Set Complement Action 0 0 Attribute set to default 1 0 Attribute on 0 1 Attribute set to complement of default setting 1 1 Attribute off character-set OpenVMS usage:longword_unsigned type: longword (unsigned) access: read only mechanism: by reference Specifies the default character set for all text in this virtual display. The character-set argument is the address of an unsigned longword that contains the character set code. Valid values are SMG$C_ASCII (the default) and SMG$C_SPEC_GRAPHICS.