DisplayMode プロパティ

コントロールが編集モードではなく、データ マスクが有効な時に、コントロールのコンテンツをどのようにクリップボードにコピーするのかを決める値を取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property DisplayMode As Infragistics.Win.UltraWinMaskedEdit.MaskMode

C#

public Infragistics.Win.UltraWinMaskedEdit.MaskMode DisplayMode {get; set;}

解説

このプロパティは、コントロールが編集モードでないときにマスクのリテラルとプロンプト文字がどのように表示されるかを決定します。コントロールのテキストは、このプロパティの設定に基づいて次のいずれかになります。すなわち、プロンプト文字もリテラルも一切含まない (生データのみ)、データとリテラルのみを含む、データとプロンプト文字のみを含む、またはプロンプト文字もリテラルも含むテキスト全体のいずれかです。部分的マスク値の書式設定されたスペースは、リテラルをパディングと共に含むよう指定することで保持できます。この場合、データとリテラル文字は含まれますが、プロンプト文字はパッド文字 (通常はスペース) に置き換えられます。

通常、セルが編集モードでなくなると、ユーザーへの視覚的な合図として、プロンプト文字は非表示になります。ただしアプリケーションによっては、セルが編集モードでなくなっても、データと共にマスクのリテラルも表示する方が適切な場合があります。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinMaskedEdit

  Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load

      ' InputMask をマスクに設定します
      Me.ultraMaskedEdit1.InputMask = "mm/dd/yyyy"

      ' DisplayMode、DataMode、ClipMode の値を設定しますDataMode は
      ' Text プロパティ (データは文字列型の場合に Value プロパティも) を返すことを指定します
      ' DisplayMode は、マスク エディターにフォーカスがない場合に表示されることを影響します
      ' ClipMode は、ユーザーが UltraMaskedEdit のテキストをコピーするときに
      ' クリップボードに何がコピーされるかに影響します
      Me.ultraMaskedEdit1.DataMode = MaskMode.IncludeLiterals
      Me.ultraMaskedEdit1.DisplayMode = MaskMode.IncludeLiterals
      Me.ultraMaskedEdit1.ClipMode = MaskMode.IncludeBoth

      ' スピン ボタンを表示するには、SpinButtonDisplayStyle を 
      ' OnRight または OnLeft に設定しますスピン ボタンを使用すると、数値を簡単に
      ' 増加または減少できます数値または日時セクションのみで 
      ' 使用できます
      Me.ultraMaskedEdit1.SpinButtonDisplayStyle = SpinButtonDisplayStyle.OnRight

      ' スピン ボタンのスタイルも設定できます
      Me.ultraMaskedEdit1.SpinButtonStyle = UIElementButtonStyle.PopupBorderless

      ' 境界線スタイルを設定します
      Me.ultraMaskedEdit1.BorderStyle = UIElementBorderStyle.InsetSoft

      ' DisplayStyle を表示スタイルに設定しますBorderStyle プロパティ設定は、
      ' DisplayStyle を Standard 以外の値に設定した場合は無視されます
      Me.ultraMaskedEdit1.DisplayStyle = EmbeddableElementDisplayStyle.Standard

      ' PromptChar を文字に設定しますデフォルトは、"_" (アンダースコア文字) です 
      Me.ultraMaskedEdit1.PromptChar = "_"

      ' PadChar を文字に設定しますデフォルトは、" " (スペース文字) です
      Me.ultraMaskedEdit1.PadChar = " "

      ' マスク エディター内のテキストのパッディングをピクセルに設定できます
      ' デフォルトは 1 です。
      Me.ultraMaskedEdit1.Padding = 2

      ' Value プロパティを設定すると、最初の値を割り当てます
      Me.ultraMaskedEdit1.Value = DateTime.Now

      ' MinValue と MaxValue を設定しますユーザー入力がこの制限以外の値の場合、 
      ' 無効な入力であると見なされます。無効な値があるコントロールのフォーカスを
      ' 解除しようとすると、マスク エディターは
      ' MaskValidationError を発生します
      Me.ultraMaskedEdit1.MinValue = New DateTime(1990, 1, 1)
      Me.ultraMaskedEdit1.MaxValue = New DateTime(2010, 12, 31)

	' SpinWrap プロパティは、コントロールのスピン ボタンの値を循環させるかどうかを
	' 示す値を取得または設定しますTrue の場合、スピン ボタンは Min および Max 値に基づいて
	' 値を増加/減少します
	Me.ultraMaskedEdit1.SpinWrap = True

  End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinMaskedEdit;
using System.Diagnostics;

private void Form1_Load(object sender, System.EventArgs e)
{
	// InputMask をマスクに設定します
	this.ultraMaskedEdit1.InputMask = "mm/dd/yyyy";

	// DisplayMode、DataMode、ClipMode の値を設定しますDataMode は
	// Text プロパティ (データは文字列型の場合に Value プロパティも) を返すことを指定します
	// DisplayMode は、マスク エディターにフォーカスがない場合に表示されることを影響します
	// ClipMode は、ユーザーが UltraMaskedEdit のテキストをコピーするときに
	// クリップボードに何がコピーされるかに影響します
	this.ultraMaskedEdit1.DataMode    = MaskMode.IncludeLiterals;
	this.ultraMaskedEdit1.DisplayMode = MaskMode.IncludeLiterals;
	this.ultraMaskedEdit1.ClipMode    = MaskMode.IncludeBoth;

	// スピン ボタンを表示するには、SpinButtonDisplayStyle を 
	// OnRight または OnLeft に設定しますスピン ボタンを使用すると、数値を簡単に
	// 増加または減少します数値または日時セクションのみで 
	// 使用できます
	this.ultraMaskedEdit1.SpinButtonDisplayStyle = SpinButtonDisplayStyle.OnRight;

	// スピン ボタンのスタイルも設定できます
	this.ultraMaskedEdit1.SpinButtonStyle = UIElementButtonStyle.PopupBorderless;

	// 境界線スタイルを設定します
	this.ultraMaskedEdit1.BorderStyle = UIElementBorderStyle.InsetSoft;

	// DisplayStyle を表示スタイルに設定しますBorderStyle プロパティ設定は、
	// DisplayStyle を Standard 以外の値に設定した場合は無視されます
	this.ultraMaskedEdit1.DisplayStyle = EmbeddableElementDisplayStyle.Standard;

	// PromptChar を文字に設定しますデフォルトは、'_' (アンダースコア文字) です 
	this.ultraMaskedEdit1.PromptChar = '_';
	
	// PadChar を文字に設定しますデフォルトは、' ' (スペース文字) です
	this.ultraMaskedEdit1.PadChar = ' ';

	// マスク エディター内のテキストのパッディングをピクセルに設定できます
	// デフォルトは 1 です。
	this.ultraMaskedEdit1.Padding = 2;

	// Value プロパティを設定すると、最初の値を割り当てます
	this.ultraMaskedEdit1.Value = DateTime.Now;

	// MinValue と MaxValue を設定しますユーザーの入力がこの制限以外の値の場合に 
	// 無効な入力です。無効な値があるコントロールのフォーカスを
	// 解除しようとすると、マスク エディターは
	// MaskValidationError を発生します
	this.ultraMaskedEdit1.MinValue = new DateTime( 1990, 1, 1 );
	this.ultraMaskedEdit1.MaxValue = new DateTime( 2010, 12, 31 );

      // SpinWrap プロパティは、コントロールのスピン ボタンの値を循環させるかどうかを
      // 示す値を取得または設定しますTrue の場合、スピン ボタンは Min および Max 値に基づいて
      // 値を増加/減少します
       this.ultraMaskedEdit1.SpinWrap = true;
		
}