Método IPropertyPage::IsPageDirty (ocidl.h)

  • Artículo

Indica si la página de propiedades ha cambiado desde que se activó o desde la llamada más reciente a Apply.

Sintaxis

HRESULT IsPageDirty();

Valor devuelto

Este método devuelve S_OK para indicar que la página de propiedades ha cambiado. De lo contrario, devuelve S_FALSE.

Comentarios

La hoja de propiedades usa esta información para habilitar o deshabilitar el botón Aplicar en el cuadro de diálogo. No es necesario aplicar los valores en una página de propiedades si esos valores ya están actualizados con los objetos subyacentes.

Notas para los implementadores

Este método no tiene ninguna razón para devolver un código de error, ya que la incapacidad de determinar si la página está desfasada debe devolver S_OK como valor predeterminado. De este modo, el usuario tiene la oportunidad de actualizar los valores. La página no debe devolver un código de error, ya que un código de error no es el mismo que S_OK e indicaría que la página no está sucia. A continuación, el marco de propiedad podría deshabilitar el botón Aplicar , no permitiendo al usuario asegurarse de que los valores de propiedad están actualizados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IPropertyPage