Control.QueryAccessibilityHelp Ereignis

Definition

Tritt ein, wenn AccessibleObject Hilfe für barrierefreie Anwendungen bereitstellt.Occurs when AccessibleObject is providing help to accessibility applications.

public:
 event System::Windows::Forms::QueryAccessibilityHelpEventHandler ^ QueryAccessibilityHelp;
public event System.Windows.Forms.QueryAccessibilityHelpEventHandler QueryAccessibilityHelp;
member this.QueryAccessibilityHelp : System.Windows.Forms.QueryAccessibilityHelpEventHandler 
Public Custom Event QueryAccessibilityHelp As QueryAccessibilityHelpEventHandler 

Beispiele

Das folgende Codebeispiel veranschaulicht die Erstellung eines Barrierefreiheits fähigen Diagramm Steuer Elements mithilfe der Klassen AccessibleObject und Control.ControlAccessibleObject, um Barrierefreie Informationen verfügbar zu machen.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Das-Steuerelement zeichnet zwei Kurven zusammen mit einer Legende.The control plots two curves along with a legend. Die ChartControlAccessibleObject-Klasse, die von ControlAccessibleObject abgeleitet wird, wird in der CreateAccessibilityInstance-Methode verwendet, um benutzerdefinierte Informationen für das Diagramm Steuerelement bereitzustellen.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Da die Diagramm Legende kein tatsächliches Control-basiertes Steuerelement ist, sondern stattdessen vom Diagramm Steuerelement gezeichnet wird, sind keine integrierten zugänglichen Informationen verfügbar.Since the chart legend is not an actual Control -based control, but instead is drawn by the chart control, it does not any built-in accessible information. Aus diesem Grund überschreibt die ChartControlAccessibleObject-Klasse die GetChild-Methode, um die CurveLegendAccessibleObject zurückzugeben, die barrierefreie Informationen für jeden Teil der Legende darstellt.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Wenn eine barrierefreie Anwendung dieses Steuerelement verwendet, kann das Steuerelement die erforderlichen zugänglichen Informationen bereitstellen.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Dieser Code Ausschnitt veranschaulicht die Behandlung des QueryAccessibilityHelp-Ereignisses.This code excerpt demonstrates handling the QueryAccessibilityHelp event. Das gesamte Codebeispiel finden Sie in der Übersicht über AccessibleObject-Klasse.See the AccessibleObject class overview for the complete code example.

// Handles the QueryAccessibilityHelp event.
void ChartControl_QueryAccessibilityHelp( Object^ /*sender*/, System::Windows::Forms::QueryAccessibilityHelpEventArgs^ e )
{
   e->HelpString = "Displays chart data";
}
// Handles the QueryAccessibilityHelp event.
private void ChartControl_QueryAccessibilityHelp(object sender, 
                            System.Windows.Forms.QueryAccessibilityHelpEventArgs e)
{            
    e.HelpString = "Displays chart data";
}          
' Handle the QueryAccessibilityHelp event.
Private Sub ChartControl_QueryAccessibilityHelp(sender As Object, _
                   e As System.Windows.Forms.QueryAccessibilityHelpEventArgs) Handles MyBase.QueryAccessibilityHelp
    e.HelpString = "Displays chart data"
End Sub 

Hinweise

Verwenden Sie die HelpProvider-Klasse, um Benutzern das Aufrufen von Hilfe für Ihr Barrierefreies Objekt zu ermöglichen, indem Sie die F1-Taste drücken.You should use the HelpProvider class to enable users to invoke help on your accessible object by pressing the F1 key. Wenn Sie die HelpProvider verwenden, erhalten Sie umfassende Informationen in der QueryAccessibilityHelpEventArgs.Using the HelpProvider provides you with complete information in the QueryAccessibilityHelpEventArgs. Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Gilt für:

Siehe auch