AccessibleObject.Parent Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das übergeordnete Element eines zugreifbaren Objekts ab.

public virtual System.Windows.Forms.AccessibleObject? Parent { get; }

Eigenschaftswert

AccessibleObject

Ein AccessibleObject, das das übergeordnete Element eines zugreifbaren Objekts darstellt, oder null, wenn kein übergeordnetes Objekt vorhanden ist.

Beispiele

Im folgenden Beispiel wird die Erstellung eines barrierefreiheitsfähigen Diagrammsteuerelements veranschaulicht, das die AccessibleObject Klassen und Control.ControlAccessibleObject verwendet, um barrierefreie Informationen verfügbar zu machen. Das Steuerelement zeichnet zwei Kurven zusammen mit einer Legende. Die ChartControlAccessibleObject -Klasse, die von ControlAccessibleObjectabgeleitet wird, wird in der CreateAccessibilityInstance -Methode verwendet, um benutzerdefinierte, zugängliche Informationen für das Diagrammsteuerelement bereitzustellen. Da es sich bei der Diagrammlegende nicht um ein tatsächlich Control basiertes Steuerelement handelt, sondern stattdessen vom Diagrammsteuerelement gezeichnet wird, enthält sie keine integrierten, zugänglichen Informationen. Aus diesem Grund überschreibt die ChartControlAccessibleObject -Klasse die -Methode, um die GetChild zurückzugeben, die CurveLegendAccessibleObject zugängliche Informationen für jeden Teil der Legende darstellt. Wenn eine barrierefreie Anwendung dieses Steuerelement verwendet, kann das Steuerelement die erforderlichen barrierefreien Informationen bereitstellen.

Dieser Codeauszug veranschaulicht das Überschreiben der Parent -Eigenschaft. Das vollständige Codebeispiel finden Sie in der AccessibleObject Klassenübersicht.

// Inner class CurveLegendAccessibleObject represents accessible information 
// associated with the CurveLegend object.
public class CurveLegendAccessibleObject : AccessibleObject
{
    private CurveLegend curveLegend;

    public CurveLegendAccessibleObject(CurveLegend curveLegend) : base() 
    {
        this.curveLegend = curveLegend;                    
    }                

    // Private property that helps get the reference to the parent ChartControl.
    private ChartControlAccessibleObject ChartControl
    {   
        get {
            return Parent as ChartControlAccessibleObject;
        }
    }

    // Internal helper function that returns the ID for this CurveLegend.
    internal int ID
    {
        get {
            for(int i = 0; i < ChartControl.GetChildCount(); i++) {
                if (ChartControl.GetChild(i) == this) {
                    return i;
                }
            }
            return -1;
        }
    }

    // Gets the Bounds for the CurveLegend. This is used by accessibility programs.
    public override Rectangle Bounds
    {
        get {                        
            // The bounds is in screen coordinates.
            Point loc = curveLegend.Location;
            return new Rectangle(curveLegend.chart.PointToScreen(loc), curveLegend.Size);
        }
    }

    // Gets or sets the Name for the CurveLegend. This is used by accessibility programs.
    public override string Name
    {
        get {
            return curveLegend.Name;
        }
        set {
            curveLegend.Name = value;                        
        }
    }

    // Gets the Curve Legend Parent's Accessible object.
    // This is used by accessibility programs.
    public override AccessibleObject Parent
    {
        get {
            return curveLegend.chart.AccessibilityObject;
        }
    }

    // Gets the role for the CurveLegend. This is used by accessibility programs.
    public override AccessibleRole Role 
    {
        get {
            return AccessibleRole.StaticText;
        }
    }

    // Gets the state based on the selection for the CurveLegend. 
    // This is used by accessibility programs.
    public override AccessibleStates State 
    {
        get {
            AccessibleStates state = AccessibleStates.Selectable;
            if (curveLegend.Selected) 
            {
                state |= AccessibleStates.Selected;
            }
            return state;
        }
    }

    // Navigates through siblings of this CurveLegend. This is used by accessibility programs.
    public override AccessibleObject Navigate(AccessibleNavigation navdir) 
    {
        // Uses the internal NavigateFromChild helper function that exists
        // on ChartControlAccessibleObject.
        return ChartControl.NavigateFromChild(this, navdir);
    }

    // Selects or unselects this CurveLegend. This is used by accessibility programs.
    public override void Select(AccessibleSelection selection) 
    {
        // Uses the internal SelectChild helper function that exists
        // on ChartControlAccessibleObject.
        ChartControl.SelectChild(this, selection);
    }
}

Hinweise für Vererber

Alle Objekte sollten diese Eigenschaft unterstützen.

Gilt für:

Weitere Informationen

• Bounds
• DefaultAction
• Description
• Help
• KeyboardShortcut
• Name
• Role
• State
• Value