Application.FormatResultEx-Methode (Visio)
Formatiert eine Zeichenfolge oder Zahl in eine Zeichenfolge gemäß einem Formatbild, wobei angegebene Einheiten für die Skalierung und Formatierung verwendet werden. Legt optional für Datums- oder Uhrzeitzeichenfolgen die Sprache und den Kalendertyp der Zeichenfolge fest.
Syntax
Ausdruck. FormatResultEx (StringOrNumber, UnitsIn, UnitsOut, Format, LangID, CalendarID)
expression Eine Variable, die ein Application-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| StringOrNumber | Erforderlich | Variant | Eine Zeichenfolge oder eine Zahl, die formatiert werden soll. Der Wert kann als Zeichenfolge, Fließkommazahl oder ganze Zahl übergeben werden. |
| UnitsIn | Erforderlich | Variant | Maßeinheiten als Attribute für StringOrNumber. |
| UnitsOut | Erforderlich | Variant | Maßeinheiten, in denen das Ergebnis ausgedrückt werden soll. |
| Format | Erforderlich | String | Angabe, wie die resultierende Zeichenfolge aussehen soll. |
| LangID | Optional | Long | Die für die resultierende Zeichenfolge zu verwendende Sprache. |
| CalendarID | Optional | Long | Der für die resultierende Zeichenfolge zu verwendende Kalender. Der Standardwert ist der westliche Kalender, visCalWestern. |
Rückgabewert
String
Hinweise
Wenn string als Zeichenfolge übergeben wird, kann StringOrNumber die Formel oder prospektive Formel einer Zelle oder das Ergebnis oder das prospektive Ergebnis einer Zelle sein, die als Zeichenfolge ausgedrückt wird. Die FormatResultEx-Methode wertet die Zeichenfolge aus und formatiert das Ergebnis. Da die Zeichenfolge außerhalb des Kontexts ausgewertet wird, in dem es sich um die Formel einer bestimmten Zelle handelt, gibt die FormatResultEx-Methode einen Fehler zurück, wenn die Zeichenfolge Zellbezüge enthält.
StringOrNumber kann u. a. die folgenden Werte aufweisen:
- 1.7
- 3
- "2.5"
- "4,1 cm"
- "12 ft - 17 in + (12 cm / WURZEL(7))"
Wenn UnitsInauf visDate festgelegt ist, können Sie einen numerischen Wert an die DATETIME-Funktion in StringOrNumber übergeben. Der ganzzahlige Teil des übergebenen Werts sollte die Anzahl der Tage seit dem 30. Dezember 1899 darstellen, und der Dezimalteil sollte den Bruchteil eines Tages seit Mitternacht darstellen. Beispielsweise steht 38135.50 für den 28. Mai 2004.
Die Argumente UnitsIn und UnitsOut können Zeichenfolgen wie "inches", "inch", "in." oder "i" sein. Zeichenfolgen können für alle unterstützen Microsoft Visio-Einheiten, wie z. B. Zentimeter, Meter, Meilen usw., verwendet werden. Sie können auch jede der Einheitenkonstanten verwenden, die von der Visio-Typbibliothek in VisUnitCodes deklariert werden. Eine Liste der gültigen Einheiten ist auch in About-Maßeinheiten enthalten.
Wenn StringOrNumber eine Zeichenfolge ist, gibt UnitsIn an, wie das ausgewertete Ergebnis interpretiert werden soll, und wird nur verwendet, wenn das Ergebnis ein Skalar ist. Der Ausdruck "4 * 5 cm" ergibt z. B. 20 cm, was kein Skalar ist, sodass UnitsIn ignoriert wird. Der Ausdruck "4 * 5" ergibt 20, was ein Skalar ist und mit dem angegebenen UnitsIn interpretiert wird.
Das UnitsOut-Argument gibt die Einheiten an, in denen die zurückgegebene Zeichenfolge ausgedrückt werden soll. Wenn die Ergebnisse in den gleichen Einheiten wie der ausgewertete Ausdruck ausgedrückt werden sollen, übergeben Sie "NOCAST" oder visNoCast.
Format ist eine Zeichenfolge, die eine Vorlage oder ein Bild der von der FormatResultEx-Methode erzeugten Zeichenfolge angibt. Weitere Informationen finden Sie in der FORMAT-Funktion. Einige der Möglichkeiten sind:
#– Gibt eine einzelne Ziffer aus, aber nicht, wenn es sich um eine führende oder nachfolgende 0 handelt.0– Gibt eine einzelne Ziffer aus, auch wenn es sich um eine führende oder nachfolgende 0 handelt..– Dezimalplatzhalter.,– Tausendertrennzeichen."text"oder'text'– Gibt den eingeschlossenen Text unverändert aus.\c– Gibt das Zeichen c aus.
Wenn UnitsInauf visDate festgelegt ist, sollte Format eines der benutzerdefinierten erweiterten Microsoft Visio-Formate für Datum/Uhrzeit sein, die das Format "{{date/time format picture}}" aufweisen. Sie können diese Formate im Feld Benutzerdefiniertes Format im Dialogfeld Datenformat in Visio anzeigen (wählen Sie eine Form aus, und klicken Sie dann auf der Registerkarte Einfügen auf Feld. Wählen Sie in der Liste Kategoriedie Option Datum/Uhrzeit und dann Datenformat aus.
Das LangID-Argument ist optional. Wenn Sie keinen Wert angeben, verwendet Visio die aktuelle Systemsprache. Wenn Sie einen Wert übergeben, sollte das LangID-Argument eine der Standard-IDs sein, die von Windows zum Codieren verschiedener Sprachversionen verwendet werden. Beispielsweise ist 1033 die Sprach-ID für Englisch (USA). Eine Liste der möglichen Sprach-IDs finden Sie unter Sprachbezeichnerkonstanten und Zeichenfolgen.
Das CalendarID-Argument sollte einer der folgenden Werte sein, die in VisCellVals in der Visio-Typbibliothek deklariert werden. Der Standardwert ist der westliche Kalender, visCalWestern.
| Konstante | Wert | Beschreibung |
|---|---|---|
| visCalWestern | 0 | Westlich |
| 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 |
Beispiel
Das folgende Beispiel zeigt, wie Sie die FormatResultEx-Eigenschaft verwenden, um ein Datum in griechischer Sprache zu formatieren und als Formtext anzuzeigen.
Public Sub FormatResultEx_Example
Dim vsoShape As Visio.Shape
Dim strDate As String
Set vsoShape = ActivePage.DrawOval (3, 5, 5, 9)
strDate = Application.FormatResultEx (37663.50, visDate, "", "{{dd MMMM yyyy}}", 1032, 0)
vsoShape.Text = strDate
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.