LoadIcon

Die Funktion LoadIcon lädt die angegebene Icon Ressource aus der ausführbaren Datei (.(EXE) Datei einer Anwendungsinstanz zugeordnet. Diese Funktion wurde von der LoadImage -Funktion ersetzt

(HICON LoadIcon HINSTANCE  hInstance, / / handle für die AnwendungsinstanzLPCTSTRLpIconName / / Symbol-Name String oder Symbol Ressource / / Bezeichner);
 

Parameter

hInstance
Behandeln Sie, um eine Instanz des Moduls deren ausführbare Datei enthält das Symbol geladen werden. Dieser Parameter muss NULL sein, wenn ein Standardsymbol geladen wird.
lpIconName
Zeiger auf eine auf Null endende Zeichenfolge, die mit dem Namen der Symbolressource geladen werden soll. Alternativ kann dieser Parameter der Ressourcenbezeichner im niederwertigen Wort und NULL im höherwertigen Wort enthalten. Verwenden des Makros MAKEINTRESOURCE um diesen Wert zu erstellen.

Um eines der vordefinierten Symbole zu verwenden, festlegen Sie den hInstance -Parameter auf NULL und der LpIconName Parameter einen der folgenden Werte:
Wert Beschreibung
IDI_APPLICATION Standard-Anwendungssymbol.
IDI_ASTERISK Gleiche wie IDI_INFORMATION.
IDI_ERROR Hand-förmig Symbol.
IDI_EXCLAMATION Gleiche wie IDI_WARNING.
IDI_HAND Gleiche wie IDI_ERROR.
IDI_INFORMATION Sternchensymbol.
IDI_QUESTION Fragezeichen-Symbol.
IDI_WARNING Ausrufezeichen.
IDI_WINLOGO Windows-Logo-Symbol.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den neu geladenen Symbol.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

LoadIcon lädt die Symbolressource nur, wenn es nicht geladen wurde. Andernfalls ruft es ein Handle auf die vorhandene Ressource. Die Funktion durchsucht die Symbolressource für das Symbol für die aktuelle Anzeige am besten geeignet. Die Symbolressource kann eine Farbe oder Monochrom-Bitmap sein.

LoadIcon kann nur ein Symbol Laden, dessen Größe auf die SM_CXICON und SM_CYICON System metrische Werte entspricht. Verwenden Sie die LoadImage -Funktion, um Symbole von anderen Größen laden.

Windows CE: Vordefinierte Symbole (IDI_ **) werden nicht unterstützt.

In Windows CE 1.0 muss das Symbol einer zwei Bit pro Pixel (.ic2) Symbol oder ein Monochrom-Symbol.

Siehe auch

Übersicht über die Symbole, Symbol Funktionen, CreateIcon, LoadImage, MAKEINTRESOURCE

Index