DataColumn.SetProperty-Methode (Visio)

Artikel
04/07/2023

Legt den Wert der angegebenen Datenspalteneigenschaft fest.

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.

Syntax

Ausdruck. SetProperty (Eigenschaft, Wert)

Ausdruck Ein Ausdruck, der ein DataColumn-Objekt zurückgibt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Eigenschaft	Erforderlich	VisDataColumnProperties	Die Datenspalteneigenschaft, deren Wert Sie festlegen möchten. Mögliche Werte finden Sie in den Hinweisen .
Wert	Erforderlich	Variant	Der Wert, der der Datenspalteneigenschaft zugewiesen werden soll. Mögliche Werte finden Sie in den Hinweisen .

Rückgabewert

Nichts

Bemerkungen

Wenn Sie Shapes in einer Microsoft Visio-Zeichnung mit Daten in einem Datenrecordset verknüpfen, ordnet Visio die Spalten im Datenrecordset den entsprechenden Zeilen im Abschnitt Shape-Daten der ShapeSheet-Kalkulationstabelle zu. Beide entsprechen einem Shape-Datenelement.

Hinweis

In einigen früheren Versionen von Visio wurden die Shape-Daten als benutzerdefinierte Eigenschaften bezeichnet.

Datenspalteneigenschaften ordnen Datenspalten bestimmten Zellen im Abschnitt Shape Data des ShapeSheets zu. Indem Sie beispielsweise der SetProperty-Methode einen neuen Wert für die DisplayName-Eigenschaft übergeben, die durch den Aufzählungswert visDataColumnPropertyDisplayName dargestellt wird, legen Sie den Wert der Zelle Label im Abschnitt Shape Data des ShapeSheet für ein bestimmtes Shape-Datenelement fest.

Darüber hinaus legt das Festlegen dieser Eigenschaft die Bezeichnung des Shape-Datenelements im Dialogfeld Shape-Daten sowie den Namen der Datenspalte fest, die im Fenster Externe Daten auf der Visio-Benutzeroberfläche angezeigt wird. Diese Einstellungen entsprechen den Einstellungen, die Sie im Dialogfeld Spalteneinstellungen auf der Visio-Benutzeroberfläche festlegen können (klicken Sie mit der rechten Maustaste auf das Fenster Externe Daten, und klicken Sie dann auf Spalteneinstellungen), sowie den Einstellungen, die Sie im Dialogfeld Typen und Einheiten für jede Spalte festlegen können (klicken Sie im Dialogfeld Spalteneinstellungen auf Datentypen).

Mögliche Werte für den Property-Parameter werden in VisDataColumnProperties deklariert und in der folgenden Tabelle angezeigt.

Konstante	Wert	Beschreibung
visDataColumnPropertyCalendar	3	Kalender der Datenspalteneigenschaft
visDataColumnPropertyCurrency	5	Währung der Datenspalteneigenschaft
visDataColumnPropertyDisplayName	6	Anzeigename der Datenspalteneigenschaft auf der Benutzeroberfläche
visDataColumnPropertyHyperlink	8	Ob der Datenspaltenwert beim Verknüpfen mit einem Shape auf der Benutzeroberfläche von Visio zu einem Hyperlink wird
visDataColumnPropertyLangID	2	Sprachen-ID der Datenspalteneigenschaft
visDataColumnPropertyType	1	Datentyp der Datenspalteneigenschaft
visDataColumnPropertyUnits	4	Einheiten der Datenspalteneigenschaft
visDataColumnPropertyVisible	7	Ob die Datenspalteneigenschaft auf der Benutzeroberfläche angezeigt wird

Mögliche Werte für den Value-Parameter hängen vom Wert des Property-Parameters ab. In der folgenden Tabelle sind gültige Datenspalteneigenschaftswerte für jede Datenspalteneigenschaft aufgeführt, je nach Datentyp der Datenspalte.

Data Column-Eigenschaft	Zahl	Datum	Währung	Dauer	String	Boolesch
Konstante	visPropTypeNumber	visPropTypeDate	visPropTypeCurrency	visPropTypeDuration	visPropTypeString	visPropTypeBoolean
Visible	Boolescher Wert	Boolescher Wert	Boolescher Wert	Boolescher Wert	Boolescher Wert	Boolescher Wert
DisplayName	String	String	String	String	String	String
Langid	Gültige LCID-Nummer
Währung			Gültige Zeichenfolge aus drei Buchstaben für die Währungskonstante, wie sie in der CY-Funktion in der ShapeSheet-Kalkulationstabelle von Visio verwendet wird.
Kalender		Eines der Member von VisCellVals, abhängig vom LangID-Wert (siehe Tabelle unten).
Units	Eines der folgenden Elemente von VisUnitsCodes: visAcre visAngleUnits VisCentimeter visCiceros visCicerosAndDidots visDegreeMinSec visDegrees visDrawingUnits VisFeet visFeetAndInches visHectare visDidots visInches visInchFrac visKilometers visMeter visMileFrac visMiles visMillimeter visMin visNautMiles visPageUnits visPicas visPicasAndPoints VisPoints visRadians visSec visYards visNumber (spezielles Verhalten: Diese Konstante macht den Wert unitlos) ODER Beschreibende Zeichenfolge: Eine Zeichenfolge, die für Einheiten verwendet wird, z. B. cm oder sq cm. Diese Zeichenfolge wird überprüft, sodass sie eine der unterstützten Visio-Einheiten ist. Werden ungültige Zeichenfolgen übergeben, schlägt die Methode fehl.			Eines der folgenden Elemente von VisUnitsCodes: visDurationUnits visElapsedDay visElapsedHour visElapsedMin visElapsedSec visElapsedWeek ODER Beschreibende Zeichenfolge: Eine Zeichenfolge, die für Einheiten wie ew verwendet wird. Diese Zeichenfolge wird validiert, sodass sie zu den von Visio unterstützten Einheiten wird. Wird eine ungültige Zeichenfolge übergeben, schlägt die Methode fehl.
Hyperlink					Boolean

Die Eigenschaften Sprachen-ID und Kalender sind an die Validierungsregeln der folgenden Tabelle geknüpft. Nicht angezeigte Sprachen verwenden nur den westlichen Kalender.

Sprache	Hirji	Western	Französisch transkribiert	Englisch transkribiert	Hebräischer Mondkalender	Indischer Kalender	Japan: Ära des Kaisers	Koreanisch Danki
Alle arabischen Sprachen	x	x	x	x
Bengla(Bangladesch)	x	x
Divehi	x	x
Alle englischen Sprachen	x	x			x	x
Persisch	x	x
Hebräisch	x				x
Hindi	x					x
Japanisch		x					x
Koreanisch		x						x
Kashmiri (Arabisch)	x	x
Punjabi (Pakistan)	x	x
Paschtu	x	x
Sindhi	x	x
Thailändisch
Urdu	x	x
Tamzight	x	x

Beispiel

Das folgende VBA-Makro (Microsoft Visual Basic for Applications) zeigt, wie sie die GetProperty-Methode verwenden, um den Wert der Zelle Label im Abschnitt Shape Data für die erste Spalte im Datenrecordset abzurufen, das an die Methode übergeben wird, und ihn im Direktfenster anzuzeigen. Anschließend wird die SetProperty-Methode verwendet, um den Wert festzulegen, und der neue Wert wird angezeigt. Indem dieser Wert geändert wird, wird die Bezeichnung des Shape-Datenelements für alle mit Zeilen im Datensatz verknüpfte Shapes im Dialogfeld Shape-Daten geändert.

Zum Abrufen und Festlegen des Zellenwerts Label übergibt das Makro den visDataColumnPropertyDisplayName-Wert aus der VisDataColumnProperties-Enumeration an die Methoden DataColumn.GetProperty und DataColumn.SetProperty .

Erstellen Sie vor dem Ausführen des Makros mindestens ein Datenrecordset im VBA-Projekt, um das Makro zu übergeben.

 
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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über