Compartilhar via

Método DataColumn.SetProperty (Visio)

  • Artigo

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

Observação

This Visio object or member is available only to licensed users of Visio Professional 2013.

Sintaxe

expressão. SetProperty (Propriedade, Valor)

Expressão Uma expressão que retorna um objeto DataColumn .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Propriedade Obrigatório VisDataColumnProperties A propriedade de coluna de dados cujo valor você deseja definir. Consulte Observações para obter valores possíveis.
Valor Obrigatório Variantes O valor a ser atribuído à propriedade de coluna de dados. Consulte Observações para obter valores possíveis.

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.

Observação

Em algumas versões anteriores do Visio, os dados da forma eram chamados de propriedades personalizadas.

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

Além disso, definir essa propriedade define o rótulo do item de dados de forma na caixa de diálogo Dados de Forma , bem como o nome da coluna de dados exibida na janela Dados Externos na interface do usuário do Visio. Essas configurações correspondem às que você pode definir na caixa de diálogo Configurações de Coluna na interface do usuário do Visio (clique com o botão direito do mouse na janela Dados Externos e clique em Configurações de Coluna), bem como aquelas que você pode fazer na caixa de diálogo Tipos e Unidades para cada coluna (clique em Tipos de Dados na caixa de diálogo Configurações de Coluna ).

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

Constant Valor Descrição
visDataColumnPropertyCalendar 3 Calendário da propriedade de coluna de dados.
visDataColumnPropertyCurrency 5 Moeda da propriedade de coluna de dados.
visDataColumnPropertyDisplayName 6 Nome para exibição da propriedade de coluna de dados na interface do usuário.
visDataColumnPropertyHyperlink 8 Se o valor da coluna de dados se tornará um hiperlink na interface do usuário do Visio quando for vinculado a uma forma.
visDataColumnPropertyLangID 2 Identificação de idioma da propriedade de coluna de dados.
visDataColumnPropertyType 1 Tipo de dados da propriedade de coluna de dados.
visDataColumnPropertyUnits 4 Unidades da propriedade de coluna de dados.
visDataColumnPropertyVisible 7 Se a propriedade de coluna de dados estará visível na interface do usuário.

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

Propriedade Coluna de Dados Número Data Moeda Duration String Booliano
Constant visPropTypeNumber visPropTypeDate visPropTypeCurrency visPropTypeDuration visPropTypeString visPropTypeBoolean
Visível Booliano Booliano Booliano Booliano Booliano Booliano
DisplayName Cadeia de caracteres Cadeia de caracteres Cadeia de caracteres Cadeia de caracteres Cadeia de caracteres Cadeia de caracteres
LangID Número LCID válido
Moeda Cadeia de caracteres válida de constantes de moeda de 3 letras conforme usada na função CY da planilha ShapeSheet do Visio.
Calendário Um dos membros do VisCellVals, dependendo do valor LangID (confira tabela abaixo).
Unidades Um dos seguintes membros de VisUnitsCodes:
  • visAcre
  • visAngleUnits
  • visCentimeters
  • visCiceros
  • visCicerosAndDidots
  • visDegreeMinSec
  • visDegrees
  • visDrawingUnits
  • visFeet
  • visFeetAndInches
  • visHectare
  • visDidots
  • visInches
  • visInchFrac
  • visKilometers
  • visMeters
  • visMileFrac
  • visMiles
  • visMillimeters
  • visMin
  • visNautMiles
  • visPageUnits
  • visPicas
  • visPicasAndPoints
  • visPoints
  • visRadians
  • visSec
  • visYards
  • visNumber (comportamento especial: essa constante torna o valor sem unidade)

OU

Cadeia de caracteres descritiva: uma cadeia de caracteres usada para unidades, como cm ou cm sq. Essa cadeia de caracteres será validada para que seja uma das unidades do Visio com suporte. Passar cadeias de caracteres inválidas causa a falha do método.		 Um dos seguintes membros de VisUnitsCodes:
  • visDurationUnits
  • visElapsedDay
  • visElapsedHour
  • visElapsedMin
  • visElapsedSec
  • visElapsedWeek

OU

Cadeia de caracteres descritiva: uma cadeia de caracteres usada para unidades como ew. Essa cadeia de caracteres será validada para ser usada como uma das unidades do Visio com suporte. Passar cadeias de caracteres inválidas causa a falha do método.
Hiperlink Boolean

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.

Idioma Hirji Ocidental Transliteração Francesa Transliteração Inglesa Lunar Hebraico Era Saka Era do Imperador Japonês Danki Coreano Budista Tailandês
Árabe (todos) x x x x
Bengla(Bangladesh) x x
Divehi x x
Inglês (todos) x x x x
Persa x x
Hebraico x x
Híndi x x
Japonês x x
Coreano x x
Caxemira (árabe) x x
Punjabi (Paquistão) x x
Pachto x x
Sindi x x
Tailandês
Urdu x x
Tamzight x x

Exemplo

A macro do Microsoft Visual Basic for Applications (VBA) a seguir mostra como usar o método GetProperty para obter o valor da célula Label na seção Dados de Forma para a primeira coluna no conjunto de registros de dados passado para o método e exibi-lo na janela Imediata. Em seguida, ele usa o método SetProperty para definir o valor e exibe 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.