Freigeben über


IImageList2::Replace2-Methode (commoncontrols.h)

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)