_Application3.FormatString(Object, String, String) メソッド

定義

名前空間:

Microsoft.Office.Interop.InfoPath

アセンブリ:

Microsoft.Office.Interop.InfoPath.dll

指定したカテゴリとオプションのパラメーターに従って、指定された文字列または XML ノードの書式を設定します。

public:
 System::String ^ FormatString(System::Object ^ varInput, System::String ^ bstrCategory, System::String ^ bstrOptions);

public string FormatString (object varInput, string bstrCategory, string bstrOptions);

abstract member FormatString : obj * string * string -> string

Public Function FormatString (varInput As Object, bstrCategory As String, bstrOptions As String) As String

パラメーター

varInput

Object

書式設定する値または XML ノード。

bstrCategory

String

書式設定に使用するカテゴリを指定する値。 値には、数値、パーセント、通貨、日付、時刻、および日時が含まれます。

bstrOptions

String

書式設定に使用するオプションを指定する値。 "optionName:value" の形式の文字列で、大文字と小文字が区別されます。

戻り値

String

指定したカテゴリとオプション パラメーターに従って書式設定された、指定した文字列または XML ノード。

実装

FormatString(Object, String, String)

例

次の例では、 オブジェクトの FormatString メソッドを Application 使用して、指定した日付文字列を長い日付形式に書式設定します。

thisApplication.<span class="label">FormatString</span>("2003-01-08", "date", "dateFormat:Long Date");

注釈

どこでも必要な場所で FormatString メソッドを使用して、指定した文字列の書式を変更できます。 アプリケーション名で修飾する必要があり、戻り値は、変数に代入するか、または文字列値が必要な式として使用する必要があります。

次の表に、 と bstrOptionsに使用できる値をbstrCategory示します。

カテゴリの一覧

number	数値を使用します。 このカテゴリに対して有効なオプションは、locale、numDigits、leadingZero、grouping、decimalSep、thousandSep、および negativeOrder です。
割合	パーセント値を使用します。 このカテゴリに対して有効なオプションは、locale、numDigits、leadingZero、grouping、decimalSep、thousandSep、および negativeOrder です。
currency	通貨値を使用します。 このカテゴリに対して有効なオプションは、locale、"numDigits、leadingZero、grouping、decimalSep、thousandSep、negativeOrder、positiveOrder、および currencyLocale です。
date	日付値を使用します。 このカテゴリに対して有効なオプションは、locale、dateFormat、useAltCalendar、および useEnglishStringsAlways です。
time	時刻値を使用します。 このカテゴリに対して有効なオプションは、locale、timeFormat、および noSeconds です。
Datetime	日時値を使用します。 このカテゴリに対して有効なオプションは、locale、dateFormat、timeFormat、noSeconds、useAltCalendar、および useEnglishStringAlways です。

オプションの一覧

locale	ロケール識別子 (LCID) を指定します。 指定しない場合は、既定で現在のユーザーの LCID になります。
numDigits	小数点記号の後の小数部の桁数を指定します。 値 auto を使用して、入力された小数部桁数を出力の小数部桁数にするように示すこともできます。 たとえば、1.234、1.234、1.00、1.00、1.56e2、156.00 などです。 指定しないと、地域設定の対応する値が既定で使用されます。
leadingZero	10 進数フィールドで、値の前にゼロを付けるかどうかを指定します。 0 はゼロを付けないことを意味し、1 はゼロを付けることを意味します。 指定しないと、地域設定の対応する値が既定で使用されます。
グループ	小数点の左側の各桁グループのサイズを指定します。 0 ～ 9 の範囲の値および値 32 が有効です。 値 32 は、グループが最初は 3 桁で、その後は 2 桁であることを示します。 指定しないと、地域設定の対応する値が既定で使用されます。
decimalSep	小数点の区切り文字を指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
thousandSep	3 桁の区切り文字を指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
negativeOrder	負の値のモードを指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
positiveOrder	正の値のモードを指定します。 指定しないと、地域設定の対応する値が既定で使用されます。
currencyLocale	通貨記号に対するロケール識別子 (LCID) を指定します。 指定しないと、ロケールで指定されている値が既定で使用されます。
dateFormat	日付文字列を作成するために使用する書式設定の図の文字列を指定します。 値 Short Date、Long Date、Year Month、および none を使用して、短い日付書式、長い日付書式、年月の書式、および書式なしを示すこともできます。 Short Date、Long Date、および Year Month は、オペレーティング システムの地域設定および言語設定で提供される既定の書式です。
useAltCalendar	日付の書式設定に対して代替カレンダーを使用するかどうかを指定します。 通常のカレンダーを使用する場合は 0 を指定し、代替カレンダーを使用する場合は 1 を指定します。 指定しない場合の既定値は 0 です。
useEnglishStringsAlways	日付の書式設定に対して常に英語の文字列を使用するかどうかを指定します。 ロケールで指定されている言語を使用する場合は 0 を指定し、常に英語を使用する場合は 1 を指定します。 指定しない場合の既定値は 0 です。
timeFormat	時刻の文字列を作成するために使用する書式設定文字列を指定します。 値 none を使用して、書式設定なしを示すこともできます。 指定しないと、地域設定の時刻の書式が既定で使用されます。
noSeconds	秒を使用しないかどうかを指定します。 秒を使用する場合は 0 を指定し、秒を使用しない場合は 1 を指定します。 指定しない場合の既定値は 0 です。