IPropertyPage::IsPageDirty メソッド (ocidl.h)

  • [アーティクル]

プロパティ ページがアクティブ化されてから変更されたか、 最新の Apply 呼び出し以降に変更されたかを示します。

構文

HRESULT IsPageDirty();

戻り値

このメソッドは、プロパティ ページが変更されたことを示すS_OKを返します。 それ以外の場合は S_FALSE を返します。

注釈

プロパティ シートでは、この情報を使用して、ダイアログ ボックスの [ 適用 ] ボタンを有効または無効にします。 これらの値が基になるオブジェクトで既に最新の値である場合は、プロパティ ページで値を適用する必要はありません。

実装者へのメモ

このメソッドは、ページがダーティかどうかを判断できないため、エラー コードを返す理由はありませんS_OKを既定として返す必要があります。 このようにして、ユーザーは値を更新する機会があります。 エラー コードはS_OKと同じではなく、ページがダーティされていないことを示すので、ページはエラー コードを返すべきではありません。 その後、プロパティ フレームで [適用 ] ボタンが無効になる可能性があり、ユーザーはプロパティ値が最新であることを確認できません。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

IPropertyPage