Compartir a través de


CDC::TextOut

Escribe una cadena de caracteres en la ubicación especificada usando la fuente seleccionada actualmente.

virtual BOOL TextOut( 
   int x, 
   int y, 
   LPCTSTR lpszString, 
   int nCount  
); 
BOOL TextOut( 
   int x,
   int y,
   const CString& str 
);

Parámetros

  • x
    Especifica la coordenada X lógica del punto inicial del texto.

  • y
    Especifica la coordenada Y lógica del punto inicial del texto.

  • lpszString
    Apunta a la cadena de caracteres que se va a dibujar.

  • nCount
    Especifica el número de caracteres de la cadena.

  • str
    Objeto CString que contiene los caracteres que se van a dibujar.

Valor devuelto

Es distinto de cero si la función se realiza correctamente; de lo contrario, es 0.

Comentarios

Los orígenes de los caracteres están en la esquina superior izquierda de la celda de caracteres. De forma predeterminada, la función no usa ni actualiza la posición actual.

Si una aplicación necesita actualizar la posición actual cuando llama a TextOut, la aplicación puede llamar a la función miembro SetTextAlign con nFlags establecido en TA_UPDATECP. Cuando se establece esta marca, Windows pasa por alto los parámetros x e y en las llamadas posteriores a TextOut, y usa la posición actual en su lugar.

Ejemplo

Vea el ejemplo de CDC::BeginPath.

Requisitos

Encabezado: afxwin.h

Vea también

Referencia

CDC (clase)

Gráfico de jerarquías

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut