InvisibleApp.FormatResultEx-Methode (Visio)

  • Artikel

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)

Ausdruck Eine Variable, die ein InvisibleApp-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

Zeichenfolge

HinwBemerkungeneise

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

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.