DrawTextBoxMatrixA

Text, Page layout

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to DrawTextBoxMatrix and string arguments are interpreted using the current SetAnsiMode code page

This function is similar to the DrawTextBox function but the position/scaling/rotation is specified using a transformation matrix.

The vertical alignment can be set using the Options parameter, and the horizontal alignment can be set with the SetTextAlign function. The text will be word-wrapped to fit inside the bounding box.

Syntax

Delphi

Function DLDrawTextBoxMatrixA(InstanceID: Integer; Width, Height: Double; Text: PAnsiChar; Options: Integer; M11, M12, M21, M22, MDX, MDY: Double): Integer;

DLL

int DLDrawTextBoxMatrixA(int InstanceID, double Width, double Height, const char * Text, int Options, double M11, double M12, double M21, double M22, double MDX, double MDY);

Parameters

WidthThe width of the bounding box
HeightThe height of the bounding box
TextThe text to draw on the page
Options0 = Center vertical alignment 1 = Top vertical alignment 2 = Bottom vertical alignment 3 = Center vertical alignment, no wrapping 4 = Top vertical alignment, no wrapping 5 = Bottom vertical alignment, no wrapping Matrix component
M11
M12Matrix component
M21Matrix component
M22Matrix component
MDXMatrix component
MDYMatrix component

Return values

0The Options parameter was out of range, or the Width parameter was too small to contain any text The number of lines of text actually drawn
Non-zerodouble M21, double M22, double MDX, double MDY);