Método Graphics::MeasureDriverString (gdiplusgraphics.h)

Artículo
02/26/2024

El método Graphics::MeasureDriverString mide el rectángulo delimitador de los caracteres especificados y sus posiciones correspondientes.

Sintaxis

Status MeasureDriverString(
  [in]  const UINT16 *text,
  [in]  INT          length,
  [in]  const Font   *font,
  [in]  const PointF *positions,
  [in]  INT          flags,
  [in]  const Matrix *matrix,
  [out] RectF        *boundingBox
);

Parámetros

[in] text

Tipo: const UINT16*

Puntero a una matriz de valores de 16 bits. Si se establece la marca DriverStringOptionsCmapLookup, cada valor especifica un carácter Unicode que se va a mostrar. De lo contrario, cada valor especifica un índice en un glifo de fuente que define un carácter que se va a mostrar.

[in] length

Tipo: INT

Entero que especifica el número de valores de la matriz de texto . 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 va a aplicar a la cadena.

[in] positions

Tipo: const PointF*

Si se establece la marca DriverStringOptionsRealizedAdvance, las posiciones son un puntero a un objeto PointF que especifica la posición del primer glifo. De lo contrario, las posiciones son una matriz de objetos PointF , cada uno de los cuales especifica el origen de un glifo individual.

[in] flags

Tipo: INT

Entero que especifica las opciones para la apariencia de la cadena. Este valor debe ser un elemento de la enumeración DriverStringOptions o el resultado de un OR bit a bit aplicado a dos o más de estos elementos.

[in] matrix

Tipo: matriz const *

Puntero a un objeto Matrix que especifica la matriz de transformación que se va a aplicar a cada valor de la matriz de texto .

[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

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