DataColumn.SetProperty-Methode (Visio)

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 verwendet werden. SetProperty (Property, Value)

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. Siehe Hinweise zu möglichen Werten.
Wert Erforderlich Variant Der Wert, der der Datenspalteneigenschaft zugewiesen werden soll. Siehe Hinweise zu möglichen Werten.

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-Daten" des ShapeSheet zu. Indem Sie beispielsweise der SetProperty-Methode einen neuen Wert für die DisplayName-Eigenschaft übergeben, der durch den Aufzählungswert visDataColumnPropertyDisplayName dargestellt wird, legen Sie den Wert der Zelle "Label" im Abschnitt "Shape-Daten" des ShapeSheets für ein bestimmtes Shape-Datenelement fest.

Darüber hinaus wird durch Festlegen dieser Eigenschaft die Beschriftung des Shape-Datenelements im Dialogfeld Shape-Daten sowie der Name der Datenspalte festgelegt, die im Fenster "Externe Daten" in der Visio-Benutzeroberfläche angezeigt wird. Diese Einstellungen entsprechen denen, die Sie im Dialogfeld Spalteneinstellungen in der Visio-Benutzeroberfläche festlegen können (klicken Sie mit der rechten Maustaste in das Fenster Externe Daten, und klicken Sie dann auf Spalteneinstellungen), sowie denen, die Sie im Dialogfeld Typen und Einheiten für jede Spalte vornehmen 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 Parameter Value hängen vom Wert des Property-Parameters ab. Die folgende Tabelle zeigt gültige Werte von Datenspalteneigenschaften für jede Datenspalteneigenschaft, abhängig vom Datentyp der Datenspalte.

Eigenschaft "Datenspalte" Zahl Datum Währung Dauer Zeichenfolge Boolean
Konstante visPropTypeNumber visPropTypeDate visPropTypeCurrency visPropTypeDuration visPropTypeString visPropTypeBoolescher Wert
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 Mitglieder von VisCellVals, abhängig vom LangID-Wert (siehe Tabelle unten).
Units Eines der folgenden Elemente von 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 (spezielles Verhalten: diese Konstante macht den Wert einheitenlos)

OR

Beschreibende Zeichenfolge: Eine Zeichenfolge, die für Einheiten wie cm oder cm² verwendet wird. 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

OR

Descriptive string: 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 Thai Buddhistisch
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
Thai
Urdu x x
Tamzight x x

Beispiel

Das folgende Microsoft Visual Basic for Applications (VBA)-Makro zeigt, wie Sie mit der GetProperty-Methode den Wert der Zelle "Label" im Abschnitt "Shape-Daten" für die erste Spalte im an die Methode übergebenen Datenrecordset abrufen und im Direktfenster anzeigen. 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 Beschriftungszellenwerts ü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.

  • Last updated on