TextOut - Extended


static void TextOut(Handle Device,
                    int X,
                    int Y,
                    unsigned Options,
                    Rectangle Clip,
                    String^ Text,
                    Array<int>^ Vector)

static void TextOut(Handle Device,
                    unsigned Options,
                    Rectangle Clip,
                    String^ Text,
                    Array<int>^ Vector)

static void TextOut(Handle Device,
                    int X,
                    int Y,
                    unsigned Options,
                    Rectangle Clip,
                    String^ Text)

static void TextOut(Handle Device,
                    unsigned Options,
                    Rectangle Clip,
                    String^ Text)

These functions draw text in the current font (with inter-character spacings).

Parameters

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.

unsigned Options

The options for drawing the text - see enumeration VectorTextOption.

Rectangle Clip

A rectangle that is used for clipping or painting of the background.

String^ Text

A pointer to the text to be drawn.

Array<int> Vector

A pointer to an array of values specifying the distance between the origins of adjacent character cells. Vector[i] logical units separate the origins of the ith and the i+1th character cells.

Notes

The text is drawn:

The current text alignment determines how the reference point is used to position the text.

If the increment array is null, the default spacing between characters is used. The origin of a character cell is the upper left corner of the character box. Measurements are expressed in logical units (within the array).

The current position is neither used nor updated by this operator unless the text alignment is set to contain the value TextAlignment::PositionUpdate. When this is done, the system ignores the positional parameters on subsequent calls and uses and updates the current position instead.

Details

Name Space IPlusPlus::Graphics
Class Gdi
Assembly IPlusPlus.WinPlus.dll