DataColumn.SetProperty, méthode (Visio)

Article
04/07/2023

Définit la valeur de la propriété de colonne de données spécifiée.

Remarque

Cet objet ou ce membre Visio est disponible uniquement pour les titulaires d’une licence d’utilisation de Visio Professionnel 2013.

Syntaxe

expression. SetProperty (Property, Value)

Expression Expression qui renvoie un objet DataColumn .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Propriété	Obligatoire	VisDataColumnProperties	Propriété de colonne de données dont vous souhaitez définir la valeur. Consultez remarques pour connaître les valeurs possibles.
Valeur	Obligatoire	Variant	Valeur à laquelle attribuer la propriété de colonne de données. Consultez remarques pour connaître les valeurs possibles.

Valeur renvoyée

Aucune

Remarques

Lorsque vous liez des formes dans un dessin Microsoft Visio à des données dans un jeu d’enregistrements de données, Visio mappe des colonnes dans le jeu d’enregistrements de données à des lignes de la section Données de forme de la feuille de calcul ShapeSheet. Chacune d’entre elles correspond à un élément de données de forme.

Remarque

Dans certaines versions antérieures de Visio, les données de forme étaient appelées des propriétés personnalisées.

Les propriétés de colonne de données mappent des colonnes de données à certaines cellules de la section Données de forme de la feuille ShapeSheet. Par exemple, en passant à la méthode SetProperty une nouvelle valeur pour la propriété DisplayName , qui est représentée par la valeur énumérée visDataColumnPropertyDisplayName, vous définissez la valeur de la cellule Label dans la section Données de forme de la feuille ShapeSheet pour un élément de données de forme particulier.

En outre, la définition de cette propriété définit l’étiquette de l’élément de données de forme dans la boîte de dialogue Données de forme, ainsi que le nom de la colonne de données affichée dans la fenêtre Données externes de l’interface utilisateur de Visio. Ces paramètres correspondent à ceux que vous pouvez définir dans la boîte de dialogue Paramètres de colonne de l’interface utilisateur de Visio (cliquez avec le bouton droit dans la fenêtre Données externes, puis cliquez sur Paramètres de colonne), ainsi qu’à ceux que vous pouvez définir dans la boîte de dialogue Types et unités pour chaque colonne (cliquez sur Types de données dans la boîte de dialogue Paramètres de colonne ).

Les valeurs possibles pour le paramètre Propriétés sont déclarées dans VisDataColumnProperties. Elles apparaissent aussi dans le tableau suivant.

Constante	Valeur	Description
visDataColumnPropertyCalendar	3	Calendrier de la propriété de colonne de données.
visDataColumnPropertyCurrency	5	Devise de la propriété de colonne de données.
visDataColumnPropertyDisplayName	6	Nom complet de la propriété de colonne de données dans l'interface utilisateur.
visDataColumnPropertyHyperlink	8	Si la valeur de colonne de données devient un lien hypertexte dans l'interface utilisateur de Visio lorsqu'elle est liée à une forme.
visDataColumnPropertyLangID	2	ID de langue de la propriété de colonne de données.
visDataColumnPropertyType	1	Type de données de la propriété de colonne de données.
visDataColumnPropertyUnits	4	Unités de la propriété de colonne de données.
visDataColumnPropertyVisible	7	Si la propriété de colonne de données est visible dans l'interface utilisateur.

Les valeurs possibles pour le paramètre Valeur dépendent de la valeur du paramètre Propriété. Le tableau suivant présente les valeurs de propriété de colonne de données valides pour chaque propriété de colonne de données, en fonction du type de données de colonne de données.

Propriété Colonne de données	Nombre	Date	Devise	Durée	Chaîne	Valeur booléenne
Constante	visPropTypeNumber	visPropTypeDate	visPropTypeCurrency	visPropTypeDuration	visPropTypeString	visPropTypeBoolean
Visible	Boolean	Boolean	Boolean	Boolean	Boolean	Boolean
DisplayName	String	String	String	String	String	String
LangID	Nombre LCID valide
Devise			Chaîne de constante de devise à trois lettres valide, comme utilisé dans la fonction CY de la feuille de calcul Visio ShapeSheet.
Calendrier		Un des membres de VisCellVals, en fonction de la valeur LangID (voir le tableau ci-dessous).
Units	Un des membres suivants de VisUnitsCodes: visAcre visAngleUnits visCentimeters visCiceros visCicerosAndDidots visDegreeMinSec visDegrees visDrawingUnits visFeet visFeetAndInches visHectare visDidots visInches visInchFrac visKilomètres visMeters visMileFrac visMiles visMillimeters visMin visNautMiles visPageUnits visPicas visPicasAndPoints visPoints visRadians visSec visYards visNumber (comportement spécial : cette constante rend la valeur sans unité) OR Chaîne descriptive : chaîne utilisée pour les unités, telles que cm ou cm carré. Cette chaîne sera validée afin qu’elle soit l’une des unités Visio prises en charge. Le transfert de chaînes non valides entraîne l'échec de la méthode.			Un des membres suivants de VisUnitsCodes : visDurationUnits visElapsedDay visElapsedHour visElapsedMin visElapsedSec visElapsedWeek OR Chaîne descriptive : chaîne utilisée pour les unités telles que ew. Cette chaîne sera validée afin de constituer l'une des unités Visio prises en charge. Le passage d’une chaîne non valide entraîne l’échec de cette méthode.
Lien hypertexte					Boolean

Les propriétés LangID et Calendar sont liées par les règles de validation illustrées dans le tableau suivant. Les langues qui n'apparaissent pas utilisent le calendrier occidental uniquement.

Langue	Hirji	Occidentale	Transcription française	Transcription anglaise	Lunaire hébraïque	Saka Era	Japonais (ère impériale)	Coréen (Danki)
Tout en arabe	x	x	x	x
Bengla(Bangladesh)	x	x
Divehi	x	x
Tout en anglais	x	x			x	x
Perse	x	x
Hébreu	x				x
Hindi	x					x
Japonais		x					x
Coréen		x						x
Kachméré (arabe)	x	x
Pendjabi (Pakistan)	x	x
Pachtou	x	x
Sindhi	x	x
Thaï
Ourdou	x	x
Tamzight	x	x

Exemple

La macro Microsoft Visual Basic pour Applications (VBA) suivante montre comment utiliser la méthode GetProperty pour obtenir la valeur de la cellule Label dans la section Données de forme pour la première colonne du jeu d’enregistrements de données passé à la méthode et l’afficher dans la fenêtre Exécution. Il utilise ensuite la méthode SetProperty pour définir la valeur et affiche la nouvelle valeur. Modification de cette valeur modifie l’étiquette de l’élément de données de forme dans le données de forme boîte de dialogue de toutes les formes liées à des lignes dans le jeu d’enregistrements de données.

Pour obtenir et définir la valeur de la cellule Étiquette, la macro transmet la valeur visDataColumnPropertyDisplayName depuis l'énumération VisDataColumnProperties vers les méthodes DataColumn.GetProperty et DataColumn.SetProperty.

Avant d'exécuter cette macro, créez au moins un jeu d'enregistrements de données dans votre projet VBA pour passer à 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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via