fractionString()

概要

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

多くの場合、任意指定の引数は相互に作用します。このため、実際の動作が、指定された設定(特に既定の設定)と異なることがあります。たとえば、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?	ブール値	任意指定。出力にフィートを含めるかどうかを指定します。false にすると、インチのみが含まれます。既定は True です。
suppressUnits?	ブール値	任意指定。単位指定子を含めるかどうかを指定します。既定は True です。
fractionHyphen?	ブール値	任意指定。分数のインチ部分で、整数インチと分数の間にハイフンを含めるかどうかを指定します。既定は False です。
feetInchHyphen?	ブール値	任意指定。フィートとインチの値の間にハイフンが必要かどうかを指定します。既定は True です。
hideZeroInches?	ブール値	任意指定。整数インチのゼロ値を含めるかどうかを指定します。既定の動作では、フィートの値にゼロは一切含められません。hideZeroInches? が true であるかのように動作します。
hideZeroFeet?	ブール値	任意指定。フィートのゼロ値を含めるかどうかを指定します。既定は 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 であるかのように動作します。