CDC::ExtTextOut
Llame a esta función miembro para escribir una cadena de caracteres dentro de un área rectangular con la fuente seleccionado actualmente.
virtual BOOL ExtTextOut(
int x,
int y,
UINT nOptions,
LPCRECT lpRect,
LPCTSTR lpszString,
UINT nCount,
LPINT lpDxWidths
);
BOOL ExtTextOut(
int x,
int y,
UINT nOptions,
LPCRECT lpRect,
const CString& str,
LPINT lpDxWidths
);
Parámetros
x
Especifica la coordenada x lógica de carácter por el primer carácter de la cadena especificada.y
Especifica la coordenada y lógica de la parte superior de la celda de carácter por el primer carácter de la cadena especificada.nOptions
Especifica el tipo del rectángulo.Este parámetro puede tener uno, o cualquiera de los siguientes valores:ETO_CLIPPED especifica que el texto se recortarán al rectángulo.
ETO_OPAQUE especifica que los rellenos de color de fondo actual el rectángulo.(Puede establecer y ver el color de fondo actual con el miembro de SetBkColor y de GetBkColor funciona).
lpRect
Señala una estructura de RECT que determina las dimensiones del rectángulo.este parámetro puede ser NULL.También puede pasar un objeto de CRect para este parámetro.lpszString
Apunta a la cadena de caracteres especificada que se va a dibujar.También puede pasar un objeto de CString para este parámetro.nCount
Especifica el número de caracteres de la cadena.lpDxWidths
Señala a una matriz de valores que indican la distancia entre los orígenes de celdas de carácter adyacentes.Por ejemplo, las unidades lógicas de lpDxWidths[i] separarán orígenes de celda de caracteres i y de celda de caracteres i + 1.Si lpDxWidths es NULL, ExtTextOut utiliza el espaciado predeterminado entre caracteres.str
Un objeto de CString que contiene los caracteres especificados que se va a dibujar.
Valor devuelto
Distinto de cero si la función es correcta; si no 0.
Comentarios
la región rectangular puede ser opaca (rellenado con el color de fondo actual), y puede ser una zona de recorte.
Si nOptions es 0 y lpRect es NULL, las etiquetas de la función texto en el contexto de dispositivo sin utilizar una región rectangular.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 ExtTextOut, la aplicación puede llamar a la función SetTextAlign miembro de CDC con nFlags establecido en TA_UPDATECP.Cuando se establece este marcador, Windows omite x e y en llamadas subsiguientes a ExtTextOut y utiliza la posición actual en su lugar.Cuando una aplicación usa TA_UPDATECP para actualizar la posición actual, ExtTextOut establece la posición actual hasta el final de la línea de texto anterior o a la posición especificada por el último elemento de la matriz indicada por lpDxWidths, lo que sea mayor.
Requisitos
encabezado: afxwin.h