IPropertyPage::IsPageDirty method (ocidl.h)

Menunjukkan apakah halaman properti telah berubah sejak diaktifkan atau sejak panggilan terbaru ke Terapkan.

Sintaks

HRESULT IsPageDirty();

Mengembalikan nilai

Metode ini mengembalikan S_OK untuk menunjukkan bahwa halaman properti telah berubah. Jika tidak, ia menampilkan S_FALSE.

Keterangan

Lembar properti menggunakan informasi ini untuk mengaktifkan atau menonaktifkan tombol Terapkan dalam kotak dialog. Tidak perlu menerapkan nilai pada halaman properti jika nilai tersebut sudah ada saat ini dengan objek yang mendasar.

Catatan untuk Pelaksana

Metode ini tidak memiliki alasan untuk mengembalikan kode kesalahan, karena ketidakmampuan untuk menentukan apakah halaman kotor harus mengembalikan S_OK sebagai default. Dengan cara ini, pengguna memiliki kesempatan untuk memperbarui nilai. Halaman tidak boleh mengembalikan kode kesalahan, karena kode kesalahan tidak sama dengan S_OK dan akan menunjukkan bahwa halaman tidak kotor. Kemudian, bingkai properti berpotensi menonaktifkan tombol Terapkan , tidak memungkinkan pengguna untuk memastikan bahwa nilai properti saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IPropertyPage