Метод Selection.LinkToData (Visio)

Статья
04/07/2023

Связывает выбранные фигуры с одной строкой данных в наборе записей данных.

Примечание.

Этот объект или элемент Visio доступен только лицензированным пользователям Visio профессиональный 2013.

Синтаксис

выражение. LinkToData( _DataRecordsetID_ , _DataRowID_ , _AutoApplyDataGraphics_ )

Выражение Выражение, возвращающее объект Selection .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
DataRecordsetID	Обязательный	Long	Идентификатор набора записей данных, содержащего данные для связывания.
DataRowID	Обязательный	Long	Идентификатор строки в наборе записей данных, содержащей конкретную запись данных, с ней необходимо связать.
AutoApplyDataGraphics	Необязательный	Логический	Следует ли автоматически применять рисунок данных к связанным фигурам. Дополнительные сведения см. в разделе Примечания.

Возвращаемое значение

Отсутствует

Примечания

Метод Selection.LinkToData работает аналогично тому же методу объекта Shape , Shape.LinkToData, за исключением того, что он связывает выбор фигур, а не одну фигуру с одной строкой данных.

Если Visio не удается установить связь между фигурой и строкой данных, Visio пропускает ее и переходит к следующей фигуре в выделенном фрагменте. После выполнения метода, чтобы определить, связаны ли все фигуры в выделенном фрагменте со строкой данных, вызовите метод Shape.GetLinkedDataRow для каждой фигуры в выделенном фрагменте. Если этот метод завершается ошибкой для любой фигуры, это означает, что фигура не связана со строкой данных. Visio обычно успешно связывает строку с фигурой, если только фигура не связана с данными, а параметр link-replace-behavior для набора записей данных указывает, что ссылка не должна быть заменена.

Если передать значение True для параметра AutoApplyDataGraphics, Visio повторно применит существующий рисунок данных к фигурам, к которым уже применена графика данных до вызова метода . Для фигур, у которой ранее не было графических данных, Visio применяет рисунок данных, который последний раз применялся к любой другой фигуре в текущем документе.

Пример

В следующем макросе Microsoft Visual Basic для приложений (VBA) показано, как использовать метод LinkToData для связывания фигур в выделенном фрагменте со строкой данных.

Перед выполнением этого макроса разместите несколько фигур на странице и добавьте по крайней мере один набор записей данных в коллекцию DataRecordsets документа. Макрос использует идентификатор набора записей данных, недавно добавленного в коллекцию. Он связывает выбранные фигуры с данными в первой строке набора записей данных.

Public Sub LinkToData_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim vsoSelection As Visio.Selection 
    Dim intCount As Integer 
     
    intCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intCount) 
     
    ActiveWindow.DeselectAll 
    ActiveWindow.SelectAll 
     
    Set vsoSelection = ActiveWindow.Selection 
    vsoSelection.LinkToData vsoDataRecordset.ID, 1, True 
 
End Sub

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.