View.SelectText Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
SelectText(XPathNavigator) |
Sélectionne le texte contenu dans un contrôle modifiable lié au nœud spécifié par l’objet XPathNavigator passé à cette méthode. |
SelectText(XPathNavigator, String) |
Sélectionne le texte contenu dans un contrôle modifiable lié au nœud spécifié par l’objet et l’identificateur XPathNavigatorViewContext du contrôle. |
SelectText(XPathNavigator)
Sélectionne le texte contenu dans un contrôle modifiable lié au nœud spécifié par l’objet XPathNavigator passé à cette méthode.
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)
Paramètres
- xmlNode
- XPathNavigator
Objet qui spécifie le texte à sélectionner.
Exceptions
La méthode SelectText a été appelée à partir d’un gestionnaire d’événements pour l’événement Loading .
Le paramètre passé à cette méthode est une référence null (Nothing en Visual Basic).
Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect.
Exemples
Dans l’exemple suivant, la méthode SelectText(xmlNode
) est utilisée pour sélectionner le texte dans 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)
Remarques
Si le texte spécifié est lié à plusieurs contrôles dans la vue, cette méthode SelectText génère une exception. Pour éviter cela, vous devez utiliser la SelectText(XPathNavigator, String) méthode qui vous permet de spécifier l’identificateur ViewContext du contrôle qui contient le texte que vous souhaitez sélectionner.
En outre, si l’argument de la méthode SelectText est une référence Null (Nothing en Visual Basic) ou n’est pas exposé dans la vue, la méthode SelectText lève également une exception.
Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.
Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.
S’applique à
SelectText(XPathNavigator, String)
Sélectionne le texte contenu dans un contrôle modifiable lié au nœud spécifié par l’objet et l’identificateur XPathNavigatorViewContext du contrôle.
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)
Paramètres
- xmlNode
- XPathNavigator
Objet qui spécifie le texte à sélectionner.
- viewContext
- String
L’identificateur ViewContext du contrôle dans lequel sélectionner du texte.
Exceptions
La méthode SelectText a été appelée à partir d’un gestionnaire d’événements pour l’événement Loading .
Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).
Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.
Exemples
Dans l’exemple suivant, field1 est lié à plusieurs contrôles, l’un d’entre eux doté de l’identificateur ViewContext « CTRL2 ». La méthode SelectText(xmlnode
,viewContext
) est utilisée pour sélectionner le texte dans field1 à partir du contrôle avec l’identificateur ViewContext « 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")
Remarques
Si la plage spécifiée de nœuds est liée à plusieurs contrôles dans la vue, vous devez fournir l’identificateur ViewContext du contrôle pour sélectionner du texte. Vous pouvez déterminer l’identificateur ViewContext d’un contrôle en ouvrant le modèle de formulaire en mode Création, en affichant la boîte de dialogue Propriétés du contrôle, puis en cliquant sur l’onglet Avancé.
Lorsque l’identificateur ViewContext est spécifié, le texte à sélectionner doit se trouver dans ce contexte.
Si l’un des arguments de la méthode SelectText est une référence Null (Nothing en Visual Basic) ou n’est pas exposé dans la vue, la méthode SelectText lève également une exception.
Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.
Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.