CDC::DrawText 

virtual int DrawText ( LPCTSTR lpszString, int nCount, LPRECT lpRect, UINT nFormat );

int Dr&awText (const CStringamp;STRLPRECTlpRectUINTnFormat );

Valor devuelto

La altura del texto si la función es correcta.

Parámetros

lpszString

Puntos de la cadena a extraerse. Si nCount es – 1, la cadena debe ser terminada en null.

nCount

Especifica el número de caracteres en la cadena. Si nCount es-1, luego lpszString supone que es que un puntero a una cadena terminada en nulo y DrawText largo calcula automáticamente el número de caracteres.

lpRect

Apunta a una estructura RECT o un objeto CRect que contiene el rectángulo (en coordenadas lógicas) en que el texto es un formato.

str

 Un objeto CString que contiene los caracteres especificados se.

nFormat

Especifica el método de formato al texto. Puede ser cualquier combinación de los siguientes valores (combinar utilizando el operador OR bit a bit):

• DT_BOTTOMnbsp;  Especifica el texto justificado a la parte inferior. Este valor debe combinarse con DT_SI&NGLELINE.
  
  
• DT_CALCRECT   Determina el ancho y alto del rectángulo. Si hay varias líneas de texto, DrawText utilice el ancho del rectángulo apuntado por lpRect y ampliar la base del rectángulo a la última línea del texto. Si hay sólo una línea de texto, DrawText modificará el lado derecho del rectángulo que delimita el último carácter de la línea. En cualquier caso, DrawText devuelve la altura del texto con formato, pero no dibujar el texto.
  
  
• DT_CE&NTERnbsp;  Centra el texto horizontalmente.
  
  
• DT_E&ND_ELLIPSIS o DT_PATH_ELLIPSISnbsp;Reemplaza parte de la cadena dada con elipses, si es necesario, por lo que el resultado se ajusta en el rectángulo especificado. La cadena dada no es modificada salvo que se especifique la bandera DT_MODIFYSTRING.

  Puede especificar DT_END_ELLIPSIS para reemplazar caracteres al final de la cadena, o DT_PATH_ELLIPSIS para reemplazar caracteres de la cadena. Si la cadena contiene caracteres de barra diagonal inversa (\), DT_PATH_ELLIPSIS conserva lo más posible del texto después de la última barra invertida.

• DT_EXPA&NDTABSnbsp;  Expande los caracteres de tabulación. El número de caracteres por ficha predeterminado es ocho.
  
  
• DT_EXTER&NALLEADINGnbsp;  Incluye la inicial externa la fuente en la altura de la línea. Normalmente, la inicial externa no está incluido en la altura de una línea de texto.
  
  
• DT_LEFT   Alinea el texto escalera izquierda.
  
  
• DT_MODIFYSTRI&NGnbsp;Modifica la cadena dada para que coincida con el texto mostrado. Este indicador no tiene ningún efecto a menos que se especifica el indicador DT_END_ELLIPSIS o DT_PATH_ELLIPSIS.

  Nota Algunas combinaciones de bandera de uFormat pueden causar la cadena ha pasado a ser modificado. Usando DT_MODIFYSTRING con DT_END_ELLIPSIS o DT_PATH_ELLIPSIS puede causar la cadena a modificarse, causando una afirmación en la CString reemplazar.

• DT_&NOCLIPnbsp;  Dibuja sin recorte. DrawText es algo más rápido cuando se utiliza DT_NOCLIP.
  
  
• DT_NOPREFIXnbsp;  Desactiva el procesamiento de caracteres de prefijo. Normalmente, DrawText interpreta el personaje de prefijo de tecla de acceso "y" comercial (&) como una directiva para subrayar el carácter que sigue y el dos-ampersand (& &) caracteres de prefijo de tecla de acceso como una directiva para imprimir un único símbolo. Si se especifica DT_NOPREFIX, este proceso está desactivada.
  
  
• DT_PATH_ELLIPSISnbsp; & nbsp;
  
  
• DT_RIGHT   Alinea el texto escalera derecha.
  
  
• DT_SI&NGLELINEnbsp;  Especifica la línea sólo. Retornos de carro y saltos no romper la línea.
  
  
• DT_TABSTOP   Establece las tabulaciones. El byte de orden superior de nFormat es el número de caracteres para cada ficha. El número de caracteres por ficha predeterminado es ocho.
  
  
• DT_TOP   Especifica el texto justificado a la parte superior (sólo línea única).
  
  
• DT_VCE&NTERnbsp;  Especifica texto centrado verticalmente (sólo línea única).
  
  
• DT_WORDBREAK   Especifica la palabra ruptura. Las líneas se rompen automáticamente entre las palabras si una palabra se extendería allá del borde del rectángulo especificado por lpRect. Una secuencia de return–linefeed de transporte también romperá la línea.

&Notenbsp;Los valores DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPy DT_NOPREFIX no pueden usarse con el valor DT_TABSTOP.

Observaciones

Llame a esta función miembro para dar formato al texto en el rectángulo especificado. Formatos de texto ampliando fichas en los espacios adecuados, alinear texto a la izquierda, derecha o centro del rectángulo determinado, y dividir el texto en líneas que encajan dentro del rectángulo determinado. NFormat especifica el tipo de formato.

Esta función miembro utiliza el contexto de dispositivo fuente seleccionada, color de texto y color de fondo para dibujar el texto. A menos que se utiliza el formato DT_NOCLIP , DrawText recorta el texto para que el texto no aparece fuera del rectángulo determinado. Todo el formato se asume que tiene varias líneas a menos que se le da el formato DT_SINGLELINE.

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

Si se especifica el indicador DT_CALCRECT , el rectángulo especificado por lpRect se actualizarán para reflejar la anchura y la altura necesaria para dibujar el texto.

Si ha establecido la bandera de la alineación del texto TA_UPDATECP (véase CDC::SetTextAlign), DrawText mostrará texto comenzando en la posición actual, en lugar de a la izquierda del rectángulo determinado. DrawText no se ajustará el texto cuando se ha establecido la bandera TA_UPDATECP (es decir, la bandera DT_WORDBREAK no tiene ningún efecto).

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

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, RECT, CDC::SetTextAlign