Método Graphics::MeasureString(constWCHAR*,INT,constFont*,constRectF&,RectF*) (gdiplusgraphics.h)

  • Artigo

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

Sintaxe

Status MeasureString(
  [in]      const WCHAR   *string,
  [in]      INT           length,
  [in]      const Font    *font,
  [in, ref] const RectF & layoutRect,
  [out]     RectF         *boundingBox
);

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 de comprimento 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] layoutRect

Tipo: const RectF

Referência a um retângulo que vincula a cadeia de caracteres.

[out] boundingBox

Tipo: RectF*

Ponteiro para um objeto RectF que recebe o retângulo que vincula 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 .

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

Confira também

Métodos DrawString

Fonte

Elementos gráficos

RectF