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 |