Método Graphics::MeasureString(constWCHAR,INT,constFont,constSizeF&,constStringFormat,SizeF,INT,INT) (gdiplusgraphics.h)

Artigo
01/10/2024

O método Graphics::MeasureString mede a extensão da cadeia de caracteres no retângulo de fonte, formato e layout especificados.

Sintaxe

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

Parâmetros

[in] string

Tipo: const WCHAR*

Ponteiro para uma cadeia de caracteres largos a ser medida.

Importante Para idiomas bidirecionais, como árabe, o comprimento da cadeia de caracteres não deve exceder 2046 caracteres.

[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 o nome da família, o tamanho e o estilo da fonte que é aplicada à cadeia de caracteres.

[in, ref] layoutRectSize

Tipo: const SizeF

Referência a um objeto SizeF que especifica a largura e a altura de um retângulo que vincula a cadeia de caracteres.

[in] stringFormat

Tipo: const StringFormat*

Ponteiro para um objeto StringFormat que especifica as informações de layout, como alinhamento, corte, paradas de tabulação e assim por diante.

[out] size

Tipo: SizeF*

Ponteiro para um objeto SizeF que recebe a largura e a altura do retângulo que vincula a cadeia de caracteres.

[out] codepointsFitted

Tipo: INT*

Opcional. Ponteiro para um INT que recebe o número de caracteres que realmente se encaixam no retângulo de layout. O valor padrão é um ponteiro NULL .

[out] linesFilled

Tipo: INT*

Opcional. Ponteiro para um INT que recebe o número de linhas que realmente se encaixam no retângulo de layout. O valor padrão é um ponteiro NULL .

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 .

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