Control.QueryAccessibilityHelp Event

Definition

Si verifica quando l'oggetto AccessibleObject fornisce la Guida per le applicazioni di accessibilità.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 

Examples

Nell'esempio di codice riportato di seguito viene illustrata la creazione di un controllo Chart in grado di riconoscere l'accessibilità utilizzando le classi AccessibleObject e Control.ControlAccessibleObject per esporre le informazioni accessibili.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Il controllo traccia due curve insieme a una legenda.The control plots two curves along with a legend. La classe ChartControlAccessibleObject, che deriva da ControlAccessibleObject, viene utilizzata nel metodo CreateAccessibilityInstance per fornire informazioni personalizzate accessibili per il controllo Chart.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Poiché la legenda del grafico non è un controllo effettivo basato su Control, ma viene invece disegnato dal controllo Chart, non vengono fornite informazioni incorporate accessibili.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. Per questo motivo, la classe ChartControlAccessibleObject esegue l'override del metodo GetChild per restituire il CurveLegendAccessibleObject che rappresenta le informazioni accessibili per ogni parte della legenda.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Quando un'applicazione in grado di riconoscere accessibilità utilizza questo controllo, il controllo può fornire le informazioni accessibili necessarie.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Questo estratto di codice illustra la gestione dell'evento QueryAccessibilityHelp.This code excerpt demonstrates handling the QueryAccessibilityHelp event. Per l'esempio di codice completo, vedere Cenni preliminari sulla classe AccessibleObject.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 

Remarks

È consigliabile usare la classe HelpProvider per consentire agli utenti di richiamare la guida sull'oggetto accessibile premendo il tasto F1.You should use the HelpProvider class to enable users to invoke help on your accessible object by pressing the F1 key. Utilizzando il HelpProvider vengono fornite informazioni complete nel QueryAccessibilityHelpEventArgs.Using the HelpProvider provides you with complete information in the QueryAccessibilityHelpEventArgs. Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.For more information about handling events, see Handling and Raising Events.

Applies to

See also