Control.AccessibleDescription 속성

정의

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

예제

다음 코드 예제에서는 MyCheckBox파생 클래스 CheckBox의 인스턴스를 만들고, Image 속성에 Image을 할당 하 고, AccessibleName 속성이 AccessibleDescription 이므로 Textnull속성을 설정 합니다.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. 이 예에서는 이름이 MyFormForm 있어야 합니다.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 속성은 설명이 명확 하지 않은 경우 또는 개체의 AccessibleName, AccessibleRole, StateValue 속성을 기반으로 중복 된 경우에 필요 합니다.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. 예를 들어 "OK"가 있는 단추에는 추가 정보가 필요 하지 않지만 선인장 그림을 보여 주는 단추는 있습니다.For example, a button with "OK" would not need additional information, but a button that shows a picture of a cactus would. 선인장 단추의 AccessibleNameAccessibleRoleHelp속성은 해당 용도를 설명 하지만 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.

적용 대상

추가 정보