Freigeben über

DataColumn.SetProperty-Methode (Visio)

  • Artikel

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 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
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.