Método ID3DX10Font::D rawText

Dibujar texto con formato. Este método admite cadenas ANSI y Unicode.

Sintaxis

INT DrawText(
  [in] LPD3DX10SPRITE pSprite,
  [in] LPCTSTR        pString,
  [in] INT            Count,
  [in] LPRECT         pRect,
  [in] UINT           Format,
  [in] D3DXCOLOR      Color
);

Parámetros

pSprite [in]

Tipo: LPD3DX10SPRITE

Puntero a un objeto ID3DX10Sprite que contiene la cadena que desea dibujar. Puede ser NULL, en cuyo caso Direct3D representará la cadena con su propio objeto de sprite. Para mejorar la eficacia, se debe especificar un objeto de sprite si se debe llamar a ID3DX10Font::D rawText más de una vez en una fila.

pString [in]

Tipo: LPCTSTR

Puntero a una cadena que se va a dibujar. Si se define UNICODE, este tipo de parámetro se resuelve en un LPCWSTR; de lo contrario, el tipo se resuelve en un LPCSTR. Si el parámetro Count es -1, la cadena debe terminar en NULL .

Recuento [in]

Tipo: INT

Número de caracteres de la cadena. Si Count es -1, se supone que el parámetro pString es un puntero a un sprite que contiene una cadena terminada en NULL y ID3DX10Font::D rawText calcula automáticamente el recuento de caracteres.

pRect [in]

Tipo: LPRECT

Puntero a una estructura RECT que contiene el rectángulo, en coordenadas lógicas, en las que se va a dar formato al texto. Al igual que con cualquier objeto RECT, el valor de coordenada del lado derecho del rectángulo debe ser mayor que el de su lado izquierdo. Del mismo modo, el valor de coordenada de la parte inferior debe ser mayor que el de la parte superior.

Formato [in]

Tipo: UINT

Especifique el método para dar formato al texto. Puede ser cualquier combinación de los valores siguientes:

Elemento	Descripción
DT_BOTTOM	Justifica el texto en la parte inferior del rectángulo. Este valor debe combinarse con DT_SINGLELINE.
DT_CALCRECT	Indique a DrawText que calcule automáticamente el ancho y el alto del rectángulo en función de la longitud de la cadena que se le indique que se dibuje. Si hay varias líneas de texto, ID3DX10Font::D rawText usa el ancho del rectángulo al que apunta el parámetro pRect y extiende la base del rectángulo para enlazar la última línea de texto. Si solo hay una línea de texto, ID3DX10Font::D rawText modifica el lado derecho del rectángulo para que delimite el último carácter de la línea. En cualquier caso, ID3DX10Font::D rawText devuelve el alto del texto con formato, pero no dibuja el texto.
DT_CENTER	Centrar el texto horizontalmente en el rectángulo.
DT_EXPANDTABS	Expanda los caracteres de tabulación. El número de caracteres predeterminado por tabulación es ocho.
DT_LEFT	Alinee el texto a la izquierda.
DT_NOCLIP	Dibuje sin recortar. ID3DX10Font::D rawText es algo más rápido cuando se usa DT_NOCLIP.
DT_RIGHT	Alinee el texto a la derecha.
DT_RTLREADING	Mostrar texto en orden de lectura de derecha a izquierda para texto bidireccional cuando se selecciona una fuente hebreo o árabe. El orden de lectura predeterminado para todo el texto es de izquierda a derecha.
DT_SINGLELINE	Mostrar texto solo en una sola línea. Los retornos de carro y las fuentes de línea no rompen la línea.
DT_TOP	Texto de justificación superior.
DT_VCENTER	Texto central vertical (solo línea única).
DT_WORDBREAK	Romper palabras. Las líneas se interrumpen automáticamente entre palabras si una palabra se extendería más allá del borde del rectángulo especificado por el parámetro pRect. Una secuencia de retorno/avance de línea de carro también interrumpe la línea.

 

Color [in]

Tipo: D3DXCOLOR

Color del texto. Vea D3DXCOLOR.

Valor devuelto

Tipo: INT

Si la función se ejecuta correctamente, el valor devuelto es el alto del texto en unidades lógicas. Si se especifica DT_VCENTER o DT_BOTTOM, el valor devuelto es el desplazamiento de pRect (superior a la parte inferior) del texto dibujado. Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Los parámetros de este método son muy similares a los de la función DrawText de GDI .

Este método admite cadenas ANSI y Unicode.

A menos que se use el formato DT_NOCLIP, este método recorta el texto para que no aparezca fuera del rectángulo especificado. Se supone que todo el formato tiene varias líneas a menos que se especifique el formato DT_SINGLELINE.

Si la fuente seleccionada es demasiado grande para el rectángulo, este método no intenta sustituir una fuente más pequeña.

Este método solo admite fuentes cuya orientación y escape son cero.

Requisitos

Consulte también

ID3DX10Font

D3DX Interfaces