CDC::ExtTextOut

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 lpRectCString& const;STRLPINTlpDxWidths );

Valor devuelto

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

Parámetros

x

Especifica la coordenada x lógica de la celda del carácter del primer carácter de la cadena especificada.

y

Especifica la coordenada y lógica de la parte superior de la celda del carácter del primer carácter de la cadena especificada.

nOptions

Especifica el tipo de rectángulo. Este parámetro puede ser uno, ambos o ninguno de los siguientes valores:

lpRect

Puntos a una estructura RECT que determina las dimensiones del rectángulo. Este parámetro puede ser NULL. También se puede pasar un objeto CRect para este parámetro.

lpszString

Puntos de la cadena de caracteres especificado a extraerse. También se puede pasar un objeto CString para este parámetro.

nCount

Especifica el número de caracteres en la cadena.

lpDxWidths

Puntos en una matriz de valores que indican la distancia entre el origen de las celdas de caracteres adyacentes. Por ejemplo, lpDxWidths[] unidades lógicas separará los orígenes del personaje celda y carácter celda + 1. Si lpDxWidths es NULL, ExtTextOut utiliza el espaciado predeterminado entre caracteres.

str

 Un objeto CString que contiene los caracteres especificados se.

Observaciones

Llame a esta función miembro para escribir una cadena de caracteres dentro de una región rectangular con la fuente seleccionada. La región rectangular puede ser opaca (rellena con el color de fondo actual), y puede ser una región de recorte.

Si nOptions es 0 y lpRect es NULL, la función escribe texto en el contexto de dispositivo sin necesidad de utilizar una región rectangular. De forma predeterminada, la posición actual no usa o actualizada 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 de miembro de CDC SetTextAlign con nFlags a TA_UPDATECP. Cuando se establece este indicador, Windows omite x e y en las llamadas posteriores al ExtTextOut y utiliza la posición actual en su lugar. Cuando una aplicación utiliza TA_UPDATECP para actualizar la posición actual, ExtTextOut establece la posición actual hasta el final de la anterior línea de texto o a la posición especificada por el último elemento de la matriz que apunta a lpDxWidths, lo que sea mayor.

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

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

Index