Método Graphics::D rawDriverString (gdiplusgraphics.h)

Artículo
03/14/2023

El método Graphics::D rawDriverString dibuja caracteres en las posiciones especificadas. El método proporciona al cliente un control completo sobre la apariencia del texto. El método supone que el cliente ya ha configurado el formato y el diseño que se va a aplicar.

Sintaxis

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

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

Tipo: pincel* const

Puntero a un objeto Brush que se usa para rellenar 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 .

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 .

Comentarios

Este método no admite el control de scripts complejos y supone que el cliente ha configurado todo el diseño de texto de alguna otra manera. Este método es útil para crear elementos de menú dibujados por el propietario. El cliente debe usar el método DrawString Methods para fines generales.

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