JPAddress for .NETの準備
GcPostalBarCode コントロールの機能は、別製品「JPAddress for .NET(以下、JPAddress)」を利用して実現されており、カスタマバーコードの作成機能を利用するためには JPAddress のインストールおよび開発ライセンスが必要です。
詳細については「JPAddress for .NETとの連携」を参照してください。
詳細については「JPAddress for .NETとの連携」を参照してください。
入力用コントロールの設定
GcPostalBarCode コントロールは入力された郵便番号や住所、大口事業所の個別郵便番号の情報からカスタマバーコード(郵便バーコード)を生成するためのバーコード用キャラクタを作成し、カスタマバーコードを表示します。スタートコードとストップコード、およびチェックデジットは自動的に追加されます。
郵便番号や大口事業所の個別郵便番号を入力するコントロール、住所を入力するコントロールは以下のプロパティで設定します。
次のサンプルコードでは、郵便番号と住所を入力するコントロールを指定しています。
郵便番号や大口事業所の個別郵便番号を入力するコントロール、住所を入力するコントロールは以下のプロパティで設定します。
- ZipCodeInputControlプロパティ(郵便番号を入力するコントロールを取得または設定します。)
- AddressInputControlプロパティ(住所を入力するコントロールを取得または設定します。)
次のサンプルコードでは、郵便番号と住所を入力するコントロールを指定しています。
' TextBox1に入力された郵便番号からカスタマバーコードを作成します。 GcPostalBarCode1.ZipCodeInputControl = TextBox1 ' TextBox2に入力された住所からカスタマバーコードを作成します。 GcPostalBarCode1.AddressInputControl = TextBox2
// textBox1に入力された郵便番号からカスタマバーコードを作成します。 gcPostalBarCode1.ZipCodeInputControl = textBox1; // textBox2に入力された住所からカスタマバーコードを作成します。 gcPostalBarCode1.AddressInputControl = textBox2;
郵便番号や住所の設定
入力用コントロールを指定しないで直接設定する場合には、AddressプロパティやZipCodeプロパティを設定します。
' 郵便番号を設定します。 GcPostalBarCode1.ZipCode = "1130033" ' 住所を設定します。 GcPostalBarCode1.Address = "東京都文京区本郷7丁目3−1"
// 郵便番号を設定します。 gcPostalBarCode1.ZipCode = "1130033"; // 住所を設定します。 gcPostalBarCode1.Address = "東京都文京区本郷7丁目3−1";
バーコード用キャラクタ作成時のエラー
GcPostalBarCode コントロールに設定された郵便番号が不正または該当する住所がないなどでバーコード用キャラクタを作成できない場合は、値(Value プロパティ)が初期値(12345)にリセットされます。その際、HasError プロパティがTrueに設定されてHasErrorChangedイベントが発生します。
Private Sub GcPostalBarCode1_HasErrorChanged(sender As Object, e As EventArgs) Handles GcPostalBarCode1.HasErrorChanged ' 郵便番号や住所が不正な場合 If GcPostalBarCode1.HasError Then MessageBox.Show("入力された値が不正です") End If End Sub
private void gcPostalBarCode1_HasErrorChanged(object sender, EventArgs e) { // 郵便番号や住所が不正な場合 if (gcPostalBarCode1.HasError) { MessageBox.Show("入力された値が不正です"); } }