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.