AmbientValueAttribute 클래스

정의

네임스페이스:

System.ComponentModel

어셈블리:

System.ComponentModel.TypeConverter.dll

Source:

AmbientValueAttribute.cs

속성이 다른 소스에서 값을 가져오도록 속성에 전달할 값을 지정합니다. 이를 앰비언스라고 합니다. 이 클래스는 상속될 수 없습니다.

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

상속

Object

Attribute

AmbientValueAttribute

특성

AttributeUsageAttribute

예제

다음 코드 예제에서는 사용 하 여 AmbientValueAttribute 라는 AlertForeColor속성에 대 한 주변 동작을 적용 하는 방법을 보여 줍니다. 전체 코드 목록은 참조 하세요 방법: Windows Forms 컨트롤에서 특성 적용합니다.

[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

설명

컨트롤의 속성에 주변 동작이 있는 경우 이 특성이 있어야 합니다. 앰비언트 속성은 부모 값(예: 속성 또는 속성)을 Control.FontControl.BackColor 쿼리합니다.

일반적으로 시각적 디자이너는 특성을 사용하여 속성에 AmbientValueAttribute 유지할 값을 결정합니다. 이는 일반적으로 속성이 다른 원본에서 해당 값을 가져오는 값입니다. 앰비언트 값의 예는 Color.Empty 속성의 앰비언트 값입니다 BackColor . 폼에 컨트롤이 있고 컨트롤의 속성이 폼의 속성과 BackColor 다른 색 BackColor 으로 설정된 경우 컨트롤의 을 로 설정하여 컨트롤의 속성을 폼의 속성으로 다시 BackColor 설정할 BackColorColor.Empty수 있습니다.

생성자

AmbientValueAttribute(Boolean)	해당 값에 대해 부울 값을 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Byte)	해당 값에 대해 8비트 부호 없는 정수를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Char)	해당 값에 대해 유니코드 문자를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Double)	해당 값에 대해 배정밀도 부동 소수점 숫자를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Int16)	해당 값에 대해 16비트 부호 있는 정수를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Int32)	해당 값에 대해 32비트 부호 있는 정수를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Int64)	해당 값에 대해 64비트 부호 있는 정수를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Object)	해당 값에 대해 개체를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Single)	해당 값에 대해 단정밀도 부동 소수점 숫자를 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(String)	해당 값에 대해 문자열을 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.
AmbientValueAttribute(Type, String)	값 및 형식을 지정하여 AmbientValueAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

TypeId	파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)
Value	이 AmbientValueAttribute의 값인 개체를 가져옵니다.

메서드

Equals(Object)	지정한 AmbientValueAttribute가 현재 AmbientValueAttribute와 같은지 여부를 확인합니다.
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)