書式の設定
GcProgressBar コントロールに表示するテキストは、DisplayTextFormat プロパティを使って指定します。このプロパティに、キーワードとリテラル文字を設定することで容易にテキストの書式を作成できます。テキストのフォントは、Font プロパティを使用して設定します。コントロールにテキストを表示しない場合は、DisplayTextFormat プロパティを空にします。
テキストの書式は、「値のタイプ」と「値の書式」二つの部分から構成されます。設計時にテキストの書式を設定するには、プロパティウィンドウから DisplayTextFormat プロパティを選択して、「テキストの表示設定」ダイアログを開いて行います。
DisplayTextFormat プロパティのデフォルト値は"[p]%|#0"です。コードで設定するときは、下記のように定義します。
用例1
用例2
テキストの書式は、「値のタイプ」と「値の書式」二つの部分から構成されます。設計時にテキストの書式を設定するには、プロパティウィンドウから DisplayTextFormat プロパティを選択して、「テキストの表示設定」ダイアログを開いて行います。
DisplayTextFormat プロパティのデフォルト値は"[p]%|#0"です。コードで設定するときは、下記のように定義します。
GcProgressBar1.DisplayTextFormat = "値のタイプ|値の書式"
gcProgressBar1.DisplayTextFormat = "値のタイプ|値の書式";
「値のタイプ」に使用できるキーワード
「値のタイプ」に指定できるキーワードは下記のとおりです。これらのキーワードのほかに、任意のリテラル文字と組み合わせて表示するテキストの書式を設定できます。キーワード | 説明 |
---|---|
[v] | コントロールの現在値(Value プロパティの値) |
[p] | 全体の進行範囲に対する完成の度合い(Value プロパティの値に基づいたパーセンテージ) |
[s] | 全体の進行範囲(Maximum - Minimum の値) |
[m] | コントロールの最小値(Minimum プロパティ) |
[M] | コントロールの最大値(Maximum プロパティ) |
[^v] | タスク完了までの残り値(Maximum - Value の値) |
[^p] | 全体の進行範囲に対する未完成の度合い(完了までの残り値に基づいたパーセンテージ) |
「値の書式」に使用できるキーワード
「値の書式」では、「値のタイプ」で設定する値の書式を指定します。書式に指定できるキーワードは下記のとおりです。それ以外の文字は使用できません。キーワード | 説明 |
---|---|
# | 数値の桁を指定します。値が0の場合は何も表示されません。 |
0 | 数値の桁を指定します。値が0の場合は0を表示します。 |
.(ピリオド) | 小数点の表示位置を指定します。 |
,(コンマ) | 桁区切り記号の表示位置を指定します。 |
キーワードの活用例
以下に、DisplayTextFormat プロパティのキーワードを活用した、いくつかの用例を示します。用例1
GcProgressBar1.Minimum = 0
GcProgressBar1.Maximum = 1234
GcProgressBar1.Value = 456
GcProgressBar1.DisplayTextFormat = "[s]件のうち[v]件のデータを更新しました|#0"
gcProgressBar1.Minimum = 0;
gcProgressBar1.Maximum = 1234;
gcProgressBar1.Value = 456;
gcProgressBar1.DisplayTextFormat = "[s]件のうち[v]件のデータを更新しました|#0";
用例2
GcProgressBar1.FlatStyle = FlatStyle.Flat
GcProgressBar1.Style = GrapeCity.Win.Bars.ProgressStyle.Continuous
GcProgressBar1.Minimum = 0
GcProgressBar1.Maximum = 12
GcProgressBar1.Value = 8.6
GcProgressBar1.DisplayTextFormat = "空き領域 [^v] GB/ [M] GB([p]%使用済み)|#0.0"
gcProgressBar1.FlatStyle = FlatStyle.Flat;
gcProgressBar1.Style = GrapeCity.Win.Bars.ProgressStyle.Continuous;
gcProgressBar1.Minimum = 0;
gcProgressBar1.Maximum = 12;
gcProgressBar1.Value = 8.6;
gcProgressBar1.DisplayTextFormat = "空き領域 [^v] GB/ [M] GB([p]%使用済み)|#0.0";
テキストの配置
TextAlign プロパティで、テキストの水平方向と垂直方向の配置を設定できます。それぞれの値に対応する位置は次のとおりです。
次のサンプルコードは、テキストをコントロールの左中央に配置します。
次のサンプルコードは、テキストをコントロールの左中央に配置します。
' テキストを垂直方向の中央、左揃えに配置します。
GcProgressBar1.TextAlign = ContentAlignment.MiddleLeft
// テキストを垂直方向の中央、左揃えに配置します。
gcProgressBar1.TextAlign = ContentAlignment.MiddleLeft;
テキストの向き
TextOrientation プロパティを使用して、テキストの向きを設定できます。文字の縦表示は、TextOrientation プロパティを Downward か、または Upward に設定します。漢字やひらがななどの日本語だけを縦に表示する場合は、VerticalFarEast や HorizontalRotatedFarEast を使用します。
次のサンプルコードは、コントロールを縦に表示し、日本語も縦方向に表示する方法を示します。
次のサンプルコードは、コントロールを縦に表示し、日本語も縦方向に表示する方法を示します。
' 書式を設定します。 GcProgressBar1.DisplayTextFormat = "[p]%完了しました|#0" ' 縦方向に配置します。 GcProgressBar1.Orientation = Orientation.Vertical ' 日本語を縦方向に表示します。 GcProgressBar1.TextOrientation = GrapeCity.Win.Common.TextOrientation.VerticalFarEast
// 書式を設定します。 gcProgressBar11.DisplayTextFormat = "[p]%完了しました|#0"; // 縦方向に配置します。 gcProgressBar1.Orientation = Orientation.Vertical; // 日本語を縦方向に表示します。 gcProgressBar1.TextOrientation = GrapeCity.Win.Common.TextOrientation.VerticalFarEast;