Graphics::MeasureString(constWCHAR,INT,constFont,constPointF&,constStringFormat,RectF) (gdiplusgraphics.h)

Artículo
08/24/2023

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

Sintaxis

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [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] origin

Tipo: const PointF

Referencia al punto en el que se inicia la cadena.

[in] stringFormat

Tipo: const StringFormat*

Puntero a un objeto StringFormat que especifica la información de diseño, como la alineación, el recorte, las tabulaciones, etc.

[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 ejecuta 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


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