Compartir a través de

Método DataColumn.SetProperty (Visio)

  • Artículo

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

expresión. SetProperty (Propiedad, Value)

Expresión Expresión que devuelve un objeto DataColumn .

Parameters

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

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 el 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 Label en la sección Datos de formas de ShapeSheet para un elemento de datos de forma 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. Esta configuración se corresponde con las que puede establecer en el cuadro de diálogo Configuración de columna de la interfaz de usuario de Visio (haga clic con el botón derecho en la ventana Datos externos y, a continuación, haga clic en Configuración de columna), así como las que puede realizar en el cuadro de diálogo Tipos y unidades para cada columna (haga clic en Tipos de datos en el cuadro de diálogo Configuración de columna ).

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 de propiedad de columna de datos válidos para cada propiedad de columna de datos, en función del tipo de datos de columna de datos.

Propiedad 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, según el valor de LangID (vea 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
  • visKilometers
  • visMeters
  • visMileFrac
  • visMiles
  • visMillimeters
  • visMin
  • visNautMiles
  • visPageUnits
  • visPicas
  • visPicasAndPoints
  • visPoints
  • visRadians
  • visSec
  • visYards
  • visNumber (comportamiento especial: esta constante hace que el valor no tenga unidad)

O

Cadena descriptiva: cadena que se usa para las unidades, como cm o sq cm. Esta cadena se validará para que sea una de las unidades de Visio admitidas. 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

O

Cadena descriptiva: cadena usada 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 usar el método GetProperty para obtener el valor de la celda Label en la sección Datos de formas de 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.