Characters.AddFieldEx-Methode (Visio)
Ersetzt den Text, der durch ein Characters-Objekt dargestellt wird, durch ein neues Feld der kategorie, des Codes, des Formats, der Sprach-ID und der Kalender-ID, die Sie angeben.
Syntax
Ausdruck. AddFieldEx (Category, Code, Format, LangID, CalendarID)
Ausdruck Eine Variable, die ein Characters-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Kategorie | Erforderlich | VisFieldCategories | Die Kategorie für das neue Feld. |
| Code | Erforderlich | VisFieldCodes | Der Code für das neue Feld. |
| Format | Erforderlich | VisFieldFormats | Das Format für das neue Feld. |
| Langid | Optional | Long | Die Sprache, die für das neue Feld verwendet werden soll. |
| CalendarID | Optional | Long | Der für das neue Feld zu verwendende Kalender. |
Rückgabewert
Nichts
Bemerkungen
Konstante Werte für Category, Code und Format werden von der Visio-Typbibliothek in VisFieldCategories, VisFieldCodes bzw . VisFieldFormats deklariert.
Das LangID-Argument sollte eine der Standard-IDs sein, die von Windows zum Codieren verschiedener Sprachversionen verwendet werden. Beispielsweise ist &H0409 die Sprach-ID für die US-Version von Microsoft Visio. Um eine Liste der möglichen Sprach-IDs anzuzeigen, suchen Sie im Microsoft Platform SDK auf MSDN nach "VERSIONINFO".
Das CalendarID-Argument sollte einer der folgenden Werte sein, die in VisCellVals in der Visio-Typbibliothek deklariert werden. Der Standardwert ist visCalWestern, womit "Westlich" als Kalender festgelegt wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
| visCalWestern | 0 | Western |
| visCalArabicHijri | 1 | Arabisch Hijiri |
| visCalHebrewLunar | 2 | Hebräischer Mondkalender |
| visCalChineseTaiwan | 3 | Taiwankalender |
| visCalJapaneseEmperor | 4 | Japan - Kaiserherrschaft |
| visCalThaiBuddhism | 5 | Thai Buddhistisch |
| visCalKoreanDanki | 6 | Koreanisch Danki |
| visCalSakaEra | 7 | Sakazeit |
| visCalTranslitEnglish | 8 | Englisch transkribiert |
| visCalTranslitFrench | 9 | Französisch transkribiert |
Die Verwendung der AddFieldEx-Methode ist vergleichbar mit dem Klicken auf Feld auf der Registerkarte Einfügen und dem Einfügen einer der folgenden Feldkategorien im Text:
Datum/Uhrzeit
Dokumentinfo
Geometrie
Objektinfo
Zeichenblattinfo
Um ein benutzerdefiniertes Formelfeld hinzuzufügen, verwenden Sie die AddCustomField- oder AddCustomFieldU-Methode . Wenn Sie keine Werte für die optionalen LangID- und CalendarID-Argumente übergeben (oder Standardwerte übergeben), verhält sich AddFieldEx genau wie AddField.
Beispiel
Das folgende VBA-Makro (Microsoft Visual Basic für Applikationen) veranschaulicht, wie mit der AddFieldEx-Eigenschaft ein Datumsfeld in einem Shape formatiert wird. Es zeichnet ein Rechteck auf dem Zeichenblatt und fügt dann ein Feld ein, das das aktuelle Datum in griechischer Sprache unter Verwendung des westlichen Kalenders anzeigt.
Public Sub AddFieldEx_Example()
Dim vsoCharacters As Visio.Characters
Dim vsoShape As Visio.Shape
ActiveWindow.DeselectAll
Set vsoShape = Application.ActivePage.DrawRectangle(3, 5, 5, 3)
vsoShape.Text = "Date: "
Set vsoCharacters = vsoShape.Characters
'Set Begin property equal to End property to
'append new text to existing text.
vsoCharacters.Begin = vsoCharacters.End
'Add a field for the current date, in Greek,
'using the Western calendar and the long date format.
vsoCharacters.AddFieldEx visFCatDateTime, visFCodeCurrentDate, visFmtMsoDateLong, 1032, visCalWestern
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.