Compartilhar via


View.SelectText Método

Definição

Sobrecargas

SelectText(XPathNavigator)

Seleciona o texto contido em um controle editável que está associado ao nó especificado pelo XPathNavigator objeto passado para esse método.

SelectText(XPathNavigator, String)

Seleciona o texto contido em um controle editável que está associado ao nó especificado pelo objeto e pelo XPathNavigatoridentificador ViewContext do controle.

SelectText(XPathNavigator)

Seleciona o texto contido em um controle editável que está associado ao nó especificado pelo XPathNavigator objeto passado para esse método.

public:
 abstract void SelectText(System::Xml::XPath::XPathNavigator ^ xmlNode);
public abstract void SelectText (System.Xml.XPath.XPathNavigator xmlNode);
abstract member SelectText : System.Xml.XPath.XPathNavigator -> unit
Public MustOverride Sub SelectText (xmlNode As XPathNavigator)

Parâmetros

xmlNode
XPathNavigator

Um objeto que especifica o texto a ser selecionado.

Exceções

O método SelectText foi chamado de um manipulador de eventos para o Loading evento.

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

Exemplos

No exemplo a seguir, o método SelectText(xmlNode) é usado para selecionar o texto no campo1.

// Create XPathNavigator and select field.
XPathNavigator textNode = 
   CreateNavigator().SelectSingleNode(
   "/my:myFields/my:field1", NamespaceManager);

// Select text in specified field.
CurrentView.SelectText(textNode);
' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
   CreateNavigator().SelectSingleNode( _
   "/my:myFields/my:field1", NamespaceManager)

' Select text in specified field.
CurrentView.SelectText(textNode)

Comentários

Se o texto especificado estiver associado a mais de um controle no modo de exibição, o uso desse método SelectText gerará uma exceção. Para evitar isso, você deve usar o SelectText(XPathNavigator, String) método que permite especificar o identificador ViewContext do controle que contém o texto que você deseja selecionar.

Além disso, se o argumento para o método SelectText for uma referência nula (Nada no Visual Basic) ou não estiver exposto no modo de exibição, o método SelectText também gerará uma exceção.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

SelectText(XPathNavigator, String)

Seleciona o texto contido em um controle editável que está associado ao nó especificado pelo objeto e pelo XPathNavigatoridentificador ViewContext do controle.

public:
 abstract void SelectText(System::Xml::XPath::XPathNavigator ^ xmlNode, System::String ^ viewContext);
public abstract void SelectText (System.Xml.XPath.XPathNavigator xmlNode, string viewContext);
abstract member SelectText : System.Xml.XPath.XPathNavigator * string -> unit
Public MustOverride Sub SelectText (xmlNode As XPathNavigator, viewContext As String)

Parâmetros

xmlNode
XPathNavigator

Um objeto que especifica o texto a ser selecionado.

viewContext
String

O identificador ViewContext para o controle no qual selecionar texto.

Exceções

O método SelectText foi chamado de um manipulador de eventos para o Loading evento.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

Exemplos

No exemplo a seguir, o field1 está associado a mais de um controle, um dos quais tem o identificador ViewContext de "CTRL2". O método SelectText(xmlnode,viewContext) é usado para selecionar o texto no campo1 no controle com o identificador ViewContext de "CTRL2".

// Create XPathNavigator and select field.
XPathNavigator textNode = 
   CreateNavigator().SelectSingleNode(
   "/my:myFields/my:field1", NamespaceManager);

// Select text in specified field.
CurrentView.SelectText(textNode, "CTRL2");
' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
   CreateNavigator().SelectSingleNode( _
   "/my:myFields/my:field1", NamespaceManager)

' Select text in specified field.
CurrentView.SelectText(textNode, "CTRL2")

Comentários

Se o texto especificado estiver vinculado a mais de um controle no modo de exibição, você deverá fornecer o identificador ViewContext do controle para selecionar texto. Você pode determinar o identificador ViewContext para um controle abrindo o modelo de formulário no modo Design, exibindo a caixa de diálogo Propriedades do controle e clicando na guia Avançado.

Quando o identificador ViewContext é especificado, o texto que deve ser selecionado deve estar dentro desse contexto.

Se algum dos argumentos para o método SelectText for uma referência nula (Nada no Visual Basic) ou não estiver exposto na exibição, o método SelectText também gerará uma exceção.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a