Метод Graphics::D rawString(constWCHAR*,INT,constFont*,constPointF&,constBrush*) (gdiplusgraphics.h)
Метод Graphics::D rawString рисует строку на основе шрифта и источника строки.
Синтаксис
Status DrawString(
[in] const WCHAR *string,
[in] INT length,
[in] const Font *font,
[in, ref] const PointF & origin,
[in] const Brush *brush
);
Параметры
[in] string
Тип: const WCHAR*
Указатель на строку расширенных символов для рисования.
[in] length
Тип: INT
Целое число, указывающее количество символов в строковом массиве. Параметр length может иметь значение –1, если строка завершается null.
[in] font
Тип: const Font*
Указатель на объект Font , указывающий атрибуты шрифта (имя семейства, размер и стиль шрифта) для использования.
[in, ref] origin
Тип: const PointF
Ссылка на объект PointF , указывающий начальную точку для строки.
[in] brush
Тип: const Brush*
Указатель на объект Brush , используемый для заполнения строки.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Обратите внимание, что GDI+ не поддерживает шрифты PostScript или OpenType, которые не имеют контуров TrueType.
При использовании API GDI+ не следует разрешать приложению скачивать произвольные шрифты из ненадежных источников. Операционной системе требуются повышенные привилегии, чтобы гарантировать, что все установленные шрифты являются доверенными.
Примеры
В следующем примере рисуется строка в указанном источнике.
VOID Example_DrawString2(HDC hdc)
{
Graphics graphics(hdc);
// Create a string.
WCHAR string[] = L"Sample Text";
// Initialize arguments.
Font myFont(L"Arial", 16);
PointF origin(0.0f, 0.0f);
SolidBrush blackBrush(Color(255, 0, 0, 0));
// Draw string.
graphics.DrawString(
string,
11,
&myFont,
origin,
&blackBrush);
}
Требования
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusgraphics.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |