LoadImageA-Funktion (winuser.h)

Lädt ein Symbol, einen Cursor, einen animierten Cursor oder eine Bitmap.

Syntax

HANDLE LoadImageA(
  [in, optional] HINSTANCE hInst,
  [in]           LPCSTR    name,
  [in]           UINT      type,
  [in]           int       cx,
  [in]           int       cy,
  [in]           UINT      fuLoad
);

Parameter

[in, optional] hInst

Typ: HINSTANCE-

Ein Handle für das Modul einer DLL oder ausführbaren Datei (.exe), die das zu ladende Bild enthält. Weitere Informationen finden Sie unter GetModuleHandle-. Beachten Sie, dass ab 32-Bit-Windows ein Instanzhandle (HINSTANCE), z. B. das Anwendungsinstanzhandle, das vom Systemfunktionsaufruf von WinMainverfügbar gemacht wird, und ein Modulhandle (HMODULE) identisch sind.

Um ein vordefiniertes Bild oder eine eigenständige Ressource (Symbol-, Cursor- oder Bitmapdatei) zu laden, legen Sie diesen Parameter auf NULL-fest.

[in] name

Typ: LPCTSTR-

Das zu ladende Bild.

Wenn der hInst Parameter nichtNULL- ist und der fuLoad Parameter LR_LOADFROMFILEweggelassen, gibt Name die Bildressource im hInst Modul an.

Wenn die Bildressource anhand des Namens aus dem Modul geladen werden soll, ist der Name Parameter ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen der Bildressource enthält.

Wenn die Bildressource vom Modul geladen werden soll, verwenden Sie das MAKEINTRESOURCE-Makro, um das Bild-Ordinal in ein Formular zu konvertieren, das an die LoadImage--Funktion übergeben werden kann.

Wenn der hInst Parameter NULL- ist und der fuLoad Parameter den LR_LOADFROMFILE Wert ausgelassen und den LR_SHAREDenthält, gibt der Name das vordefinierte bild an, das geladen werden soll.

Die vordefinierten Bildbezeichner werden in Winuser.h definiert und weisen die folgenden Präfixe auf:

Um OEM-Bildbezeichner konstanten an die LoadImage--Funktion zu übergeben, verwenden Sie das MAKEINTRESOURCE Makro. Um beispielsweise den OCR_NORMAL Cursor zu laden, übergeben Sie MAKEINTRESOURCE(OCR_NORMAL) als Namen Parameter, NULL als hInst Parameter, und LR_SHARED als eines der Flags an den fuLoad Parameter.

Wenn der hInst-Parameter NULL- ist und der fuLoad- Parameter den LR_LOADFROMFILE Wert enthält, ist Name der Name der Datei, die die eigenständige Ressource (Symbol-, Cursor- oder Bitmapdatei) enthält , z. B. c:\myicon.ico.

Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.

[in] type

Typ: UINT-

Der Typ des zu ladenden Bilds.

Dieser Parameter kann einer der folgenden Werte sein:

[in] cx

Typ: int

Die Breite des Symbols oder Cursors in Pixel. Wenn dieser Parameter null ist und der fuLoad Parameter LR_DEFAULTSIZEist, verwendet die Funktion den SM_CXICON- oder SM_CXCURSOR Systemmetrikwert, um die Breite festzulegen. Wenn dieser Parameter null ist und LR_DEFAULTSIZE nicht verwendet wird, verwendet die Funktion die tatsächliche Ressourcenbreite.

[in] cy

Typ: int

Die Höhe des Symbols oder Cursors in Pixel. Wenn dieser Parameter null ist und der fuLoad Parameter LR_DEFAULTSIZEist, verwendet die Funktion den SM_CYICON- oder SM_CYCURSOR Systemmetrikwert, um die Höhe festzulegen. Wenn dieser Parameter null ist und LR_DEFAULTSIZE nicht verwendet wird, verwendet die Funktion die tatsächliche Ressourcenhöhe.

[in] fuLoad

Typ: UINT-

Dieser Parameter kann einen oder mehrere der folgenden Werte sein.

Rückgabewert

Typ: HANDLE

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle des neu geladenen Images.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Wenn IS_INTRESOURCE(Name) TRUEist, gibt Name den ganzzahligen Bezeichner der angegebenen Ressource an. Andernfalls handelt es sich um einen Zeiger auf eine mit Null beendete Zeichenfolge. Wenn das erste Zeichen der Zeichenfolge ein Nummernzeichen (#) ist, stellen die verbleibenden Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner der Ressource angibt. Beispielsweise stellt die Zeichenfolge "#258" den Bezeichner 258 dar.

Wenn Sie mit der Verwendung einer Bitmap, eines Cursors oder eines Symbols fertig sind, das Sie geladen haben, ohne das kennzeichen LR_SHARED anzugeben, können Sie den zugeordneten Speicher freigeben, indem Sie eine der Funktionen in der folgenden Tabelle aufrufen.

Das System löscht diese Ressourcen automatisch, wenn der Prozess, der sie erstellt hat, beendet wird; Das Aufrufen der entsprechenden Funktion spart jedoch Speicher und verringert die Größe des Arbeitssatzes des Prozesses.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Fensterklassen.

Anforderungen

Siehe auch

Konzeptionelle

CopyImage-

GetSystemMetrics-

LoadBitmap-

LoadCursor-

LoadIcon-

andere Ressourcen

Referenz-

Ressourcen