PowerTools InputMan for ASP.NET 8.0J
DisplayFormat プロパティ (GcTime)
使用例 

表示用の時刻書式を示すTimeDisplayFormatオブジェクトを取得または設定します。
構文
Public Shadows Property DisplayFormat As TimeDisplayFormat
public new TimeDisplayFormat DisplayFormat {get; set;}

プロパティ値

既定値:GrapeCity.Web.Input.IMDate.TimeDisplayFormat("H:mm:ss")
解説
時刻コントロールの表示書式は、DisplayFormatプロパティが参照するTimeDisplayFormatオブジェクトを使って設定します。このオブジェクトのTimeDisplayFormat.Patternプロパティにキーワードとリテラル文字列を設定することで、表示書式を作成します。

TimeDisplayFormat.Patternプロパティを空の文字列(""またはString.Empty)に設定すると、Formatプロパティが参照するTimeFormat.Patternプロパティに設定された書式が適用されます。

時刻コントロールの表示書式を設定するTimeDisplayFormat.Patternプロパティでは、以下のキーワードまたは書式指定子が使えます。キーワードはカスタム書式を設定するときに使用し、書式指定子は既定の書式を呼び出すときに使用します。

時刻に関するキーワード

キーワード 説明
t 12時間制で時刻を表示するときに午前(AMDesignatorプロパティで設定)または午後(PMDesignatorプロパティで設定)を表す文字列の最初の1文字を表示
tt 12時間制で時刻を表示するときに午前(AMDesignatorプロパティで設定)または午後(PMDesignatorプロパティで設定)を表す文字列を表示
h 時を12時間制で表示(先頭に0を付けない)
hh 時を12時間制で表示(先頭に0を付ける)
H 時を24時間制で表示(先頭に0を付けない)
HH 時を24時間制で表示(先頭に0を付ける)
m 分を表示(先頭に0を付けない)
mm 分を表示(先頭に0を付ける)
s 秒を表示(先頭に0を付けない)
ss 秒を表示(先頭に0を付ける)
\(Chr(92)) キーワードをリテラル文字として表示

旧式のプロパティ

TimeDisplayFormatクラスのNullプロパティは、8.0J以降で旧式(obsolate)のメンバとなりました。これらのプロパティと同等の機能を実現するには、Watermarkプロパティを使用して、未入力時の表示文字を設定します。
使用例
最初のサンプルコードは、FormatプロパティとDisplayFormatプロパティを使って時刻の書式を設定する方法を示します。
下のサンプルコードは、同様の設定をTimeFormatオブジェクトとTimeDisplayFormatオブジェクトを明示的に生成することで行います。
' 時刻の書式を設定します。
GcTime1.AMDesignator = "午前"
GcTime1.PMDesignator = "午後"
GcTime1.Format.Pattern = "tt hh時 mm分"
GcTime1.DisplayFormat.Pattern = "tt hh時 mm分"
// 時刻の書式を設定します。
GcTime1.AMDesignator = "午前";
GcTime1.PMDesignator = "午後";
GcTime1.Format.Pattern = "tt hh時 mm分";
GcTime1.DisplayFormat.Pattern = "tt hh時 mm分";
Imports GrapeCity.Web.Input.IMDate

' 時刻の書式を設定します。
GcTime1.AMDesignator = "午前"
GcTime1.PMDesignator = "午後"
GcTime1.Format = New TimeFormat("tt hh時 mm分")
GcTime1.DisplayFormat = New TimeDisplayFormat("tt hh時 mm分")
using GrapeCity.Web.Input.IMDate;

// 時刻の書式を設定します。
GcTime1.AMDesignator = "午前";
GcTime1.PMDesignator = "午後";
GcTime1.Format = new TimeFormat("tt hh時 mm分");
GcTime1.DisplayFormat = new TimeDisplayFormat("tt hh時 mm分");
参照

GcTime クラス
GcTime メンバ
TimeDisplayFormat クラス
Format プロパティ
AMDesignator プロパティ
PMDesignator プロパティ

 

 


© 2005-2015 GrapeCity inc. All rights reserved.