SAY^XGF(): Screen String

Reference Type: Supported, Category: XGF Function Library, Integration Agreement: 3173

Description

This API outputs a string to the screen (with optional positioning and attribute control).

Use this API rather than the M WRITE command to output strings to the screen. The row and column parameters specify where to print the string. If omitted, the current row and column positions are used. If specified, the row must be between 0 and IOSL-1, and the column must be between 0 and IOM-1.

A call to the PREP^XGF(): Screen/Keyboard Setup API must be made at some point prior to calling SAY^XGF.

You can specify row and column parameters relative to the current $x and $y by specifying "+" or "-" to increment or decrement $x or $y by 1. You can increment or decrement by more than 1 if you add a number as well (e.g., "-5" or "+10").

NOTE: You must use quotes to pass a "+" or "-". Otherwise, to specify exact locations for row and column, pass numbers.

Without the fourth argument for video attribute, SAY^XGF displays the string using the current video attribute. With the fourth argument, SAY^XGF displays the string using the attributes you specify. SAY^XGF changes the video attribute only for the output of the string; upon termination of the function, it restores video attributes to their state prior to the function call.

NOTE: For a discussion of valid video attribute codes for the video attribute parameter, please refer to the SETA^XGF(): Screen Video Attributes API.

Format

  SAY^XGF([row][,col,]str[,atr])

Input Parameters

NOTE: See also: IOXY^XGF(): Screen Cursor Placement and SAYU^XGF(): Screen String with Attributes APIs.

Output Parameters

Example 1

For example, to print "Hello, World" in the center of the screen, in the current video attribute, do the following:

>D SAY^XGF(11,35,"Hello World")

Example 2

To print "ERROR!" at (row,col) position ($X+1,$Y+5), in reverse and bold video attributes, do the following:

>D SAY^XGF("+","+5",0,"ERROR!","R1B1")

Example 3

To print "..." at the current cursor position, in the current video attribute, do the following:

>D SAY^XGF(,,"...")