B1WS-0141-02Z0(00)
2008
年
6
月
Windows
Interstage Charset Manager
Standard Edition Web
入力
Agent V9
まえがき
本マニュアルの目的
本マニュアルは、Interstage Charset Manager Standard Edition Web 入力 Agent(以降では、"Charset-Web 入力"と略します)のコマンド リファレンスです。
Interstage Charset Manager とは、クライアント/サーバシステムでの日本語運用環境の整備・管理・保守を容易に行う機能を提供する、 富士通株式会社のソフトウェア製品です。
Charset-Web 入力は、ベンダ固有の文字や外字などを含む Web サーバ上の日本語文字列を扱う業務 Web アプリケーションにおい て、入力・表示・印刷を含めたソリューションを提供するシステムです。
表記上の約束
本マニュアルでは、次に示すマニュアル名称、略称および記号を使用しています。
マニュアル名称
・
マニュアル中で、自身を参照する場合は、「本マニュアル」と記述します。・
Charset-Web 入力のマニュアル名称を記述する場合、マニュアル名の先頭の「Interstage Charset Manager Standard Edition Web 入力 Agent V9」は省略し、「導入ガイド」「運用ガイド」「コマンドリファレンス」と記述する場合があります。Charset-Web 入力以外のマニュ アルを参照する際も、マニュアル名の先頭の製品名称を省略する場合があります。略称
正式名称 略称
Interstage Charset Manager Standard Edition Web 入力 Agent Charset-Web 入力
Interstage Charset Manager Web 入力 マルチ文字コードオプション マルチ文字コードオプション Interstage Studio Enterprise Edition
Interstage Studio Standard-J Edition
Interstage Studio
Interstage Business Application Server Standard Edition Interstage Business Application Server 以下の V9.1 製品に同梱されている Formcoordinator 機能
Interstage Business Application Server Standard Edition
Formcoordinator
以下の V9.1 製品に同梱されている Webcoordinator 機能 Interstage Application Server Standard-J Edition
Interstage Application Server Enterprise Edition Interstage Business Application Server Standard Edition
Webcoordinator
Interstage Application Server Enterprise Edition Interstage Application Server Standard-J Edition
Interstage Application Server
Interstage Charset Manager Standard Edition Charset Manager-M Interstage Charset Manager Standard Edition Agent Charset Manager-A Interstage Charset Manager 住所辞書オプション Charset-住所辞書オプション Interstage Charset Manager 氏名辞書オプション Charset-氏名辞書オプション Interstage Charset Manager 住所辞書オプション
Interstage Charset Manager 氏名辞書オプション
Charset-辞書オプション
Interstage Charset Manager 外字データライブラリオプション 外字データライブラリ Microsoft(R) Windows Server(R) 2008 Standard
Microsoft(R) Windows Server(R) 2008 Enterprise
正式名称 略称 Microsoft(R) Windows Server(R) 2008 Standard without Hyper-V(TM)
Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-V(TM) Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition Microsoft(R) Windows Server(R) 2003, Enterprise Edition Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Standard Edition Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Windows Server 2003 Standard Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Windows Server 2003 Enterprise Edition
Microsoft(R) Windows(R) 2000 Server operating system Windows 2000 Server
Microsoft(R) Windows(R) 2000 Advanced Server operating system Windows 2000 Advanced Server Microsoft(R) Windows(R) 2000 Professional operating system Windows 2000 Professional Microsoft(R) Windows(R) XP Professional operating system
Microsoft(R) Windows(R) XP Home Edition operating system
Windows XP
Microsoft(R) Windows Vista(R) Ultimate Microsoft(R) Windows Vista(R) Enterprise Microsoft(R) Windows Vista(R) Business Microsoft(R) Windows Vista(R) Home Premium Microsoft(R) Windows Vista(R) Home Basic
Windows Vista
BEA WebLogic Server (TM) WebLogic
Microsoft(R) Internet Information Server Microsoft(R) Internet Information Services
IIS
Microsoft(R) Internet Explorer 5.5
Microsoft(R) Internet Explorer 5.5 Service Pack 1 Microsoft(R) Internet Explorer 5.5 Service Pack 2
Internet Explorer 5.5
Microsoft(R) Internet Explorer 6.0
Microsoft(R) Internet Explorer 6.0 Service Pack 1 Microsoft(R) Internet Explorer 6.0 Service Pack 2
Internet Explorer 6.0
Microsoft(R) Internet Explorer 7.0 Internet Explorer 7.0 Microsoft(R) .NET Framework .NET Framework Microsoft(R) Visual Studio(R) .NET Visual Studio .NET Netscape 7.0
Netscape 7.01 Netscape 7.02
Netscape 7
・
次の製品について区別せずに指す場合は、「Windows」と表記しています。 Microsoft(R) Windows Server(R) 2008 StandardMicrosoft(R) Windows Server(R) 2008 Enterprise
Microsoft(R) Windows Server(R) 2008 Standard without Hyper-V(TM) Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-V(TM) Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition Microsoft(R) Windows Server(R) 2003 R2, Standard Edition Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition Microsoft(R) Windows(R) 2000 Server operating system
Microsoft(R) Windows(R) 2000 Advanced Server operating system Microsoft(R) Windows(R) 2000 Professional operating system Microsoft(R) Windows(R) XP Professional operating system Microsoft(R) Windows(R) XP Home Edition operating system
Microsoft(R) Windows Vista(R) Ultimate Microsoft(R) Windows Vista(R) Enterprise Microsoft(R) Windows Vista(R) Business Microsoft(R) Windows Vista(R) Home Premium Microsoft(R) Windows Vista(R) Home Basic
・
Charset Manager-M、Charset Manager-A、Charset-Web 入力を区別せずに指す場合は、「Charset Manager」と表記しています。ま た、Systemwalker CharsetMGR-M、Systemwalker CharsetMGR-A、Systemwalker CharsetMGR-A Web 入力について区別せずに 指す場合は「CharsetMGR」と表記しています。記号
本マニュアルでは、キーやメニューなどを表記するために、次のように記号を使用します。 記号 意味 [ ] 画面やダイアログボックスに表示される文字、およびキーボードのキーを示します。 例：[設定]ダイアログボックス、[ファイル]メニュー、[項目名]、[OK]ボタン、[Enter]キー [ ]－[ ] 画面のメニューとメニューコマンドを示します。 例：[ツール]メニューの[設定]コマンドの場合 [ツール]－[設定] ・ ・ ・ 途中を省略していることを示します。 例： <TABLE> ・ ・ ・ </TABLE> また、次のアイコン表記を使用します。注意
注意が必要な情報を示します。参考
参考記事を示します。例
例を示します。マニュアル体系と読み方
本マニュアルの読者
本マニュアルは、Charset-Web 入力の機能を利用した業務アプリケーションを作成される方を対象としています。 本マニュアルを参照することによって、Charset-Web 入力が提供する各機能の API やコマンドの使用方法を知ることができます。本マニュアルの構成
本マニュアルは、次の構成になっています。 第1章 JSVR部品ライブラリ JSVR 部品ライブラリのリファレンスです。 第2章 JSVR-Webサービスのインタフェース JSVR-Web サービスインタフェースのリファレンスです。 第3章辞書反映ツール 辞書反映ツールの機能リファレンスです。 第4章環境ファイル JSVR 部品運用で参照する環境ファイルのリファレンスです。 第5章 JSVR-Webサービス環境ファイル JSVR-Web サービス運用で参照する環境ファイルのリファレンスです。 第6章 JSVRChecker Charset-Web 入力のシステムの状態を確認するために使用する、JSVRChecker の機能リファレンスです。 第7章手書き文字認識サービス 手書き部品検索機能や手書き検索機能で使用する、手書き文字認識サービスの機能リファレンスです。 第8章 JSVRAXのリファレンス JSVRAX のリファレンスです。 用語集 本マニュアルで使用している用語について説明しています。マニュアル体系
マニュアル名称 内容Interstage Charset Manager Standard Edition Web 入力 Agent V9 導入ガイド
リリース情報、概要、インストール手順、およびアンインストール 手順について説明しています。
Interstage Charset Manager Standard Edition Web 入力 Agent V9 運用ガイド
運用手順、サンプルの内容、および他製品との連携などについ て説明しています。
Interstage Charset Manager Standard Edition Web 入力 Agent V9 コマンドリファレンス
(本マニュアル)
コマンドや関数インタフェースなどのリファレンスです。
関連マニュアル
本マニュアルを読むにあたり、次のマニュアルもあわせて参照してください。
・
Interstage Charset Manager Standard Edition 使用手引書 日本語資源管理編・
Interstage Charset Manager Web 入力 マルチ文字コードオプション ユーザーズガイド・
Interstage Charset Manager 住所辞書オプション ソフトウェア説明書・
Interstage Charset Manager 氏名辞書オプション ソフトウェア説明書・
難読苗字検索ライブラリ ソフトウェア説明書2008 年 6 月
Microsoft、Windows および Windows Server またはその他のマイクロソフト製品の名称および製品名は、米国 Microsoft Corporation の米国およびその他の国における登録商標または商標です。
その他の会社名および製品名は、それぞれの会社の登録商標もしくは商標です。 Microsoft Corporation のガイドラインに従って画面写真を使用しています。
目 次
第1章 JSVR部品ライブラリ...1 1.1 概要...1 1.1.1 インタフェースの種類...1 1.1.2 キャラクタセットについての注意...1 1.2 JSVR 部品ライブラリを使用する際の注意・制限事項...2 1.3 JavaScript インタフェース...3 1.3.1 使用方法...4 1.3.2 部品コントロールクラスのリファレンス...6 1.3.2.1 EJ_Control()...7 1.3.2.2 writeEJInput()...8 1.3.2.3 writeEJInputWithParam()...8 1.3.2.4 copyDefaultPropertyStruct()...9 1.3.2.5 copyPropertyStruct()...9 1.3.2.6 copyPropertyStructByName()...10 1.3.2.7 setPropertyStruct()...10 1.3.2.8 setPropertyStructByName()...11 1.3.2.9 getSubmitValue()...12 1.3.2.10 getSubmitValueByName()...12 1.3.2.11 getTextLength()...13 1.3.2.12 getTextLengthByName()...13 1.3.2.13 changeText()...14 1.3.2.14 changeTextByName()...14 1.3.2.15 resetText()...15 1.3.2.16 resetTextByName()...15 1.3.2.17 changeDspState()...15 1.3.2.18 changeDspStateByName()...16 1.3.2.19 focusEJInput()...17 1.3.2.20 focusEJInputByName()...17 1.3.3 プロパティ構造体のリファレンス...18 1.3.3.1 blnEditable...18 1.3.3.2 strCharsetName...19 1.3.3.3 strSubmitName...19 1.3.3.4 intTabindex...19 1.3.3.5 strDefaultText...19 1.3.3.6 strSearchId...20 1.3.3.7 intInputFontSize...20 1.3.3.8 intListFontSize...21 1.3.3.9 intListCount...21 1.3.3.10 intMaxTextLength...21 1.3.3.11 blnGrid...21 1.3.3.12 strDetailedStyle...21 1.3.3.13 strTextForeColor...22 1.3.3.14 strClassOnFocus...22 1.3.3.15 strClassOnBlur...22 1.3.3.16 strClassDisable...23 1.3.3.17 funcEventCallBack...23 1.3.4 代行メソッド群のリファレンス...23 1.3.4.1 ej_agt_getEJCInstance()...23 1.4 JSP カスタムタグインタフェース...24 1.4.1 JSP カスタムタグインタフェースを使用する際の準備...24 1.4.2 使用方法...25 1.4.3 リファレンス...27 1.4.3.1 EJInput...27 1.4.3.2 EJInputEnv...28 1.4.3.3 EJText...281.4.3.4 EJTextEnv...29 第2章 JSVR-Webサービスのインタフェース...30 2.1 概要...30 2.1.1 インタフェースの種類...30 2.1.2 JSVR-Web サービスの機能...30 2.2 JSVR-Web サービスのインタフェースを利用する際の制限・注意事項...31 2.3 JSVR-SOAP インタフェース...33 2.3.1 開発のための資源...34 2.3.2 文字辞書のリファレンス...34 2.3.2.1 getCharacters()...34 2.3.2.2 getCharactersCount()...35 2.3.2.3 getCharactersWithCount()...36 2.3.2.4 recognizeAsCharacter()...36 2.3.3 簡易文字辞書のリファレンス...37 2.3.3.1 getRawCharacters()...37 2.3.3.2 getRawCharactersCount()...38 2.3.3.3 getRawCharactersWithCount()...38 2.3.3.4 recognizeAsRawCharacter()...39 2.3.4 部首辞書のリファレンス...40 2.3.4.1 getRadicals()...40 2.3.4.2 getRadicalsCount()...40 2.3.4.3 getRadicalsWithCount()...41 2.3.5 文字部品辞書のリファレンス...42 2.3.5.1 getParts()...42 2.3.5.2 getPartsCount()...42 2.3.5.3 getPartsWithCount()...43 2.3.5.4 recognizeAsPart()...44 2.3.6 字形辞書のリファレンス...44 2.3.6.1 getGlyphs()...44 2.3.7 単語辞書/KUIN 氏名辞書のリファレンス...45 2.3.7.1 getWords() / getWordsByKuinName()...45 2.3.7.2 getWordsCount() / getWordsCountByKuinName()...46 2.3.7.3 getWordsWithCount() / getWordsWithCountByKuinName()...47 2.3.8 住所辞書/KUIN 住所辞書のリファレンス...47 2.3.8.1 getAddresses() / getAddressesByKuin()...48 2.3.8.2 getAddressesCount() / getAddressesCountByKuin()...48 2.3.8.3 getAddressesWithCount() / getAddressesWithCountByKuin()...49 2.3.9 クラスのリファレンス...50 2.3.9.1 WSCharacter...51 2.3.9.2 WSCharacterKeyword...52 2.3.9.3 WSSortOrder...55 2.3.9.4 WSCharacterMaximizer...56 2.3.9.5 WSRawCharacter...56 2.3.9.6 WSRadical...57 2.3.9.7 WSRadicalKeyword...58 2.3.9.8 WSRadicalMaximizer...59 2.3.9.9 WSPart...59 2.3.9.10 WSPartKeyword...59 2.3.9.11 WSPartMaximizer...60 2.3.9.12 WSGlyph...60 2.3.9.13 WSGlyphKeyword...61 2.3.9.14 WSImageSetting...62 2.3.9.15 WSGlyphMaximizer...62 2.3.9.16 WSWord...63 2.3.9.17 WSHinshi...63 2.3.9.18 WSWordKeyword...64 2.3.9.19 WSGroup...65
2.3.9.20 WSWordMaximizer...66 2.3.9.21 WSAddress...66 2.3.9.22 WSAddressKeyword...67 2.3.9.23 WSHierarchyAccess...68 2.3.9.24 WSAddressMaximizer...68 2.3.9.25 WSStrokeData...69 2.3.9.26 StrokeData_Rect...70 2.3.9.27 StrokeData_Pattern...70 2.3.9.28 StrokeData_PointShort...70 2.4 JSVR-CSV インタフェース...71 2.4.1 リクエストとレスポンス...71 2.4.2 文字辞書のリファレンス...73 2.4.3 部首辞書のリファレンス...74 2.4.4 文字部品辞書のリファレンス...75 2.4.5 字形辞書のリファレンス...75 2.4.6 文字字形辞書のリファレンス...76 2.4.7 単語辞書/KUIN 氏名辞書のリファレンス...77 2.4.8 住所辞書/KUIN 住所辞書のリファレンス...78 2.4.9 手書き文字認識(文字部品)のリファレンス...79 2.4.10 手書き文字認識(文字)のリファレンス...79 2.4.11 手書き文字認識(簡易文字)のリファレンス...80 第3章辞書反映ツール...82 3.1 概要...82 3.2 使用方法...82 3.3 運用形態...83 3.4 設定ファイル...83 第4章環境ファイル...87 4.1 概要...87 4.1.1 環境ファイルの位置...87 4.1.2 設定変更の手順...87 4.1.3 注意事項...87 4.2 設定項目...87 4.2.1 [SYSTEM]セクション...87 4.2.2 [ENV]セクション...88 4.2.3 [DB]セクション...90 4.2.4 [HANDWRITE]セクション...91 4.2.5 [UI]セクション...91 第5章 JSVR-Webサービス環境ファイル...95 5.1 概要...95 5.1.1 JSVR-Web サービス環境ファイルの位置...95 5.1.2 設定変更の手順...95 5.1.3 注意事項...96 5.2 設定項目...96 5.2.1 項目の一覧...96 5.2.2 JSVR-Web サービス環境ファイルの記述例...98 第6章 JSVRChecker...99 6.1 JSVRChecker とは...99 6.2 使用上の注意点...99 6.3 使用方法...99 6.4 チェック項目...100 6.5 チェック結果の出力...102 6.5.1 画面への出力例...102 6.5.2 ログへの出力例...102 6.5.3 出力情報の一覧...103
第7章手書き文字認識サービス...107 7.1 概要...107 7.2 使用方法...107 7.3 手書き文字認識サービス設定ファイル...107 7.3.1 手書き文字認識サービス設定ファイルの位置...107 7.3.2 設定変更の手順...107 7.3.3 設定項目...108 第8章 JSVRAXのリファレンス...109 8.1 概要...109 8.2 JSVRAX を利用する際の制限・注意事項...111 8.3 Environment HTC...111 8.3.1 機能と GUI...111 8.3.2 API...112 8.3.2.1 実装モジュールの URL...112 8.3.2.2 HTC 情報...112 8.3.2.3 拡張プロパティ...113 8.3.2.4 拡張メソッド...114 8.3.2.5 拡張イベント...114 8.3.2.6 拡張スタイル...115 8.3.2.7 使用例...115 8.4 Default HTC...115 8.4.1 機能と GUI...115 8.4.2 API...116 8.4.2.1 実装モジュールの URL...116 8.4.2.2 HTC 情報...116 8.4.2.3 拡張プロパティ...117 8.4.2.4 拡張メソッド...118 8.4.2.5 拡張イベント...118 8.4.2.6 拡張スタイル...118 8.4.2.7 使用例...118 8.5 InputValidator HTC...118 8.5.1 機能と GUI...118 8.5.2 API...119 8.5.2.1 実装モジュールの URL...120 8.5.2.2 HTC 情報...120 8.5.2.3 拡張プロパティ...120 8.5.2.4 拡張メソッド...121 8.5.2.5 拡張イベント...121 8.5.2.6 拡張スタイル...121 8.5.2.7 使用例...121 8.6 TSFAttacher HTC...122 8.6.1 機能と GUI...122 8.6.2 API...122 8.6.2.1 実装モジュールの URL...123 8.6.2.2 HTC 情報...123 8.6.2.3 拡張プロパティ...124 8.6.2.4 拡張メソッド...126 8.6.2.5 拡張イベント...127 8.6.2.6 拡張スタイル...128 8.6.2.7 使用例...128 8.7 Textarea HTC...128 8.7.1 機能と GUI...128 8.7.2 API...132 8.7.2.1 実装モジュールの URL...133 8.7.2.2 HTC 情報...133 8.7.2.3 拡張プロパティ...134
8.7.2.4 拡張メソッド...137 8.7.2.5 拡張イベント...137 8.7.2.6 拡張スタイル...137 8.7.2.7 使用例...139 8.8 JSVRAX.TSF...140 8.8.1 機能と GUI...140 8.8.2 JSVRAX.TSF.Result インタフェース...141 8.8.2.1 プロパティ...141 8.8.2.2 メソッド...141 8.8.3 JSVRAX.TSF.Result.TextInputImpl クラス...142 8.8.3.1 プロパティ...142 8.8.3.2 メソッド...142 8.9 JSVRAX.IME...142 8.9.1 インラインかな漢字変換 TIP の機能と GUI...142 8.9.2 インラインかな漢字変換 TIP の API...147 8.9.2.1 拡張プロパティ...147 8.9.2.2 拡張スタイル...150 8.9.3 文字検索ダイアログ TIP の機能と GUI...151 8.9.4 文字検索ダイアログ TIP の API...156 8.9.4.1 拡張プロパティ...156 8.9.4.2 拡張スタイル...156 8.9.5 動作環境設定 TIP の機能と GUI...157 8.9.6 JSVRAX.IMEIndicator クラス...157 8.9.7 JSVRAX.IMEIndicator.Mode クラス...158 8.9.7.1 メソッド...158 8.9.7.2 使用例...158 8.10 Utility...158 8.10.1 JSVRAX.Utility.CharBehavior インタフェース...158 8.10.1.1 メソッド...159 8.10.2 JSVRAX.Utility.CharBehavior.DimensionMap インタフェース...159 8.10.2.1 プロパティ...159 8.10.2.2 使用例...160 8.10.3 JSVRAX.Utility.CharBehavior.Parser クラス...161 8.10.3.1 メソッド...161 8.10.3.2 プロパティ...162 8.10.3.3 メソッド...163 8.10.3.4 使用例...163 8.10.4 JSVRAX.Utility.CharBehavior.Parser.Handler インタフェース...164 8.11 エレメントビヘイビアのインタフェースについて...164 8.12 通知情報...165 用語集...169 索引...172
第
1
章
JSVR
部品ライブラリ
この章では、Charset-Web 入力が提供する JSVR 部品ライブラリの使用方法について説明します。1.1
概要
ここでは JSVR 部品ライブラリで使用できるインタフェースの種類や、キャラクタセットについて説明します。1.1.1
インタフェースの種類
JSVR 部品とは、Charset-Web 入力が提供する Web ページ用のプログラム部品です。JSVR 部品には、かな漢字変換ライクな操作に よる文字列の入力が可能な「JSVR 文字入力部品」と、文字列の表示のみが可能な「JSVR 文字表示部品」があり、JSVR 部品ライブラ リを介して使用します。JSVR 部品ライブラリには、次の 2 種類のインタフェースがあります。 JavaScriptインタフェース JavaScript インタフェースは、次の機能を提供します。－
JSVR 文字入力部品の書き出し－
書き出した JSVR 文字入力部品に対する操作(値の取得・変更など) JSPカスタムタグインタフェース JSP カスタムタグインタフェースは、次の機能を提供します。－
JSVR 文字入力部品の書き出し－
JSVR 文字表示部品の書き出し注意
・
運用文字コードが EJ_KIBAN の場合、JSVR 部品を使用することはできません。・
本マニュアルでは、JSVR 部品を指すことが明らかな場合には、単に「部品」と記述することがあります。1.1.2
キャラクタセットについての注意
JSVR 部品を利用した Web ページを作成する場合は、その Web ページが、運用文字コードに適したキャラクタセットでレスポンスされ る必要があります。 各運用文字コードに対応する Web ページのキャラクタセットは次のとおりです。なお、運用文字コードを表すリテラルについては、 「1.3.3.2 strCharsetName」の表を参照してください。 運用文字コードを表すリテラル キャラクタセット EJ_SJIS Windows-31J (*1)EJ_UNICODE, EJ_UNICODE2004MS UTF-8
EJ_UNIJEF UTF-8
EJ_SJIS_ENC, EJ_UNICODE_ENC, EJ_UNIJEF_ENC, EJ_JEF, EJ_KEIS, EJ_JIPS, EJ_DBCS Windows-31J (*1), Shift_JIS,UTF-8 *1 : 注意事項「Windows-31J を使用する際の注意」を参照してください。 静的な HTML の場合は、キャラクタセットに応じて、次の 1 と 2 を表に従って設定すると、レスポンスのキャラクタセットを制御すること ができます。
1.
HTML 文書の保存エンコーディング2.
<META>によるキャラクタセットの指定キャラクタセット 処理 Windows-31J (*1)
1.
シフト JIS2.
<META http-equiv="Content-Type" content="text/html; charset=Windows-31J">UTF-8
1.
UTF-82.
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">シフト JIS
1.
シフト JIS2.
<META http-equiv="Content-Type" content="text/html; charset=Shift_JIS"> *1 : 注意事項「Windows-31J を使用する際の注意」を参照してください。注意
Windows-31J を使用する際の注意 HTML の<META>に"Windows-31J"を指定すると、Internet Explorer がこれを誤認識し、文字化けやスクリプトエラーが発生することが あります。これは、<META>によるキャラクタセットの指定を、"Windows-31J"の代わりに"Shift_JIS"とすることで回避できます。 ただし、JSP/Servlet/CGI など、ブラウザ以外のシーンにおける文字エンコーディングの指定については、それぞれのプラットフォーム が定めた正しい文字エンコーディングを指定してください。例えば、JSP/Servlet 内では、"Windows-31J"を指定してください。また、環 境ファイルの HTML_CHARSET の値も、"Windows-31J"のままご利用ください。 指定の例 運用文字コードが EJ_SJIS で、JSP で Web ページを作成していた場合 設定項目 値 環境ファイルの HTML_CHARSET Windows-31J JSP 内の response 用文字エンコーディング Windows-31J JSP が出力する HTML の<META>記述 Shift_JIS注意
JSP/Servlet/CGI などの動的な Web ページの場合は、response オブジェクトに対するキャラクタセットも明示的に指定する必要がありま す。
1.2
JSVR
部品ライブラリを使用する際の注意・制限事項
・
frame および iframe でなく、style.overflow にてスクロールを実装しているエレメント内に JSVR 部品を置く場合は、次の注意が必 要です。－
マウスホイールでのスクロール操作、およびインライン変換リストを表示した状態でのスクロールバー操作を行うと、部品本体だ けがツールバーを残してスクロールしてしまいます。 この場合は、部品のフォーカスをあてなおすと、正しい表示位置に戻ります。 なお、frame および iframe を利用することで、この現象を回避することができます。・
JSVR 部品を使用する form 内では、[Enter]キーでフォームが送信(submit)されないように実装する必要があります。[Enter]キーで フォームが送信されるように実装すると、JSVR 部品上で文字を直接確定(かな漢字変換せずに、読みのまま[Enter]キーを押す)し た場合、送信処理が動作することがあります。・
JSVR 部品の出力文字サイズを小さくした場合、文字がつぶれることがあります。出力文字サイズについては、アプリケーションの 画面設計時に次の点を十分検討してください。－
11px 以下の場合、文字がつぶれ、出力品質が極端に低下します。－
12px 以上 24px 未満の場合、使用頻度の高い内字にはラスタフォントが使用され可読性は保てます。しかし、外字にはラスタ フォントは使用されないため、文字がつぶれます。－
24px 以上であっても、複雑な字形の場合は文字がつぶれることがあります。・
JSVR 部品の出力文字サイズを 12 ～ 24px にした場合、頻度の高い内字については、ラスタフォントが使用されます。その際、縦 横線分などを間引いた省略字形が使用されます。正確な字形を確認する場合は、出力文字サイズを大きくするか、文字の「プロパ ティ」ダイアログを使用してください。・
JSVR 部品にアクセスする場合、必ず Charset-Web 入力のシステムが提供するアクセスメソッドを使用してください。JSVR 部品が 持つエレメントに対し、規定のアクセスメソッドを用いず、直接参照・書き換えなどのアクセスを行った場合、正常に動作しないこと があります。 特に、document.all()、document.getElementsByTagName() などで不特定エレメントへのアクセスを行うと、本規約違反になります ので、充分ご注意ください。・
JSVR 部品に対するイベントフローを変更・遅延させると、正常に動作しない可能性があります。部品が動作している間は、keydown のフックや、ダイアログ表示などは行わないようご注意ください。 例えば、Internet Explorer5.5 以上をお使いで、サブミット時にダイアログを表示する設定になっている場合は、インライン変換リスト でページ移動する際にこのダイアログが表示され、変換リストが消えてしまうことがあります。・
td, div{…}などによる、不特定エレメントに対するスタイル定義を行った場合、JSVR 部品が正常に動作しないことがあります。 id や class 属性を用いて、特定エレメントにのみ適用するようにしてください。・
String, Array など、JavaScript が標準実装しているオブジェクトを拡張すると、JSVR 部品が正常に動作しないことがあります。・
Charset-Web 入力が使用している変数名、関数名と同じ名前の変数・関数などを定義した場合、JSVR 部品が正常に動作しない ことがあります。 Charset-Web 入力で使用している名前の prefix は次のとおりです。 項目 prefix 変数名 ej_ 関数名 ej_ オブジェクト名 EJ_ CSS-Style クラス名 EJ_ また、次に示す関数名を使用しています。－
isKana()－
isNumber()－
cnvNumberEmEn()・
JSVR 部品の左下に、DIV エレメントの描画を上書きしてしまうエレメント(SELECT、FRAME、IFRAME、ActiveX 等)を配置する と、これらのエレメントによって JSVR 部品のツールバーが隠されてしまうことがあります。画面レイアウト時にはこれらのエレメントの 配置に注意してください。1.3
JavaScript
インタフェース
JavaScript インタフェースについて、使用方法と API リファレンスを説明します。 使用方法 「1.3.1 使用方法」 APIリファレンス 内容 参照先 部品コントロールクラス 「1.3.2 部品コントロールクラスのリファレンス」 プロパティ構造体 「1.3.3 プロパティ構造体のリファレンス」 代行メソッド群 「1.3.4 代行メソッド群のリファレンス」1.3.1
使用方法
次のサンプルコードにそって、使用方法を説明します。
◆サンプルコード
<HTML> <HEAD>
<META http-equiv="content-type" content="text/html; charset=Shift_JIS">
<script src="/j_svr/page/ime/ej_js_include.jsp" 1. charset="Shift_JIS"></script> <script language="JavaScript"> <!--var objEJC 2. = new EJ_Control( true, "EJ_SJIS", "", 0, "あいうえお", "20|30|40", 24, 18, 10, 50, true, "", "2F4F4F", "FocusStyle", "BlurStyle", "", catchEvent); function catchEvent(_strEventType, _intIndex) { ... } //--> </script> <style type="text/css"> <!--.FocusStyle { border:2px inset; background-color:white; } .BlurStyle { border:2px inset; background-color:darkseagreen; } --> </style> <BODY> <FORM action="..."> 名前を入力してください<br> <script language="JavaScript"> 3. <!--var struct = objEJC.copyDefaultPropertyStruct(); *1
struct.strSubmitName = "name"; *2 struct.strSearchId = "40|20"; *3 objEJC.writeEJInput(struct); *4 //--> </script> <br> 住所を入力してください<br> <script language="JavaScript"> 4. <!--struct = objEJC.copyDefaultPropertyStruct(); *1 struct.strSubmitName = "address"; *2 struct.strSearchId = "30|20"; *3 objEJC.writeEJInput(struct); *4 //--> </script> <br> <INPUT type="submit"> </FORM> </BODY> </HTML>
◆全体の流れ
JavaScript インタフェースを使用する場合の流れは次のとおりです。1.
JavaScript インタフェースの JSVR 部品ライブラリのインクルード2.
部品コントロールクラスのクリエイト3.
部品の書き出し1. JavaScript
インタフェースの
JSVR
部品ライブラリのインクルード
JSVR 部品ライブラリをインクルードします。注意
・
スクリプトライブラリロード時のパス(例では"/j_svr/page/ime/")は、環境ファイルの SCRIPT_PATH と同じ文字列を指定してくださ い。・
スクリプトライブラリロード時の charset(例では"Shift_JIS")は、環境ファイルの HTML_CHARSET と揃える必要があります。詳しく は、「1.1.2 キャラクタセットについての注意」を参照してください。2.
部品コントロールクラスのクリエイト
すべてのアクセスメソッドはこのクラスのメンバであるため、メソッドの利用前にクリエイトが必要です。クリエイト時のパラメータは、この Web ページにおける JSVR 文字入力部品のデフォルト値を定義したプロパティ構造体に保存されます。注意
・
部品コントロールクラスのクリエイトは、Web ページで 1 回だけ行ってください。・
「1.3.2.1 EJ_Control()」もあわせて参照してください。3. JSVR
文字入力部品の書き出し
(
名前入力用
JSVR
部品
)
名前入力用プロパティの設定例です。 *1 この Web ページにおける JSVR 文字入力部品のデフォルトプロパティ構造体のコピーを取得 *2 サブミット時の name 属性を"name"に変更 *3 変換種別を"40|20"(氏名優先|標準変換)に変更 *4 変更したプロパティで部品書き出し注意
・
JSVR 文字入力部品は、必ず<FORM>エレメントで囲ってください。・
「1.3.2.4 copyDefaultPropertyStruct()」「1.3.2.2 writeEJInput()」もあわせて参照してください。4. JSVR
文字入力部品の書き出し
(
住所入力用
JSVR
部品
)
住所入力用プロパティの設定例です。 *1 この Web ページにおける JSVR 文字入力部品のデフォルトプロパティ構造体のコピーを取得 *2 サブミット時の name 属性を"address"に変更 *3 変換種別を"30|20"(住所入力|標準変換)に変更 *4 変更したプロパティで部品書き出し注意
・
JSVR 文字入力部品は、必ず<FORM>エレメントで囲ってください。・
「1.3.2.4 copyDefaultPropertyStruct()」「1.3.2.2 writeEJInput()」もあわせて参照してください。1.3.2
部品コントロールクラスのリファレンス
名称
EJ_Control解説
本クラスは、JSVR 文字入力部品を Web ページ上で動作させるためのクラスです。本クラスのメンバを使い、部品の書き出しや、書き 出し済の部品へのアクセスなどを行います。メソッド
名称 機能 EJ_Control() 部品コントロールクラスを構築する (コンストラクタ) writeEJInput() 部品を書き出す writeEJInputWithParam() 部品を書き出す copyDefaultPropertyStruct() 現在の Web ページにおける JSVR 文字入力部品のデフォルトプロパティ構造体のコピーを 取得する copyPropertyStruct() 指定 ID の部品が保持しているプロパティ構造体のコピーを取得する copyPropertyStructByName() 指定サブミット名の部品が保持しているプロパティ構造体のコピーを取得する setPropertyStruct() 指定 ID の部品が保持しているプロパティ構造体を変更する setPropertyStructByName() 指定サブミット名の部品が保持しているプロパティ構造体を変更する getSubmitValue() 指定 ID の部品が保持しているサブミット値を取得する getSubmitValueByName() 指定サブミット名の部品が保持しているサブミット値を取得する getTextLength() 指定 ID の部品の表示文字列長を取得する getTextLengthByName() 指定サブミット名の部品の表示文字列長を取得する changeText() 指定 ID の部品の表示文字列を変更する changeTextByName() 指定サブミット名の部品の表示文字列を変更する resetText() 指定 ID の部品の表示文字列をリセットする resetTextByName() 指定サブミット名の部品の表示文字列をリセットする changeDspState() 指定 ID の部品の表示状態を変更する changeDspStateByName() 指定サブミット名の部品の表示状態を変更する focusEJInput() 指定 ID の部品をフォーカスする focusEJInputByName() 指定サブミット名の部品をフォーカスするプロパティ
すべて非公開1.3.2.1
EJ_Control()
解説
部品コントロールクラスのオブジェクトを構築します。
構文
EJ_Control(blnEditable, strCharsetName, strSubmitName, intTabindex, strDefaultText, strSearchId,
intInputFontSize, intListFontSize, intListCount, intMaxTextLength, blnGrid,
strDetailedStyle, strTextForeColor, strClassOnFocus, strClassOnBlur, strClassDisable, funcEventCallBack)
引数の解説
すべてのパラメータは、この Web ページにおける JSVR 文字入力部品のデフォルト値を定義したプロパティ構造体に保存されます。 各パラメータについて詳しくは、「1.3.3 プロパティ構造体のリファレンス」の各プロパティを参照してください。 なお、各パラメータのデフォルト値は次のとおりです。 パラメータ名 デフォルト値 blnEditable true strCharsetName "EJ_SJIS" strSubmitName "" intTabindex 0 strDefaultText "" strSearchId "20" intInputFontSize 24 intListFontSize 24 intListCount 20 intMaxTextLength 50 blnGrid false strDetailedStyle "" strTextForeColor "" strClassOnFocus "" (内部定義クラスを使用) strClassOnBlur "" (内部定義クラスを使用) strClassDisable "" (内部定義クラスを使用) funcEventCallBack null復帰値
構築された部品コントロールクラスのインスタンス用例
var objEJC = new EJ_Control(true, "EJ_SJIS", "", 0, "", "20", 16, 24, 10, 15, false, "", "", "", "", "", "", "");
1.3.2.2
writeEJInput()
解説
JSVR 文字入力部品を書き出します。 書き出す部品の属性(文字のサイズや変換動作など)は、引数のプロパティ構造体によって決められます。注意
プロパティ構造体は、ユーザが独自にクリエイトするのではなく、copyDefaultPropertyStruct()メソッドにて取得したものを使用してくださ い。構文
instance.writeEJInput(pstructProperty)引数の解説
名称 型 解説 pstructProperty EJ_PropertyStruct 部品の動作を定義したプロパティ構造体。各プロパティに関しては、「1.3.3 プ ロパティ構造体のリファレンス」を参照してください。復帰値
型 解説 数値(整数) 書き出した部品の ID用例
var objEJC = new EJ_Control(true, "EJ_SJIS", "", 0, "", "20", 16, 24, 10, 15, false, "", "", "", "", "", "", "");
// デフォルト構造体を取得
var struct = objEJC.copyDefaultPropertyStruct(); // フォントサイズ設定
struct.intInputFontSize = 36; // 部品の書き出し
var intID = objEJC.writeEJInput(struct);
1.3.2.3
writeEJInputWithParam()
解説
JSVR 文字入力部品を書き出します。
書き出す部品の属性(文字のサイズや変換動作など)は、引数によって決められます。
構文
instance.writeEJInputWithParam(blnEditable, strCharsetName, strSubmitName, intTabindex,
strDefaultText, strSearchId, intInputFontSize, intListFontSize, intListCount, intMaxTextLength, blnGrid, strDetailedStyle, strTextForeColor, strClassOnFocus, strClassOnBlur,
引数の解説
各パラメータについて詳しくは、「1.3.3 プロパティ構造体のリファレンス」を参照してください。復帰値
型 解説 数値(整数) 書き出した部品の ID用例
var objEJC = new EJ_Control(true, "EJ_SJIS", "", 0, "", "20", 16, 24, 10, 15, false, "", "", "", "", "", "", "");
// 部品の書き出し
var intID = objEJC.writeEJInputWithParam(true, "EJ_SJIS", "adr1", 0, "住所", "20",16, 24, 10, 15, false, "", "", "", "", "", "", "");
1.3.2.4
copyDefaultPropertyStruct()
解説
現在の Web ページにおける JSVR 文字入力部品のデフォルト値を定義したプロパティ構造体のコピーを取得します。 本構造体は、本クラスのコンストラクタによって作られます。構文
instance.copyDefaultPropertyStruct( )引数の解説
なし復帰値
型 解説 EJ_PropertyStruct 現在の Web ページにおける JSVR 文字入力部品のデフォルトプロパティ構造体のコピー用例
var objEJC = new EJ_Control(true, "EJ_SJIS", "", 0, "", "20", 16, 24, 10, 15, false, "", "", "", "", "", "", "");
var struct = objEJC.copyDefaultPropertyStruct();
1.3.2.5
copyPropertyStruct()
解説
指定した部品が保持しているプロパティ構造体のコピーを取得します。
構文
引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID復帰値
型 解説 EJ_PropertyStruct 指定した部品のプロパティ構造体のコピー用例
var struct = objEJC.copyPropertyStruct(intID);
1.3.2.6
copyPropertyStructByName()
解説
指定した部品が保持しているプロパティ構造体のコピーを取得します。構文
instance.copyPropertyStructByName(pstrName)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名復帰値
型 解説 EJ_PropertyStruct 指定した部品のプロパティ構造体のコピー用例
var struct = objEJC.copyPropertyStructByName(strName);
1.3.2.7
setPropertyStruct()
解説
指定した部品のプロパティ構造体を変更します。注意
次のプロパティの値は変更しないでください。・
intMaxTextLength・
strTextForeColor・
funcEventCallBack構文
instance.setPropertyStruct(pintIndex, pstructProperty)引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID pstructProperty EJ_PropertyStruct 置き換えるプロパティ構造体復帰値
なし用例
// 指定部品のプロパティ構造体を取得var struct = objEJC.copyPropertyStruct(intID); // フォントサイズの設定 struct.intInputFontSize = 36; // 新しい構造体を指定した部品IDの部品に適用 objEJC.setPropertyStruct(intID, struct);
1.3.2.8
setPropertyStructByName()
解説
指定した部品のプロパティ構造体を変更します。注意
次のプロパティの値は変更しないでください。・
intMaxTextLength・
strTextForeColor・
funcEventCallBack構文
instance.setPropertyStructByName(pstrName, pstructProperty)引数の解説
名称 型 解説 pstrName 文字列 サブミット名 pstructProperty EJ_PropertyStruct 置き換えるプロパティ構造体復帰値
なし用例
// 指定部品のプロパティ構造体を取得
var struct = objEJC.copyPropertyStructByName(strName); // フォントサイズの設定 struct.intInputFontSize = 36; // 新しい構造体を指定した部品IDの部品に適用 objEJC.setPropertyStructByName(strName,struct);
1.3.2.9
getSubmitValue()
解説
指定した部品が保持しているサブミット値を取得します。構文
instance.getSubmitValue(pintIndex)引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID復帰値
型 解説 文字列 指定した部品のサブミット値用例
var strValue = objEJC.getSubmitValue(intID);
1.3.2.10
getSubmitValueByName()
解説
指定した部品が保持しているサブミット値を取得します。構文
instance.getSubmitValueByName(pstrName)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名復帰値
型 解説 文字列 指定した部品のサブミット値用例
var strValue = objEJC.getSubmitValueByName(strName);
1.3.2.11
getTextLength()
解説
指定した部品に表示されている文字列の長さを取得します。構文
instance.getTextLength(pintIndex)引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID復帰値
型 解説 数値(整数) 指定した部品に表示されている文字列の長さ用例
var intTextLength = objEJC.getTextLength(intID);
1.3.2.12
getTextLengthByName()
解説
指定した部品に表示されている文字列の長さを取得します。構文
instance.getTextLengthByName(pstrName)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名復帰値
型 解説 数値(整数) 指定した部品に表示されている文字列の長さ用例
1.3.2.13
changeText()
解説
指定した部品の表示文字列を変更します。構文
instance.changeText(pintIndex, pstrText)引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID pstrText 文字列 変更後の表示文字列復帰値
なし用例
objEJC.changeText(intID, "あいうえお");1.3.2.14
changeTextByName()
解説
指定した部品の表示文字列を変更します。構文
instance.changeTextByName(pstrName, pstrText)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名 pstrText 文字列 変更後の表示文字列復帰値
なし用例
objEJC.changeTextByName(strName, "あいうえお");1.3.2.15
resetText()
解説
指定した部品の表示文字列をリセットします。構文
instance.resetText(pintIndex)引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID復帰値
なし用例
objEJC.resetText(intID);1.3.2.16
resetTextByName()
解説
指定した部品の表示文字列をリセットします。構文
instance.resetTextByName(pstrName)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名復帰値
なし用例
objEJC.resetTextByName(strName);1.3.2.17
changeDspState()
解説
指定した部品の表示状態を変更します。構文
instance.changeDspState(pintIndex, pstrState)引数の解説
名称 型 解説
pintIndex 数値(整数) 部品 ID
pstrState 文字列 表示状態を、次のリテラルから指定する。 "DSP"
style.display = "" & style.visibility = "visible" に準拠
"NONE"
style.display = "none" & style.visibility = "visible" に準 拠
"HIDDEN"
style.display = "" & style.visibility = "hidden" に準拠
復帰値
なし用例
objEJC.changeDspState(intID, "HIDDEN");1.3.2.18
changeDspStateByName()
解説
指定した部品の表示状態を変更します。構文
instance.changeDspStateByName(pstrName, pstrState)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名 pstrState 文字列 表示状態を、次のリテラルから指定する。 "DSP"style.display = "" & style.visibility = "visible" に準拠 "NONE"
style.display = "none" & style.visibility = "visible" に準 拠
"HIDDEN"
style.display = "" & style.visibility = "hidden" に準拠
復帰値
なし用例
objEJC.changeDspStateByName(strName, "HIDDEN");1.3.2.19
focusEJInput()
解説
指定した部品をフォーカスします。構文
instance.focusEJInput(pintIndex)引数の解説
名称 型 解説 pintIndex 数値(整数) 部品 ID復帰値
なし用例
objEJC.focusEJInput(intID);1.3.2.20
focusEJInputByName()
解説
指定した部品をフォーカスします。構文
instance.focusEJInputByName(pstrName)引数の解説
名称 型 解説 pstrName 文字列 部品のサブミット名復帰値
なし用例
objEJC.focusEJInputByName(strName);1.3.3
プロパティ構造体のリファレンス
名称
EJ_PropertyStruct解説
プロパティ構造体とは、JSVR 部品の振る舞い(プロパティ)を定義する構造体です。本構造体は、部品コントロールクラスを経由して使 用するもので、Web ページ作成者が直接クリエイトすることはできません。メソッド
公開しているメソッドはありません。注意
プロパティ構造体クラスは、コンストラクタも非公開です。独自に本クラスのインスタンスを作成して使用できません。プロパティ
名称 機能 blnEditable 編集の可/不可の指定 strCharsetName 運用文字コードの指定 strSubmitName サブミットした値を受け取るための名前intTabindex INPUT タグの tabindex と同義
strDefaultText デフォルトで表示する文字列 strSearchId 変換種別の指定
intInputFontSize フォントサイズ(px 単位)
intListFontSize インライン変換時の候補リスト中のフォントサイズ(px 単位)
intListCount インライン変換時の候補リスト中の候補数
intMaxTextLength INPUT タグの maxlength と同義
blnGrid グリッド表示の有無を指定 strDetailedStyle css-style 属性の指定 strTextForeColor 文字色の指定 strClassOnFocus フォーカス時に適用させる class スタイル名の指定 strClassOnBlur ブラー時に適用させる class スタイル名の指定 strClassDisable 編集不可時に適用させる class スタイル名の指定 funcEventCallBack イベント発生時に実行するコールバック関数の指定
1.3.3.1
blnEditable
解説
部品の編集の可/不可を、true(可)/false(不可)で指定します。型
論理値1.3.3.2
strCharsetName
解説
部品の運用文字コードを、次のリテラルのいずれかで指定します。 リテラル 運用文字コード EJ_SJIS シフト JIS(MS) EJ_SJIS_ENC シフト JIS(MS)のエンコード形式 EJ_UNICODE Unicode(MS) EJ_UNICODE_ENC Unicode(MS)のエンコード形式 EJ_UNICODE2004MS Unicode(2004MS) EJ_UNIJEF Unicode-JEF EJ_UNIJEF_ENC Unicode-JEF のエンコード形式 EJ_JEF JEF EJ_KEIS KEIS EJ_JIPS JIPS EJ_DBCS DBCS-Host型
文字列1.3.3.3
strSubmitName
解説
INPUT タグの name 属性と同義です。型
文字列1.3.3.4
intTabindex
解説
INPUT タグの tabindex 属性と同義です。型
数値(整数)1.3.3.5
strDefaultText
解説
部品にデフォルトで表示させる文字列を、次のように指定します。運用文字コード(リテラル) 指定方法 EJ_SJIS_ENC, EJ_UNICODE_ENC, EJ_UNIJEF_ENC, EJ_JEF, EJ_KEIS, EJ_JIPS, EJ_DBCS "A4A2A4A4A4A6"などと、決められた桁のエンコーディング文字表現で指定する。 EJ_SJIS, EJ_UNICODE, EJ_UNICODE2004MS, EJ_UNIJEF "あいう"などと、ネイティブ文字表現で指定する。
型
文字列1.3.3.6
strSearchId
解説
部品の変換種別を、次のリテラルから指定します。 リテラル 変換種別 機能 20 標準変換 一般的な、かな漢字変換 30 住所入力 住所変換(部分一致変換) 40 氏名入力 変換候補のうち氏名を強調表示KUIN30 KUIN 住所入力 運用 KUIN 住所辞書による変換(部分一致変換) KUIN40 KUIN 氏名入力 運用 KUIN 氏名辞書による変換
リテラルを"|"で結合することにより、複数の変換種別を指定することもできます。その際は、結合した順番に、変換種別を切り換えるこ とができます。 例えば"20|40|KUIN40"と指定すると、部品の変換種別を「標準変換」→「氏名入力」→「KUIN 氏名入力」とトグルで切り換えることがで きます。
型
文字列1.3.3.7
intInputFontSize
解説
部品に表示させるフォントサイズを、1 ～ 2400 の範囲で指定します。単位は px です。型
数値(整数)1.3.3.8
intListFontSize
解説
インライン変換候補リストのフォントサイズを指定します。単位は px です。型
数値(整数)1.3.3.9
intListCount
解説
インライン変換候補リストの、１ページ(1 リクエスト)に表示する候補数を指定します。型
数値(整数)1.3.3.10
intMaxTextLength
解説
INPUT タグの maxlength 属性と同義です。型
数値(整数)1.3.3.11
blnGrid
解説
部品のグリッド(文字のマス)表示の有無を、true(有り)/false(無し)で指定します。型
論理値1.3.3.12
strDetailedStyle
解説
部品における CSS-Style の position、top、left、width、height、z-index を、次のように指定します。 "position:absolute; top:10pt; left:105.3px; z-index:3"注意
・
上記以外の指定はできません。・
position 属性には、absolute 以外を指定できません。型
文字列1.3.3.13
strTextForeColor
解説
部品の文字色を、16 進の RGB 値で、次のように指定します。 黒 : "000000", 白 : "FFFFFF", 赤 : "FF0000", 青 : "0000FF"型
文字列1.3.3.14
strClassOnFocus
解説
部品フォーカス時に適用させる class スタイル名を指定します。W3C CSS1/2 に従って、border-width、border-style、border-color、 background-color を定義した class スタイルを定義し、この定義名を指定します。ただし、border-width の定義は 2px 固定としてくださ い。 次の場合は、"myFocusStyle"を指定します。 .myFocusStyle { border-width : 2px; border-color : red; border-style : solid; background-color : lightyellow; }注意
・
border-width の定義は 2px 固定としてください。・
border-style には必ず何らかの定義が必要です。型
文字列1.3.3.15
strClassOnBlur
解説
部品ブラー時(フォーカスが外れるとき)に適用させる class スタイル名を指定します。指定方法は、「1.3.3.14 strClassOnFocus」を参照 してください。型
文字列1.3.3.16
strClassDisable
解説
部品編集不可時に適用させる class スタイル名を指定します。指定方法は、「1.3.3.14 strClassOnFocus」を参照してください。型
文字列1.3.3.17
funcEventCallBack
解説
部品上のイベント発生時に実行するコールバック関数を指定します。現在利用できるイベントは、onFocus、onBlur、onKeyup、および onKeydown です。 コールバック関数には、次のように引数を渡します。 名称 型 解説pstrEventType 文字列 DOM の event.type に従った文字列。 例)"focus"、"blur"、"keyup"、"keydown" pintIndex 数値(整数) 部品 ID。
pevent イベントオブジェクト 発生したイベントオブジェクト。 コールバック関数を次のように定義した場合、catchEvent を指定します。
function catchEvent( pstrEventType, pintIndex, pevent ) { ． ． ． }
参考
コールバック関数に渡す引数のうち pevent は V8.0 で新たに加わったものですが、V7.0 以前の引数の形式(pevent を指定しない形 式)での利用も可能です。型
function1.3.4
代行メソッド群のリファレンス
代行メソッド群とは、JSP カスタムタグインタフェースを使用して JSVR 部品を書き出した場合(利用者が自分で EJ_Control クラスをクリ エイトしなかった場合)に使用するメソッド群です。1.3.4.1
ej_agt_getEJCInstance()
解説
構文
_objEJC = ej_agt_getEJCInstance()引数の解説
JSP カスタムタグインタフェースの利用者が JSVR 部品のアクセスメソッドを使用する場合、本メソッドで取得した EJ_Control のインスタ ンスから、各メソッドを使用します。使い方については、「1.4.2 使用方法」の「◆書き出した JSVR 部品を操作する」を参照してください。復帰値
型 解説 EJ_Control 現在の Web ページにおける部品コントロールクラスのインスタンス用例
_objEJC = ej_agt_getEJCInstance()1.4
JSP
カスタムタグインタフェース
JSP カスタムタグインタフェースについて、使用前に必要な準備事項、使用方法と API リファレンスを説明します。 使用前に必要な準備事項 「1.4.1 JSP カスタムタグインタフェースを使用する際の準備」 使用方法 「1.4.2 使用方法」 APIリファレンス 「1.4.3 リファレンス」1.4.1
JSP
カスタムタグインタフェースを使用する際の準備
JSP カスタムタグインタフェースを利用するには、次の 1 ～ 4 の手順を行う必要があります。1.
利用者の
Web
アプリケーションの
web.xml
の編集
利用者の Web アプリケーションの web.xml に、次の太字の記述を追加します。 web.xml <?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> .... <taglib> <taglib-uri>com.fujitsu.jsvr.taglib</taglib-uri> <taglib-location>/WEB-INF/jsvrtaglib.tld</taglib-location> </taglib> ... </web-app>
2. JSP
カスタムタグの定義ファイル
(jsvrtaglib.tld)
の配置
利用者の Web アプリケーションの WEB-INF 配下に、Charset-Web 入力のインストール先の"j_svr¥WEB-INF"の下にある jsvrtaglib.tld ファイルをコピーします。
3. JSP
カスタムタグのクラス
(jsvrtaglib.jar)
の参照
利用者の Web アプリケーションから、Charset-Web 入力のインストール先の"j_svr¥WEB-INF¥lib¥jsvrtaglib.jar"を参照可能にします。 Interstage Application Serverの場合
利用者の Web アプリケーションを配備しているワークユニットで、[環境設定]タブの[ワークユニット設定]－[クラスパス]に、Charset-Web 入力のインストール先の"j_svr¥WEB-INF¥lib¥jsvrtaglib.jar"のパスを設定します。
Tomcatの場合
次の場所に jsvrtaglib.jar をコピーします。
－
[利用者の Web アプリケーションの実フォルダ]¥WEB-INF¥lib4. Charset-Web
入力の
Web
アプリケーション
Context
の参照を許可
他の Web アプリケーションのコンテキストの参照を許可する設定が明示的に必要になります。 Interstage Application Serverの場合
[Web アプリケーション] の [環境設定] の [コンテキストの共有] を [する] に設定します。 Tomcatの場合
Tomcat での、Chaset-Web 入力の Web アプリケーションのコンテキストの設定にて、[クロスコンテキスト]を true にします。 コンテキスト設定ファイル"j_svr.xml"での設定の例)
下の太字部分のように「crossContext="true"」の設定を追加します。
<Context docBase="c:¥Program Files¥JapanistSVR¥j_svr" crossContext="true" />
注意
利用者の Web アプリケーションと、Charset-Web 入力の Web アプリケーションとは、仮想ホスト(Tomcat の場合は、server.xml の <Host>、Interstage Application Server の場合は、ワークユニットを意味する)が同じである必要があります。
1.4.2
使用方法
サンプルコードにそって、使用方法を説明します。◆
JSVR
部品を書き出す
全体の流れは次のとおりです。1.
JSP カスタムタグインタフェースのライブラリの宣言2.
部品の書き出し ここでは、文字表示部品および文字入力部品それぞれの書き出しについて例として示します。 サンプルコード(JSVR部品を書き出す)<%@ page contentType="text/html; charset=Windows-31J" pageEncoding="Windows-31J" %>
<%@ taglib uri="com.fujitsu.jsvr.taglib" prefix="JSVR" %> (1)
<HTML> <HEAD>
<META http-equiv="content-type" content="text/html; charset=Shift_JIS"> </HEAD>
<BODY>
<JSVR:EJText JSVRPath="/j_svr"
charsetName="EJ_SJIS" fontSize="32" text="登録ページ" /> (2)
<br>
<FORM action="...">
charsetName="EJ_SJIS" submitName=""
tabindex="0" defaultText="" searchId="20|30|40" inputFontSize="24" listFontSize="18" listCount="10" maxTextLength="30" grid="true" detailedStyle="" textForeColor="CC0000" classOnFocus="" classOnBlur="" classDisable="" eventCallBack="">
名前を入力してください<br>
<JSVR:EJInput submitName="name" searchId="40|20" /><br> (4)
住所を入力してください>
<JSVR:EJInput submitName="address" searchId="30|20" /><br> (5) </JSVR:EJInputEnv> (6) <INPUT type="submit"> </FORM> </BODY> </HTML> (1) JSPカスタムタグインタフェースのライブラリの宣言 この JSP 内で JSP カスタムタグインタフェースを使えるようにするための宣言です。 (2) JSVR文字表示部品の書き出し JSVR 文字表示部品の設定例です。 (3) JSVR文字入力部品のプロパティ設定開始タグ JSVR 文字入力部品のプロパティ設定開始タグです。終了タグまでの間にある EJInput に対して、ここで設定したプロパティが適用 されます。 (4) JSVR文字入力部品の書き出し(名前入力用のプロパティ) 名前入力用プロパティの設定例です。 この例では、サブミット時の name 属性を"username"に変更し、変換種別を"40|20"(氏名優先|標準変換)に変更しています (5) JSVR文字入力部品の書き出し(住所入力用のプロパティ) 住所入力用プロパティの設定例です。 この例では、サブミット時の name 属性を"address"に変更し、変換種別を"30|20"(住所入力|標準変換)に変更しています (6) JSVR文字入力部品のプロパティ設定終了タグ JSVR 文字入力部品のプロパティ設定終了タグです。
注意
HTML の<META>や、JSP での文字エンコーディング指定の注意点については、「1.1.2 キャラクタセットについての注意」を参照して ください。◆書き出した
JSVR
部品を操作する
JSP カスタムタグインタフェースを使用すると、JavaScript を記述する必要がなく便利ですが、利用者が自ら部品コントロールクラス (EJ_Control)をクリエイトしないため、JSVR 文字入力部品アクセスメソッドを使用する際は、現在の Web ページ(window.document)に おける EJ_Control のインスタンスを別途取得する必要があります。 また、書き出した JSVR 文字入力部品に対してアクセスメソッドを使用する場合は、サブミット名から JSVR 部品にアクセスするメソッド (...ByName())を使用する必要があります。 次のサンプルコードは、JSVR 文字入力部品(submitName="myName")の値を取得し、チェックするメソッドの例です。 サンプルコード(書き出したJSVR部品を操作する) ...<JSVR:EJInput submitName="myName" searchId="40|20" /><br> (1)
<input type="button" onclick="checkEJInputValue()" value="チェックします"> ... <script language="JavaScript"> <!--function checkEJInputValue() {
var objEJC = ej_agt_getEJCInstance(); (2) var value = objEJC.getSubmitValueByName("myName"); (3)
if( ... != value ) { ... } ... } //--> </script> ... (1) JSVR文字入力部品の書き出し JSP カスタムタグインタフェースによる JSVR 文字入力部品書き出しです。 (2) 部品コントロールクラスのインスタンスの取得 現在の Web ページにおける部品コントロールクラス(EJ_Control)のインスタンスを取得します。 (3) JSVR文字入力部品のサブミット値を取得 JSP カスタムタグインタフェースで指定したサブミット名をアクセスメソッド(getSubmitValueByName())に渡し、特定の JSVR 部品の サブミット値を取得します。
1.4.3
リファレンス
1.4.3.1
EJInput
解説
JSVR 文字入力部品を書き出します。EJInputEnv と共に使用すると、プロパティをまとめて指定することができます。構文
<JSVR:EJInputJSVRPath="/j_svr" editable="true" charsetName="EJ_SJIS" submitName="" tabindex="0" defaultText="あいう
えお" searchId="20|30|40" inputFontSize="24" listFontSize="18" listCount="10" maxTextLength="30" grid="true" detailedStyle="" textForeColor="CC0000" classOnFocus="" classOnBlur="" classDisable="" eventCallBack="" />
パラメータの解説
名称 型 解説
JSVRPath 文字列 Charset-Web 入力の Web アプリケーション(j_svr)のドキュメントルートからのパスを指定(通常は "/j_svr")
editable 論理値 編集の可/不可の指定(blnEditableを参照) charsetName 文字列 運用文字コードの指定(strCharsetNameを参照)
submitName 文字列 サブミットした値を受け取るための名前(strSubmitNameを参照)
名称 型 解説 defaultText 文字列 デフォルトで表示する文字列(strDefaultTextを参照) searchId 文字列 変換種別の指定(strSearchIdを参照) inputFontSize 数値(整数) フォントサイズ(px 単位) (intInputFontSizeを参照) listFontSize 数値(整数) インライン変換時の候補リスト中のフォントサイズ(px 単位) (intListFontSizeを参照) listCount 数値(整数) インライン変換時の候補リスト中の候補数(intListCountを参照) maxTextLength 数値(整数) INPUT タグの maxlength と同義(intMaxTextLengthを参照)
grid 論理値 グリッド表示の有無を指定(blnGridを参照)
detailedStyle 文字列 css-style 属性の指定(strDetailedStyle参照)
textForeColor 文字列 文字色の指定(strTextForeColorを参照)
classOnFocus 文字列 フォーカス時に適用させる class スタイル名の指定(strClassOnFocusを参照) classOnBlur 文字列 ブラー時に適用させる class スタイル名の指定(strClassOnBlurを参照) classDisable 文字列 編集不可時に適用させる class スタイル名の指定(strClassDisableを参照)
eventCallBack 文字列 イベント発生時に実行するコールバック関数の指定(funcEventCallBackを参照)
注意
・
タグは単体で使用します。タグで何かを囲うことはできません。・
JSVRPath、charsetName、submitName は、EJInput、またはそれを囲む EJInputEnv のどちらかに、必ず指定しなければならない属 性です。1.4.3.2
EJInputEnv
解説
EJInput のプロパティをまとめて設定します。EJInput、またはその他の JSP カスタムタグインタフェースによる記述を囲って使用します。構文
<JSVR:EJInputEnvJSVRPath="/j_svr" editable="true" charsetName="EJ_SJIS" submitName="" tabindex="0" defaultText="あいう えお" searchId="20|30|40" inputFontSize="24" listFontSize="18" listCount="10" maxTextLength="30" grid="true" detailedStyle="" textForeColor="CC0000" classOnFocus="" classOnBlur="" classDisable="" eventCallBack="" > ... <JSVR:EJInput ... /> ... </JSVR:EJInputEnv>
 ・ [End](末尾) ・ 上下カーソルキー(先頭/末尾) 読みがなの後退 読みがな域のキャレットの左の](https://thumb-ap.123doks.com/thumbv2/123deta/6844098.738061/156.892.96.829.121.612/インラインキャレットキャレットカーソルキーカーソルキー.webp)
 ・ [Space](次選択) ・ [Shift]+[変換](前選択) ・ [Sh](https://thumb-ap.123doks.com/thumbv2/123deta/6844098.738061/157.892.91.788.118.483/本状態およびインラインおけるインラインキーカーソルキー.webp)
