TextPattern.GetVisibleRanges Méthode

public:
 cli::array <System::Windows::Automation::Text::TextPatternRange ^> ^ GetVisibleRanges();

public System.Windows.Automation.Text.TextPatternRange[] GetVisibleRanges();

member this.GetVisibleRanges : unit -> System.Windows.Automation.Text.TextPatternRange[]

Public Function GetVisibleRanges () As TextPatternRange()

Retours

Collection de plages de texte visibles au sein du conteneur ou d’un tableau vide. Null n’est jamais retourné.

Exemples

private TextPatternRange[] CurrentVisibleRanges(AutomationElement target)
{
    // Specify the control type we're looking for, in this case 'Document'
    PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

    // target --> The root AutomationElement.
    AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

    TextPattern textpatternPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

    if (textpatternPattern == null)
    {
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
        return null;
    }
    return textpatternPattern.GetVisibleRanges();
}

Private Function CurrentVisibleRanges(ByVal target As AutomationElement) As TextPatternRange()
    ' Specify the control type we're looking for, in this case 'Document'
    Dim cond As PropertyCondition = New PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document)

    ' target --> The root AutomationElement.
    Dim textProvider As AutomationElement = target.FindFirst(TreeScope.Descendants, cond)

    Dim textpatternPattern As TextPattern = CType(textProvider.GetCurrentPattern(TextPattern.Pattern), TextPattern)

    If (textpatternPattern Is Nothing) Then
        Console.WriteLine("Root element does not contain a descendant that supports TextPattern.")
        Return Nothing
    End If

    Return textpatternPattern.GetVisibleRanges()
End Function

Remarques

Des plages de texte disjointes peuvent se produire lorsqu’un contenu d’un conteneur de texte est masqué par une fenêtre qui se chevauche ou un autre objet, ou lorsqu’un conteneur de texte avec une disposition à plusieurs colonnes comporte une ou plusieurs colonnes partiellement affichées.

Si aucun texte n’est visible, une plage de texte dégénérée (vide) est retournée. Cette plage vide peut être retournée si le conteneur de texte est vide ou lorsque tout le texte est sorti de l’affichage.

Voir aussi

• TextPatternRange