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

Indique si la page de propriétés a changé depuis son activation ou depuis l’appel le plus récent à Appliquer.

Syntaxe

HRESULT IsPageDirty();

Valeur de retour

Cette méthode retourne S_OK pour indiquer que la page de propriétés a changé. Sinon, elle retourne S_FALSE.

Remarques

La feuille de propriétés utilise ces informations pour activer ou désactiver le bouton Appliquer dans la boîte de dialogue. Il n’est pas nécessaire d’appliquer les valeurs sur une page de propriétés si ces valeurs sont déjà à jour avec les objets sous-jacents.

Remarques aux implémenteurs

Cette méthode n’a aucune raison de retourner un code d’erreur, car l’impossibilité de déterminer si la page est sale doit retourner S_OK comme valeur par défaut. De cette façon, l’utilisateur a la possibilité de mettre à jour les valeurs. La page ne doit pas retourner de code d’erreur, car un code d’erreur n’est pas identique à S_OK et indique que la page n’est pas sale. Ensuite, le cadre de propriété peut potentiellement désactiver le bouton Appliquer , ce qui ne permet pas à l’utilisateur de s’assurer que les valeurs de propriété sont actuelles.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IPropertyPage