TextPattern.GetVisibleRanges Método

Definição

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

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.

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

TextPatternRange[]

A coleção de intervalos de texto visíveis dentro do contêiner ou de uma matriz vazia. Null nunca é retornado.

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

Intervalos de texto desarticulados 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 parcialmente roladas para fora da exibição.

Se nenhum texto estiver visível, um intervalo de texto degenerado (vazio) será retornado. Esse intervalo vazio poderá ser retornado se o contêiner de texto estiver vazio ou quando todo o texto for rolado para fora do modo de exibição.

Confira também

• TextPatternRange