このプロパティは、入力マスクの特定の位置にユーザー入力が必要であることを示す文字を設定するときに使用します。どのような文字を使用してもかまいませんが、標準の入力プロンプト文字はアンダースコア(_)です。
このプロパティに設定できるのは 1 文字だけです。複数の文字を割り当てようとすると、エラーが発生します。
列のセルへのデータ入力のマスク方法を指定するときは MaskInput プロパティを使用します。マスクには通常、ユーザーが入力するデータを区切るためのリテラル文字が含まれます。このプロパティは、MaskInput プロパティが設定されている(つまり、データマスキングが有効である)場合以外は効果がありません。
データマスキングを有効にすると、MaskClipMode プロパティによってクリップボードへのセル値のコピー方法を指定できます。また、MaskDataMode プロパティによってデータソースによるセル値の保存方法を指定し、MaskDisplayMode プロパティによってセル値の表示方法を指定できます。
Imports Infragistics.Shared Imports Infragistics.Win Imports Infragistics.Win.UltraWinGrid Private Sub Button17_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button17.Click Dim column As UltraGridColumn = Me.ultraGrid1.DisplayLayout.Bands(0).Columns("Phone") ' Enable masked input in a column by setting the MaskInput property. column.MaskInput = "(###) ###-####" ' Set various mask modes. These mask modes effect how what is included when data ' is committed to the cell, when it's displayed and when it's copied. MaskMode of ' Raw does not include literals and prompt characters. So for this particular mask, ' only thig that is going to be put in the data source will be just the digits, ' Literals will be stripped out (in this example, literals are '(', ')', ' ', '-' ' characters.) column.MaskDataMode = MaskMode.Raw column.MaskDisplayMode = MaskMode.IncludeBoth column.MaskClipMode = MaskMode.IncludeLiterals ' PadChar and PromptChar properties effect which characters are used as pad character ' and prompt character in masked input cells. Padchar is the character that gets ' substituted in place of an empty character when the MaskMode of ' IncludeLiteralsWithPadding is applied. PromptChar is the character that's used ' for prompting. Default for PadChar is ' ' (space character) and for PromptChar is ' '_' (an underscore). Me.ultraGrid1.DisplayLayout.Bands(0).Columns(0).PadChar = " " Me.ultraGrid1.DisplayLayout.Bands(0).Columns(0).PromptChar = "_" End Sub
using Infragistics.Shared; using Infragistics.Win; using Infragistics.Win.UltraWinGrid; using System.Diagnostics; private void button17_Click(object sender, System.EventArgs e) { UltraGridColumn column = this.ultraGrid1.DisplayLayout.Bands[0].Columns["Phone"]; // Enable masked input in a column by setting the MaskInput property. column.MaskInput = "(###) ###-####"; // Set various mask modes. These mask modes effect how what is included when data // is committed to the cell, when it's displayed and when it's copied. MaskMode of // Raw does not include literals and prompt characters. So for this particular mask, // only thig that is going to be put in the data source will be just the digits, // Literals will be stripped out (in this example, literals are '(', ')', ' ', '-' // characters.) column.MaskDataMode = MaskMode.Raw; column.MaskDisplayMode = MaskMode.IncludeBoth; column.MaskClipMode = MaskMode.IncludeLiterals; // PadChar and PromptChar properties effect which characters are used as pad character // and prompt character in masked input cells. Padchar is the character that gets // substituted in place of an empty character when the MaskMode of // IncludeLiteralsWithPadding is applied. PromptChar is the character that's used // for prompting. Default for PadChar is ' ' (space character) and for PromptChar is // '_' (an underscore). this.ultraGrid1.DisplayLayout.Bands[0].Columns[0].PadChar = ' '; this.ultraGrid1.DisplayLayout.Bands[0].Columns[0].PromptChar = '_'; }