GrapeCity InputMan for Windows Forms 11.0J
主な機能と設定方法

郵便番号コントロールの基本的な使い方について解説します。

JPAddress for Windows Formsの準備

郵便番号コントロールの機能は、「JPAddress for Windows Forms(以下、JPAddress)」を利用して実現されており、検索機能を利用するためにはJPAddress のインストールが必要です。また、検索機能を使用するためには、JPAddress のGcJPAddress コンポーネントをページに配置する必要があります。
詳細については「JPAddress for .NETとの連携」を参照してください。

書式の設定

郵便番号コントロールの入力フィールドには次の4つのフィールドが設定されており、これらのフィールドオブジェクトを使って書式が設定されています。なお、これらの入力フィールドはFields プロパティから参照されています。

郵便番号コントロールでは、これらのフィールドを追加したり削除したりすることはできません。接頭語やリテラルを非表示にしたい場合には、各フィールドのText プロパティを削除します。

また、ZipCodeCharType プロパティを使用すると、入力可能な郵便番号用数値を全角か半角かのとちらかに限定することができます。

プロパティ値 説明
HalfWidthDigit 郵便番号を半角で入力/表示します。
FullWidthDigit 郵便番号を全角で入力/表示します。
検索の対象と出力用コントロール

郵便番号コントロールは入力された郵便番号から住所などの検索を行い、検索結果を指定したコントロールに出力します。QueryMode プロパティで住所の郵便番号と大口事業所の個別郵便番号、もしくはその両方を対象として検索を行うかどうかを設定できます。

プロパティ値 説明
GeneralZipCode 住所の郵便番号を対象に検索を行います。
CompanyZipCode 大口事業所の個別郵便番号を対象に検索を行います。
Both 住所の郵便番号と大口事業所の個別郵便番号の両方を対象に検索を行います。

検索結果を出力するコントロールは以下のプロパティで設定します。また、住所情報が変更されたときにはAddressOutputting イベントが発生します。

次のサンプルコードは、テキストコントロールに住所の郵便番号の結果を出力します。郵便番号は全角で表示します。

Imports GrapeCity.Win.Editors

' 住所と住所のカナを出力するコントロールを指定します。
GcPostal1.AddressOutput = GcTextBox1
GcPostal1.AddressKanaOutput = GcTextBox2

' 検索対象に住所の郵便番号を指定します。
GcPostal1.QueryMode = GcAddressProvider.ZipCodeQueryMode.GeneralZipCode
' 郵便番号を全角で表示します。
GcPostal1.ZipCodeCharType = ZipCodeCharType.FullWidthDigit
using GrapeCity.Win.Editors;

// 住所と住所のカナを出力するコントロールを指定します。
gcPostal1.AddressOutput = gcTextBox1;
gcPostal1.AddressKanaOutput = gcTextBox2;

// 検索対象に住所の郵便番号を指定します。
gcPostal1.QueryMode = GcAddressProvider.ZipCodeQueryMode.GeneralZipCode;
// 郵便番号を全角で表示します。
gcPostal1.ZipCodeCharType = ZipCodeCharType.FullWidthDigit;
検索結果のカスタマイズ

郵便番号から検索される住所などの情報は、次の2つのプロパティによって結果をカスタマイズできます。

SplitAreaDetails プロパティ

同じ郵便番号に複数の丁目が含まれているときにそれぞれを分割するかどうかを取得または設定します。
郵便番号によっては、ひとつの郵便番号に複数の丁目が含まれている場合があります。こういった場合に、それぞれを分割して別々のレコードとするか、複数の丁目がまとまったままのひとつのレコードとするかを設定します。

たとえば、〒105-0022は「東京都港区海岸(1、2丁目)」と登録されています。これを

と別々のレコードとして扱うか

とひとつのレコードとして扱うかを指定します。

SplitAreaDetails プロパティをTrue に設定してそれぞれを別々のレコードとして扱った場合、分割した最初のレコードが検索結果として返されます。

GenerateCompanyAddressKana プロパティ

大口事業所の検索結果に住所のカナを含めるかどうかを取得または設定します。
大口事業所の個別郵便番号の検索結果にのみ有効です。住所の郵便番号の場合には住所のカナは必ず含まれます。

関連トピック

 

 


© 2004 GrapeCity inc. All rights reserved.