AmbientValueAttribute Classe
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 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
- Attributs
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
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 .
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec une valeur Boolean comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier non signé 8 bits comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un caractère Unicode comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un nombre à virgule flottante double précision comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier signé 16 bits comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier signé 32 bits comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un entier signé 64 bits comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un objet comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec un nombre à virgule flottante simple précision comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec une chaîne comme valeur. |
Ambient |
Initialise une nouvelle instance de la classe AmbientValueAttribute avec sa valeur et son type. |
Type |
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. |
Equals(Object) |
Détermine si l'objet AmbientValueAttribute spécifié est égal à l'objet AmbientValueAttribute actuel. |
Get |
Retourne le code de hachage de cette instance. |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Is |
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) |
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
_Attribute. |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute) |
_Attribute. |
Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute) |
_Attribute. |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute) |
_Attribute. |
Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute) |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :