Control.AccessibilityNotifyClients Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Upozorní klientské aplikace AccessibleEventspřístupnosti na .

Přetížení

Name	Description
AccessibilityNotifyClients(AccessibleEvents, Int32)	Upozorní klientské aplikace usnadnění zadané AccessibleEvents pro zadaný podřízený ovládací prvek.
AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)	Upozorní klientské aplikace usnadnění určené AccessibleEvents pro zadaný podřízený ovládací prvek .

AccessibilityNotifyClients(AccessibleEvents, Int32)

Zdroj:

Control.cs

Upozorní klientské aplikace usnadnění zadané AccessibleEvents pro zadaný podřízený ovládací prvek.

protected public:
 void AccessibilityNotifyClients(System::Windows::Forms::AccessibleEvents accEvent, int childID);

protected internal void AccessibilityNotifyClients(System.Windows.Forms.AccessibleEvents accEvent, int childID);

member this.AccessibilityNotifyClients : System.Windows.Forms.AccessibleEvents * int -> unit

Protected Friend Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, childID As Integer)

Parametry

accEvent

AccessibleEvents

Oznámení AccessibleEvents klientským aplikacím pro usnadnění přístupu

childID

Int32

Control Dítě, které má upozornit na událost s podporou přístupnosti.

Příklady

Následující příklad kódu ukazuje vytvoření ovládacího prvku grafu s podporou přístupnosti pomocí AccessibleObject a Control.ControlAccessibleObject tříd k zveřejnění přístupných informací. Ovládací prvek vykreslují dvě křivky spolu s legendou. Třída ChartControlAccessibleObject , která je odvozena z ControlAccessibleObject, je použita v CreateAccessibilityInstance metodě k poskytnutí vlastních přístupných informací pro ovládací prvek grafu. Vzhledem k tomu, že legenda grafu není skutečný Control ovládací prvek -based, ale je vykreslen ovládacím prvku grafu, neobsahuje žádné předdefinované přístupné informace. Z tohoto důvodu třída přepíše metodu tak, ChartControlAccessibleObject aby vrátilaGetChild, která představuje přístupné informace pro každou část legendy.CurveLegendAccessibleObject Pokud aplikace s podporou přístupnosti používá tento ovládací prvek, může ovládací prvek poskytnout nezbytné přístupné informace.

Tento výňatek kódu ukazuje volání AccessibilityNotifyClients metody. Kompletní příklad kódu najdete v přehledu AccessibleObject třídy.

   // Gets or sets the location for the curve legend.
   Point get()
   {
      return location;
   }

   void set( Point value )
   {
      location = value;
      chart->Invalidate();
      
      // Notifies the chart of the location change. This is used for
      // the accessibility information. AccessibleEvents::LocationChange
      // tells the chart the reason for the notification.
      chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
   }

}

property String^ Name 
{

   // Gets or sets the Name for the curve legend.
   String^ get()
   {
      return name;
   }

   void set( String^ value )
   {
      if ( name != value )
      {
         name = value;
         chart->Invalidate();
         
         // Notifies the chart of the name change. This is used for
         // the accessibility information. AccessibleEvents::NameChange
         // tells the chart the reason for the notification.
         chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

}

property bool Selected 
{

   // Gets or sets the Selected state for the curve legend.
   bool get()
   {
      return selected;
   }

   void set( bool value )
   {
      if ( selected != value )
      {
         selected = value;
         chart->Invalidate();
         
         // Notifies the chart of the selection value change. This is used for
         // the accessibility information. The AccessibleEvents value depends upon
         // if the selection is true (AccessibleEvents::SelectionAdd) or
         // false (AccessibleEvents::SelectionRemove).
         chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

    // Gets or sets the location for the curve legend.
    public Point Location
    {   
        get {
            return location;
        }
        set {
            location = value;
            chart.Invalidate();

            // Notifies the chart of the location change. This is used for
            // the accessibility information. AccessibleEvents.LocationChange
            // tells the chart the reason for the notification.

            chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }            

    // Gets or sets the Name for the curve legend.
    public string Name
    {   
        get {
            return name;
        }
        set {
            if (name != value) 
            {
                name = value;
                chart.Invalidate();

                // Notifies the chart of the name change. This is used for
                // the accessibility information. AccessibleEvents.NameChange
                // tells the chart the reason for the notification.

                chart.AccessibilityNotifyClients(AccessibleEvents.NameChange, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

    // Gets or sets the Selected state for the curve legend.
    public bool Selected
    {   
        get {
            return selected;
        }
        set {
            if (selected != value) 
            {
                selected = value;
                chart.Invalidate();

                // Notifies the chart of the selection value change. This is used for
                // the accessibility information. The AccessibleEvents value depends upon
                // if the selection is true (AccessibleEvents.SelectionAdd) or 
                // false (AccessibleEvents.SelectionRemove).
                chart.AccessibilityNotifyClients(
                    selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

' Gets or sets the location for the curve legend.            
Public Property Location() As Point
    Get
        Return m_location
    End Get
    Set
        m_location = value
        chart.Invalidate()

        ' Notifies the chart of the location change. This is used for
        ' the accessibility information. AccessibleEvents.LocationChange
        ' tells the chart the reason for the notification.
        chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
                CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
    End Set
End Property

' Gets or sets the Name for the curve legend.            
Public Property Name() As String
    Get
        Return m_name
    End Get
    Set
        If m_name <> value Then
            m_name = value
            chart.Invalidate()

            ' Notifies the chart of the name change. This is used for
            ' the accessibility information. AccessibleEvents.NameChange
            ' tells the chart the reason for the notification. 
            chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
                    CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
        End If
    End Set
End Property

' Gets or sets the Selected state for the curve legend.            
Public Property Selected() As Boolean
    Get
        Return m_selected
    End Get
    Set
        If m_selected <> value Then
            m_selected = value
            chart.Invalidate()

            ' Notifies the chart of the selection value change. This is used for
            ' the accessibility information. The AccessibleEvents value varies
            ' on whether the selection is true (AccessibleEvents.SelectionAdd) or 
            ' false (AccessibleEvents.SelectionRemove). 
            If m_selected Then
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            Else
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            End If
        End If
    End Set
End Property

Poznámky

Je nutné volat metodu Control.ControlAccessibleObject.NotifyClients pro každou AccessibleEvents klientskou aplikaci přístupnosti, o které se mají informovat. Metoda NotifyClients se obvykle volá, když je vlastnost nastavena nebo z obslužné rutiny události. Můžete například volat metodu NotifyClients a předat AccessibleEvents hodnotu Hide z obslužné rutiny události pro Control.VisibleChanged událost.

Viz také

• AccessibleEvents
• Controls

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

Zdroj:

Control.cs

Upozorní klientské aplikace usnadnění určené AccessibleEvents pro zadaný podřízený ovládací prvek .

protected:
 void AccessibilityNotifyClients(System::Windows::Forms::AccessibleEvents accEvent, int objectID, int childID);

protected void AccessibilityNotifyClients(System.Windows.Forms.AccessibleEvents accEvent, int objectID, int childID);

member this.AccessibilityNotifyClients : System.Windows.Forms.AccessibleEvents * int * int -> unit

Protected Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, objectID As Integer, childID As Integer)

Parametry

accEvent

AccessibleEvents

Oznámení AccessibleEvents klientským aplikacím pro usnadnění přístupu

objectID

Int32

Identifikátor .AccessibleObject

childID

Int32

Control Dítě, které má upozornit na událost s podporou přístupnosti.