CDC::ExtTextOut

wirtualne 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& stała;strLPINTlpDxWidths );

Wartość zwracany

Niezerowa, jeśli funkcja jest skuteczne; inny sposób 0.

Parametry

x

Określa komórki znaku odpowiadającego pierwszemu znakowi logiczne współrzędną x w określony ciąg.

y

Określa logiczne współrzędna y górnej komórce znak dla pierwszego znaku w określony ciąg.

nOptions

Określa typ prostokąta. Ten parametr może być jedną, zarówno lub żaden z poniższych wartości:

• ETO_CLIPPED   Określa, że tekst jest przycięty do prostokąta.
  
  
• ETO_OPAQUE   Określa, że bieżący kolor tła wypełnia prostokąta. (Można ustawić i kwerendy bieżący kolor tła z SetBkColor i GetBkColor Członkowskie funkcji.)

lpRect

Punkty struktury RECT , określająca wymiary prostokąta. Ten parametr może być NULL. Można również przekazać obiekt CRect dla tego parametru.

lpszString

Wskazuje ciąg znaków określony wyciągnąć. Można również przekazać obiekt CString dla tego parametru.

nCount

Określa liczbę znaków w ciągu.

lpDxWidths

Punkty do tablicy wartości, które wskazują odległość między pochodzenie komórek sąsiedniego znaku. Na przykład jednostki logiczne lpDxWidths[i] będą oddzielne pochodzenie znaku komórki i i znak komórki i + 1. Jeśli lpDxWidths ma wartość NULL, ExtTextOut wykorzystuje domyślne odstępy między znakami.

str

 Obiekt CString , który zawiera określone znaki wyciągnąć.

Uwagi

Wywołanie tej funkcji członek zapisu ciąg znaków do obszaru prostokątnego, przy użyciu aktualnie zaznaczonej czcionki. Prostokątnego może być nieprzezroczyste (wypełniona bieżącym kolorem tła) i można ją obszar przycinania.

Jeśli nOptions jest 0 i lpRect ma wartość NULL, funkcja zapisuje tekst do kontekstu urządzenia bez korzystania z prostokątnego obszaru. Domyślnie bieżąca pozycja nie jest używany lub aktualizowane przez funkcję. Jeżeli aplikacji musi zaktualizować bieżącą pozycję, gdy wywołuje ExtTextOut, aplikacja może wywołać funkcję Państwa CDC SetTextAlign z nFlags ustawiony na TA_UPDATECP. Jeśli ta flaga będzie ustawiona, Windows ignoruje x i y na wezwań do ExtTextOut i zamiast tego używa bieżącego położenia. Jeśli aplikacja używa TA_UPDATECP , aby zaktualizować bieżącą pozycję, ExtTextOut Ustawia aktualne stanowisko na koniec poprzedniego wiersza tekstu albo w pozycji określonej przez ostatni element tablicy wskazywanego przez lpDxWidths, którakolwiek z dat jest większa.

Omówie&nie CDC |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CDC::SetTextAlign, CDC::TabbedTextOut, CDC::TextOut, CDC::GetBkColor, CDC::SetBkColor, CDC::SetTextColor, :: ExtTextOut, RECT