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

El método Graphics::MeasureString mide la extensión de la cadena en el rectángulo de fuente y diseño especificados.

Sintaxis

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*

Puntero a una cadena de caracteres anchos que se va a medir.

Importante En el caso de los idiomas bidireccionales, como el árabe, la longitud de la cadena no debe superar los 2046 caracteres.

 

[in] length

Tipo: INT

Entero que especifica el número de caracteres de la matriz de cadenas . El parámetro length se puede establecer en –1 si la cadena termina en null.

[in] font

Tipo: const Font*

Puntero a un objeto Font que especifica el nombre de familia, el tamaño y el estilo de la fuente que se aplica a la cadena.

[in, ref] layoutRect

Tipo: const RectF

Referencia a un rectángulo que enlaza la cadena.

[out] boundingBox

Tipo: RectF*

Puntero a un objeto RectF que recibe el rectángulo que enlaza la cadena.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve OK, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Métodos DrawString

Fuente

Elementos gráficos

RectF