Export (0) Print
Expand All

IPropertyPage::IsPageDirty method

Indicates whether the property page has changed since it was activated or since the most recent call to Apply.

Syntax


HRESULT IsPageDirty();

Parameters

This method has no parameters.

Return value

This method returns S_OK to indicate that the property page has changed. Otherwise, it returns S_FALSE.

Remarks

The property sheet uses this information to enable or disable the Apply button in the dialog box. There is no need to apply the values on a property page if those values are already current with the underlying objects.

Notes to Implementers

This method has no reason to return an error code, since the inability to determine if the page is dirty should return S_OK as a default. In this way, the user has a chance to update the values. The page should not return an error code, since an error code is not the same as S_OK and would indicate that the page is not dirty. Then, the property frame could potentially disable the Apply button, not allowing the user to make sure that the property values are current.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IPropertyPage is defined as B196B28D-BAB4-101A-B69C-00AA00341D07

See also

IPropertyPage

 

 

Community Additions

ADD
Show:
© 2014 Microsoft