IImageList::SetImageCount-Methode (commoncontrols.h)

Artikel
02/24/2024

Ändert die Größe einer vorhandenen Bildliste.

Syntax

HRESULT SetImageCount(
  [in] UINT uNewCount
);

Parameter

[in] uNewCount

Typ: UINT

Ein Wert, der die neue Größe der Bildliste angibt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn eine Anwendung eine Bildliste mit dieser Methode erweitert, muss sie mithilfe von IImageList::Replace neue Images hinzufügen. Wenn die Anwendung den neuen Indizes keine gültigen Images hinzugibt, sind Zeichnungsvorgänge, die die neuen Indizes verwenden, unvorhersehbar.

Wenn Sie die Größe einer Bildliste mit dieser Methode verringern, werden Bilder am Ende der Liste, für die kein Raum mehr vorhanden ist, aus der Liste abgeschnitten. Auf diese Weise abgeschnittene Bilder werden automatisch zugeordnet.

Um IImageList::SetImageCount 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)

Freigeben über