Xuni コントロール > FlexGrid > 機能 > 列の書式設定 |
FlexGrid の列に表示される生の値は、さまざまな形式に変換できます。列を書式設定することで、生の値を通貨、パーセント、日付などの数値列のさまざまな表示値に変換できます。FlexGrid は、SimpleDateFormat 構文を使用する日付書式設定および DecimalFormat パターンを使用する数値書式設定をサポートしています。書式設定は、セルの表示値にのみ適用され、基底のデータには影響しません。
列を書式設定するには、カスタム書式文字列を使用して setFormat を呼び出します。たとえば、次のコードは、列内の数値を書式設定して、小数点以下 2 桁の通貨として表示します。
column1.setFormat("$#.##"); // $1.23
column2.setFormat(“hh:mm a”); // 08:05 AM
flexGrid.Columns.GetColumn("Money").Format = "$##.##"; // $1.23
flexGrid.Columns.GetColumn("Hired").Format = "MM/dd"; // 08/31
文字列は、書式指定子の組み合わせを使用して作成します。次の表に、カスタム数値文字列を作成するためによく使用される記号を示します。
記号 | 意味 |
0 | 数字 |
@ | 有効数字 |
# | 桁。先頭の 0 は表示されません。 |
. | ローカライズされた小数点または通貨小数点 |
- | 負符号 |
, | 桁区切り文字 |
% | プリフィックスまたはサフィックス。パーセンテージ表示。値が 100 倍されます。 |
次の表に、カスタム日時文字列を作成するためによく使用される記号を示します。
記号 | 意味 | 例 |
"a" | 午前/午後 | 午後 |
"d" | 月内の通算日数 | 1 |
"dd" | 月内の通算日数 | 01 |
"D" | 年内の通算日数 | 189 |
"E"、"EE"、または "EEE" | 省略形の曜日 | 火 |
"EEEE" | 長い曜日 | 火曜日 |
"EEEEE" | 1 文字の曜日 | 火 |
"h" | 12 時間制の時間(1 ~ 12) | 1 |
"H" | 24 時間制の時間(0 ~ 23) | 0 |
"k" | 24 時間制の時間(1 ~ 24) | 1 |
"K" | 12 時間制の時間(0 ~ 11) | 0 |
"m" | 時間内の分数 | 30 |
"M" | 月 | 1 |
"MM" | 月 | 01 |
"MMM" | 省略形の月名 | 1 月 |
"MMMM" | 完全形の月名 | 1 月 |
"MMMMM" | 1 文字の月名 | 1 |
"s" | 分内の通算秒数 | 55 |
"w" | 年内の通算週数 | 27 |
"W" | 月内の通算週数 | 2 |
"y"、"yyy"、または "yyyy" | 年 | 2016 |
"yy" | 省略形の年 | 16 |
"z"、"zz"、または "zzz" | タイムゾーン | PST |
"zzzz" | タイムゾーンの完全名 | 太平洋標準時刻 |
' | エスケープテキスト | '日付 =' |
カスタム書式文字列に加えて、FlexGrid では、標準の .NET 書式文字列を使用する、より簡単な方法も提供されています。Format プロパティを、一般的な書式のリストにある既知の文字列に設定するだけで、列の数値書式を指定できます。この文字列は 1 文字または 2 文字から成ります。最初の文字は書式指定子、2 番目の文字はオプションの精度指定子です。
たとえば、次の書式文字列は、生の値を小数点以下 2 桁の現地通貨に変換して表示します。
C# |
コードのコピー
|
---|---|
flexGrid.Columns.GetColumn("Money").Format = "c2"; // $1.23 |
次の表に、FlexGrid が現在サポートしている数値書式文字列を示します。これらの書式文字列では、大文字小文字は区別されません。
書式指定子 | 名前 | 精度指定子 | 例 |
"C" または "c" | 通貨 | 小数点以下桁数 | 123.4567 (C2) à $123.46 |
"D" または "d" | 10 進数 | 最小桁数 | 1234 (D6) à 001234 |
"E" または "e" | 指数 | 小数点以下桁数 | 1,234 (E2) à 1.23E3 |
"F" または "f" | 固定小数点 | 小数点以下桁数 | -1234.56 (F4) à -1234.5600 |
"G" または "g" | 一般 | 有効桁数 | 123.45 (G4) à 123.5 |
"N" または "n" | 数値 | 目的の小数点以下桁数 | 1234 (N1) à 1234.0 |
"P" または "p" | パーセント | 目的の小数点以下桁数 | 1 (P2) à 100.00% |
"X" または "x" | 16 進数 | 結果の文字列の目的の桁数 | 123 (X2) à 7B |
数値または日付/時刻以外の列を書式設定する必要がある場合は、「カスタムセル」および「データマッピング」トピックを参照してください。