Método DataColumn.SetProperty (Visio)

Establece el valor de la propiedad de columna de datos especificada.

Nota:

Este objeto o miembro Visio solo se encuentra disponible para los usuarios con licencia de Visio Professional 2013.

Sintaxis

más sencilla.SetProperty (propiedad, valor)

expresión Una expresión que devuelve un objeto DataColumn .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Propiedad Obligatorio VisDataColumnProperties La propiedad de la columna de datos cuyo valor desea establecer. Vea Comentarios para ver los posibles valores.
Valor Obligatorio Variant Valor que se va a asignar a la propiedad de columna de datos. Vea Comentarios para ver los posibles valores.

Valor devuelto

Nothing

Comentarios

Al vincular formas de un dibujo de Microsoft Visio con datos de un conjunto de registros de datos, Visio asigna columnas del conjunto de registros de datos a las filas de la sección Datos de formas de la hoja de cálculo ShapeSheet, cada una de las cuales se corresponde con un elemento de datos de formas.

Nota:

En algunas versiones anteriores de Visio, los datos de formas se denominaban propiedades personalizadas.

Las propiedades de columnas de datos asignan columnas de datos a algunas celdas de la sección Datos de formas de ShapeSheet. Por ejemplo, al pasar al método SetProperty un nuevo valor para la propiedad DisplayName , que se representa mediante el valor enumerado visDataColumnPropertyDisplayName, se establece el valor de la celda Etiqueta en la sección Datos de formas de ShapeSheet para un elemento de datos de formas determinado.

Además, al establecer esa propiedad, se establece la etiqueta del elemento de datos de forma en el cuadro de diálogo Datos de formas , así como el nombre de la columna de datos que se muestra en la ventana Datos externos de la interfaz de usuario de Visio. Estos valores corresponden a los que puede establecer en el cuadro de diálogo Configuración de columnas de la interfaz de usuario de Visio (haga clic con el botón derecho en la ventana Datos externos y, después, haga clic en Configuración de columnas), así como a los que puede realizar en el cuadro de diálogo Tipos y unidades de cada columna (haga clic en Tipos de datos en el cuadro de diálogo Configuración de columnas ).

Los posibles valores del parámetro Property se declaran en VisDataColumnProperties y se muestran en la siguiente tabla.

Constante Valor Descripción
visDataColumnPropertyCalendar 3 Calendario de la propiedad de columna de datos.
visDataColumnPropertyCurrency 5 Moneda de la propiedad de columna de datos.
visDataColumnPropertyDisplayName 6 Nombre para mostrar de la propiedad de columna de datos de la IU.
visDataColumnPropertyHyperlink 8 Si el valor de la columna de datos se convierte en un hipervínculo de la IU de Visio cuando se vincula a una forma.
visDataColumnPropertyLangID 2 Identificador de idioma de la propiedad de columna de datos.
visDataColumnPropertyType 1 Tipo de datos de la propiedad de columna de datos.
visDataColumnPropertyUnits 4 Unidades de la propiedad de columna de datos.
visDataColumnPropertyVisible 7 Si la propiedad de columna de datos se ve en la IU.

Los posibles valores del parámetro Value dependen del valor del parámetro Property. En la tabla siguiente se muestran valores válidos de propiedad de columna de datos para cada propiedad de columna de datos, en función del tipo de datos de columna de datos.

Propiedad de columna de datos Número Fecha Divisa Duración String Booleano
Constante visPropTypeNumber visPropTypeDate visPropTypeCurrency visPropTypeDuration visPropTypeString visPropTypeBoolean
Visible Boolean Boolean Boolean Boolean Boolean Boolean
DisplayName String String String String String String
LangID Valid LCID number
Moneda Cadena de constante de moneda de 3 letras válida usada como la función CY de la hoja de cálculo ShapeSheet de Visio.
Calendario Uno de los miembros de VisCellVals, dependiendo del valor LangID (consulte la tabla siguiente).
Units Uno de los siguientes miembros de VisUnitsCodes:
  • visAcre
  • visAngleUnits
  • visCentimeters
  • visCiceros
  • visCicerosAndDidots
  • visDegreeMinSec
  • visDegrees
  • visDrawingUnits
  • visFeet
  • visFeetAndInches
  • visHectare
  • visDidots
  • visInches
  • visInchFrac
  • visKilómetros
  • VisMeters
  • visMileFrac
  • visMiles
  • visMilímetros
  • visMin
  • visNautMiles
  • visPageUnits
  • visPicas
  • visPicasAndPoints
  • visPoints
  • visRadians
  • visSec
  • visYards
  • visNumber (comportamiento especial: esta constante hace que el valor no tenga unidades)

OR

Cadena descriptiva: una cadena utilizada para unidades, como cm o cm cuadrado. Esta cadena se validará para que sea una de las unidades de Visio compatibles. Si se pasan cadenas no válidas, se produce un error del método.		 Uno de los siguientes miembros de VisUnitsCodes:
  • visDurationUnits
  • visElapsedDay
  • visElapsedHour
  • visElapsedMin
  • visElapsedSec
  • visElapsedWeek

OR

Cadena descriptiva: una cadena que se usa para unidades como ew. Esta cadena se validará para que sea una de las unidades que admite Visio. Si se pasa una cadena no válida, se produce un error de este método.
Hipervínculo Boolean

Las propiedades LangID y Calendar se enlazan mediante las reglas de validación mostradas en la siguiente tabla. Los idiomas que no se muestran usan sólo el calendario occidental.

Idioma Hirji Occidental Transliteración al francés Transliteración al inglés Hebreo lunar Saka Era del emperador japonés Danki coreano Budista tailandés
Todos los tipos de árabe x x x x
Bengla (Bangladesh) x x
Divehi x x
Todos los tipos de inglés x x x x
Persa x x
Hebreo x x
Hindi x x
Japonés x x
Coreano x x
Cachemir (árabe) x x
Punjabi (Pakistán) x x
Pashto x x
Sindhi x x
Tailandés
Urdu x x
Tamzight x x

Ejemplo

La siguiente macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo utilizar el método GetProperty para obtener el valor de la celda Etiqueta de la sección de datos de formas para la primera columna del conjunto de registros de datos pasado al método y mostrarlo en la ventana Inmediato. A continuación, usa el método SetProperty para establecer el valor y muestra el nuevo valor. Si se cambia este valor, se cambia la etiqueta del elemento de datos de formas del cuadro de diálogo Datos de formas de todas las formas vinculadas a las filas del conjunto de registros de datos.

Para obtener y establecer el valor de la celda Etiqueta, la macro pasa el valor visDataColumnPropertyDisplayName desde la enumeración VisDataColumnProperties a los métodos DataColumn.GetProperty y DataColumn.SetProperty.

Antes de ejecutar esta macro, cree al menos un conjunto de registros de datos en el proyecto de VBA para pasar a la 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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.

  • Last updated on