template<class character>
bool text_out(handle device,
              int x,
              int y,
              const character* text,
              int length)

This function draws text at a specified position or at the current position.


handle device

The handle of the device context.

int x

The x-coordinate of the position at which the text is drawn.

int y

The y-coordinate of the position at which the text is drawn.

const character* text

A pointer to the text to be drawn.

int length

The length (in characters) of the text to be drawn.



true The function succeeded.
false The call failed.


The text is drawn in the currently selected font.

If the current text alignment includes the flag text_alignment_flag::position_update; the current position is used for the text and the parameters specifying position (x and y) are ignored. If this flag is not in effect, the text is drawn at the specified position and the current position is neither used nor updated.

The text alignment for a device context may be

When this function is called from within a path bracket, the system generates a path including the characters and the containing character boxes.