IDesktopWallpaper::Aktifkan metode (shobjidl_core.h)

Mengaktifkan atau menonaktifkan latar belakang desktop.

Sintaks

HRESULT Enable(
  [in] BOOL enable
);

Parameter

[in] enable

TRUE untuk mengaktifkan latar belakang desktop, FALSE untuk menonaktifkannya.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan ditampilkan, termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_FALSE	Wallpaper desktop sudah dalam status yang Anda minta melalui panggilan ini.
E_FILE_NOT_FOUND	Wallpaper desktop yang akan digunakan ketika latar belakang diaktifkan hilang dari lokasi yang diharapkan. Panggil SetWallpaper untuk menentukan wallpaper baru.

Keterangan

Metode ini biasanya akan dipanggil untuk menonaktifkan latar belakang desktop karena alasan performa.

Ketika latar belakang desktop dinonaktifkan, warna solid ditampilkan di tempatnya. Untuk mendapatkan atau mengatur warna tertentu, gunakan metode GetBackgroundColor dan SetBackgroundColor .

Catatan Panggilan ke metode IDesktopWallpaper_SetWallpaper atau IDesktopWallpaper_SetSlideshow akan mengaktifkan latar belakang desktop meskipun saat ini dinonaktifkan melalui metode ini.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

IDesktopWallpaper