AmbientValueAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

AmbientValueAttribute.cs

Spécifie la valeur à passer à une propriété pour que celle-ci obtienne sa valeur à partir d’une autre source. On appelle cela l’ambiance. Cette classe ne peut pas être héritée.

public ref class AmbientValueAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class AmbientValueAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type AmbientValueAttribute = class
    inherit Attribute

Public NotInheritable Class AmbientValueAttribute
Inherits Attribute

Héritage

Object

Attribute

AmbientValueAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple de code suivant illustre l’utilisation AmbientValueAttribute de pour appliquer un comportement ambiant à une propriété appelée AlertForeColor. Pour obtenir une liste de code complète, consultez How to : Apply Attributes in Windows Forms Controls.

[AmbientValue(typeof(Color), "Empty")]
[Category("Appearance")]
[DefaultValue(typeof(Color), "White")]
[Description("The color used for painting alert text.")]
public Color AlertForeColor
{
    get
    {
        if (this.alertForeColorValue == Color.Empty &&
            this.Parent != null)
        {
            return Parent.ForeColor;
        }

        return this.alertForeColorValue;
    }

    set
    {
        this.alertForeColorValue = value;
    }
}

// This method is used by designers to enable resetting the
// property to its default value.
public void ResetAlertForeColor()
{
    this.AlertForeColor = AttributesDemoControl.defaultAlertForeColorValue;
}

// This method indicates to designers whether the property
// value is different from the ambient value, in which case
// the designer should persist the value.
private bool ShouldSerializeAlertForeColor()
{
    return (this.alertForeColorValue != AttributesDemoControl.ambientColorValue);
}

<AmbientValue(GetType(Color), "Empty"), _
Category("Appearance"), _
DefaultValue(GetType(Color), "White"), _
Description("The color used for painting alert text.")> _
Public Property AlertForeColor() As Color
    Get
        If Me.alertForeColorValue = Color.Empty AndAlso (Me.Parent IsNot Nothing) Then
            Return Parent.ForeColor
        End If

        Return Me.alertForeColorValue
    End Get

    Set(ByVal value As Color)
        Me.alertForeColorValue = value
    End Set
End Property

' This method is used by designers to enable resetting the
' property to its default value.
Public Sub ResetAlertForeColor()
    Me.AlertForeColor = AttributesDemoControl.defaultAlertForeColorValue
End Sub

' This method indicates to designers whether the property
' value is different from the ambient value, in which case
' the designer should persist the value.
Private Function ShouldSerializeAlertForeColor() As Boolean
    Return Me.alertForeColorValue <> AttributesDemoControl.ambientColorValue
End Function

Remarques

Si une propriété sur un contrôle a un comportement ambiant, cet attribut doit être présent. Les propriétés ambiantes interrogent leur parent pour leur valeur, par exemple une Control.Font propriété ou une Control.BackColor propriété.

En règle générale, un concepteur visuel utilise l’attribut AmbientValueAttribute pour déterminer la valeur à conserver pour une propriété. Il s’agit généralement d’une valeur qui amène la propriété à obtenir sa valeur à partir d’une autre source. Un exemple de valeur ambiante est Color.Empty la valeur ambiante de la BackColor propriété . Si vous avez un contrôle sur un formulaire et que la BackColor propriété du contrôle est définie sur une couleur différente de celle de la BackColor propriété du formulaire, vous pouvez réinitialiser la BackColor propriété du contrôle à celle du formulaire en affectant la valeur à Color.Emptyla BackColor propriété du contrôle .

Constructeurs

AmbientValueAttribute(Boolean)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec une valeur Boolean comme valeur.
AmbientValueAttribute(Byte)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier non signé 8 bits comme valeur.
AmbientValueAttribute(Char)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un caractère Unicode comme valeur.
AmbientValueAttribute(Double)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un nombre à virgule flottante double précision comme valeur.
AmbientValueAttribute(Int16)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier signé 16 bits comme valeur.
AmbientValueAttribute(Int32)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier signé 32 bits comme valeur.
AmbientValueAttribute(Int64)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier signé 64 bits comme valeur.
AmbientValueAttribute(Object)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un objet comme valeur.
AmbientValueAttribute(Single)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec un nombre à virgule flottante simple précision comme valeur.
AmbientValueAttribute(String)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec une chaîne comme valeur.
AmbientValueAttribute(Type, String)	Initialise une nouvelle instance de la classe AmbientValueAttribute avec sa valeur et son type.

Propriétés

TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
Value	Obtient l'objet qui est la valeur de ce AmbientValueAttribute.

Méthodes

Equals(Object)	Détermine si l'objet AmbientValueAttribute spécifié est égal à l'objet AmbientValueAttribute actuel.
GetHashCode()	Retourne le code de hachage de cette instance.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)