Share via

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

  • Artículo

Habilita o deshabilita el fondo del escritorio.

Sintaxis

HRESULT Enable(
  [in] BOOL enable
);

Parámetros

[in] enable

TRUE para habilitar el fondo del escritorio, FALSE para deshabilitarlo.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT , incluido lo siguiente.

Código devuelto Descripción
S_FALSE
 El fondo de pantalla de escritorio ya está en el estado que está pidiendo a través de esta llamada.
E_FILE_NOT_FOUND
 El fondo de pantalla de escritorio que se usaría cuando falta el fondo en segundo plano en su ubicación esperada. Llame a SetWallpaper para especificar un nuevo fondo de pantalla.

Comentarios

Normalmente, se llamaría a este método para deshabilitar el fondo del escritorio por motivos de rendimiento.

Cuando el fondo del escritorio está deshabilitado, se muestra un color sólido en su lugar. Para obtener o establecer el color específico, use los métodos GetBackgroundColor y SetBackgroundColor .

Nota Una llamada a los métodos IDesktopWallpaper_SetWallpaper o IDesktopWallpaper_SetSlideshow habilitará el fondo del escritorio aunque esté deshabilitado actualmente a través de este método.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)

Consulte también

IDesktopWallpaper