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 [ En]

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 sprite. Para mejorar la eficacia, se debe especificar un objeto sprite si se va a llamar a DrawText más de una vez en una fila.

pString [ En]

Tipo: LPCTSTR

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

Recuento [ En]

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 [ En]

Tipo: LPRECT

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

Formato [ En]

Tipo: DWORD

Especifica el método para dar 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 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 enlazar el último carácter de la línea. En cualquier caso, DrawText devuelve el alto del texto con formato, pero no dibuja el texto.
CENTRO _ DE DT
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 recorte. 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 en 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 los avances de línea no interrumpirán la línea.
DT _ TOP
Texto que se justifica en la parte superior.
DT _ VCENTER
Centra el texto verticalmente (solo una línea).
DT _ WORDBREAK
Interrumpe las palabras. Las líneas se divide 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 de carro/avance de línea también interrumpe la línea.

Color [ En]

Tipo: D3DCOLOR

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

Valor devuelto

Tipo: INT

Si la función se realiza 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 desde pRect (de arriba a _ _ abajo) 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 un 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 utilice 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 cuyo escape y orientación son cero.

Requisitos

Requisito Value
Encabezado
D3dx9core.h
Biblioteca
D3dx9.lib

Vea también

ID3DXFont