Método DataColumn.SetProperty (Visio)

Define o valor da da propriedade de coluna de dados especificada.

Sintaxe

expressão. SetProperty (Propriedade, Valor)

expressão Uma expressão que devolve um objeto DataColumn .

Parâmetros

Valor de retorno

Nada

Comentários

Quando você vincula as formas de um desenho do Microsoft Visio aos dados de um conjunto de registros de dados, o Visio mapeia as colunas do conjunto de registros de dados para as linhas na seção Shape Data da planilha ShapeSheet, com cada uma correspondendo a um item de dados da forma.

As propriedades de coluna de dados mapeiam as colunas de dados para determinadas células na seção Shape Data do ShapeSheet. Por exemplo, ao transmitir ao método SetProperty um novo valor para a propriedade DisplayName , que é representada pelo valor enumerado visDataColumnPropertyDisplayName, define o valor da célula Etiqueta na secção Dados da Forma da ShapeSheet para um item de dados de forma específico.

Além disso, definir essa propriedade define a etiqueta do item de dados da forma na caixa de diálogo Dados da Forma , bem como o nome da coluna de dados que é apresentada na janela Dados Externos na interface de utilizador do Visio. Estas definições correspondem às que pode definir na caixa de diálogo Definições de Coluna na interface de utilizador do Visio (clique com o botão direito do rato na janela Dados Externos e, em seguida, clique em Definições de Coluna), bem como aquelas que pode criar na caixa de diálogo Tipos e Unidades para cada coluna (clique em Tipos de Dados na caixa de diálogo Definições da Coluna ).

Os valores possíveis para o parâmetro Property são declarados em VisDataColumnProperties e mostrados na tabela a seguir.

Os valores possíveis para o parâmetro Value dependem do valor do parâmetro Property. A tabela seguinte mostra valores de propriedade de coluna de dados válidos para cada propriedade de coluna de dados, consoante o tipo de dados da coluna de dados.

As propriedades LangID e Calendar estão ligadas pelas regras de validação mostradas na tabela a seguir. Os idiomas não exibidos usam somente o calendário ocidental.

Exemplo

A seguinte macro do Microsoft Visual Basic for Applications (VBA) mostra como utilizar o método GetProperty para obter o valor da célula Etiqueta na secção Dados da Forma para a primeira coluna no conjunto de registos de dados transmitido ao método e apresentá-lo na janela Imediato. Em seguida, utiliza o método SetProperty para definir o valor e apresenta o novo valor. A alteração desse valor modifica o rótulo do item de dados da forma na caixa de diálogo Dados da Forma de todas as formas vinculadas às linhas no conjunto de registros de dados.

Para obter e definir o valor da célula Label, a macro passa o valor visDataColumnPropertyDisplayName da enumeração VisDataColumnProperties para os métodos DataColumn.GetProperty e DataColumn.SetProperty.

Antes de executar essa macro, crie pelo menos um conjunto de registros de dados em seu projeto VBA para passar para a macro.

 
Public Sub SetProperty_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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.