 | | Wide Studio Object Reference
| |
クラスの型
WSCvifield
メソッド関数仕様
addString 関数の説明
- 書式
- void addString(char* var)
- 機能
- 現在表示中の文字列に指定した文字列を追記する関数です。
文字列を置き換えたい場合は、プロパティ WSNlabelString を
用います。
- 処理
-
- 引数
-
- 返値
- なし。
- 注意
- 文字列を置き換えたい場合は、プロパティ WSNlabelString を
用いてください。
//現在表示中の文字列に指定された文字列を追加します。
newvifi_000->addString("文字列の追加");
getBuf 関数の説明
- 書式
- WSCushort* getBuf()
- 機能
- 内部のテキストバッファを取得する関数です。
このバッファの内容は、UCS2 コードです。
- 処理
-
- 引数
- なし。
- 返値
- テキストバッファ
- 注意
- 返されたバッファを解放してはいけません。
また、キー入力が行われてバッファの内容が変更されると、
領域は無効となります。したがって、
この関数が返す領域の永続的な利用は避け、
なるべく、他の領域にコピーしてください。
- サンプル
-
//現在表示中の文字列のUCS2文字列バッファを取得します。
WSCushort* buf = newvifi_000->getBuf();
setBuf 関数の説明
- 書式
- void setBuf(WSCushort* buf)
- 機能
- WSCvifield 内のデータ管理バッファに
UCS2 文字列のデータを直接設定する関数です。
- 処理
-
- 引数
-
(in)WSCushort* buf | 設定したい UCS2 文字列 |
- 返値
- なし。
- 注意
- 指定されたバッファがそのまま内部用のバッファとして
利用されますので、指定後にそのバッファを解放してはいけません。
- サンプル
-
//UCS2文字列を生成。
WSCushort buf = WSGFgetUCS2("文字列");
//UCS2文字列バッファを直接指定します。
newvifi_000->setBuf(buf); // buf は、そのまま内部のバッファとして使用。
onKey() 関数の説明
- 書式
- void onKey(WSDkeyboard* keyboard,WSCbool keydown);
- 機能
- キーボードが押下または解放したとき、この関数が実行されます。
派生クラスでは、トリガonKey( )関数が実行されます。
アプリケーションは、トリガ
(WSEV_KEY_PRESS/WSEV_KEY_RELEASE)による
イベントプロシージャを用いる代わりに、
この関数をオーバーライドすることでも、キーボード入力に関する
イベント処理を行うことができます。
キーボード状態は、押下時には True、解放時には False が
渡されます。
- 処理
-
- 引数
-
(in)WSDkeyboard* keyboard | キーボードインスタンス |
(in)WSCbool keydown | True = Press、False = Release |
- 返値
- なし。
- 注意
-
- サンプル
-
void new_class::onKey(WSDkeyboard* keyboard,WSCbool keydown){
//キー入力された場合に呼び出されます。
if (keydown != False){ //キー押下
//キーの取得
long key = keyboard->getKey();
//入力文字列の取得
WSCstring str = keyboard->getText();
}
//処理を派生元クラスに引き継ぎます。
old_class::onKey(keyboard,keydown);
}
onKeyHook() 関数の説明
- 書式
- void onKeyHook(WSDkeyboard* keyboard);
- 機能
- キーボード入力が行われ、キーボードがフックされたとき、
この関数が実行されます。
派生クラスでは、トリガ(WSEV_KEY_HOOK)による
イベントプロシージャを用いる代わりに、
この関数をオーバーライドすることでも、キーボード入力に関する
イベント処理を行うことができます。
- 処理
-
- 引数
-
(in)WSDkeyboard* keyboard | キーボードインスタンス |
- 返値
- なし。
- 注意
-
- サンプル
-
void new_class::onKeyHook(WSDkeyboard* keyboard){
//キー入力された場合に呼び出されます。
//入力文字列の取得
WSCstring str = keyboard->getText();
//keyboard->setText(...) で、文字列を置き換えることで、
//文字列入力を操作することができます。
//処理を派生元クラスに引き継ぎます。
old_class::onKeyHook(keyboard);
}
onActivate() 関数の説明
- 書式
- void onActivate()
- 機能
- リターンキーが入力されたときに、この関数が実行されます。
派生クラスでは、トリガ(WSEV_ACTIVATE)による
イベントプロシージャを用いる代わりに、
この関数をオーバーライドすることでも、リターンキーによる
ACTIVATE に関するイベント処理を行うことができます。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
void new_class::onActivate(){
//リターンキーが入力された場合に行う処理を記述します。
//処理を派生元クラスに引き継ぎます。
old_class::onActivate();
}
onValueChange() 関数の説明
- 書式
- void onValueChange()
- 機能
- キー入力され値が変化したとき、この関数が実行されます。
派生クラスでは、トリガ(WSEV_VALUE_CH)による
イベントプロシージャを用いる代わりに、
この関数をオーバーライドすることでも、キー入力に関する
イベント処理を行うことができます。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
void new_class::onValueChange(){
//入力が行われ、文字列が変更された場合に行う処理を記述します。
//処理を派生元クラスに引き継ぎます。
old_class::onValueChange();
}
replaceSelectedString() 関数の説明
- 書式
- void replaceSelectedString(char* str,long encoding = WS_EN_DEFAULT);
- 機能
- 選択中の文字列を引数に指定された文字列で置き換える関数です。
エンコーディングを省略すると WS_EN_DEFAULT が指定されたものと
みなされます。
- 処理
-
- 引数
-
(in)char* str | 置換後の文字列 |
(in)long encoding | 文字列のエンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- なし。
- 注意
-
- サンプル
-
//現在選択状態にある文字列を指定した文字列で置換します。
newvifi_000->replaceSelectedString("置換文字列");
getSelectedString() 関数の説明
- 書式
- WSCstring getSelectedString()
- 機能
- 選択されている文字列を取得する関数です。
- 処理
-
- 引数
- なし。
- 返値
- 選択文字列
- 注意
-
- サンプル
-
//現在選択状態にある文字列を取得します。
WSCstring stext = newvifi_000->getSelectedString();
getString() 関数の説明
- 書式
- WSCstring getString()
- 機能
- 入力文字列を取得する関数です。
- 処理
-
- 引数
- なし。
- 返値
- 入力文字列
- 注意
-
- サンプル
-
//現在の入力文字列を取得します。
WSCstring text = newvifi_000->getString();
deleteSelectedString() 関数の説明
- 書式
- void deleteSelectedString()
- 機能
- 選択文字列を削除する関数です。
選択部分以降にあった文字列は前に詰められます。
- 処理
- 選択された文字列の部分だけ削除します。
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
//現在選択状態にある文字列を削除します。
newvifi_000->deleteSelectedString();
setSelect() 関数の説明
- 書式
- long setSelect(long pos,long len)
- 機能
- 指定された位置から指定された長さの文字列を
選択状態にする関数です。
- 処理
- 文字位置 pos から指定された長さの文字列を選択状態にします。
- 引数
-
(in)long pos | 文字列開始位置 |
(in)long len | 文字列長 |
- 返値
- WS_NO_ERR= 正常、それ以外はエラー。
- 注意
-
- サンプル
-
//指定した位置の文字列を選択状態にします。
//例えば先頭から5文字目までを選択状態にするには次のようにします。
newvifi_000->setSelectedString(0,5);
getSelectedPos() 関数の説明
- 書式
- long setSelectedPos()
- 機能
- 選択文字列が先頭からの何文字目にあるかを取得する関数です。
- 処理
-
- 引数
- なし。
- 返値
- 先頭からの文字数
- 注意
-
- サンプル
-
//選択状態にある文字列の先頭からの文字数を取得します。
long pos = newvifi_000->setSelectedPos();
Document Release 3.70 For Use with Wide Studio Release 3.70, Spring 2004 WideStudio Home | Up to Copyright(C) WideStudio Development Team, 1999-2004 | | Last modified: May. 25, 2004 | |