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