WinApi-grafika 2D

5. Grafika 1/20 

Graphics Device Interface (GDI – interfejs urzdzenia graficznego) jest podsystemem 

Windows odpowiedzialnym za wywietlanie grafiki (włcznie z napisami) na ekranie i 

wydrukach. 

Kolory w Windows s pamitane w 32 bitowych liczbach całkowitych bez znaku (unsigned 

long) Opisujcy je typ danych ma nazw COLORREF. Warto tego typu zwraca makro 

RGB, które pobiera trzy argumenty reprezentujce barw czerwon, zielon i niebiesk: 

COLORREF RGB(BYTE byRed, BYTE byGreen, BYTE byBlue); 

Makrodefinicje: GetRValue, GetGValue, GetBValue pozwalaj obliczy z wartoci 

koloru RGB warto odpowiednich barw podstawowych (0-255). 

Przy omawianiu komunikatów poznalimy dwa podstawowe sposoby pobrania uchwytu 

kontekstu urzdzenia. 

Gdy program otrzymuje HDC, Windows tworzy kontekst urzdzenia przyjmujc wartoci 

domylne dla kadego jego atrybutu. W programie kad z tych wartoci mona odczyta lub 

zmieni. 

Copyright © 2001-2003 Ewa Lach


Atrybut DC 

Tryb odwzorowania 

(mapping mode) 

Punkt pocztkowy 

okna (window origin) 


widoku (viewport 

origin) 

Rozcigło okna 

(window extents) 

Rozcigło widoku 

(viewport extents) 

Warto domylna Funkcja 

zmieniajca warto 

Funkcja zwracajca 

warto 

MM_TEXT SetMapMode GetMapMode 

(0, 0) SetWindowOrgEx 

OffsetWindowOrgEx 

GetWindowOrgEx 

(0, 0) SetViewportOrgEx GetViewportOrgEx 

OffsetViewportOrgEx 

(1, 1) SetWindowExtEx 

SetMapMode 

ScaleWindowExtEx 

(1, 1) SetViewportExtEx 

SetMapMode 

GetWindowExtEx 

GetViewportExtEx 

ScaleViewportExtEx 

Pióro (pen) BLACK_PEN SelectObject SelectObject 

Pdzel (brush) WHITE_BRUSH SelectObject SelectObject 

Czcionka (font) SYSTEM_FONT SelectObject SelectObject 

Mapa bitowa 

(bitmap) 

Bieca pozycja 

pióra 

Tryb malowania tła 

(background mode) 

Kolor tła 

(background color) 

Kolor napisów 

(text color) 

Tryb krelenia 

(drawing mode) 

Tryb rozcigania 

mapy bitowej 

(stretching mode) 

Tryb wypełniania 

wieloktów (polygon 

fill mode) 

Odstp midzy 

znakami 


pdzla (Brush 

Origin) 

Region obcinania 

(clipping region) 

Brak SelectObject SelectObject 

(0, 0) MoveToEx 

LineTo 

PolylineTo 

PolyBezierTo 

GetCurrentPositionEx 

OPAQUE SetBkMode GetBkMode 

Biały SetBkColor GetBkColor 

Czarny SetTextColor GetTextColor 

R2_COPYPEN SetROP2 GetROP2 

BLACKONWHIT 

E 

SetStretchBltMode 

GetStretchBltMode 

ALTERNATE SetPolyFillMode GetPolyFillMode 

0 SetTextCharacterExtr GetTextCharacterExtr 

a 

a 

(0, 0) SetBrushOrgEx GetBrushOrgEx 

Brak 

SelectObject 

SelectClipRgn 

IntersectClipRgn 

OffsetClipRgn 

ExcludeClipRect 

SelectClipPath 

GetClipBox 



W momencie gdy zwalniamy DC funkcjami EndPaint, ReleaseDC wszelkie zmiany 

atrybutów DC s tracone. Moemy je zapamita okrelajc w stylach klasy: 

CS_OWNDC –kade okno danej klasy bdzie miało swój własny DC. Kontekst ten bdzie 

istnie dopóki nie usuniemy okna, a jego atrybuty pozostan stałe, dopóki si ich jawnie nie 

zmieni. 

lub: 

CS_CLASSDC – dana klasa ma własny kontekst urzdzenia dzielony midzy wszystkie okna 

tej klasy. 

Czasami pojawia si konieczno zmiany atrybutów na krótka chwile i ponowne 

przywrócenie poprzednich atrybutów. Dokonamy tego stosujc funkcje: 

int iSaveID = SaveDC(hdc); 

// zmiana atrybutów i działania na zmienionym DC 

RestoreDC(hdc, -1); 

BOOL RestoreDC(HDC hdc, int nSavedDC) 

nSavedDC – wskazuje na stan DC do odtworzenia. Jeeli >0 wskazuje na warto zwrócon 

przez SaveDC, jeeli jest to warto ujemna wskazuje który zapisany DC ma odtworzy 

np. –1 spowoduje odtworzenie ostatnio zapisanego DC. 

W trakcie rysowania przyda si funkcja któr poznalimy wczeniej (w.2) zwracajca 

współrzdne obszaru roboczego okna w stosunku do lewego górnego rogu obszaru roboczego 

okna (lpRect.left = lpRect.top = 0) 

BOOL GetClientRect(HWND hWnd, LPRECT lpRect) 

funkcja odczytujca parametry systemu: 

int GetSystemMetrics(int nIndex); 

nIndex - indeks parametru, którego warto chcemy otrzyma, np. SM_CXSCREEN zwraca 

szeroko ekranu 

funkcja odczytujca lub ustawiajca zadany parametr 

BOOL SystemParametersInfo(UINT uiAction, UINT uiParam, 

PVOID pvParam,UINT fWinIni); 

uiAction - jaki parametr naley odczyta lub ustawi 

uiParam, pvParam - parametry zalene od podejmowanej akcji 

fWinIni - czy aktualizowa ustawienia (rozesłanie komunikatu: WM_SETTINGCHANGE) 

np. SystemParametersInfo(SPI_GETWORKAREA,0,&rect,0) pobiera rozmiar 

obszaru roboczego (bez paska zada) 



Tryb odwzorowania. 

Wikszo współrzdnych i wymiarów uywanych we wszystkich funkcjach GDI jest 

wyraone w jednostkach logicznych. Windows zmienia jednostki logiczne na jednostki 

urzdzenia, czyli na piksele. Sposób zmiany współrzdnych zaley m.in. od trybu 

odwzorowania. 

Windows wyrónia osiem trybów odwzorowywania: 

Kierunek wzrostu wartoci 

Tryb odwzorowania Jednostki logiczne na osi x na osi y 

MM_TEXT (domylny) piksel w prawo w dół 

MM_LOMETRIC 0,1 mm w prawo do góry 

MM_HIMETRIC 0,01 mm w prawo do góry 

MM_LOENGLISH 0,01 cala w prawo do góry 

MM_HIENGLISH 0,001 cala w prawo do góry 

MM_TWIPS 1/1440 cala w prawo do góry 

MM_ISOTROPIC dowolne (x=y) do wyboru do wyboru - 

mona zmieni rozcigło okna/widoku 

MM_ANISOTROPIC dowolne (x!=y) do wyboru do wyboru - 

mona zmieni rozcigło okna/widoku 

int SetMapMode(HDC hdc, int iMapMode) – pozwala na zmian trybu 

odwzorowania.. 

int GetMapMode(HDC hdc) – zwraca tryb odwzorowania. 

Tryb odwzorowania okrela odwzorowanie „okna” (współrzdne logiczne) na „widok” 

(współrzdne urzdzenia) za pomoc: 

xViewport =(xWindow – xWindOrg) * (xViewExt / xWinExt) + 

xViewOrg 

yViewport =(yWindow – yWindOrg) * (yViewExt / yWinExt) + 

yViewOrg 

xWindow, yWindow – przekształcany punkt we współrzdnych logicznych 

xViewport, yViewport – wynik przekształcenia we współrzdnych urzdzenia. 

xWindOrg, yWindOrg, xViewOrg, yViewOrg – pocztek okna i widoku 

xViewExt, yViewExt, xWinExt, yWindExt – rozcigło widoku i okna. Kada rozcigło z 

osobna nic nie znaczy, ale stosunek rozcigłoci widoku do rozcigłoci okna okrela czynnik 

skalujcy niezbdny do przeliczania. 

BOOL DPtoLP(HDC hdc, LPPOINT lpPoints, int iNumber) – funkcja 

przekształca iNumber punktów urzdzenia zawartych w tablic lpPoints na punkty logiczne. 

BOOL LPtoDP(HDC hdc, LPPOINT lpPoints, int iNumber) – funkcja 

przekształca iNumber punktów logicznych zawartych w tablic lpPoints na punkty urzdzenia. 



Jeeli chcesz wywietli obraz w calach lub milimetrach bez zmiany trybu mona dziki 

funkcji GetDeviceCaps uzyska potrzebne informacje i samemu odpowiednio wyskalowa 

rysunek. 

int GetDeviceCaps(HDC hdc, int nIndex) – zwraca informacje na temat DC. 

nIndex – indeks danej o któr pytamy 

HORZSIZE – szeroko w mm 

VERTSIZE – wysoko w mm 

HORZRES – szeroko w pikselach 

VERTRES – wysoko w liniach rastra 

BITSPIXEL – liczba bitów na piksel (głbia koloru) 

PLANES – liczba warstw koloru 

NUMBRUSHES – liczba pdzli urzdzenia 

NUMPENS – liczba piór urzdzenia 

NUMMARKERS – liczba znaczników urzdzenia 

NUMFONTS – liczba czcionek urzdzenia 

NUMCOLORS – liczba kolorów urzdzenia 

PDEVICESIZE – rozmiar struktury urzdzenia 

ASPECTX – wzgldna szeroko piksela 

ASPECTY – wzgldna wysoko piksela 

ASPECTXY – wzgldna przektna piksela 

LOGPIXELSX – punkty na cal w poziomie 

LOGPIXELSY – punkty na cal w pionie 

SIZEPALETTE – liczba pozycji palety 

NUMRESERVED – zarezerwowane pozycje palety 

COLORRES – faktyczna rozdzielczo koloru 

BOOL ClientToScreen(HWND hwnd, LPPOINT lpPoint) – przekształca 

współrzdne wskazane przez lpPoint obszaru roboczego na współrzdne ekranu. 

BOOL ScreenToClient(HWND hwnd, LPPOINT lpPoint) – przekształca 

współrzdne ekranu na współrzdne obszaru roboczego. 



Pióro. 

Do rysowania w kontekcie urzdzenia uywamy „pióra”. Pióro okrela kolor linii, jej 

grubo oraz styl (cigła, kropkowana, przerywana). 

W systemie mamy trzy predefiniowane pióra: 

BLACK_PEN – domylny, czarne cigłe linie gruboci jednego piksela. 

WHITE_PEN 

NULL_PEN – pióro jest przeroczyste. 

Oby otrzyma w programie predefiniowane pióro wykorzystujemy funkcje GetStockObject. 

HPEN hPen = GetStockObject(WHITE_PEN); 

Aby dane pióro było biece w kontekcie urzdzenia korzystamy z funkcji SelectObject. 

HPEN hPenOld = SelectObject(hdc, hPen); 

HGDIOBJ SelectObject(HDC hdc, HGDIOBJ hGDIobj) – funkcja ustawia obiekt 

GDI w okrelonym kontekcie urzdzenia i zwraca uchwyt obiektu, który został zastpiony. 

Obiektem moe by bitmapa, czcionka, pióro, pdzel. 

HPEN CreatePen(int PenStyle, int iWidth, COLORREF rgbColor) - 

tworzy „pióro logiczne” które moe nastpnie by wybrane w DC przy pomocy SelectObject. 

PenStyle – okrela styl linii: 

PS_SOLID ______________ 

PS_DASH __ __ __ __ __ 

PS_DOT ............................ 

PS_DASHDOT 

PS_DASHDOTDOT 

PS_NULL 

PS_INSIDEFRAME ______________ - odpowiada PS_SOLID. W przypadku prostokta 

jego wymiary s zmniejszane tak aby ramka mieciła si wewntrz podanych wymiarów. 

iWidth – dla PS_SOLID, PS_NULL i PS_INSIDEFRAME grubo linii. 0 oznacza jeden 

piksel. 

HPEN CreatePenIndirect( CONST LOGPEN * logpen) - tworzy „pióro 

logiczne” które moe nastpnie by wybrane w DC przy pomocy SelectObject, przy pomocy 

struktury LOGPEN. 

typedef struct tagLOGPEN { 

UINT PenStyle; 

POINT iWidth; // system ignoruje iWidth.y i bierze pod uwag jedynie 

iWidth.x 

COLORREF rgbColor; 

} LOGPEN, *PLOGPEN; 

HPEN ExtCreatePen(DWORD dwPenStyle, DWORD dwWidth, CONST 

LOGBRUSH * lplb, DWORD dwStyleCount, CONST DWORD *lpStyle) – 

tworzy rozszerzone pióro. Cz jego moliwoci nie jest wykorzystywana przy kreleniu 

zwykłych linii. Wicej jego właciwoci wykorzystywane jest przy kreleniu cieki za 

pomoc StrokePath. 

dwPenStyle – okrela styl linii. Mona połczy style uywane w CreatePen z stylami: 

PS_GEOMETRIC – dwWidth okrela grubo linii w jednostkach logicznych 

PS_COSMETIC – dwWidth musi si równa 1. 

PS_ENDCAP_ROUND – zaokrglone koce linii (domylne w CreatePen) 



PS_ENDCAP_SQUARE – koczy lini kwadratem wydłuajc lini o pół gruboci linii na 

kadym jej kocu. 

PS_ENDCAP_FLAT – koczy lini kwadratem 

PS_JOIN_ROUND – połczenia midzy liniami s zaokrglane (domylne w CreatePen) 

PS_JOIN_BEVEL – cina koce połczenia 

PS_JOIN_MITER – tworzy połczenie spiczaste 

lplp – wskanik na struktur opisujc pdzel. Jeeli styl jest PS_COSMETIC pole struktury 

lbStyle = BS_SOLID, a lbColor okrela kolor. Jeeli PS_GEOMETRIC – dowolne. 

Mona pobra informacje o piórze: 

GetObject(hPen, sizeof(LOGPEN), (LPVOID) &logpen); 

int GetObject(HGDIOBJ hGDIobj, int cbBuffor, LPVOID lpvObj) – 

funkcja zwraca informacje na temat obiektu GDI wypełniajc bufor przechowujcy 

informacje na temat obiektu. 

cbBuffor – okrela wielko bufora. 

Wszystkie utworzone przez uytkownika obiekty GDI musz by usunite. 

BOOL DeleteObject(HGDIOBJ hGDIobj); 

Nie wolno usuwa obiektów GDI w chwili gdy s wybrane w nie zwolnionym DC, oraz 

obiektów predefiniowanych. 

Przerwy w liniach, tło tekstu i pdzla jest wypełniane kolorem tła DC jeeli tryb tła jest 

ustawiony na OPAQUE. Jeeli tryb tła jest TRANSPARENT wówczas Windows pozostawia 

tło bez wypełnienia. 

int SetBkMode(HDC hdc, int iBkMode) – ustawia tryb tła (OPAQUE, 

TRANSPARENT) 

int GetBkMode(HDC hdc) – zwraca tryb tła (OPAQUE, TRANSPARENT) 

int SetBkColor(HDC hdc, COLORREF rgbColor) – ustawia kolor tła 

COLORREF GetBkColor(HDC hdc) – zwraca kolor tła. 

Tryb rysowania okrela wynik połczenia pikseli pióra i podłoa – kolor linii jest wynikiem 

działa logicznych na kolorze pióra i podłoa. 

R2_BLACK - 0 Piksel jest zawsze czarny 

R2_NOTMERGEPEN - ~(P|T) Piksel jest inwersj koloru uzyskanego trybem 

R2_MERGEPEN 

R2_MASKNOTPEN - ~P &T 

R2_NOTCOPYPEN - ~P Piksel jest inwersj koloru pióra 

R2_MASKPENNOT - P& ~T 

R2_NOT - ~T Piksel jest inwersj koloru tła 

R2_XORPEN - P^T 

R2_NOTMASKPEN - ~(P&T) 

R2_MASKPEN - P&T 

R2_NOTXORPEN - ~(P^T) 

R2_NOP - T Piksel pozostaje niezmieniony 

R2_MERGENOTPEN - ~P|T 

R2_COPYPEN - P Domylny. Piksel jest koloru pióra 

R2_MERGEPENNOT - P| ~T 

R2_MERGEPEN - P|T Piksel jest kombinacj koloru tła i pióra 

R2_WHITE - 1 Piksel jest zawsze biały 

int SetROP2(HDC hdc, int iDrawMode) – ustawia tryb rysowania. 

int GetROP2(HDC hdc) – zwraca tryb rysowania. 



Pdzel. 

Do wypełniania obszarów uywamy „pdzla”. Pdzel jest map bitow o wymiarach 8 pikseli 

na 8 pikseli. 

W systemie mamy predefiniowane pdzle: 

WHITE_BRUSH – domylny, wypełnia obszar na biało. 

LTGRAY_BRUSH 

GRAY_BRUSH 

DKGRAY_BRUSH 

BLACK_BRUSH 

NULL_BRUSH = HOLLOW_BRUSH 

Mona wybra predefiniowany pdzel tak jak wybierało si predefiniowane pióro: 

HBRUSH hBrush = GetStockObject(GRAY_BRUSH); 

HBRUSH hBrushOld = SelectObject(hdc, hBrush); 

HBRUSH CreateSolidBrush(COLORREF rgbColor) – tworzy pdzel logiczny o 

okrelonym kolorze. 

HBRUSH CreateHatchBrush(int iHatchStyle, COLORREF rgbColor) – 

tworzy pdzel ze wzorem o okrelonym kolorze. 

iHatchStyle – okrela rodzaj wzoru: 

HS_HORIZONIAL 

HS_VERICAL 

HS_FDIAGONAL 

HS_BDIAGONAL 

HS_CROSS 

HS_DIAGCROSS 

Obszar midzy liniami jest wypełniany w zalenoci od koloru i trybu tła ( jak pióro z 

przerywanymi liniami). 

HBRUSH CreatePatternBrush(HBITMAP hBitmap) – tworzy pdzel w oparciu o 

map bitow. 

HBRUSH CreateBrushIndirect( CONST LOGBRUSH * logbrush) – tworzy 

pdzel w oparciu o struktur LOGBRUSH. Struktura składa si z trzech pól. Warto pola 

lbStyle okrela w jaki sposób Windows interpretuje pozostałe dwa pola 

LbSytle (UINT) lbColor (COLORREF) 

BS_SOLID kolor pdzla pomijane 

BS_HOLLOW pomijane pomijane 

lbHatch (LONG) 

BS_HATCHED kolor linii wzoru wzór wypełnienia 

BS_PATTERN pomijane uchwyt mapy bitowej 



Krelenie na ekranie : 

COLORREF SetPixel( HDC hdc, int X, int Y, COLORREF crColor) – 

ustawia piksel o okrelonym połoeniu na dany kolor 

COLORREF GetPixel( HDC hdc, int X, int Y) – zwraca kolor piksela o 

okrelonym połoeniu. 

Cz funkcji nie okrela miejsca od którego rozpoczyna krelenia. Korzysta z biecej 

pozycji pióra. Mona zmieni t pozycj za pomoc: 

BOOL MoveToEx(HDC hdc, int X, int Y, LPPOINT lpPoint); 

lpPoint – zawiera poprzedni pozycj. Jeeli nie interesuje nas ta warto moemy poda 

NULL. 

Moemy pobra biec pozycj za pomoc: 

BOOL GetCurrentPositionEx(HDC hdc, LPPOINT lpPoint); 

BOOL LineTo(HDC hdc, int nXend, int nYend) – rysuje linie od biecej 

pozycji do punktu podanego w funkcji (ale bez tego punktu). Zmienia biec pozycj pióra 

na punkt podany w funkcji. 

BOOL Polyline(HDC hdc, CONST POINT *lppt, int cPoint) – funkcja 

kreli linie łczce kolejne punkty z tablicy punktów. Funkcja nie wykorzystuje, ani nie 

zmienia biecej pozycji pióra. 

cPoint – okrela ilo punktów w tablicy musi by wikszy od 1. 

BOOL PolylineTo(HDC hdc, CONST POINT *lppt, int cPoint) - funkcja 

kreli linie łczce kolejne punkty z tablicy punktów. Przy czym pierwszy punkt odpowiada 

biecej pozycji pióra; funkcja ustawia biec pozycj w jej punkcie kocowym. 

BOOL Rectangle(HDC hdc, int xLeft, int yTop, int xRight, int 

yBottom) – kreli prostokt za pomoc biecego pióra i wypełnia go za pomoc 

biecego pdzla. 

BOOL Ellipse(HDC hdc, int xLeft, int yTop, int xRight, int 

yBottom) – kreli elips za pomoc biecego pióra i wypełnia j za pomoc biecego 

pdzla. rodek elipsy odpowiada rodkowi podanego prostokta. 

BOOL RoundRect(HDC hdc, int xLeft, int yTop, int xRight, int 

yBottom, int xCornerEllipse, int yCornerEllipse) – kreli prostokt z 

zaokrglonymi wierzchołkami za pomoc biecego pióra i wypełnia go za pomoc biecego 

pdzla. xCornerEllipse i yCornerEllipse okrelaj szeroko i wysoko elipsy 

uytej do zaokrglania prostokta. 

BOOL Arc(HDC hdc, int xLeft, int yTop, int xRight, int 

yBottom, int xStart, int yStart, int xEnd, int yEnd) – kreli łuk, 

bdcy czci elipsy opisanej przez 4 pierwsze parametry prostokta. Pozostałe 4 okrelaj 

pocztek i koniec łuku bdcy przeciciem elipsy i prostej łczcej rodek elipsy i punkt 

pocztku / koca. 



BOOL Chord(HDC hdc, int xLeft, int yTop, int xRight, 

int yBottom, int xStart, int yStart, int xEnd, int yEnd) 

– kreli łuk jak w funkcji Arc, oraz odcinek łczc koniec i pocztek łuku przy pomocy 

biecego pióra i wypełnia obszar pomidzy łukiem a odcinkiem za pomoc biecego 

pdzla. 

BOOL Pie(HDC hdc, int xLeft, int yTop, int xRight, 

int yBottom, int xStart, int yStart, int xEnd, int yEnd) 

– kreli łuk jak w funkcji Arc, oraz odcinki łczc koniec i pocztek łuku z rodkiem elipsy 

przy pomocy biecego pióra i wypełnia obszar pomidzy łukiem a odcinkami za pomoc 

biecego pdzla. 

BOOL PolyBezier(HDC hdc, Const POINT *lppt, DWORD cPoints)– kreli 

jedn lub wicej krzywych Beziera. 

lppt – wskanik na tablic punktów 

Pierwsza krzywa jest krelona od pierwszego do czwartego punktu, przy uyciu 2 i 3 punktu 

jako punktów kontrolnych ( które pełni rol magnesów odcigajcych lini od odcinka 

łczcego punkty kocowe). Kada kolejny segment krzywej potrzebuje trzech punktów. 

Punkt kocowy wczeniejszego segmentu jest punktem pocztkowym nastpnego. 

CPoints – ilo punktów w tablicy (3*ilo krzywych +1) 

BOOL PolyBezierTo(HDC hdc, Const POINT *lppt, DWORD cPoints)– 

kreli jedn lub wicej krzywych Beziera. Róni si od PolyBezier tym, e pierwszy punkt 

pocztkowy odpowiada biecej pozycji pióra. Funkcja ustawia biec pozycj w jej punkcie 

kocowym. 

BOOL Polygon(HDC hdc, CONST POINT *lppt, int cPoint) – funkcja kreli 

linie łczce kolejne punkty z tablicy punktów. Jeeli ostatni punkt z tablicy nie pokrywa si z 

pierwszym Windows dodaje odcinek zamykajcy figur. Nastpnie system wypełnia figur 

korzystajc z pdzla biecego w sposób zaleny od ustawionego trybu wypełniania 

wieloktów. 

cPoint – okrela ilo punktów w tablicy; musi by wikszy od 1. 

int SetPolyFillMode(HDC hdc, int iMode) – zmienia tryb wypełniania 

wieloktów w biecym DC. 

iMode – tryb wypełniania wieloktów: 

ALTRNATE – domylny. Obszar zostanie wypełniony jeli półprosta wyprowadzona z 

dowolnego punktu obszaru przetnie nieparzyst liczb krawdzi. Pozostałe obszary pozostan 

niewypełnione. 

WINDING – Windows wypełni wszystkie domknite obszary. 

int FillRect(HDC hdc, CONST RECT * rect, HBRUSH hBrush) – 

wypełnia obszar prostokta wskazany 

przez rect za pomoc podanego pdzla. Zawiera lew i górn krawd prostokta, nie zawiera 

krawdzi prawej i dolnej. 

int FrameRect(HDC hdc, CONST RECT * rect, HBRUSH hBrush) – maluje 

pdzlem prostoktn ramk, 

rodek pozostawiajc nie wypełniony. 

BOOL InvertRect(HDC hdc, CONST RECT * rect) – odwraca barw pikseli 

wewntrz prostokta. 



Operacje na obiekcie typu RECT: 

BOOL SetRect(RECT *rect, int xLeft, int yTop, int xRight, 

yBottom) – funkcja ustawia pola 

obiektu typu RECT. 

BOOL OffsetRect(RECT *rect,int x,int y) –przesuwa prostokt o okrelon 

liczb jednostek wzdłu osi x i y. 

BOOL InflateRect(RECT *rect, int dx, int dy) – zwiksza lub zmniejsza 

rozmiary prostokta o okrelon 

liczb jednostek w obie strony. 

BOOL SetRectEmpty(RECT *rect) – wyzerowuje wszystkie pola zmiennej typu 

RECT. 

BOOL CopyRect(RECT *DestRect, RECT *SrcRect) – Kopiuje pola jednego 

prostokta do drugiego. 

BOOL IntersectRect(RECT *DestRect, RECT *SrcRect1, RECT 

*SrcRect2) – wylicza cz wspóln 

dwóch prostoktów. 

BOOL UnionRect(RECT *DestRect,RECT *SrcRect1,RECT *SrcRect2)- 

wylicza sum dwóch prostoktów. 

BOOL IsRectEmpty(RECT *rect)- zwraca TRUE jeeli wszystkie boki prostokta s 

zerowe. 

BOOL PtInRect(RECT *rect, POINT point)- zwraca TRUE jeeli punkt 

znajduje si wewntrz prostokta. 

Region. 

Region opisuje obszar powstały ze złoenia prostoktów, wieloktów i elips. Region 

podobnie jak pióro lub pdzel jest obiektem GDI. To znaczy mona go utworzy, pobra do 

niego uchwyt, a nastpnie naley go usun (DeleteObject(hRgn)). 

HRGN CreateRectRgn(int xLeft, int yTop, int xRight, int 

yBottom) – tworzy region w kształcie prostokta. 

HRGN CreateRectRgnIndirect(CONST RECT * rect) – tworzy region w 

kształcie prostokta. 

HRGN CreateEllipticRgn(int xLeft, int yTop, int xRight, int 

yBottom) – tworzy region w kształcie elipsy. 

HRGN CreateEllipticRgnIndirect(CONST RECT * rect) – tworzy region w 

kształcie elipsy. 

HRGN CreateRectRgn(int xLeft, int yTop, int xRight, int 

yBottom, int nWidthEllipse, int nHeightEllipse) – tworzy region w 

kształcie prostokta z zaokrglonymi rogami. 

HRGN CreatePolygonRgn(CONST POINT *lppt, int cPoint, int 

iPolyFillMode) – funkcja tworzy region w kształcie wielokta, powstałego w wyniku 

połczenia kolejnych punktów z tablicy punktów. Jeeli ostatni punkt z tablicy nie pokrywa 

si z pierwszym Windows dodaje odcinek zamykajcy figur. 

cPoint – okrela ilo punktów w tablicy; musi by wikszy od 1. 

iPolyFillMode – jest równy ALTRNATE lub WINDING i okrela które piksele nale do 

regionu. 



int CombineRgn(HRGN hDestRgn, HRGN hSrcRgn1, HRGN hSrcRgn2, 

int iCombine) – funkcja składa dwa regiony dajc w wyniku uchwyt nowego regionu. 

Wszystkie trzy regiony musz istnie wczeniej, a region poprzednio opisywany przez 

hDestRgn zostanie usunity. 

iCombine – okrela sposób łczenia regionów 

RGN_AND – cz wspólna regionów 

RGN_OR – suma regionów 

RGN_XOR – suma regionów z wyłczeniem czci wspólnej 

RGN_DIFF – cz naleca do hSrcRgn1 i nie naleca do hSrcRgn2 

RGN_COPY – cało hSrcRgn1. 

Funkcja zwraca: 

NULLREGION – region pusty 

SIMPLEREGION – pojedynczy prostokt, wielokt lub elipsa 

COMPLEXREGION – złoenie prostoktów, wieloktów i elips. 

ERROR - błd 

BOOL FillRgn(HDC hdc,HRGN hrgn,HBRUSH hBrush) – wypełnia obszar 

regionu za pomoc podanego pdzla. 

BOOL FrameRect(HDC hdc, HRGN hrgn, HBRUSH hBrush, int nWidth, 

int nHeight) – maluje pdzlem ramk dookoła regionu, rodek pozostawiajc nie 

wypełniony. 

nWidth, nHeight – szeroko i wysoko ramki. 

BOOL InvertRgn(HDC hdc, HRGN hrgn) – odwraca barw pikseli wewntrz 

regionu. 

BOOL PaintRgn(HDC hdc, HRGN hrgn) – wypełnia region za pomoc biecego 

pdzla. 

Regiony moemy wykorzysta do ustawiania obszarów w którym mona malowa – 

regionów obcinania. Poza tymi obszarami Windows nic nie wykreli. Wykorzystujemy do 

tego funkcje 

uniewaniajc obszar: InvalidateRgn(HWND hWnd , HRGN hRgn, BOOL 

bErase ) i zatwierdzajc obszar ValidateRgn(HWND hWnd , HRGN hRgn). 

wyznaczajc obszar obcinania dla danego DC: 

HRGN SelectObject(HDC hdc, HRGN hRgn); 

int SelectClipRgn(HDC hdc, HRGN hRgn); 

cieka. 

cieka jest zbiorem odcinków i łuków pamitanych przez GDI. Podcieki składaj si z 

cigu połczonych linii. Kada podcieka moe by zamknita lub otwarta. Moemy 

zamkn podciek odcinkiem za pomoc funkcji: 

BOOL CloseFigure(HDC hdc) 

ciek tworzymy za pomoc funkcji: 

BeginPath(hdc); 

// funkcje krelce linie, odcinki, krzywe 

EndPath(hdc); 

Funkcje usuwajce definicj cieki: 

BOOL StrokePath(HDC hdc) – kreli ciek za pomoc biecego pióra. 

BOOL FillPath(HDC hdc) – zamyka odcinkiem kad otwart figur w ciece i 

wypełnia j uywajc pdzla biecego. 



BOOL StrokeAndFillPath(HDC hdc) – kreli ciek za pomoc biecego pióra, 

zamyka odcinkiem kad otwart figur w ciece i wypełnia j uywajc pdzla biecego. 

HRGN PathToRegion(HDC hdc) – przekształca ciek w region 

BOOL SelectClipPath(HDC hdc, int iCombine) – definiuje obszar obcinania. 

iCombine – przyjmuje takie same wartoci jak iCombine w funkcji CombineRgn i okrela 

sposób w jaki cieka zostanie połczona z biecym regionem obcinania. 

Obrazy. 

Wyróniamy dwa sposoby przechowywania obrazów w programach: za pomoc map 

bitowych (cyfrowa reprezentacja obrazu) oraz metaplików (opisów obrazu). 

Liczba kolorów mapy bitowej jest równa 2 do potgi równej liczbie bitów przypadajcych na 

piksel (głbia koloru).(np. 16-kolorowa bitmapa– 4 bity na piksel). 

DDB. 

Do czasu Windows 3.0 mielimy do czynienia jedynie z bitmapami jako obiektami GDI. S to 

mapy monochromatyczne, albo mapy o takiej samej organizacji kolorów jak rzeczywiste 

graficzne urzdzenia wyjciowe ( monitor, drukarka), dla którego mapa była tworzona. 

Działanie na tych bitmapach jest jednak wygodniejsze i wydajniejsze ni na bitmapach 

niezalenych sprztowo, dlatego jeeli potrzebujesz mapy bitowej zgodnej z kart graficzn i 

wyłcznie na uytek twojego programu lepiej korzysta ze starszej wersji bitmapy. 

Funkcje tworzce mapy bitowe zalene od sprztu ( DDB): 

HBITMAP CreateBitmap(int cxWidth, int cyHeight, UINT iPlanes, 

UINT iBitsPixel, CONST VOID * lpBits) 

Pierwsze dwa argumenty odpowiadaj szerokoci i wysokoci bitmapy w pikselach, trzeci 

okrela liczb warstw barwnych, a czwarty głbi koloru. W rzeczywistoci trzeci i czwarty 

argument bd przyjmowa nastpujce wartoci: 

- iBitPixel = iPlanes =1 – bitmapa monochromatyczna 

- iBitPixel i iPlanes odpowiadaj wartociom danego DC, które mona pobra przy 

pomocy GetDeviceCap. 

lpBits- wskanik na tablic kolorów, uytych do utworzenia bitmapy. Jeeli równe NULL 

tworzymy nie zainicjowan map bitow. 

HBITMAP CreateCompatibeBitmap(HDC hdc, int cxWidth, 

int cyHeight) 

– na podstawie hdc Windows pobierze potrzebne informacje na temat warstw i głbi koloru. 

W tym przypadku mapa bitowa nie bdzie zainicjowana. Oprócz posiadania takiej samej 

organizacji barw jak DC bitmapa nie jest zwizana w inny sposób z DC. 

HBITMAP CreateBitmapIndirect(CONST BITMAP * bitmap) 

– tworzy bitmap w oparciu o struktur BITMAP. 

typedef struct tagBITMAP { 

LONG bmType; // Ustawione na 0 

LONG bmWidth; // Szeroko mapy bitowej w pikselach 

LONG bmHeight; // Wysoko mapy bitowej wyraona w wierszach pikseli 

LONG bmWidthBytes; // Szeroko mapy bitowej wyraona w bajtach – najmniejsza 

parzysta liczba bajtów potrzebna do 

// zapamitania jednego wiersza pikseli. 

WORD bmPlanes; // Liczba warstw barwnych 

WORD bmBitsPixel; // głbia koloru 

LPVOID bmBits; // Wskanik do tablicy bitów 

} BITMAP, *PBITMAP; 



Aby skopiowa zawarto tablicy zawierajcej bity mapy bitowej do istniejcej mapy bitowej 

naley uy funkcji: 

LONG SetBitmapBits(HBITMAP hBitmap, LONG dwCount, LPVOID 

pBitmap) 

dwCount - ilo bitów do przekopiowania do tablicy wskazanej przez pBitmap. Liczb 

wszystkich bitów w mapie bitowej mona wyliczy za pomoc wzoru: 

dwCount = (DWORD) bitmap.bmWidhtBytes * bitmap.bmHeight * 

bitmap.bmPlanes; 

Moemy pobra informacje o bitmapie za pomoc funkcji: 

GetObject(hBitmap, sizeof(BITMAP), (LPVOID) &bitmap) – funkcja 

kopiuje informacje do struktury BITMAP pozostawiajc pole bmBits puste. 

Aby otrzyma dostp do mapy bitowej naley wywoła funkcj: 

LONG GetBitmapBits(HBITMAP hBitmap, LONG dwCount, LPVOID 

pBitmap) 

W kontekcie zwykłego urzdzenia nie mona wybra mapy bitowej. Jest to moliwe jedynie 

w kontekcie urzdzenia pamiciowego. Kontekst urzdzenia pamiciowego ta taki DC, który 

ma „powierzchnie wywietlania” istniejc tylko w pamici komputera i moemy go 

utworzy za pomoc funkcji: 

HDC CreateCompatibleDC(HDC hdc) – funkcja tworzy DC pamiciowego , który ma 

“powierzchni wywietlania” zawierajc dokładnie 1 piksel monochromatyczny. 

Aby powikszy tak utworzony DC pamiciowego naley wybra map bitow w DC: 

SelectObject(hdcMem, hBitmap); 

Z tak utworzonym DC moesz robi to samo co z zwykłym DC – zmienia atrybuty, 

sprawdza ich wartoci, wybiera w kontekcie pióro, pdzel i regiony. 

Wszelkie zmiany poczynione na mapie bitowej pojawiaj si na powierzchni wywietlania 

DC pamiciowego. Wszystko co narysujesz w DC pamiciowego jest tak naprawd rysowane 

na mapie bitowej. 

Bitmap bdziemy wywietla w DC obszaru roboczego naszego okna przekazujc bity 

bitmapy midzy kontekstami urzdzenia. 

BOOL PatBlt(HDC hdc, int xDest, int yDest, int xWidth, int 

yHeight, DWORD dwROP) – funkcja rysuje prostokt uywajc biecego pdzla. 

Funkcja dokonuje operacji logicznych na kolorach pdzla i ekranu. 

xDst, yDst – punkt logiczny wskazujcy na lewy górny naronik prostokta dla trybu 

MM_TEXT. W pozostałych trybach naronik prostokta zale od znaku przy dwóch 

kolejnych parametrach. 

xWidth, yHeight – warto bezwzgldna z tych wartoci wyznacza szeroko i wysoko 

prostokta 

dwROP – okrela operacje wykonywane na kolorach pdzla i ekranu: 

BLACKNESS – wypełnia prostokt czarnym kolorem 

WHITENESS – wypełnia prostokt białym kolorem 

DSTINVERT – odwraca kolor ekranu 

PATINVERT – łczy kolory za pomoc operacji logicznej XOR (Pdzel ^ Ekran) 

PATCOPY – przekopiowuje kolory pdzla 



BOOL BitBlt(HDC hdcDest, int xDest, int yDest, int xWidth, int 

yHeight, HDC hdcSrc, int xSrc, int ySrc, DWORD dwROP) – funkcja 

przesyła bity kolorów okrelonego prostokta z DC ródłowego do 

DC docelowego. DC ródłowy moe równa si DC docelowy 

dwROP – okrela operacje wykonywane na kolorach pdzla hdcDest, ekranu i prostokta 

ródłowego. 

BLACKNESS – wypełnia prostokt czarnym kolorem 

WHITENESS – wypełnia prostokt białym kolorem 

DSTINVERT – odwraca kolor ekranu 

MERGECOPY – łczy kolor pdzla hdcDest z kolorem prostokta ródłowego przy pomocy 

operacji logicznej AND. 

MERGEPAINT – łczy odwrócone kolory prostokta ródłowego i kolory ekranu przy 

pomocy operacji logicznej OR. 

SRCCOPY – przekopiowuje kolory prostokta ródłowego 

NOTSRCCOPY – przekopiowuje odwrócone kolory prostokta ródłowego. 

SRCERASE - łczy odwrócone kolory ekranu i kolory prostokta ródłowego przy pomocy 

operacji logicznej AND 

NOTSRCERASE - łczy kolory ekranu i prostokta ródłowego przy pomocy operacji 

logicznej OR i odwraca wynik. 

PATINVERT – łczy kolory pdzla i ekranu za pomoc operacji logicznej XOR (Pdzel ^ 

Ekran) 

PATCOPY – przekopiowuje kolory pdzla 

PATPAINT – łczy kolory pdzla i odwrócone kolory prostokta ródłowego przy pomocy 

operacji OR. Rezultat łczy z kolorami ekranu przy pomocy operacji OR. 

SRCAND – łczy kolory prostokta ródłowego i ekranu za pomoc operacji AND. 

SRCINVERT - łczy kolory prostokta ródłowego i ekranu za pomoc operacji XOR. 

SRCPAINT - łczy kolory prostokta ródłowego i ekranu za pomoc operacji OR. 

BOOL StretchBlt(HDC hdcDest, int xDest, int yDest, int 

xDestWidth, int yDestHeight, HDC hdcSrc, int xSrc, int ySrc, 

int xSrcWidth, int ySrcHeight, DWORD dwROP) – funkcja rozszerza 

moliwoci BitBlt o zmian wielkoci bitmapy z kontekstu urzdzenia docelowego. 

Umoliwia take odwrócenie obrazu : odbicie zwierciadlane ( jeeli xSrcWidth i xDestWidth 

po zmianie na współrzdne urzdzenia maj róne znaki) lub w kierunku góra-dół ( jeeli 

ySrcHeight i yDestHeight po zmianie na współrzdne urzdzenia maj róne znaki). To w 

jaki sposób funkcja zmniejsza obraz zaley od trybu rozcigania mapy bitowej (stretching 

mode) okrelanego dla kadego DC. 

Mona zmienia warto tego trybu za pomoc funkcji: 

int SetStretchBltMode(HDC hdc, int iMode) 

iMode: 

BLACKONWHITE = STRETCH_ANDSCANS – jeeli dwa lub wicej pikseli trzeba złczy 

w jeden piksel StretchBlt wykonuje na pikselach operacj koniunkcji (logiczne AND) 

WHITEONBLACK = STRETCH_ORSCANS - StretchBlt wykonuje na pikselach operacj 

alternatywy(logiczne OR) 

COLORONCOLOR = STRETCH_DELETESCANS – StretchBlt eliminuje wiersze lub 

kolumny bez wykonywania jakichkolwiek operacji logicznych. 

HALFTONE = STRETCH_HALFTONE – Windows oblicza redni kolor w oparciu o piksele 

które trzeba połczy. 



DIB. 

W Windows 3.0 zdefiniowany został nowy format map bitowych DIB (device-independent 

bitmap) – mapy bitowe niezalene od sprztu. DIB posiada własn tabel barw która okrela 

metod przekodowania bitów piksela na kolory systemu RGB. Format DIB słuy głównie do 

wymiany obrazów midzy programami. Mona go zapisywa w pliku albo skopiowa do 

schowka. DIB nie jest obiektem GDI. 

Metapliki. 

Metapliki s binarnie zakodowanym zbiorem wywoła funkcji graficznych. 

Najpierw tworzymy kontekst urzdzenia metapliku za pomoc funkcji: 

HDC CreateMetaFile( LPCTSTR lpszFile) 

lpszFile – nazwa pliku (najczciej z rozszerzeniem WMF (windows metafile)) lub NULL. 

Jeeli NULL metaplik powstanie w pamici. 

Nastpnie krelimy w DC metapliku. Wszystkie wywołania funkcji GDI s zapisywane 

binarnie w metapliku. 

Kolejny etap to zamknicie kontekstu urzdzenia metapliku za pomoc funkcji: 

HMETAFILE CloseMetaFile(HDC hdcMeta) – funkcja zwraca uchwyt metapliku. 

Nastpnie moemy wywietli obraz zapamitany w metapliku w DC za pomoc funkcji: 

BOOL PlayMetaFile(HDC hdc, HMETAFILE hmf) 

Podobnie jak inne obiekty GDI, metapliki powinny zosta usunite przed zakoczeniem 

programu. W tym celu wywołujemy funkcje: 

BOOL DeleteMetaFile(HMETAFILE hmf) 

Z tworzonym w ten sposób plikami wi si pewne problemy. Na przykład program 

uywajcy metapliku utworzonego w innym programie nie moe w prosty sposób okreli 

wymiarów obrazu. Dlatego metapliki s rzadko wykorzystywane do wymiany rysunków 

midzy programami. 

W zwizku z typ powstał nowy format: „ulepszone metapliki” ( enhanced metafile – EMF) 

Tworzenie „ulepszonych metaplików” i ich wywietlanie przebiega podobnie jak starych 

metaplików. 

HDC CreateEnhMetaFile(HDC hdc, LPCTSTR lpszFile, CONST RECT * 

lpRect, LPCTSTR lpDescription) 

hdc – Windows wykorzystuje ten parametr do wstawienia do nagłówka metapliku informacji 

o wymiarach rysunku. Jeeli =NULL GDI pobierze odpowiednie informacje z kontekstu 

urzdzenia wywietlajcego. 

lpRect – wskazuje na prostokt wyznaczajcy całkowite wymiary metapliku. Jeeli =NULL 

to GDI okreli te wymiary. 

lpDescription – tekst opisujcy metaplik. Składa si z dwóch czci. Pierwsza zakoczona 0 

zawiera nazw aplikacji, druga zakoczona dwoma zerami opisuje rysunek. Moe równa si 

NULL. 

HENHMETAFILE CloseEnhMetaFile(HDC hdcEMF)- funkcja usuwa uchwyt DC 

metapliku otrzymujc w zamian uchwyt metapliku. 

BOOL PlayEnhMetaFile(HDC hdc, HENHMETAFILE hmf, CONST RECT * 

lpRect) 

lpRect – prostokt do którego GDI dopasowuje rysunek. 

BOOL DeleteEnhMetaFile(HENHMETAFILE hmf) – usuwa metaplik z pamici 

HENHMETAFILE GetEnhMetaFile(LPCTSTR lpszFile) – funkcja zwraca uchwyt 

do metapliku na dysku. 



UINT GetEnhMetaFileHeader(HENHMETAFILE hemf, UINT cbSize, 

LPENHMETAHEADER emh) – funkcja zwraca informacje z nagłówka metapliku. 

cbSize – okrela w wielko bufora na dane. 

emh – wskanik na struktur ENHMETAHEADER, jeeli =NULL funkcja zwraca wielko 

rekordu nagłówkowego 

Uyteczne pola ENHMETAHEADER: 

RECT rclBounds – zawiera wymiary rysunku w pikselach 

RECT rclFrame – zawiera wymiary rysunku w setnych czciach milimetra. 

UINT GetEnhMetaFileDescription(HENHMETAFILE hemf, UINT 

sizechBuffer, LPTSTR lpszDescription) – wypełnia bufor opisem metapliku. 

Jeeli lpszDescription=NULL funkcja zwraca długo opisu. 

Teksty i czcionki 

Funkcja wywietlajc tekst: 

BOOL TextOut( HDC hdc, int nXStart, int nYStart, LPCTSTR 

lpString, int cbString) 

hdc – uchwyt kontekstu urzdzenia 

nXStart – punkt pocztkowy napisu na osi poziomej okrelany wzgldem lewego górnego 

rogu obszaru roboczego 

nYStart - punkt pocztkowy napisu na osi pionowej okrelany wzgldem lewego górnego 

rogu obszaru roboczego 

lpString – wskanik do cigu znaków. 

cbString – liczb znaków w cigu. 

Funkcja okrelajca połoenie napisów, zmieniajca domylne znaczenie parametrów 

nXStart, nYStart z funkcji TextOut. : 

UINT SetTextAlign(HDC hdc, UINT fmode) 

fmode: 

TA_LEFT – domylny; wyrównuje tekst do lewej krawdzi. nXStart wskazuje na punkt od 

którego rozpoczynamy pisanie. 

TA_RIGHT – łacuch znaków dosunity praw krawdzi ostatniego znaku do punktu o 

współrzdnej poziomej nXStart. 

TA_CENTER – współrzdna nXStart wyznacza rodek krelonego napisu 

TA_TOP – domylny; nYStart wyznacza górn krawd znaków 

TA_BOTTOM – wszystkie znaki cigu znajduj si powyej rzdnej nYStart 

TA_BASELINE – podstawa wywietlania tekstu (linia która biegnie wzdłu podstawy liter 

nie majcych tzw. wydłue dolnych np. (wydłuenia maj np.: y,p,g)) znajdzie si na rzdnej 

nYStart 

TA_UPDATECP – system ignoruje nXStart i nYStart, a zamiast nich uyje biecej pozycji 

pióra. Dla tego stylu TextOut 

ustawi biec pozycj pióra na koniec wykrelonego teksu (dla TA_LEFT) lub na jego 

pocztku (dla TA_RIGHT) 

BOOL SetTextJustification(HDC hdc, int nExtra, nBrakCount); - 

ustawia wielko przestrzeni jak trzeba rozłoy midzy przerwy w tekcie. 

nExtra – okrela przestrze jak trzeba rozłoy pomidzy przerwy w łacuchach znaków. 

NBreakCount – liczba przerw w łacuch, do których naley doda woln przestrze. 

Zaczynajc nowy wiersz jeeli wczeniej uyto tej funkcji naley ustawi przerwy: 

SetTextJustification(hdc, 0,0); 



Funkcja wywietla tekst zamieniajc umieszczone w tekcie znaki tabulacji (‘\t’ lub 0x09) na 

odstpy okrelone w tablicy liczb całkowitych: 

LONG TabbedTextOut(HDC hdc, int nXStart, int nYStart, LPCTSTR 

lpString, int cbString, int iNumTab, CONST LPINT piTabStops, 

int xTabOrgin) 

iNumTab – liczba znaków tabulacji 

piTabStops – tablica współrzdnych tabulacji wyraonych w pikselach 

Jeeli iNumTab=0 i piTabStops=NULL system ustawia tabulatory co 8 znak (w oparciu o 

redni szeroko znaku) 

Jeeli iNumTab=1 to piTabStops zawiera liczb okrelajc odstp pomidzy kolejnymi 

tabulatorami. 

xTabOrgin – wskazuje na punkt na os x od którego nastpi odmierzanie tabulatorów. 

Jeeli funkcja zakoczy si sukcesem zwraca rozmiar napisu HIWORD(wynik) – wysoko, 

LOWORD(wynik) - szeroko 

BOOL ExtTextOut(HDC hdc, int nXStart, int nYStart, UINT 

iOptions, CONST RECT *rect, LPCTSTR lpString, UINT cbString, 

CONST INT *lpDx) 

iOptions – okrelaj w jaki sposób interpretowa prostokt rect. Moe by równe 0. 

ETO_CLIPPED – rect jest to prostokt obcinania 

ETO_OPAQUE – rect – prostoktne tło, które zostanie wypełnione kolorem tła biecego. 

lpDx – wskazuje na tablic liczb całkowitych okrelajcych odstpy pomidzy kolejnymi 

znakami w cigu. Jeeli ten parametr równa si NULL domylny odstp zostanie 

zastosowany.. 

Funkcja wywietlajca sformatowany tekst w podanym prostokcie: 

BOOL DrawText(HDC hdc, LPCTSTR lpString, int cbString, LPRECT 

lpRect, UINT iFormat) 

Jeeli cbString =-1 i lpString jest cigiem zakoczonym 0 to Windows sam obliczy długo 

znaku. 

iFormat – okrela sposób formatowania tekstu: 

0 – system interpretuje tekst jako zbiór wierszy oddzielonych znakiem powrotu karetki (‘\r’ 

lub 0x0D) lub znakiem nastpnej linii (‘\n’ lub 0x0A). 

DT_LEFT – domylny. Wyrównanie lewostronne tekstu 

DT_RIGHT – wyrównanie prawostronne 

DT_CENTER – wyrodkowuje tekst pomidzy lewym i prawym bokiem prostokta 

DT_SINGLELINE – nie interpretuje znaków powrotu karetki oraz przejcia do nastpnej linii 

jako znaki koca wiersza 

DT_TOP – domylny; wyrównuje tekst do górnej czci prostokta. 

DT_BOTTOM – wyrównanie do dolnej czci prostokta 

DT_VCENTER – wyrównanie tekstu pomidzy dolnym i górnym bokiem prostokta 

DT_WORDBREAK – wymusza łamanie wiersza po dojciu do krawdzi prostokta. 

DT_NOCLIP – kreli tekst bez obcinania fragmentów nie mieszczcych si w prostokcie 

DT_EXTERNALLEADING – odstpy midzy wierszami wysokoci znaku bez pominicia 

dodatkowego odstpu zalecanego przez projektanta czcionki. 

DT_EXPANDTABS - interpretuje znaki tabulacji. Domylnie znaki tabulacji wystpuj w 

odstpach równych omiokrotnej redniej szerokoci znaku. 



Napisy s wywietlane dla danego kontekstu urzdzenia. Kilka atrybutów DC dotyczy 

napisów. 

Kolor liter domylnie jest czarny zmieniamy go za pomoc funkcji: 

COLORREF SetTextColor(HDC hdc, COLORREF rgbColor) – funkcja zwraca 

poprzedni kolor tekstu. 

COLORREF GetTextColor(HDC hdc) – funkcja zwraca biecy kolor napisów. 

Odstp midzy znakami jest wypełniony kolorem uzalenionym od trybu tła oraz koloru tła. 

Mona korzysta z kolorów systemowych pobieranych przy pomocy funkcji: 

GetSysColor(int nIndex) 

m.in nIndex moe by równe: 

COLOR_GRAYTEXT – szary (nieaktywny) kolor 

COLOR_HIGHLIGHT – kolor uywany do zaznaczania wybranego elementu w kontrolce 

COLOR_HIGHLIGHTTEXT – kolor tekstu uywany do zaznaczania wybranego elementu w 

kontrolce 

COLOR_WINDOW – tło okna 

COLOR_WINDOWTEXT – kolor tekstu w oknie 



Czcionki. 

Mona pobra predefiniowane czcionki systemowe: 

HFONT hFont = GetStockObject(iFont); 

iFont równa si SYSTEM_FONT (domylna czcionka – o proporcjonalnej szerokoci liter) 

lub SYSTEM_FIXED_FONT(o takiej samej szerokoci znaków) 

SelectObject(hFont); 

Czcionki GDI znajdujce si w plikach na dysku twardym dziel si na trzy kategorie: 

Rastrowe – kady znak jest zakodowany w postaci wzorca pikseli; „nieskalowalnymi” bez 

pogorszenia jakoci; wydajno; dobra czytelno. 

Wektorowe – znak w postaci zbioru połczonych odcinków. – niska wydajno wywietlania, 

czytelno słaba przy małych wymiarach; przy duych brzydkie; Skalowalne. 

TrueType – zdefiniowane przez kontur składajcy si z odcinków i łuków. Kontur jest 

wykorzystywany do stworzenia mapy bitowej znaku. 

Windows 95 był wyposaony w 13 czcionek TrueType w kolejnych wersjach Windows lista 

czcionek uległa powikszeniu. 

(Courier New , Courier New Bold, Courier New Italic, Courier 

New Bold Italic, Times New Roman, Times New Roman Bold, Times New Roman 

Italic, Times New Roman Bold Italic, Arial, Arial Bold, Arial Italic, Arial Bold Italic, 

Symbol). 

HFONT CrateFontIndirecta(LPLOGFONT lplf) 

typedef struct tagLOGFONT { 

LONG lfHight // podana wysoko czcionki w jednostkach logicznych. Jeeli =0 

system uywa domylnej wielkoci 

LONG lfWidth // szeroko 

LONG lfEscapement 

LONG lfOrientation 

LONG lfWeight // grubo czcionki (np. FW_DONTCARE=0, FW_NORMAL=400, 

FW_BOLD=700,..) 

BYTE lfItalic // kursywa jeeli !=0 

BYTE lfUnderline 

BYTE lfStrikeOut 

BYTE lfCharSet 

BYTE lfOutPrecision 

BYTE lfClipPrecision 

BYTE lfQuality 

BYTE lfPitchAndFamily 

TCHAR lfFaceName 

} LOGFONT, *PLOGFONT 

Aby wybra czcionk TrueType wikszo wartoci powinna by równa 0. 

BOOL GetTextExtentPoint32(HDC hdc, LPCTSTR lpString, int 

iCount, LPSIZE lpSize) – funkcja podaje szeroko i wysoko łacucha znaków na 

podstawie biecej czcionki w DC. 

Struktura SIZE składa si z dwóch pól typu LONG cx, cy.

WinApi-grafika 2D

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?