Метод 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

См. также раздел

Шрифт

Графика

GraphicsPath

SolidBrush