CDialogEx::SetBackgroundImage

  • Artikel

Legt das Hintergrundbild des Dialogfelds festlegen.

void SetBackgroundImage(
   HBITMAP hBitmap,
   BackgroundLocation location=BACKGR_TILE,
   BOOL bAutoDestroy=TRUE,
   BOOL bRepaint=TRUE 
);
BOOL SetBackgroundImage(
   UINT uiBmpResId,
   BackgroundLocation location=BACKGR_TILE,
   BOOL bRepaint=TRUE 
);

Parameter

  • [in] hBitmap
    Ein Handle für das Hintergrundbild.

  • [in] uiBmpResId
    Das Ressourcen-ID des Hintergrundbilds.

  • [in] location
    Einer der CDialogEx::BackgroundLocation-Werte, die den Speicherort des Bilds angeben.Gültige Werte enthalten BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT und BACKGR_BOTTOMRIGHT.Der Standardwert ist BACKGR_TILE.

  • [in] bAutoDestroy
    TRUE, um des Hintergrundbilds automatisch zu zerstören; andernfalls FALSE.

  • [in] bRepaint
    TRUE, um das Dialogfeld sofort neu entwerfen; andernfalls FALSE.

Rückgabewert

In der zweiten Methodenüberladungssyntax TRUE, wenn die Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Das Bild, das Sie angeben, wird nicht gestreckt, um den Dialogfeldclientbereich angepasst.

Anforderungen

Header: afxdialogex.h

Siehe auch

Referenz

CDialogEx-Klasse

Hierarchien-Diagramm