View.SelectText Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| SelectText(XPathNavigator) |
Selecciona el texto contenido en un control editable que está enlazado al nodo especificado por el XPathNavigator objeto pasado a este método. |
| SelectText(XPathNavigator, String) |
Selecciona el texto contenido en un control editable que está enlazado al nodo especificado por el objeto y el XPathNavigator identificador ViewContext del control. |
SelectText(XPathNavigator)
Selecciona el texto contenido en un control editable que está enlazado al nodo especificado por el XPathNavigator objeto pasado 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 -> unitPublic MustOverride Sub SelectText (xmlNode As XPathNavigator)Parámetros
- xmlNode
- XPathNavigator
Objeto que especifica el texto que se va a seleccionar.
Excepciones
Se llamó al método SelectText desde un controlador de eventos para el Loading evento.
El parámetro pasado a este método es una referencia nula (Nothing en Visual Basic).
El parámetro que se ha pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.
Ejemplos
En el ejemplo siguiente, se usa el método SelectText(xmlNode) para seleccionar el texto en field1.
// 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)
Comentarios
Si el texto especificado está enlazado a más de un control de la vista, el uso de este método SelectText producirá una excepción. Para evitarlo, debe usar el SelectText(XPathNavigator, String) método que le permite especificar el identificador ViewContext del control que contiene el texto que desea seleccionar.
Además, si el argumento del método SelectText es una referencia nula (Nothing en Visual Basic) o no está expuesto en la vista, el método SelectText también generará una excepción.
Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.
Se aplica a
SelectText(XPathNavigator, String)
Selecciona el texto contenido en un control editable que está enlazado al nodo especificado por el objeto y el XPathNavigator identificador ViewContext del control.
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 -> unitPublic MustOverride Sub SelectText (xmlNode As XPathNavigator, viewContext As String)Parámetros
- xmlNode
- XPathNavigator
Objeto que especifica el texto que se va a seleccionar.
- viewContext
- String
Identificador ViewContext del control en que se va a seleccionar texto.
Excepciones
Se llamó al método SelectText desde un controlador de eventos para el Loading evento.
Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).
Los parámetros que se han pasado a este método no son válidos. Por ejemplo, son de un tipo o formato no válido.
Ejemplos
En el ejemplo siguiente, field1 está enlazado a más de un control, uno de los cuales tiene el identificador ViewContext "CTRL2". El método SelectText(xmlnode,viewContext) se usa para seleccionar el texto de field1 del control con el 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")
Comentarios
Si el texto especificado está enlazado a más de un control de la vista, se debe proporcionar el identificador ViewContext del control en el que se va a seleccionar texto. Para determinar el identificador de ViewContext de un control, abra la plantilla de formulario en modo diseño, muestre el cuadro de diálogo Propiedades del control y, a continuación, haga clic en la pestaña Avanzadas.
Si se especifica el identificador ViewContext, el texto que se va a seleccionar debe encontrarse en ese contexto.
Si alguno de los argumentos del método SelectText es una referencia nula (Nothing en Visual Basic) o no se expone en la vista, el método SelectText también generará una excepción.
Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.