Método Graphics::D rawString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*) (gdiplusgraphics.h)
O método Graphics::D rawString desenha uma cadeia de caracteres com base em uma fonte, um retângulo de layout e um formato.
Sintaxe
Status DrawString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
const Brush *brush
);
Parâmetros
string
Ponteiro para uma cadeia de caracteres largos a ser desenhada.
length
Inteiro que especifica o número de caracteres na matriz de cadeia de caracteres. O parâmetro de comprimento poderá ser definido como -1 se a cadeia de caracteres for terminada em nulo.
font
Ponteiro para um objeto Font que especifica os atributos de fonte (o nome da família, o tamanho e o estilo da fonte) a serem usados.
layoutRect
Referência a um retângulo que vincula a cadeia de caracteres.
stringFormat
Ponteiro para um objeto StringFormat que especifica informações de layout de texto e manipulações de exibição a serem aplicadas à cadeia de caracteres.
brush
Ponteiro para um objeto Brush usado para preencher a cadeia de caracteres.
Retornar valor
Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .
Se o método falhar, ele retornará um dos outros elementos da enumeração Status .
Comentários
Observe que o GDI+ não dá suporte a fontes PostScript ou fontes OpenType que não têm estruturas de tópicos TrueType.
Ao usar a API GDI+, você não deve permitir que seu aplicativo baixe fontes arbitrárias de fontes não confiáveis. O sistema operacional requer privilégios elevados para garantir que todas as fontes instaladas sejam confiáveis.
Exemplos
O exemplo a seguir usa a formatação especificada para desenhar uma cadeia de caracteres em um retângulo de layout.
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);
}
Requisitos
| Cabeçalho | gdiplusgraphics.h |