Método Graphics::D rawString(constWCHAR,INT,constFont,constPointF&,constBrush*) (gdiplusgraphics.h)

Artigo
08/24/2023

O método Graphics::D rawString desenha uma cadeia de caracteres com base em uma fonte e uma origem para a cadeia de caracteres.

Sintaxe

Status DrawString(
  [in]      const WCHAR    *string,
  [in]      INT            length,
  [in]      const Font     *font,
  [in, ref] const PointF & origin,
  [in]      const Brush    *brush
);

Parâmetros

[in] string

Tipo: const WCHAR*

Ponteiro para uma cadeia de caracteres largos a ser desenhada.

[in] length

Tipo: INT

Inteiro que especifica o número de caracteres na matriz de cadeia de caracteres . O parâmetro length poderá ser definido como –1 se a cadeia de caracteres for terminada em nulo.

[in] font

Tipo: const 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.

[in, ref] origin

Tipo: const PointF

Referência a um objeto PointF que especifica o ponto de partida para a cadeia de caracteres.

[in] brush

Tipo: const Brush*

Ponteiro para um objeto Brush usado para preencher a cadeia de caracteres.

Retornar valor

Tipo: Status

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 desenha uma cadeia de caracteres na origem especificada.

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);
}

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll