TextPattern.GetVisibleRanges Méthode

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Récupère un tableau de plages de texte disjointes à partir d'un conteneur de texte où chaque plage de texte commence à la première ligne partiellement visible et se termine à la dernière ligne partiellement visible.

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

TextPatternRange[]

Collection de plages de texte visibles dans le conteneur ou 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

Les plages de texte disjoint peuvent se produire lorsqu’un contenu d’un conteneur de texte est masqué par une fenêtre ou un autre objet qui se chevauche, ou lorsqu’un conteneur de texte avec une disposition à plusieurs colonnes comporte une ou plusieurs colonnes partiellement en dehors de la vue.

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 affiché hors de vue.

Voir aussi

• TextPatternRange