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

Artigo
01/10/2024

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

Sintaxe

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

Parâmetros

string

Ponteiro para uma cadeia de caracteres largos.

length

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.

family

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

style

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.

emSize

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

origin

Referência a um objeto PointF que especifica, em unidades mundiais, o local da cadeia de caracteres.

format

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, 
      PointF(50.0f, 50.0f),
      NULL);

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