Wide Studio Object Reference

| Wide Studio Object Reference |
Wide Studio Home
Up to
  ## クラスの型 WSCvifield ## メソッド関数仕様 ### addString 関数の説明 書式 void addString(char* var) 機能 現在表示中の文字列に指定した文字列を追記する関数です。 文字列を置き換えたい場合は、プロパティ WSNlabelString を 用います。 処理 引数
  (in)char* var | 追加したい文字列

返値
  なし。
注意
  文字列を置き換えたい場合は、プロパティ WSNlabelString を 用いてください。

        //現在表示中の文字列に指定された文字列を追加します。
        newvifi_000->addString("文字列の追加");

  ### getBuf 関数の説明

  書式
    WSCushort* getBuf()
  機能
    内部のテキストバッファを取得する関数です。 返されたバッファを解放してはいけません。 また、キー入力が行われてバッファの内容が変更されると、 確保されていた領域は無効になります。 したがって、 この関数が返す領域の永続的な利用は避け、 なるべく、他の領域にコピーして使用します。 このバッファの内容は、UCS2 コードです。
  処理
  引数
    なし。
  返値
    テキストバッファ。
  注意
    返されたバッファを解放してはいけません。 また、キー入力が行われてバッファの内容が変更されると、 領域は無効となります。したがって、 この関数が返す領域の永続的な利用は避け、 なるべく、他の領域にコピーしてください。 このバッファの内容は、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= 正常、それ以外はエラー。
  注意
  サンプル

          //指定した位置の文字列を選択状態にします。
          //例えば先頭から５文字目までを選択状態にするには次のようにします。
          newvifi_000->setSelectedString(0,5);

  ### getSelectedPos() 関数の説明

  書式
    long setSelectedPos()
  機能
    選択文字列が先頭からの何文字目にあるかを取得する関数です。
  処理
  引数
    なし。
  返値
    先頭からの文字数
  注意
  サンプル

          //選択状態にある文字列の先頭からの文字数を取得します。
          long pos = newvifi_000->setSelectedPos();

  Document Release 3.20
  For Use with Wide Studio Release 3.20, Winter 2002

  WideStudio Home | Up to

  Copyright(C) T. Hirabayashi, 1999-2002 |  | Last modified: Nov. 28, 2002