FrameworkPropertyMetadataOptions Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie les types de comportement de la propriété de niveau infrastructure qui se rapportent à une propriété de dépendance particulière dans le système de propriétés WPF (Windows Presentation Foundation).
Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.
public enum class FrameworkPropertyMetadataOptions
[System.Flags]
public enum FrameworkPropertyMetadataOptions
[<System.Flags>]
type FrameworkPropertyMetadataOptions =
Public Enum FrameworkPropertyMetadataOptions
- Héritage
- Attributs
Champs
AffectsArrange | 2 | La passe de réorganisation de la composition de disposition est affectée par les modifications apportées aux valeurs de cette propriété de dépendance. |
AffectsMeasure | 1 | La passe de mesure des compositions de disposition est affectée par les modifications apportées aux valeurs de cette propriété de dépendance. |
AffectsParentArrange | 8 | La passe de réorganisation sur l’élément parent est affectée par les modifications apportées aux valeurs de cette propriété de dépendance. |
AffectsParentMeasure | 4 | La passe de mesure sur l’élément parent est affectée par les modifications apportées aux valeurs de cette propriété de dépendance. |
AffectsRender | 16 | Un aspect du rendu ou de la composition de disposition (autre que la mesure ou la réorganisation) est affecté par les modifications apportées aux valeurs de cette propriété de dépendance. |
BindsTwoWayByDefault | 256 | BindingMode pour les liaisons de données sur cette propriété de dépendance a la valeur par défaut TwoWay. |
Inherits | 32 | Les valeurs de cette propriété de dépendance sont héritées par les éléments enfants. |
Journal | 1024 | Les valeurs de cette propriété de dépendance doivent être enregistrées ou restaurées par des processus de journalisation, ou en cas de navigation par des URI (Uniform Resource Identifiers). |
None | 0 | Aucune option n’est spécifiée ; la propriété de dépendance utilise le comportement par défaut du système de propriétés WPF. |
NotDataBindable | 128 | La liaison de données à cette propriété de dépendance n’est pas autorisée. |
OverridesInheritanceBehavior | 64 | Les valeurs de cette propriété de dépendance couvrent des arborescences séparées pour les besoins de l’héritage des valeurs de propriété. |
SubPropertiesDoNotAffectRender | 2048 | Les sous-propriétés de la valeur de cette propriété de dépendance n’affectent aucun aspect du rendu. |
Exemples
L’exemple suivant appelle le FrameworkPropertyMetadata constructeur et définit plusieurs options à l’aide de valeurs de l’énumération FrameworkPropertyMetadataOptions
:
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Remarques
Utilisez cette énumération lorsque vous construisez une FrameworkPropertyMetadata instance et que vous souhaitez spécifier un ou plusieurs paramètres d’option de métadonnées au niveau de l’infrastructure.
Vous n’utilisez plus cette énumération après l’appel du constructeur. Au lieu de cela, interrogez l’option de métadonnées particulière qui a été définie lors de l’inscription en vérifiant la ou false
la true
valeur d’une propriété spécifique d’une propriété existante FrameworkPropertyMetadata. Ces noms de propriétés correspondent aux valeurs d’énumération à l’exception FrameworkPropertyMetadataOptions
de NotDataBindable, qui se trouve IsNotDataBindable sur la fin FrameworkPropertyMetadata.
L’option Journal
spécifie uniquement l’intention d’être journalisé. La journalisation réelle peut ou non être traitée par des services de journalisation tels que ceux présents dans l’application de visionneuse WPF. En particulier, la journalisation présente certaines limitations connues si l’arborescence d’éléments a été construite par le biais du code plutôt que du code XAML. Pour plus d’informations, consultez Vue d’ensemble de la navigation.
Notes
Bien que l’héritage de valeur de propriété semble fonctionner pour les propriétés de dépendance non attachées, le comportement d’héritage d’une propriété non attachée via certaines limites d’élément dans l’arborescence d’exécution n’est pas défini. Utilisez toujours la DependencyProperty.RegisterAttached méthode pour inscrire des propriétés dans lesquelles vous spécifiez FrameworkPropertyMetadata.Inherits les métadonnées.