CDC::DrawText

Artículo
02/19/2013

Llame a esta función miembro para dar formato al texto en el rectángulo especificado.para especificar opciones de formato adicionales, utilice CDC:: DrawTextEx.

virtual int DrawText(
   LPCTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat 
);
int DrawText(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat 
);

Parámetros

lpszString
Apunta a la cadena que se va a dibujar.Si es nCount – 1, la cadena debe ser terminada en null.
nCount
Especifica el número de caracteres de la cadena.Si es nCount – 1, entonces lpszString se asume que puntero largo en una cadena terminada en null y DrawText calcula el recuento de caracteres automáticamente.
lpRect
Señala una estructura de RECT o un objeto de CRect que contiene el rectángulo (en coordenadas lógicas) en el que el texto debe dar formato.
str
Un objeto de CString que contiene los caracteres especificados que se va a dibujar.
nFormat
Especifica el método de dar formato al texto.puede ser cualquier combinación de los valores descritos para el parámetro de uFormat en DrawText en Windows SDK.(combine mediante el OR bit a bit el operador):

[!NOTA]

Algunas combinaciones de marcadores de uFormat pueden producir la última cadena que se va a modificar.Mediante DT_MODIFYSTRING con DT_END_ELLIPSIS o DT_PATH_ELLIPSIS puede producir la cadena que se va a modificar, produciendo una aserción en la invalidación de CString .los valores DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, y DT_NOPREFIX no se pueden utilizar con el valor de DT_TABSTOP .

Valor devuelto

El alto del texto si la función es correcta.

Comentarios

Da formato al texto mediante tabulaciones que expanda en espacios apropiados, alineando el texto con el izquierdo, derecho, o el centro del rectángulo especificado, y colocando el texto en las líneas que caben dentro del rectángulo especificado.nFormatespecifica el tipo de formato.

Esta función miembro utiliza la fuente seleccionada, el color del texto, y el color de fondo del contexto para dibujar el texto.A menos que se utilice el formato de DT_NOCLIP , DrawText recorta el texto para que el texto no aparece fuera del rectángulo especificado.Todo el formato se supone que tener líneas múltiples a menos que se de formato de DT_SINGLELINE .

Si la fuente seleccionada es demasiado grande para el rectángulo especificado, la función miembro de DrawText no intenta sustituir una fuente más pequeña.

Si se especifica el indicador de DT_CALCRECT , el rectángulo especificado por lpRect se actualizará para reflejar el ancho y el alto necesarios para dibujar el texto.

Si se ha establecido la marca de alineación de texto de TA_UPDATECP (vea CDC:: SetTextAlign), DrawText mostrará texto que comienza en la posición actual, y no a la izquierda del rectángulo especificado.DrawText no incluirá el texto cuando se ha establecido la marca de TA_UPDATECP (es decir, el indicador de DT_WORDBREAK no tendrá ningún efecto).

El color del texto se puede establecer a CDC:: SetTextColor.