IImageList2::Replace2-Methode (commoncontrols.h)

Artikel
03/01/2024

Ersetzt ein Bild in einer Bildliste.

Syntax

HRESULT Replace2(
  [in]           int      i,
  [in]           HBITMAP  hbmImage,
  [in, optional] HBITMAP  hbmMask,
  [in, optional] IUnknown *punk,
  [in]           DWORD    dwFlags
);

Parameter

[in] i

Typ: int

Der Index des zu ersetzenden Bilds.

[in] hbmImage

Typ: HBITMAP

Ein Handle für die Bitmap, die das Bild enthält.

[in, optional] hbmMask

Typ: HBITMAP

Ein Handle für die Bitmap, die die Maske enthält. Wenn keine Maske mit der Bildliste verwendet wird, wird dieser Parameter ignoriert.

[in, optional] punk

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle .

[in] dwFlags

Typ: DWORD

Gibt an, wie die Maske als eine oder eine bitweise Kombination der folgenden Dekorationsflags auf das Bild angewendet wird.

Wert	Bedeutung
ILR_DEFAULT 0x0000	Wird nicht verwendet.
ILR_HORIZONTAL_LEFT 0x0000	Horizontal nach links ausrichten.
ILR_HORIZONTAL_CENTER 0x0001	Horizontal zentrativ.
ILR_HORIZONTAL_RIGHT 0x0002	Horizontal nach rechts ausrichten.
ILR_VERTICAL_TOP 0x0000	Vertikal nach oben ausrichten.
ILR_VERTICAL_CENTER 0x0010	Vertikal an der Mitte ausrichten.
ILR_VERTICAL_BOTTOM 0x0020	Vertikal nach unten ausrichten.
ILR_SCALE_CLIP 0x0000	Sie unternehmen nichts.
ILR_SCALE_ASPECTRATIO 0x0100	Skalierung.

Rückgabewert

Typ: HRESULT

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

Anforderungen

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

Share via