Graphics::D rawString(constWCHAR,INT,constFont,constPointF&,constStringFormat,constBrush) (gdiplusgraphics.h)

Статья
02/26/2024

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

При использовании 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