LoadImage

Funkcja LoadImage wczytuje ikonę, kursor lub bitmapy.

( LoadImage uchwyt Wystąpienie HINSTANCE  hinst, / / uchwyt wystąpienia zawierającej obrazLPCTSTRlpszName, / / nazwa lub identyfikator obrazuUINTuType, / / typ obrazuintcxDesired, / / pożądane szerokość intcyDesired, / / pożądane wysokośćUINTfuLoad / / Wczytaj flagi);
 

Parametry

hinst

Dojście do instancji modułu, który zawiera obraz ma być załadowany. Aby załadować obrazu OEM, ustawić dla tego parametru na zero.

lpszName

Dojście do obrazu do ładowania.

Jeśli parametr hinst jest NIEZEROWA, a parametr fuLoad nie zawiera LR_LOADFROMFILE, lpszName jest wskaźnik ciąg zakończony znakiem null, który zawiera nazwę zasobu obrazu w hinst module.

Jeśli hinst ma wartość NULL i LR_LOADFROMFILE nie jest określony, wyraz bity tego parametru musi być identyfikatorem obrazu OEM do załadowania. Identyfikatory obrazu OEM są zdefiniowane w WINUSER.H i mieć następujące dodanie prefiksu składającego:

Prefiks	Znaczenie
OBM_	Bitmapy OEM
OIC_	Ikony OEM
OCR_	Kursory OEM

Jeżeli parametr fuLoad zawiera wartość LR_LOADFROMFILE, lpszName jest nazwą pliku, który zawiera obraz.

uType

Określa typ obrazu do załadowania. Ten parametr może mieć jedną z następujących wartości:

Wartość	Znaczenie
IMAGE_BITMAP	Ładuje bitmapę.
IMAGE_CURSOR	Ładuje kursor.
IMAGE_ICON	Wczytuje ikonę.

cxDesired

Określa szerokość w pikselach, ikona lub kursora. Jeśli ten parametr jest zero, a parametr fuLoad jest LR_DEFAULTSIZE, funkcja używa wartości metryki systemu SM_CXICON lub SM_CXCURSOR szerokość. Jeśli ten parametr jest zero, a LR_DEFAULTSIZE nie jest używany, funkcja używa szerokość zasobów rzeczywistych.

cyDesired

Określa wysokość w pikselach, ikona lub kursora. Jeśli ten parametr jest zero, a parametr fuLoad jest LR_DEFAULTSIZE, funkcja używa wartości metryki systemu SM_CYICON lub SM_CYCURSOR do ustawiania wysokości. Jeśli ten parametr jest zero, a LR_DEFAULTSIZE nie jest używany, funkcja używa wysokość rzeczywistych zasobów.

fuLoad

Określa kombinację wartości następujących:

Wartość	Znaczenie
LR_DEFAULTCOLOR	Flaga domyślne; It does. Wszystko, co oznacza to "nie LR_MONOCHROME".
LR_CREATEDIBSECTION	Gdy parametr uType określa IMAGE_BITMAP, powoduje, że funkcja zwraca sekcji mapa bitowa DIB zamiast bitmapę zgodne. Ta flaga jest przydatne w przypadku ładowania bitmapy bez mapowania kolorów urządzenia wyświetlającego.
LR_DEFAULTSIZE	Używa szerokości lub wysokości określonej przez system metryczny wartości kursorów i ikon, jeśli wartości cxDesired lub cyDesired są ustawione na zero. Jeśli ta flaga nie jest określony, a cxDesired i cyDesired są ustawiane na wartość zero, funkcja używa wielkość zasobów rzeczywistych. Jeśli zasób zawiera wiele obrazów, funkcja używa rozmiar pierwszego obrazu.
LR_LOADFROMFILE	Ładuje obraz z pliku określonego przez parametr lpszName . Jeśli ta flaga nie jest określony, lpszName to nazwa zasobu.
LR_LOADMAP3DCOLORS	Przeszukuje tabelę kolorów obrazu i zastępuje następujące odcieni szarości odpowiadający mu kolor 3D:

	Kolor	Zamieniono
	DK Gray, RGB(128,128,128)	COLOR_3DSHADOW
	Gray, RGB(192,192,192)	COLOR_3DFACE
	Lt Gray, RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	Pobiera wartość koloru piksela na obrazie i zamienia odpowiedniego wpisu w tabeli kolor domyślny kolor okna (COLOR_WINDOW). Wszystkie piksele na obrazie, używające tego wpisu staje się domyślnym kolorem okna. Wartość ta ma zastosowanie tylko do obrazów, które mają odpowiednie tablice kolorów. Jeśli fuLoad zawiera wartości LR_LOADTRANSPARENT i LR_LOADMAP3DCOLORS, LRLOADTRANSPARENT ma pierwszeństwo. Jednakże wpis tabeli kolor jest zastępowany COLOR_3DFACE zamiast COLOR_WINDOW.
LR_MONOCHROME	Ładuje obraz czarno-biały.
LR_SHARED	Udziały uchwyt obrazu, jeśli ładowany jest obraz wiele razy. Jeśli LR_SHARED nie jest ustawiona, drugie wywołanie LoadImage dla tego samego zasobu zostanie ponownie załadować obrazu i zwraca uchwyt różnych. Nie należy używać LR_SHARED dla obrazów, które mają niestandardowych rozmiarów, które mogą ulec zmianie po załadunku, lub które są załadowane z pliku. Systemu Windows 95 i Windows 98: Funkcja znajdzie pierwszy obraz o nazwie żądanego zasobu w pamięci podręcznej, niezależnie od wielkości wymagane.
LR_VGACOLOR	Używa true VGA colors.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojściem załadowaniu obrazu.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Po zakończeniu za pomocą mapy bitowej, kursor lub ikonę, można zwolnić jego skojarzony pamięci, wywołując jedną z funkcji w poniższej tabeli.

System automatycznie usuwa te zasoby, gdy kończy proces, który je utworzył, jednak wywołanie odpowiedniej funkcji Oszczędza pamięć i zmniejsza rozmiar zestawu roboczego procesu.

Systemu Windows CE: Parametry cxDesired i cyDesired musi mieć wartość zero dla IMAGE_BITMAP.

Windows CE nie obsługuje rozciąganiem i kurczących się ikon.

Parametr fuLoad musi być równe zero (== LR_DEFAULTCOLOR).

Jeśli są wyróżniane platformę, która nie obsługuje kursory myszy, wartości SM_CXCURSOR i SM_CYCURSOR nie można określić parametrów cxDesired i cyDesired , i IMAGE_CURSOR nie można określić dla parametru uType.

Jeśli są wyróżniane platformę, która obsługuje kursory myszy, można określić SM_CXCURSOR i SM_CYCURSOR w cxDesired , parametry cyDesired i IMAGE_CURSOR w parametrze uType.

Skrócone informacje

nbsp; Windows &NT: wymaga w wersji 4.0 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:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Przegląd zasobów, działa zasób, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index