View.SelectText Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Sobrecargas

SelectText(XPathNavigator)	Seleciona o texto contido num controlo editável vinculado ao nó especificado pelo XPathNavigator objeto transmitido a este método.
SelectText(XPathNavigator, String)	Seleciona o texto contido num controlo editável vinculado ao nó especificado pelo objeto e pelo XPathNavigator identificador ViewContext do controlo.

SelectText(XPathNavigator)

Seleciona o texto contido num controlo editável vinculado ao nó especificado pelo XPathNavigator objeto transmitido a este 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 selecionar.

Exceções

InvalidOperationException

O método SelectText foi chamado a partir de um processador de eventos para o Loading evento.

ArgumentNullException

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

ArgumentException

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

Exemplos

No exemplo seguinte, o método SelectText(xmlNode) é utilizado 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 vinculado a mais do que um controlo na vista, a utilização deste método SelectText gerará uma exceção. Para evitar esta situação, tem de utilizar o SelectText(XPathNavigator, String) método que lhe permite especificar o identificador ViewContext do controlo que contém o texto que pretende 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 na vista, 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.

SelectText(XPathNavigator, String)

Seleciona o texto contido num controlo editável vinculado ao nó especificado pelo objeto e pelo XPathNavigator identificador ViewContext do controlo.

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 selecionar.

viewContext

String

O identificador ViewContext do controlo no qual pretende selecionar texto.

Exceções

InvalidOperationException

O método SelectText foi chamado a partir de um processador de eventos para o Loading evento.

ArgumentNullException

Os parâmetros transmitidos a este método são uma referência nula (Nada no Visual Basic).

ArgumentException

Os parâmetros transmitidos a este método não são válidos. Por exemplo, são do tipo ou formato errados.

Exemplos

No exemplo seguinte, o campo1 está vinculado a mais do que um controlo, um dos quais tem o identificador ViewContext de "CTRL2". O método SelectText(xmlnode,viewContext) é utilizado para selecionar o texto no campo1 no controlo 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 do que um controlo na vista, tem de fornecer o identificador ViewContext do controlo a partir do qual selecionar texto. Pode determinar o identificador ViewContext de um controlo ao abrir o modelo de formulário no modo Estrutura, ao apresentar a caixa de diálogo Propriedades do controlo e, em seguida, ao clicar no separador Avançadas.

Quando o identificador ViewContext é especificado, o texto a selecionar tem de estar nesse 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 vista, 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.