IImageList::ReplaceIcon-Methode (commoncontrols.h)

Ersetzt ein Bild durch ein Symbol oder einen Cursor.

Syntax

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Parameter

[in] i

Typ: int

Ein Wert vom Typ int , der den Index des zu ersetzenden Bilds enthält. Wenn i -1 ist, fügt die Funktion das Bild am Ende der Liste hinzu.

[in] hicon

Typ: HICON

Ein Handle für das Symbol oder den Cursor, das die Bitmap und die Maske für das neue Bild enthält.

[out] pi

Typ: int*

Ein Zeiger auf einen int , der bei der Rückgabe den Index des Bilds enthält, wenn er erfolgreich ist, oder andernfalls -1.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Da das System hicon nicht speichert, können Sie es zerstören, nachdem die Funktion zurückgegeben wird, wenn das Symbol oder der Cursor von CreateIcon erstellt wurde. Sie müssen hicon nicht zerstören, wenn es von der LoadIcon-Funktion geladen wurde. das System gibt eine Symbolressource automatisch frei, wenn sie nicht mehr benötigt wird.

Um IImageList::ReplaceIcon zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)