Control.AccessibleDescription Control.AccessibleDescription Control.AccessibleDescription Control.AccessibleDescription Property

정의

내게 필요한 옵션 지원 클라이언트 응용 프로그램에서 사용하는 컨트롤의 설명을 가져오거나 설정합니다.Gets or sets the description of the control used by accessibility client applications.

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

속성 값

내게 필요한 옵션 지원 클라이언트 애플리케이션에서 사용하는 컨트롤의 설명입니다.The description of the control used by accessibility client applications. 기본값은 null입니다.The default is null.

예제

인스턴스를 만들고 다음 코드 예제를 CheckBox 클래스를 파생 MyCheckBox, 할당는 Image 를 해당 Image 속성을 설정 합니다 AccessibleNameAccessibleDescription 속성을 때문에 Text 속성은 null합니다.The following code example creates an instance of a CheckBox derived class, MyCheckBox, assigns it an Image to its Image property and sets the AccessibleName and AccessibleDescription properties, because the Text property is null. 이 예제를 실행 하려면를 Form 라는 MyForm합니다.This example requires that you have a Form named MyForm.

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 속성은 개체의 시각적 모양에 대 한 텍스트 설명을 제공 합니다.An object's AccessibleDescription property provides a textual description about an object's visual appearance. 설명을 이해를 돕기 위해 시각 장애인을 위해 주로 있지만 컨텍스트 검색 이나 다른 응용 프로그램에 사용할 수도 있습니다.The description is primarily used to provide greater context for low-vision or blind users, but can also be used for context searching or other applications.

합니다 AccessibleDescription 속성에 대 한 설명, 없는 경우 필요한 또는 중복 될 경우 개체의 기반 AccessibleNameAccessibleRole, State, 및 Value 속성입니다.The AccessibleDescription property is needed if the description is not obvious, or if it is redundant based on the object's AccessibleName, AccessibleRole, State, and Value properties. 예를 들어, "확인"을 사용 하 여 단추에는 추가 정보를 사용 해야 합니다. 하지만 선인장 그림이 표시 된 단추입니다.For example, a button with "OK" would not need additional information, but a button that shows a picture of a cactus would. AccessibleName, 및 AccessibleRole (및 아마도 Help) 속성 선인장 단추에 대 한 용도 설명 하지만 AccessibleDescription 속성 "선인장 그림이 표시 된 단추입니다."와 같은 명백 하지 않은 정보를 전달 합니다The AccessibleName, and AccessibleRole (and perhaps Help) properties for the cactus button would describe its purpose, but the AccessibleDescription property would convey information that is less tangible, such as "A button that shows a picture of a cactus."

액세스 가능 개체의 속성에 대 한 자세한 내용은 참조 하세요. 설명이 포함 된 속성의 콘텐츠합니다.For more information about properties of accessible objects, see Content of Descriptive Properties.

적용 대상

추가 정보