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

Confira também

Elementos gráficos

Fonte

Caneta

RectF

StringFormat