ExtractIconEx

Die ExtractIconEx -Funktion erstellt ein Array von Handles für große oder kleine Symbole aus der angegebenen ausführbaren Datei, Dynamic-Link Bibliothek (DLL) oder Icon-Datei extrahiert.

(UINT ExtractIconEx LPCTSTR  LpszFile, Int  nIconIndex, HICON weit  * PhiconLarge, HICON weit  * PhiconSmall nIcons, UINT );
 

Parameter

lpszFile
Zeiger auf eine auf Null endende Zeichenfolge angeben den Namen des eine ausführbare Datei, DLL oder Icon-Datei aus die Symbole extrahiert werden.
nIconIndex
Gibt den nullbasierten Index des ersten Symbols zu extrahieren. Wenn dieser Wert 0 (null) ist, extrahiert die Funktion z. B. das erste Symbol in der angegebenen Datei.

Wenn dieser Wert 1 ist und PhIconLarge und PhiconSmall beide NULL sind, gibt die Funktion die Anzahl der Symbole in der angegebenen Datei. Wenn die Datei eine ausführbare Datei oder DLL ist, ist der Rückgabewert die Anzahl der RT_GROUP_ICON Ressourcen. Wenn die Datei ein.ICO-Datei, den zurückgegebenen Wert ist 1.

Windows 95, Windows NT 4.0 und höher: Wenn dieser Wert eine negative Zahl ist und entweder PhIconLarge oder PhiconSmall nicht NULL ist, beginnt die Funktion durch das Symbol dessen Ressourcenbezeichner gleich dem absoluten Wert der nIconIndex istextrahieren. Verwenden Sie-3 beispielsweise, um das Symbol zu extrahieren, dessen Ressourcenbezeichner 3 ist.

phiconLarge
Zeiger auf ein Array von Symbol-Griffe die Griffe mit den großen Icons extrahiert aus der Datei erhält. Wenn dieser Parameter NULL ist, werden keine große Symbole aus der Datei extrahiert.
phiconSmall
Zeiger auf ein Array von Symbol-Griffe die Griffe auf die kleinen Symbole aus der Datei extrahiert wird. Wenn dieser Parameter NULL ist, werden keine kleine Symbole aus der Datei extrahiert.
nIcons
Gibt die Anzahl der Symbole, um aus der Datei extrahieren.

Rückgabewerte

Wenn der nIconIndex Parameter 1 ist, der PhiconLarge -Parameter NULL ist, und der PhiconSmall -Parameter NULL ist, ist der Rückgabewert die Anzahl der Symbole in der angegebenen Datei enthalten. Andernfalls ist der Rückgabewert die Anzahl der Symbole aus der Datei erfolgreich extrahiert.

Bemerkungen

Sie müssen alle Icons extrahiert von ExtractIconEx durch Aufrufen der Funktion DestroyIcon zerstören.

Um die Dimensionen der großen und kleinen Icons abzurufen, verwenden Sie die GetSystemMetrics -Funktion mit den SM_CXICON, SM_CYICON, SM_CXSMICON und SM_CYSMICON Flags.

Windows CE: Der nIconIndex -Parameter muss NULL oder – n wobei n eine angegebene Ressource-ID ist. Der nIcons -Parameter muss 1 sein.

QuickInfo

&Nbsp; Windows NT: erfordert Version 3.5 oder höher.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In shellapi.h deklariert.
Importieren Bibliothek:Verwenden Sie shell32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über die Symbole, Symbol Funktionen, DestroyIcon, ExtractIcon

Index