オブジェクトのテキストを特定の書式で扱う必要があるときに、マスキングプロパティ(ClipMode 、DataMode 、または DisplayMode)の設定を変更したくない場合があります。たとえば、リテラルとプロンプト文字をすべて含む形式でオブジェクトのテキストを取得したいが、データベースへのデータの送信方法を変更したり、クリップボードを使用したりはしたくない場合などです。このような要求に対応することが GetText メソッドの目的です。
GetText はオブジェクトのテキストを含む文字列の値を、指定した書式で返します。GetText メソッドを呼び出すときは、オブジェクトのテキストをどのような書式で受け取るのかを指定するmaskmodeパラメーターを渡します。これにより、オブジェクトのマスキング プロパティの設定を無視して、プロンプト文字やリテラルを含むか、またはユーザーが入力した生のテキストのみにするかをその場限りで指定できます。
Imports Infragistics.Shared Imports Infragistics.Win Imports Infragistics.Win.UltraWinMaskedEdit Private Sub UltraMaskedEdit1_ValueChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles ultraMaskedEdit1.ValueChanged ' マスク エディターの値が変更されたときに ValueChanged を発生します ' 以下のコードは、マスク エディターの値を出力します値が ' 無効な場合、テキストを出力します If Me.UltraMaskedEdit1.IsFullyInput Then Debug.WriteLine("ValueChanged: Valid Value. Value = " & Me.ultraMaskedEdit1.Value.ToString()) Else Debug.WriteLine("ValueChanged: Invalid Value. Text = " & Me.ultraMaskedEdit1.GetText(MaskMode.IncludeBoth)) End If End Sub
using Infragistics.Shared; using Infragistics.Win; using Infragistics.Win.UltraWinMaskedEdit; using System.Diagnostics; private void ultraMaskedEdit1_ValueChanged(object sender, System.EventArgs e) { // マスク エディターの値が変更したときに ValueChanged を発生します // 以下のコードは、マスク エディターの値を出力します値が // 無効な場合、テキストを出力します if ( this.ultraMaskedEdit1.IsFullyInput ) { Debug.WriteLine( "ValueChanged: Valid Value. Value = " + this.ultraMaskedEdit1.Value.ToString( ) ); } else { Debug.WriteLine( "ValueChanged: Invalid Value. Text = " + this.ultraMaskedEdit1.GetText( MaskMode.IncludeBoth ) ); } }