DrawIconEx

Funkcja DrawIconEx zwraca ikony lub kursora w obszarze klienta okna kontekstu podanego urządzenia, operacji określonej rastrowych i rozciągnięcie lub kompresowanie ikonę lub kursora określone.

 (BOOL DrawIconEx HDC  hdc, / / dojście do kontekstu urządzeniaintxLeft, / / x-coordinate of lewy górny rógintyTop, / / współrzędna y lewy górny rógHICONhIcon, / / dojście do ikony do rysowania intcxWidth, / / szerokość ikony intcyWidth, / / wysokość ikonyUINTistepIfAniCur, / / indeksu ramki w animowanych kursorówHBRUSHhbrFlickerFreeDraw, / / dojście do tła pędzla UINTdiFlags / / rysunku ikonę flagi);

Parametry

hdc
Dojście do kontekstu urządzenia do okna.
xLeft
Określa logiczne współrzędną x lewym górnym rogu ikony lub kursora.
yTop
Określa logiczne współrzędna y lewym górnym rogu ikony lub kursora.
hIcon
Dojście do ikony lub kursora wyciągnąć. Tego parametru można zidentyfikować animowanych kursorów. Ikona lub kursora zasobu musi uprzednio załadowano przy użyciu funkcji LoadImage.
cxWidth
Określa szerokość logiczna ikonę lub kursora. Jeśli ten parametr jest zero, a parametr diFlags jest DI_DEFAULTSIZE, funkcja używa wartości metryki systemu SM_CXICON lub SM_CXCURSOR szerokość. Jeśli ten parametr jest zero, a DI_DEFAULTSIZE nie jest używany, funkcja używa szerokość zasobów rzeczywistych.
cyWidth
Określa wysokość logiczna ikonę lub kursora. Jeśli ten parametr jest zero, a parametr diFlags jest DI_DEFAULTSIZE, funkcja używa wartości metryki systemu SM_CYICON lub SM_CYCURSOR szerokość. Jeśli ten parametr jest zero, a DI_DEFAULTSIZE nie jest używany, funkcja używa wysokość rzeczywistych zasobów.
istepIfAniCur
Określa indeks ramki, aby narysować, jeśli hIcon identyfikuje animowanych kursorów. Ten parametr jest ignorowany, jeśli hIcon nie identyfikuje animowanych kursorów.
hbrFlickerFreeDraw
Dojście do pędzle, używanym przez system dla pozbawiony migotania rysunku. HbrFlickerFreeDraw to dojście ważne pędzla, system tworzy niewidocznej bitmapy, używając określonego pędzla kolor tła, rysuje ikonę lub kursora do mapy bitowej, a następnie skopiowanie bitmapy w kontekście Urządzenie identyfikowane przez hdc. Jeśli hbrFlickerFreeDraw ma wartość NULL, system rysuje ikonę lub kursor bezpośrednio do kontekstu urządzenia.
diFlags
Określa flagi rysunku. Ten parametr może mieć jedną z następujących wartości:
Wartość Znaczenie
DI_COMPAT Rysuje ikonę lub kursora za pomocą domyślnego obrazu systemu, zamiast obrazu określany przez użytkownika.
DI_DEFAULTSIZE Rysuje ikonę lub kursora za pomocą szerokości i wysokości określonej przez system metryczny wartości kursorów i ikon, jeśli parametry cxWidth i cyWidth są ustawione na zero. Jeśli ta flaga nie jest określony, a cxWidth i cyWidth są ustawiane na wartość zero, funkcja używa wielkość zasobów rzeczywistych.
DI_IMAGE Rysuje ikonę lub kursora za pomocą obrazu.
DI_MASK Rysuje ikonę lub kursora za pomocą maski.
DI_NORMAL Kombinacja DI_IMAGE i DI_MASK.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja DrawIconEx umieszcza ikony lewy górny róg w lokalizacji określonej przez parametry xLeft i yTop . Lokalizacja podlega bieżący tryb mapowania kontekstu urządzenia.

Systemu Windows CE: Należy użyć następujących ustawień parametru

Nie obsługuje systemu Windows CE:

Parametr hIcon nie może zidentyfikować animowanych kursorów.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.5 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie ikon, ikona funkcji, CopyImage, DrawIcon, LoadImage

Index