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 |