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

Indica se a página de propriedades foi alterada desde que foi ativada ou desde a chamada mais recente para Aplicar.

Sintaxe

HRESULT IsPageDirty();

Retornar valor

Esse método retorna S_OK para indicar que a página de propriedades foi alterada. Caso contrário, ele retornará S_FALSE.

Comentários

A folha de propriedades usa essas informações para habilitar ou desabilitar o botão Aplicar na caixa de diálogo. Não é necessário aplicar os valores em uma página de propriedades se esses valores já estiverem atualizados com os objetos subjacentes.

Anotações aos implementadores

Esse método não tem nenhum motivo para retornar um código de erro, pois a incapacidade de determinar se a página é sujo deve retornar S_OK como padrão. Dessa forma, o usuário tem a chance de atualizar os valores. A página não deve retornar um código de erro, pois um código de erro não é o mesmo que S_OK e indicaria que a página não está sujo. Em seguida, o quadro de propriedades pode potencialmente desabilitar o botão Aplicar , não permitindo que o usuário verifique se os valores da propriedade estão atuais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ocidl.h

Confira também

Ipropertypage