CDC::ExtTextOut

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich zapisać ciąg znaków do obszaru prostokątnego przy użyciu aktualnie wybranej czcionki.

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 
);

Parametry

x
Określa logiczną współrzędną x komórki znaków dla pierwszego znaku w ciągu określonego.
y
Określa logiczną współrzędna y górnej komórce znak pierwszego znaku w ciągu określonego.
nOptions
Określa typ prostokąta.Ten parametr może być jedną, zarówno lub żaden z następujących 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 funkcji elementów członkowskich.)
lpRect
Wskazuje na RECT strukturę, która określa wymiary prostokąta.Ten parametr może być NULL.Można również przekazać CRect obiektu dla tego parametru.
lpszString
Wskazuje ciąg znaków określony wyciągnąć.Można również przekazać CString obiektu dla tego parametru.
nCount
Określa liczbę znaków w ciągu.
lpDxWidths
Punkty do tablicy wartości wskazujące, że odległość między pochodzenie komórek sąsiadujących znaków.Na przykład lpDxWidthsi jednostek logicznych będą oddzielać pochodzenie znaku i i znaku i + 1.Jeśli lpDxWidths jest NULL, ExtTextOut używa domyślny odstęp między znakami.
str
A CString obiektu zawierającego wyciągnąć określonych znaków.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

Prostokątnego może być nieprzezroczyste (wypełniona bieżącym kolorem tła) i można go obszar przycinania.

Jeśli nOptions 0 i lpRect jest NULL, funkcja zapisuje tekst do kontekstu urządzenia bez użycia prostokątny obszar.Domyślnie bieżącej pozycji nie jest używany lub aktualizowane przez funkcję.Jeśli aplikacja musi zaktualizować bieżącej pozycji, gdy wywołuje ExtTextOut, aplikacja może wywołać CDC Członkowskich funkcji SetTextAlign z nFlags ustawiona na TA_UPDATECP.Ustawienie tej flagi ignoruje Windows x i y na kolejne wywołania ExtTextOut i użyje bieżącego położenia.Gdy aplikacja używa TA_UPDATECP zaktualizować bieżącą pozycję ExtTextOut ustawia bieżącej pozycji na koniec poprzedniego wiersza tekstu lub pozycji określonej przez ostatni element tablicy wskazywanej przez lpDxWidths, zależności, która wartość jest większa.