Control.AccessibleDescription 속성

내게 필요한 옵션 지원 클라이언트 응용 프로그램에서 사용하는 컨트롤의 설명을 가져오거나 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<LocalizableAttribute(True)> _
Public Property AccessibleDescription As String
‘사용 방법
Dim instance As Control
Dim value As String

value = instance.AccessibleDescription

instance.AccessibleDescription = value

[LocalizableAttribute(true)] 
public string AccessibleDescription { get; set; }

[LocalizableAttribute(true)] 
public:
property String^ AccessibleDescription {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_AccessibleDescription ()

/** @property */
public void set_AccessibleDescription (String value)

public function get AccessibleDescription () : String

public function set AccessibleDescription (value : String)

속성 값

내게 필요한 옵션 지원 클라이언트 응용 프로그램에서 사용하는 컨트롤의 설명입니다. 기본값은 Null 참조(Visual Basic의 경우 Nothing)입니다.

설명

개체의 AccessibleDescription 속성은 개체의 모양에 대한 텍스트 설명을 제공합니다. 이 설명은 시각 장애인을 위해 큰 컨텍스트를 제공하는 데 주로 사용되지만 컨텍스트 검색이나 기타 응용 프로그램에도 사용될 수 있습니다.

AccessibleDescription 속성은 설명이 명확하지 않거나 개체의 AccessibleName, AccessibleRole, State 및 Value 속성에서 설명이 중복될 경우에 필요합니다. 예를 들어, "확인" 단추에는 추가 설명이 필요하지 않지만 선인장 그림이 표시된 단추에는 추가 설명이 필요합니다. AccessibleName, AccessibleRole 및 Help 속성의 경우 선인장 단추의 용도를 설명하지만, AccessibleDescription 속성의 경우 "선인장 그림이 표시된 단추" 등과 같이 명백하지 않은 정보를 전달합니다.

액세스 가능한 개체의 속성에 대한 자세한 내용은 https://msdn.microsoft.com/library/kor. MSDN Library에서 "Content of Descriptive Properties" 항목을 참조하십시오.

예제

다음 코드 예제에서는 Text 속성이 Null 참조(Visual Basic의 경우 Nothing)이므로 CheckBox 파생 클래스 MyCheckBox의 인스턴스를 만들고, 해당 Image 속성에 대한 Image에 할당하고, AccessibleName 및 AccessibleDescription 속성을 설정합니다. 이 예제를 실행하려면 MyForm이라는 Form이 있어야 합니다.

Public Sub New()
   ' Create a 'MyCheckBox' control and 
   ' display an image on it. 
   Dim myCheckBox As New MyCustomControls.MyCheckBox()
   myCheckBox.Location = New Point(5, 5)
   myCheckBox.Image = Image.FromFile( _
     Application.CommonAppDataPath + "\Preview.jpg")

   ' Set the AccessibleName property
   ' since there is no Text displayed. 
   myCheckBox.AccessibleName = "Preview"

   ' Set the AccessibleDescription text.
   myCheckBox.AccessibleDescription = _
     "A toggle button used to show the document preview."
   Me.Controls.Add(myCheckBox)
End Sub

public MyForm()
{
   // Create a 'MyCheckBox' control and 
   // display an image on it.
   MyCustomControls.MyCheckBox myCheckBox = 
      new MyCustomControls.MyCheckBox();
   myCheckBox.Location = new Point(5,5);
   myCheckBox.Image = Image.FromFile(
     Application.CommonAppDataPath + "\\Preview.jpg");

   // Set the AccessibleName property
   // since there is no Text displayed.
   myCheckBox.AccessibleName = "Preview";
   myCheckBox.AccessibleDescription =
     "A toggle button used to show the document preview.";
   this.Controls.Add(myCheckBox);
}

public:
   MyForm()
   {
      // Create a 'MyCheckBox' control and
      // display an image on it.
      MyCustomControls::MyCheckBox^ myCheckBox = gcnew MyCustomControls::MyCheckBox;
      myCheckBox->Location = Point(5,5);
      myCheckBox->Image = Image::FromFile( String::Concat( Application::CommonAppDataPath, "\\Preview.jpg" ) );
      
      // Set the AccessibleName property
      // since there is no Text displayed.
      myCheckBox->AccessibleName = "Preview";
      myCheckBox->AccessibleDescription = "A toggle button used to show the document preview.";
      this->Controls->Add( myCheckBox );
   }

public MyForm()
{
    // Create a 'MyCheckBox' control and 
    // display an image on it.
    MyCustomControls.MyCheckBox myCheckBox = 
        new MyCustomControls.MyCheckBox();
    myCheckBox.set_Location(new Point(5, 5));
    myCheckBox.set_Image(Image.FromFile(Application.get_CommonAppDataPath() 
        + "\\Preview.jpg"));
    // Set the AccessibleName property
    // since there is no Text displayed.
    myCheckBox.set_AccessibleName("Preview");
    myCheckBox.set_AccessibleDescription(
        "A toggle button used to show the document preview.");
    this.get_Controls().Add(myCheckBox);
} //MyForm

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

Control 클래스
Control 멤버
System.Windows.Forms 네임스페이스
AccessibleName
AccessibleRole
Control.AccessibleDefaultActionDescription 속성
AccessibleObject.Description 속성