fractionString()

概要

AutoCAD Architecture の単位形式と同様のフィートとインチの表記法を使用して、値の文字列リプレゼンテーションを "Architecture" 形式で返します。一連の任意の引数で、多くの出力形式をコントロールすることができます。

多くの場合、任意指定の引数は相互に作用します。このため、実際の動作が、指定された設定(特に既定の設定)と異なることがあります。たとえば、feetToo? をfalse にすると、suppressUnits? をfalse にしても、出力に影響は生じません。これは、すべての単位がインチになっている場合には、通常は、単位指定子を含める必要はあまりないためです。

構文

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

引数	[タイプ]	説明
value	[数]	分数文字列に変換する値です。
maxDenominator	整数	任意指定。出力でインチを分数表記する場合に許容される最大分母です。この値は、書式設定される前に、このサイズに最も近い分数に丸められます。既定は 16 です。
feetToo?	boolean	任意指定。出力にフィートを含めるかどうかを指定します。false にすると、インチのみが含まれます。既定は True です。
suppressUnits?	ブーリアン演算	任意指定。単位指定子を含めるかどうかを指定します。既定は True です。
fractionHyphen?	ブーリアン演算	任意指定。分数のインチ部分で、整数インチと分数の間にハイフンを含めるかどうかを指定します。既定は False です。
feetInchHyphen?	ブーリアン演算	任意指定。フィートとインチの値の間にハイフンが必要かどうかを指定します。既定は True です。
hideZeroInches?	ブーリアン演算	任意指定。整数インチのゼロ値を含めるかどうかを指定します。
hideZeroFeet?	boolean	任意指定。フィートのゼロ値を含めるかどうかを指定します。既定は True です。既定の動作では、フィートの値にゼロは一切含められません。hideZeroInches? が true であるかのように動作します。

例 1

Intent >fractionString(24.375) 
--> "2'-0 3/8"" 

suppressUnits? が既定で True に設定されている場合でも、基本的には、単位は表示されることに注意してください。

例 2

Intent >fractionString(24.375, maxDenominator := 4)  
--> "2'-0 1/2"" 

3/8 は、最も近い 1/4 インチに丸められることに注目してください。suppressUnits?は、引き続き無視されます。

例 3

Intent >fractionString(24.375, feetToo? := false) 
--> "24 3/8" 

単位は表示されないことに注目してください。

例 4

Intent >fractionString(24.375, fractionHyphen? := true) 
--> "2'-0-3/8""

分数のハイフン以外は、既定と同じです。

例 5

Intent >fractionString(24.375, feetInchHyphen? := false) 
--> "2' 0 3/8"" 

ハイフンがないこと以外は、既定と同じです。

例 6

Intent >fractionString(24.375, hideZeroInches? := true) 
--> "2'-3/8"" 

既定と同じですが、ゼロは表示されません。

例 7

Intent >fractionString(0.375, hideZeroFeet? := false) 
--> "0'-3/8"" 

既定の動作では、フィートの値にゼロは一切含められません。hideZeroInches? が true であるかのように動作します。