Método GraphicsPath::AddString(constWCHAR,INT,constFontFamily,INT,REAL,constRect&,constStringFormat*) (gdipluspath.h)

Artigo
03/16/2023

O método GraphicsPath::AddString adiciona a estrutura de tópicos de uma cadeia de caracteres a esse caminho.

Sintaxe

Status AddString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const FontFamily   *family,
  [in]      INT                style,
  [in]      REAL               emSize,
  [in, ref] const Rect &       layoutRect,
  [in]      const StringFormat *format
);

Parâmetros

[in] string

Tipo: const WCHAR*

Ponteiro para uma cadeia de caracteres largos.

[in] length

Tipo: INT

Inteiro que especifica o número de caracteres a serem exibidos. Se o parâmetro de cadeia de caracteres apontar para uma cadeia de caracteres terminada em NULL, esse parâmetro poderá ser definido como –1.

[in] family

Tipo: const FontFamily*

Ponteiro para um objeto FontFamily que especifica a família de fontes para a cadeia de caracteres.

[in] style

Tipo: INT

Inteiro que especifica o estilo da face de tipo. Esse valor deve ser um elemento da enumeração FontStyle ou o resultado de um OR bit a bit aplicado a dois ou mais desses elementos. Por exemplo, FontStyleBold | FontStyleUnderline | FontStyleStrikeout define o estilo como uma combinação dos três estilos.

[in] emSize

Tipo: REAL

Número real que especifica o tamanho em, em unidades mundiais, dos caracteres de cadeia de caracteres.

[in, ref] layoutRect

Tipo: const Rect

Referência a um objeto Rect que especifica, em unidades mundiais, o retângulo delimitador para a cadeia de caracteres.

[in] format

Tipo: const StringFormat*

Ponteiro para um objeto StringFormat que especifica informações de layout (alinhamento, corte, paradas de tabulação e similares) para 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.

Exemplos

O exemplo a seguir cria um caminho de objeto GraphicsPath, adiciona uma cadeia de caracteres terminada em NULL ao caminho e desenha o caminho.

VOID Example_AddString(HDC hdc)
{
   Graphics graphics(hdc);
   FontFamily fontFamily(L"Times New Roman");
   GraphicsPath path;

   path.AddString(
      L"Hello World", 
      -1,                 // NULL-terminated string
      &fontFamily, 
      FontStyleRegular, 
      48, 
      Rect(50, 50, 150, 100),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Requisitos

Requisito	Valor
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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll