Método IDesktopWallpaper::Enable (shobjidl_core.h)

  • Artigo

Habilita ou desabilita a tela de fundo da área de trabalho.

Sintaxe

HRESULT Enable(
  [in] BOOL enable
);

Parâmetros

[in] enable

TRUE para habilitar a tela de fundo da área de trabalho, FALSE para desabilitá-la.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT , incluindo o seguinte.

Código de retorno Descrição
S_FALSE
 O papel de parede da área de trabalho já está no estado que você está solicitando por meio dessa chamada.
E_FILE_NOT_FOUND
 O papel de parede da área de trabalho que seria usado quando a tela de fundo está habilitada está ausente do local esperado. Chame SetWallpaper para especificar um novo papel de parede.

Comentários

Esse método normalmente seria chamado para desabilitar a tela de fundo da área de trabalho por motivos de desempenho.

Quando a tela de fundo da área de trabalho é desabilitada, uma cor sólida é mostrada em seu lugar. Para obter ou definir a cor específica, use os métodos GetBackgroundColor e SetBackgroundColor .

Nota Uma chamada para os métodos IDesktopWallpaper_SetWallpaper ou IDesktopWallpaper_SetSlideshow habilitará a tela de fundo da área de trabalho mesmo que ela esteja desabilitada no momento por meio desse método.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

IDesktopWallpaper