ExtTextOut (hdc, xStart, y5tart, i0ptions, &rect,PString, iCount, pxDistance) :Rozdzia� 17: Tekst i czcionki 889Pi�ty argument funkcji jest wska�nikiem...

Mo�e
to by� prostok�t wycinaj�cy, je�li parametr iOption przyjmie warto�� ETO_CLIP-
PED, b�d� prostok�t t�a (kt�ry mo�na wype�ni� bie��cym kolorem t�a), je�li pa-
rametr iOption przyjmie warto�� ETO OPAQUE. iOption mo�e przyjmowa� obie
warto�ci b�d� nie przyjmowa� �adnej z nich.
Ostatni argument jest tablic� element�w typu integer, kt�re okre�laj� odleg�o�ci
mi�dzy kolejnymi znakami �a�cucha tekstowego. Pozwala to programi�cie na
elastyczn� regulacj� tych odleg�o�ci, co mo�e by� przydatne do justowania poje-
dynczego s�owa w w�skiej kolumnie tekstu. Domy�lne odst�py mi�dzy znakami
tekstu otrzymuje si�, nadaj�c argumentowi warto�� NULL.
Funkcj� wy�szego rz�du przeznaczon� do pisania tekstu jest DrawText, z kt�r�
zetkn��e� si� po raz pierwszy w programie HELLOWIN w rozdziale 3. Zamiast
okre�la� pocz�tkowe wsp�rz�dne �a�cucha tekstu, wystarczy zdefiniowa� struk-
tur� typu RECT, opisuj�c� prostok�t, w kt�rym ma pojawia� si� tekst:
l
DrawText (hdc, pString, iCount, &rect, iFormat) ;
Podobnie jak w wypadku innych funkcji wyprowadzania tekstu, DrawText wy-
maga podania wska�nika do �a�cucha tekstowego oraz d�ugo�ci tego �a�cucha.
Je�li jednak jako argument podasz wska�nik do ci�gu znak�w zako�czonego
warto�ci� NULL, wystarczy, �e ustalisz warto�� iCount jako -l, a Windows auto-
matycznie wyznaczy d�ugo�� tekstu.
Kiedy iFormat przyjmuje warto�� 0, Windows interpretuje tekst jako jednolitero-
we wiersze oddzielone znakiem powrotu karetki ('\r' lub OxOD) b�d� znakiem
przesuni�cia wiersza ('\n' lub OxOA). Tekst rozpoczyna si� w lewym g�rnym
naro�niku prostok�ta definiowanego struktur� RECT. Znak powrotu karetki b�d�
przesuni�cia wiersza jest traktowany jako znak nowego wiersza, wi�c Windows
ko�czy bie��cy wiersz i rozpoczyna nowy. Ka�dy nowy wiersz rozpoczyna si�
po lewej stronie prostok�ta i jest odleg�y od poprzedniego o jedn� wysoko�� zna-
ku. Ka�dy, w��czaj�c w to cz�ci liter, wystaj�cy poza obszar prostok�ta po pra-
wej stronie lub poni�ej dolnej jego kraw�dzi jest obcinany.
Domy�lny spos�b dzia�ania funkcji DrawText mo�na zmieni�, odpowiednio ma-
nipuluj�c argumentem iFormat, kt�ry mo�e przyjmowa� jedn� z wielu warto�ci.
1 Warto�� sta�ej DT LEFT (przyjmowana domy�lnie) wymusza wyr�wnywanie tek-
stu do lewej kraw�dzi prostok�ta, DT RIGHT odpowiada za wyr�wnanie tekstu
do jego prawej kraw�dzi, a DT CENTER decyduje o wy�rodkowaniu �a�cucha.
Poniewa� sta�a DT LEFT jest zdefiniowana jako 0, nie musisz jej okre�la�, je�li
chcesz, aby tekst by� wyr�wnany do lewej.
Je�li nie chcesz, aby znaki powrotu karetki oraz przesuni�cia wiersza by�y inter-
pretowane jako znaki nowego wiersza, mo�esz przypisa� zmiennej iFormat war-
to�� sta�ej DT SINGLELINE i Windows potraktuje wspomniane znaki jako zwy-
k�e, a nie steruj�ce. Stosuj�c DT SINGLELINE mo�na r�wnie� okre�li�, czy tekst
ma by� umieszczany przy g�rnej kraw�dzi prostok�ta (DT TOP - domy�lnie),
w jego dolnej cz�ci (DT BOTTOM) b�d� po�rodku (DT VCENTR, gdzie V ozna-
cza vertical - w pionie).
Wy�wietlaj�c kilka wierszy tekstu, Windows �amie je w miejscach wyst�powania
znak�w powrotu karetki b�d� przesuni�cia wiersza. Je�li jednak wiersze s� zbyt
890 Cz�� II: Grafika
d�ugie, by zmie�ci� si� w obr�bie prostok�ta, mo�esz zastosowa� znacznik
DT WORDBREAK, kt�ry powoduje �amanie tekstu po ka�dym s�owie. Zar�wno
w tekstach jedno-, jak i wielowierszowych, Windows odcina fragmenty wystaj�-
ce poza prostok�t. To domy�lne dzia�anie funkcji mo�na zmieni�, stosuj�c znacz-
nik DT NOCLIP, kt�ry jednocze�rue przyspieszy jej prac�. Domy�lnie Windows
przyjmuje odleg�o�� pomi�dzy wierszami tekstu r�wn� wysoko�ci jednego zna-
ku. Je�li wolisz zastosowa� zewn�trzn� interlini�, u�yj znacznika
DT EXTERNALLEADING.
Je�li wy�wietlany tekst zawiera znaki tabulacji ('\t' lub 0x09), nale�y zastosowa�
znacznik DT EXPANDTABS. Domy�lnie tabulacje stopu ustawiane s� co 8 zna-
k�w. Mo�esz zmieni� ten rozmiar, ustawiaj�c znacznik DT TABSTOP. W takim
wypadku bardziej znacz�cy bajt parametru iFormat zawiera liczby okre�laj�ce
pozycje ka�dej tabulacji stopu. Radz� jednak unika� stosowania tej techniki, gdy�
bardziej znacz�cy bajt parametru iFormat jest u�ywany r�wnie� przez kilka in-
nych znacznik�w. Problem znacznika DT TABSTOP jest rozwi�zany przez funk-
cj� DrawTextEx, kt�ra przyjmuje dodatkowy argument:
DrawTextEx (hdc, pString, iCount, &rect, iFormat, &drawtextparams) ;
Ostatni argument jest wska�nikiem do struktury DRAWTEXTPARAMS, zdefinio-
wanej nast�puj�co:
typedef struct tagDRAWTEXTPARAMS
(
UINT cbSize ; // rozmiar struktury
int iTabLength ; // rozmiar ka�dej tabulacji stopu
int iLeftMargin ; // margines lewy
int iRightMargin ; // margines prawy
UINT uiLengthDrawn ; // liczba opracowanych znak�w
DRAWTEXTPARAMS, * LPDRAWTEXTPARAMS ;
Trzy �rodkowe pola struktury okre�lane s� w jednostkach stanowi�cych wielo-
kro#no�ci �redruej szeroko�ci znaku.
Atrybuty kontekstu urz�dzenia dia tekstu
Poza om�wion� powy�ej funkct� SetTextAlign istnieje wiele innych narz�dzi, kt�-
rych dzia�anie wp�ywa na atrybuty tekstu w kontek�cie urz�dzenia. Domy�)ny