View.SelectText Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.