Метод DataColumn.GetProperty (Visio)

Статья
04/07/2023

Возвращает значение указанного свойства data-column.

Примечание.

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

Синтаксис

expression. GetProperty (Property)

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Свойство	Обязательный	VisDataColumnProperties	Свойство столбца данных, которое требуется получить. Возможные значения см. в разделе Примечания .

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

Variant

Примечания

При связывании фигур в документе Microsoft Visio с данными в наборе записей данных Visio сопоставляет столбцы в наборе данных со строками в разделе Данные фигуры электронной таблицы ShapeSheet, каждый из которых соответствует элементу данных фигуры.

Примечание.

В некоторых предыдущих версиях Visio данные фигур назывались пользовательскими свойствами.

Свойства столбцов данных сопоставляют столбцы данных с определенными ячейками в разделе Данные фигуры таблицы фигур. Например, передав методу GetProperty свойство DisplayName , которое представлено перечисленным значением visDataColumnPropertyDisplayName, можно получить значение ячейки Метка в разделе Данные фигуры таблицы фигур для определенного элемента данных фигуры. Кроме того, это свойство задает метку элемента данных фигуры в диалоговом окне Данные фигуры , а также имя столбца данных, отображаемого в окне Внешние данные в пользовательском интерфейсе Visio.

Возможные значения для параметра Property объявлены в VisDataColumnProperties и показаны в следующей таблице.

Константа	Значение	Описание
visDataColumnPropertyCalendar	3	Календарь свойства data-column.
visDataColumnPropertyCurrency	5	Валюта свойства столбца данных.
visDataColumnPropertyDisplayName	6	Отображаемое имя свойства столбца данных в пользовательском интерфейсе.
visDataColumnPropertyHyperlink	8	Становится ли значение столбца данных гиперссылкой в пользовательском интерфейсе Visio при его связывании с фигурой.
visDataColumnPropertyLangID	2	Идентификатор языка свойства столбца данных.
visDataColumnPropertyType	1	Тип свойства столбца данных.
visDataColumnPropertyUnits	4	Единицы свойства data-column.
visDataColumnPropertyVisible	7	Отображается ли свойство data-column в пользовательском интерфейсе.

Пример

В следующем макросе Microsoft Visual Basic для приложений (VBA) показано, как с помощью метода GetProperty получить значение ячейки Метка в разделе Данные фигуры для первого столбца в наборе записей данных, переданного методу, и отобразить его в окне Интерпретация. Затем он использует метод SetProperty , чтобы задать значение и отобразить новое значение. Изменение этого значения изменяет подпись данных фигуры в диалоговом окне Данные фигуры для всех фигур, связанных со строками в наборе записей данных.

Чтобы получить и задать значение ячейки Label, макрос передает значение visDataColumnPropertyDisplayName из перечисления VisDataColumnProperties в методы DataColumn.GetProperty и DataColumn.SetProperty .

Перед выполнением этого макроса создайте в проекте VBA хотя бы один набор записей данных, который будет передаваться в макрос.

 
Public Sub GetProperty_Example(vsoDataRecordset As Visio.DataRecordset) 
    Dim strPropertyName As String 
    Dim strNewName As String 
    Dim vsoDataColumn As Visio.DataColumn 
 
    strNewName = "New Property Name" 
    Set vsoDataColumn = vsoDataRecordset.DataColumns(1) 
 
    strPropertyName = vsoDataColumn.GetProperty(visDataColumnPropertyDisplayName) 
    Debug.Print strPropertyName 
 
    vsoDataColumn.SetProperty visDataColumnPropertyDisplayName, strNewName 
    strPropertyName = vsoDataColumn.GetProperty(visDataColumnPropertyDisplayName) 
    Debug.Print strPropertyName 
End Sub

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

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

Поделиться через