Partilhar via


CDialogEx::SetBackgroundImage

Configura a imagem de plano de fundo da caixa de diálogo.

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 
);

Parâmetros

  • [in] hBitmap
    Um identificador para a imagem de plano de fundo.

  • [in] uiBmpResId
    A ID de recurso de imagem de plano de fundo.

  • [in] location
    Um do CDialogEx::BackgroundLocation valores que especificam o local da imagem. Os valores válido incluem BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT e BACKGR_BOTTOMRIGHT.O valor padrão é BACKGR_TILE.

  • [in] bAutoDestroy
    TRUE Destruir automaticamente a imagem de plano de fundo; caso contrário, FALSE.

  • [in] bRepaint
    TRUE para redesenhar imediatamente a caixa de diálogo; caso contrário, FALSE.

Valor de retorno

No segundo método de sobrecarga sintaxe, TRUE Se o método for bem-sucedida; caso contrário, FALSE.

Comentários

A imagem que você especificar não está estendida para se ajuste à área de cliente da caixa de diálogo.

Requisitos

Cabeçalho: afxdialogex.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CDialogEx