View.SelectText Метод

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

Перегрузки

SelectText(XPathNavigator)	Выделяет текст, содержащийся в редактируемом элементе управления, привязанном к узлу, указанному XPathNavigator объектом, переданным этому методу.
SelectText(XPathNavigator, String)	Выделяет текст, содержащийся в редактируемом элементе управления, привязанном к узлу, указанному XPathNavigator объектом и идентификатором ViewContext элемента управления.

SelectText(XPathNavigator)

Выделяет текст, содержащийся в редактируемом элементе управления, привязанном к узлу, указанному XPathNavigator объектом, переданным этому методу.

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)

Параметры

xmlNode

XPathNavigator

Объект, указывающий текст для выбора.

Исключения

InvalidOperationException

Метод SelectText был вызван из обработчика событий для Loading события.

ArgumentNullException

Параметр, передаваемый этому методу, является пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу передан недопустимый параметр. Например, неправильный тип или формат.

Примеры

В следующем примере метод SelectText(xmlNode) используется для выделения текста в поле 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)

Комментарии

Если указанный текст привязан к нескольким элементам управления в представлении, использование этого метода SelectText вызовет исключение. Чтобы избежать этого, необходимо использовать SelectText(XPathNavigator, String) метод , позволяющий указать идентификатор ViewContext элемента управления, содержащего текст, который требуется выделить.

Кроме того, если аргумент метода SelectText является пустой ссылкой (Nothing в Visual Basic) или не предоставляется в представлении, метод SelectText также вызовет исключение.

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.

SelectText(XPathNavigator, String)

Выделяет текст, содержащийся в редактируемом элементе управления, привязанном к узлу, указанному XPathNavigator объектом и идентификатором ViewContext элемента управления.

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)

Параметры

xmlNode

XPathNavigator

Объект, указывающий текст для выбора.

viewContext

String

Идентификатор ViewContext для элемента управления, где будет выбран текст.

Исключения

InvalidOperationException

Метод SelectText был вызван из обработчика событий для Loading события.

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу переданы недопустимые параметры. Например, неправильный тип или формат.

Примеры

В следующем примере элемент field1 привязан к нескольким элементам управления, один из которых имеет идентификатор ViewContext "CTRL2". Метод SelectText(xmlnode,viewContext) используется для выделения текста в поле1 из элемента управления с идентификатором 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")

Комментарии

Если указанный текст привязан к нескольким элементам управления в представлении, необходимо предоставить идентификатор ViewContext элемента управления, в котором будет выбран текст. Идентификатор ViewContext для элемента управления можно определить, открыв шаблон формы в режиме конструктора, открыв диалоговое окно Свойства элемента управления, а затем щелкнув вкладку Дополнительно.

Если указан идентификатор ViewContext, текст, который требуется выбрать, должен находиться внутри этого контекста.

Если какой-либо из аргументов метода SelectText является пустой ссылкой (Nothing в Visual Basic) или не предоставляется в представлении, метод SelectText также вызовет исключение.

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.