GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constPointF&,constStringFormat*) method (gdipluspath.h)
The GraphicsPath::AddString method adds the outline of a string to this path.
Syntax
Status AddString(
const WCHAR *string,
INT length,
const FontFamily *family,
INT style,
REAL emSize,
const PointF & origin,
const StringFormat *format
);
Parameters
string
Pointer to a wide-character string.
length
Integer that specifies the number of characters to display. If the string parameter points to a NULL-terminated string, this parameter can be set to –1.
family
Pointer to a FontFamily object that specifies the font family for the string.
style
Integer that specifies the style of the typeface.
This value must be an element of the FontStyle enumeration or the result of a bitwise OR applied to two or more of these elements.
For example, FontStyleBold | FontStyleUnderline | FontStyleStrikeout sets the style as a combination of the three styles.
emSize
Real number that specifies the em size, in world units, of the string characters.
origin
Reference to a PointF object that specifies, in world units, the location of the string.
format
Pointer to a StringFormat object that specifies layout information (alignment, trimming, tab stops, and the like) for the string.
Return value
Type: Status
If the method succeeds, it returns Ok, which is an element of the Status enumeration.
If the method fails, it returns one of the other elements of the Status enumeration.
Remarks
Note that GDI+ does not support PostScript fonts or OpenType fonts which do not have TrueType outlines.
Examples
The following example creates a GraphicsPath object path, adds a NULL-terminated string to path, and then draws path.
VOID Example_AddString(HDC hdc)
{
Graphics graphics(hdc);
FontFamily fontFamily(L"Times New Roman");
GraphicsPath path;
path.AddString(
L"Hello World",
-1, // NULL-terminated string
&fontFamily,
FontStyleRegular,
48,
PointF(50.0f, 50.0f),
NULL);
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
Requirements
| Requirement | Value |
|---|---|
| Header | gdipluspath.h |