IPropertyPage::IsPageDirty メソッド (ocidl.h)
プロパティ ページがアクティブ化されてから変更されたか、 最新の Apply 呼び出し以降に変更されたかを示します。
構文
HRESULT IsPageDirty();
戻り値
このメソッドは、プロパティ ページが変更されたことを示すS_OKを返します。 それ以外の場合は S_FALSE を返します。
注釈
プロパティ シートでは、この情報を使用して、ダイアログ ボックスの [ 適用 ] ボタンを有効または無効にします。 これらの値が基になるオブジェクトで既に最新の値である場合は、プロパティ ページで値を適用する必要はありません。
実装者へのメモ
このメソッドは、ページがダーティかどうかを判断できないため、エラー コードを返す理由はありませんS_OKを既定として返す必要があります。 このようにして、ユーザーは値を更新する機会があります。 エラー コードはS_OKと同じではなく、ページがダーティされていないことを示すので、ページはエラー コードを返すべきではありません。 その後、プロパティ フレームで [適用 ] ボタンが無効になる可能性があり、ユーザーはプロパティ値が最新であることを確認できません。要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ocidl.h |