InvisibleApp. FormatResult-Methode (Visio)InvisibleApp.FormatResult method (Visio)

Formatiert entsprechend eines Bildformats eine Zeichenfolge oder eine Zahl in eine Zeichenfolge.Formats a string or number into a string according to a format picture. Verwendet angegebene Einheiten für die Skalierung und Formatierung.Uses specified units for scaling and formatting.

SyntaxSyntax

Ausdruck. FormatResult (StringOrNumber, unitin, Units, Format)expression.FormatResult (StringOrNumber, UnitsIn, UnitsOut, Format)

Ausdruck Eine Variable, die ein InvisibleApp -Objekt darstellt.expression A variable that represents an InvisibleApp object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
StringOrNumberStringOrNumber ErforderlichRequired VariantVariant Eine Zeichenfolge oder eine Zahl, die formatiert werden soll. Der Wert kann als Zeichenfolge, Fließkommazahl oder ganze Zahl übergeben werden.String or number to be formatted; can be passed as a string, floating point number, or integer.
UnitsInUnitsIn ErforderlichRequired VariantVariant Maßeinheiten als Attribute für StringOrNumber.Measurement units to attribute to StringOrNumber.
EinheitenUnitsOut ErforderlichRequired VariantVariant Maßeinheiten, in denen das Ergebnis ausgedrückt werden soll.Measurement units to express the result in.
FormatFormat ErforderlichRequired StringString Angabe, wie die resultierende Zeichenfolge aussehen soll.Picture of what the result string should look like.

RückgabewertReturn value

ZeichenfolgeString

BemerkungenRemarks

Wenn als Zeichenfolge übergeben wird, kann StringOrNumber die Formel oder die zukünftige Formel einer Zelle oder das Ergebnis oder das potenzielle Ergebnis einer Zelle sein, die als Zeichenfolge ausgedrückt wird.If passed as a string, StringOrNumber might be the formula or prospective formula of a cell or the result or prospective result of a cell expressed as a string. Die FormatResult -Methode wertet die Zeichenfolge aus und formatiert das Ergebnis.The FormatResult method evaluates the string and formats the result. Da die Zeichenfolge außerhalb des Kontexts der Formel einer bestimmten Zelle ausgewertet wird, gibt die FormatResult -Methode einen Fehler zurück, wenn die Zeichenfolge beliebige Zellbezüge enthält.Because the string is being evaluated outside the context of being the formula of a particular cell, the FormatResult method returns an error if the string contains any cell references.

StringOrNumber kann u. a. die folgenden Werte aufweisen:Possible values for StringOrNumber include:

  • 1.71.7
  • 33
  • "2,5""2.5"
  • "4,1 cm""4.1 cm"
  • "12 ft - 17 in + (12 cm / WURZEL(7))""12 ft - 17 in + (12 cm / SQRT(7))"

Bei __ den Argumenten Units und unitd kann es sich um Zeichenfolgen wie "inches", "inch", "in." oder "i" handeln.The UnitsIn and UnitsOut arguments can be strings such as "inches", "inch", "in.", or "i". Zeichenfolgen können für alle unterstützten Microsoft Office Visio-Einheiten wie Zentimeter, Meter, Meilen usw. verwendet werden.Strings may be used for all supported Microsoft Office Visio units such as centimeters, meters, miles, and so on. Sie können auch beliebige Unit-Konstanten verwenden, die von der Visio-Typbibliothek in VisUnitCodes deklariert werden.You can also use any of the unit constants declared by the Visio type library in VisUnitCodes. Eine Liste gültiger Einheiten ist auch in Informationen zu Maßeinheitenenthalten.A list of valid units is also included in About units of measure.

Wenn StringOrNumber eine Zeichenfolge ist __ , gibt unitin an, wie das ausgewertete Ergebnis interpretiert wird, und wird nur verwendet, wenn das Ergebnis eine skalare ist.If StringOrNumber is a string, UnitsIn specifies how to interpret the evaluated result and is only used if the result is a scalar. Beispielsweise wird der Ausdruck "4 * 5 cm" zu 20 cm ausgewertet, was kein Skalarwert ist, sodass unitin ignoriert wird.For example, the expression "4 * 5 cm" evaluates to 20 cm, which is not a scalar, so UnitsIn is ignored. Der Ausdruck "4 * 5" ergibt 20, was ein Skalarwert ist und mithilfe der angegebenen unitin interpretiert __ wird.The expression "4 * 5" evaluates to 20, which is a scalar and is interpreted by using the specified UnitsIn.

Das __ Argument Units gibt die Einheiten an, in denen die zurückgegebene Zeichenfolge ausgedrückt werden soll.The UnitsOut argument specifies the units in which the returned string should be expressed. Wenn Sie möchten, dass die Ergebnisse in denselben Einheiten wie der ausgewertete Ausdruck ausgedrückt werden, übergeben Sie "nocast" oder visNoCast.If you want the results expressed in the same units as the evaluated expression, pass "NOCAST" or visNoCast.

Format ist eine Zeichenfolge, die eine Vorlage oder ein Bild der von der FormatResult -Methode erstellten Zeichenfolge angibt.Format is a string that specifies a template or picture of the string produced by the FormatResult method. Ausführliche Informationen finden Sie in der Format-Funktion.For details, see the FORMAT function. Einige der folgenden Möglichkeiten:A few of the possibilities are:

  • #-Gibt eine einzelne Ziffer aus, aber nicht, wenn es sich um eine führende oder nachstehende 0 handelt.# - Output a single digit, but not if it's a leading or trailing 0.

  • 0– Eine einzelne Ziffer ausgeben, auch wenn es sich um eine führende oder nachstehende 0 handelt.0 - Output a single digit, even if it is a leading or trailing 0.

  • .-Dezimal Platzhalter.. - Decimal placeholder.

  • ,-Tausendertrennzeichen., - Thousands separator.

  • "text"oder 'text' -Output Closed Text as is."text" or 'text' - Output enclosed text as is.

  • \c-Das Zeichen c ausgeben.\c - Output the character c.

BeispielExample

Dabei wird eine Zeichenfolge angegeben.Where a string is specified.

' Prints 1.00 
Debug.Print Application.FormatResult("0.5 * 2", "ft", "ft", "#.00 u") 
 
' Prints 12.00 in. 
Debug.Print Application.FormatResult("0.5 * 2", "ft", "in", "#.00 u") 
 
' Prints .39 in. 
Debug.Print Application.FormatResult("1 cm", "ft", "in", "#.00 u") 
 
' Prints 1.00 cm. 
Debug.Print Application.FormatResult("1 cm", "ft", "NOCAST", "#.00 u") 
 
' Prints 0.39 
Debug.Print Application.FormatResult("1 cm", "ft", "", "0.00 u") 
 
' Prints 1858.06 sq. cm. 
Debug.Print Application.FormatResult("1 sq. ft. * 2", "in^2", "cm^2", "0.00 u") 
 
' Throws an exception because of bad measurement unit ("bz") 
Debug.Print Application.FormatResult("1 cm", "ft", "bz", "#.00 u") 

Dabei wird eine Zahl angegeben.Where a number is specified.

' Prints 1.00 
Debug.Print Application.FormatResult(1, "ft", "ft", "#.00 u") 
 
' Prints 12.00 in. 
Debug.Print Application.FormatResult(1, "ft", "in", "#.00 u") 
 
' Prints .08 ft. 
Debug.Print Application.FormatResult(1.0, "in", "ft", "#.00 u") 
 
' Prints 12.00 
Debug.Print Application.FormatResult(1.0, visFeet, "", "#.00 u") 
 
' Throws an exception because of bad measurement unit ("bz") 
Debug.Print Application.FormatResult(1, "bz", "in", "#.00 u") 


Mit dem folgenden Makro wird gezeigt, wie mit der FormatResult-Methode ein Wert von Zentimetern in Zoll umgewandelt wird. Das Ergebnis wird dann in einem Meldungsfeld angegeben.The following macro shows how to use the FormatResult method to convert a value from centimeters to inches and display the result in a message box.

 
Public Sub FormatResult_Example() 
 
 Dim strOldValue As String 
 Dim strNewValue As String 
 
 'Set old value. 
 strOldValue = "1 cm" 
 
 'Format value. 
 strNewValue = Application.FormatResult _ 
 (strOldValue, "ft", "in", "#.00 u") 
 
 'Display new value. 
 MsgBox (strNewValue) 
 
End Sub

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.