Control.AccessibleDescription 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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

public:
 property System::String ^ AccessibleDescription { System::String ^ get(); void set(System::String ^ value); };

public string? AccessibleDescription { get; set; }

member this.AccessibleDescription : string with get, set

Public Property AccessibleDescription As String

속성 값

String

내게 필요한 옵션 지원 클라이언트 애플리케이션에서 사용하는 컨트롤의 설명입니다. 기본값은 null입니다.

예제

다음 코드 예제에서는 파생된 클래스의 인스턴스를 CheckBox 만듭니다., MyCheckBox는 속성 Image 에 할당 Image 하 고 설정 AccessibleName 합니다 및 AccessibleDescription 속성 때문에 Text 속성은 합니다null. 이 예제에서는 라는 MyForm가 Form 있어야 합니다.

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.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 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

설명

개체의 AccessibleDescription 속성은 개체의 시각적 모양에 대한 텍스트 설명을 제공합니다. 설명을 이해를 돕기 위해 시각 장애인을 위해 주로 있지만 컨텍스트 검색 이나 다른 애플리케이션에 사용할 수도 있습니다.

AccessibleDescription 설명이 명확하지 않거나 개체의 AccessibleName, , AccessibleRoleState및 Value 속성에 따라 중복되는 경우 속성이 필요합니다. 예를 들어 "확인"이 있는 단추에는 추가 정보가 필요하지 않지만 선인장 사진을 보여 주는 단추가 필요합니다. 선인장 단추의 , 및 (및 AccessibleRole 아마도 Help) 속성은 AccessibleName그 목적을 설명하지만 AccessibleDescription 속성은 "선인장의 그림을 보여주는 단추"와 같이 덜 눈에 띄는 정보를 전달합니다.

액세스 가능한 개체의 속성에 대한 자세한 내용은 설명 속성의 콘텐츠를 참조하세요.

추가 정보

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description