Share via


CDC::TextOut

Escribe una cadena de caracteres en la ubicación especificada utilizando 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 x- coordenada lógica de punto inicial del texto.

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

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

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

  • str
    Un objeto de CString que contiene los caracteres que se va a dibujar.

Valor devuelto

Distinto de cero si la función es correcta; si no 0.

Comentarios

Los orígenes de caracteres están en la esquina superior izquierda de la celda de carácter.De forma predeterminada, la posición actual no se utiliza o no está actualizado por la función.

Si una aplicación necesita actualizar la posición actual cuando llama a TextOut, la aplicación puede llamar a la función miembro de SetTextAlign con nFlags establecido en TA_UPDATECP.Cuando se establece este marcador, Windows omite el x y los parámetros de y en las llamadas posteriores a TextOut, mediante la posición actual en su lugar.

Ejemplo

Vea el ejemplo para CDC:: BeginPath.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de la CDC

Gráfico de jerarquía

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut