Compartilhar via


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

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 um cadeia de caracteres nullterminada, 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 ou 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 em tamanho, 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.

Valor de retorno

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

Observações

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 por NULL ao caminho e, em seguida, 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);
}

Requisitos

Requisito Valor
cabeçalho gdipluspath.h

Consulte também

métodos AddString

recorte de com um de região

de construção e desenho

criando um de gradiente de caminho

fonte

FontFamily

FontStyle

GraphicsPath

PointF

StringFormat

usando texto e fontes