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

Artículo
01/10/2024

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 SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

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] layoutRectSize

Tipo: const SizeF

Referencia a un objeto SizeF que especifica el ancho y el alto de un rectángulo que enlaza 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] size

Tipo: SizeF*

Puntero a un objeto SizeF que recibe el ancho y el alto del rectángulo que enlaza la cadena.

[out] codepointsFitted

Tipo: INT*

Opcional. Puntero a un INT que recibe el número de caracteres que encajan realmente en el rectángulo de diseño. El valor predeterminado es un puntero NULL .

[out] linesFilled

Tipo: INT*

Opcional. Puntero a un INT que recibe el número de líneas que encajan realmente en el rectángulo de diseño. El valor predeterminado es un puntero NULL .

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