Метод Graphics::D rawString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*) (gdiplusgraphics.h)
Метод Graphics::D rawString рисует строку на основе шрифта, прямоугольника макета и формата.
Синтаксис
Status DrawString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
const Brush *brush
);
Параметры
string
Указатель на строку расширенных символов для рисования.
length
Целое число, указывающее количество символов в строковом массиве. Параметр length может быть равен -1, если строка заканчивается null.
font
Указатель на объект Font , указывающий атрибуты шрифта (имя семейства, размер и стиль шрифта) для использования.
layoutRect
Ссылка на прямоугольник, ограничивающий строку.
stringFormat
Указатель на объект StringFormat , указывающий сведения о макете текста и операции отображения, применяемые к строке.
brush
Указатель на объект Brush , используемый для заполнения строки.
Возвращаемое значение
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Обратите внимание, что GDI+ не поддерживает шрифты PostScript или OpenType, которые не имеют контуров TrueType.
При использовании API GDI+ не следует разрешать приложению скачивать произвольные шрифты из ненадежных источников. Операционной системе требуются повышенные привилегии, чтобы гарантировать, что все установленные шрифты являются доверенными.
Примеры
В следующем примере указанное форматирование используется для рисования строки в прямоугольнике макета.
VOID Example_DrawString(HDC hdc)
{
Graphics graphics(hdc);
// Create a string.
WCHAR string[] = L"Sample Text";
// Initialize arguments.
Font myFont(L"Arial", 16);
RectF layoutRect(0.0f, 0.0f, 200.0f, 50.0f);
StringFormat format;
format.SetAlignment(StringAlignmentCenter);
SolidBrush blackBrush(Color(255, 0, 0, 0));
// Draw string.
graphics.DrawString(
string,
11,
&myFont,
layoutRect,
&format,
&blackBrush);
// Draw layoutRect.
graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}
Требования
| Верхняя часть | gdiplusgraphics.h |