fractionString()

Zusammenfassung

Gibt eine Zeichenfolgendarstellung des Werts im Architekturformat zurück. Dabei wird die Schreibweise mit Fuß und Zoll verwendet, ähnlich wie die Architektur-Einheitenformate in AutoCAD. Eine Reihe von optionalen Argumenten ermöglicht es, viele Ausgabeformate zu steuern.

Die optionalen Argumente interagieren häufig miteinander und führen möglicherweise zu Verhaltensweisen, die nicht genau mit den angegebenen Einstellungen übereinstimmen, insbesondere mit den Vorgaben. Beispiel: Wenn feetToo? False ist, verhindert es, dass suppressUnits?, wenn es False ist, eine Auswirkung auf die Ausgabe hat. Dies ist der Fall, da es normalerweise nicht erforderlich ist, Einheitsbezeichnungen einzuschließen, wenn alle Einheiten in Zoll angegeben werden.

Syntax

fractionString ( value As Number, _
                  Optional maxDenominator As Integer = 16, _
                  Optional feetToo? As Boolean = True, _
                  Optional suppressUnits? As Boolean = True, _
                  Optional fractionHyphen? As Boolean = False, _
                  Optional feetInchHyphen? As Boolean = True, _
                  Optional hideZeroInches? As Boolean = _
                   (Not feetToo?) Or (abs(value) < (1 - (1 / MaxDenominator / 2))), _
                  Optional hideZeroFeet? As Boolean = True ) As String 
Argument Typ Beschreibung
value Number Der Wert, der in einen Bruch umgewandelt werden soll
maxDenominator Integer Optional. Der in der Ausgabe bei Bruchteilen von einem Zoll maximal zulässige Nenner. Vor dem Formatieren wird der Wert auf den nächstliegenden Bruchteil dieser Größe gerundet. Vorgabe ist 16.
feetToo? Boolean Optional. Legt fest, ob die Ausgabe Fuß einschließen soll. Wenn False, sind nur Zoll enthalten. Vorgabe ist True.
suppressUnits? Boolean Optional. Legt fest, ob die Einheitsbezeichnungen eingeschlossen werden sollen. Vorgabe ist True.
fractionHyphen? Boolean Optional. Legt fest, ob im Zoll-Bruchwert ein Bindestrich zwischen dem ganzzahligen Zollwert und dem Bruch eingefügt werden soll. Vorgabe ist False.
feetInchHyphen? Boolean Optional. Legt fest, ob zwischen den Fuß- und Zollwerten ein Bindestrich eingefügt werden soll. Vorgabe ist True.
hideZeroInches? Boolean Optional. Legt fest, ob für ganzzahlige Zollwerte ein Nullwert eingeschlossen werden soll. Das Vorgabeverhalten ist, Werte in Fuß gleich Null nicht einzuschließen. Dieses Verhalten gleicht auch demjenigen, wenn hideZeroInches? True ist.
hideZeroFeet? Boolean Optional. Legt fest, ob für Fuß ein Nullwert eingeschlossen werden soll. Vorgabe ist True.

Beispiel 1

Intent >fractionString(24.375) 
--> "2'-0 3/8"" 
Beachten Sie, dass auch wenn suppressUnits? als Vorgabe True enthält, die Einheiten in der Grundschreibweise angezeigt werden.

Beispiel 2

Intent >fractionString(24.375, maxDenominator := 4)  
--> "2'-0 1/2"" 
Beachten Sie, dass 3/8 Zoll auf den nächstliegenden 1/4-Zoll-Wert gerundet werden. suppressUnits? wird weiterhin ignoriert.

Beispiel 3

Intent >fractionString(24.375, feetToo? := false) 
--> "24 3/8" 
Beachten Sie, dass die Einheiten verworfen werden.

Beispiel 4

Intent >fractionString(24.375, fractionHyphen? := true) 
--> "2'-0-3/8"" 
Wie die Vorgabe, mit Ausnahme des Bindestrichs beim Bruch

Beispiel 5

Intent >fractionString(24.375, feetInchHyphen? := false) 
--> "2' 0 3/8"" 
Wie die Vorgabe, jetzt ohne den Bindestrich

Beispiel 6

Intent >fractionString(24.375, hideZeroInches? := true) 
--> "2'-3/8"" 
Wie die Vorgabe, aber ohne die Null

Beispiel 7

Intent >fractionString(0.375, hideZeroFeet? := false) 
--> "0'-3/8"" 
Das Vorgabeverhalten ist, Werte in Fuß gleich Null nicht einzuschließen. Dieses Verhalten gleicht auch demjenigen, wenn hideZeroInches? True ist.