Método ID3DXFont::D rawText

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

Sintaxis

INT DrawText(
  [in] LPD3DXSPRITE pSprite,
  [in] LPCTSTR      pString,
  [in] INT          Count,
  [in] LPRECT       pRect,
  [in] DWORD        Format,
  [in] D3DCOLOR     Color
);

Parámetros

pSprite [in]

Tipo: LPD3DXSPRITE

Puntero a un objeto ID3DXSprite que contiene la cadena. 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 va a llamar a DrawText más de una vez en una fila.

pString [in]

Tipo: LPCTSTR

Puntero a una cadena que se va a dibujar. Si el parámetro Count es -1, la cadena debe terminar en null.

Recuento [in]

Tipo: INT

Especifica el número de caracteres de la cadena. Si Count es -1, se supone que el parámetro pString es un puntero a una cadena terminada en null y DrawText 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. El valor de coordenada del lado derecho del rectángulo debe ser mayor que el del 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: DWORD

Especifica el método de aplicación de formato al texto. Puede ser cualquier combinación de los valores siguientes:

Value Significado
DT_BOTTOM
Justifica el texto en la parte inferior del rectángulo. Este valor debe combinarse con DT_SINGLELINE.
DT_CALCRECT
Determina el ancho y el alto del rectángulo. Si hay varias líneas de texto, DrawText 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, DrawText modifica el lado derecho del rectángulo para que delimite el último carácter de la línea. En cualquier caso, DrawText devuelve el alto del texto con formato, pero no dibuja el texto.
DT_CENTER
Centra el texto horizontalmente en el rectángulo.
DT_EXPANDTABS
Expande los caracteres de tabulación. El número de caracteres predeterminado por tabulación es ocho.
DT_LEFT
Alinea el texto a la izquierda.
DT_NOCLIP
Dibuja sin recortar. DrawText es algo más rápido cuando se usa DT_NOCLIP.
DT_RIGHT
Alinea el texto a la derecha.
DT_RTLREADING
Muestra 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
Muestra texto solo en una sola línea. Los retornos de carro y las fuentes de línea no rompen la línea.
DT_TOP
Justifica el texto superior.
DT_VCENTER
Centra el texto verticalmente (solo una línea).
DT_WORDBREAK
Rompe 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: D3DCOLOR

Color del texto. Para obtener más información, vea D3DCOLOR.

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.

Se debe llamar a este método dentro de beginScene ... Bloque EndScene . La única excepción es cuando una aplicación llama a DrawText con DT_CALCRECT para calcular el tamaño de un bloque de texto determinado.

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

Requisito Value
Encabezado
D3dx9core.h
Biblioteca
D3dx9.lib

Consulte también

ID3DXFont