Graphics::D rawString(constWCHAR*,INT,constFont*,constPointF&,constStringFormat*,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 StringFormat *stringFormat,
[in] const Brush *brush
);
Параметры
[in] string
Тип: const WCHAR*
Указатель на отрисовываемую строку с расширенными символами.
[in] length
Тип: INT
Целое число, указывающее количество символов в массиве строк . Параметру length можно задать значение –1, если строка завершается null.
[in] font
Тип: константный шрифт*
Указатель на объект Font , указывающий используемые атрибуты шрифта (имя семейства, размер и стиль шрифта).
[in, ref] origin
Тип: const PointF
Ссылка на объект PointF , указывающий начальную точку для строки.
[in] stringFormat
Тип: const StringFormat*
Указатель на объект StringFormat , указывающий сведения о макете текста и операции отображения, которые будут применены к строке.
[in] brush
Тип: константная кисть*
Указатель на объект Brush , используемый для заполнения строки.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .
Комментарии
Обратите внимание, что GDI+ не поддерживает шрифты PostScript или OpenType, которые не имеют структур TrueType.
При использовании API GDI+ не следует разрешать приложению скачивать произвольные шрифты из ненадежных источников. Операционной системе требуются повышенные привилегии, чтобы гарантировать, что все установленные шрифты являются надежными.
Примеры
В следующем примере используется указанное форматирование для рисования строки в указанном источнике.
VOID Example_DrawString3(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));
StringFormat format;
format.SetAlignment(StringAlignmentCenter);
// Draw string.
graphics.DrawString(
string,
11,
&myFont,
origin,
&format,
&blackBrush);
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusgraphics.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |