Метод GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRect&,constStringFormat*) (gdipluspath.h)
Метод GraphicsPath::AddString добавляет структуру строки в этот путь.
Синтаксис
Status AddString(
[in] const WCHAR *string,
[in] INT length,
[in] const FontFamily *family,
[in] INT style,
[in] REAL emSize,
[in, ref] const Rect & layoutRect,
[in] const StringFormat *format
);
Параметры
[in] string
Тип: const WCHAR*
Указатель на строку расширенных символов.
[in] length
Тип: INT
Целое число, указывающее количество отображаемых символов. Если строковый параметр указывает на строку, завершаемую значением NULL, для этого параметра можно задать значение –1.
[in] family
Тип: const FontFamily*
Указатель на объект FontFamily , указывающий семейство шрифтов для строки.
[in] style
Тип: INT
Целое число, задающее стиль шрифта. Это значение должно быть элементом перечисления FontStyle или результатом побитовой операции OR , примененной к двум или более из этих элементов. Например, FontStyleBold | FontStyleUnderline | FontStyleStrikeout задает стиль как сочетание трех стилей.
[in] emSize
Тип: REAL
Вещественное число, указывающее размер строковых символов в единицах мира.
[in, ref] layoutRect
Тип: const Rect
Ссылка на объект Rect , указывающий в единицах мира ограничивающий прямоугольник для строки.
[in] format
Тип: const StringFormat*
Указатель на объект StringFormat , указывающий сведения о макете (выравнивание, обрезка, табуляции и т. п.) для строки.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Обратите внимание, что GDI+ не поддерживает шрифты PostScript или OpenType, которые не имеют контуров TrueType.
Примеры
В следующем примере создается путь к объекту GraphicsPath, добавляется строка, завершающаяся null, в путь, а затем рисуется путь.
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,
Rect(50, 50, 150, 100),
NULL);
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdipluspath.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |