Compartilhar via


CDialogEx::SetBackgroundImage

Define 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 identificação de recurso de imagem de plano de fundo.

  • [in] location
    Um dos valores de CDialogEx::BackgroundLocation que especificar o local da imagem.Os valores válidos incluem BACKGR_TILE, BACKGR_TOPLEFT, BACKGR_TOPRIGHT, BACKGR_BOTTOMLEFT, e BACKGR_BOTTOMRIGHT.o valor padrão é BACKGR_TILE.

  • [in] bAutoDestroy
    ParaTRUE 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

Em o segundo método falha na sintaxe, TRUE se o método for bem-sucedida; caso contrário, FALSE.

Comentários

A imagem que você especifica não é estendida para caber na área cliente da caixa de diálogo.

Requisitos

Cabeçalho: afxdialogex.h

Consulte também

Referência

Classe de CDialogEx

Gráfico de hierarquia