TextPattern.GetVisibleRanges Método

Definição

Recupera uma matriz de intervalos de texto não contíguos de um contêiner de texto em que cada intervalo de texto começa com a primeira linha parcialmente visível até o final da última linha parcialmente visível.Retrieves an array of disjoint text ranges from a text container where each text range begins with the first partially visible line through to the end of the last partially visible line.

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()

Retornos

A coleção de intervalos de texto visíveis dentro do contêiner ou de uma matriz vazia.The collection of visible text ranges within the container or an empty array. Null nunca é retornado.Null is never returned.

Exemplos

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

Comentários

Os intervalos de texto não contíguos podem ocorrer quando qualquer conteúdo de um contêiner de texto é obscurecido por uma janela sobreposta ou outro objeto, ou quando um contêiner de texto com um layout de várias colunas tem uma ou mais colunas roladas parcialmente da exibição.Disjoint text ranges may occur when any content of a text container is obscured by an overlapping window or other object, or when a text container with a multi-column layout has one or more columns partially scrolled out of view.

Se nenhum texto estiver visível, um intervalo de texto degenerado (vazio) será retornado.If no text is visible, a degenerate (empty) text range is returned. Esse intervalo vazio pode ser retornado se o contêiner de texto estiver vazio ou quando todo o texto for rolado para fora da exibição.This empty range can be returned if the text container is empty or when all text is scrolled out of view.

Aplica-se a

Veja também