[ 前へ | 目次 | 次へ ]
Japanese English

GUIコンポーネントの状態設定と取得

GUIコンポーネントは、ただ作成して配置しただけではあまり意味がありません。 ここではテキストフィールドから文字を取得したり、 グラフィックスを変更したりするなど、 配置後のGUIコンポーネントの状態設定・取得方法を解説します。

スポンサーリンク


色の変更 / 取得

色の変更

GUIコンポネントの色を変更するにはsetComponentColor関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
void setComponentColor (
  int id,
  int fgRed, int fgGreen, int fgBlue, int fgAlpha,
  int bgRed, int bgGreen, init bgBlue, int bgAlpha
)

引数は以下の通りです:

  • id: 色を変更する対象のGUIコンポーネントIDを指定します。
  • fgRed, fgGreen, fgBlue, fgAlpa: 前景色のRGBA(赤/緑/青/α)成分をそれぞれ0〜255の範囲で指定します。
  • bgRed, bgGreen, bgBlue, bgAlpa: 背景色のRGBA(赤/緑/青/α)成分をそれぞれ0〜255の範囲で指定します。

ここで色成分は、赤(R)、緑(G)、青(B)成分で表現する「RGBカラー」形式に、 不透明度の「α(A)成分」を加えた「RGBAカラー」形式で指定します。各値の範囲については、以下の通りです:

  • 各色成分はそれぞれ 0 から 255 の範囲の値をとります。
  • α成分も同様ですが、 0 で完全な透明、255 で不透明を表します。

ところで、各色成分の合成は、下図のように、光の混色ルールである「加法混色」によって処理される事にご注意ください。日常で馴染みの深い、絵の具の混色ルールである「減法混色」とは結果がかなり異なります。

色成分の合成の様子
色成分の合成の様子
色成分の合成は、絵の具のような減法混色では無く、光のような加法混色により行われます。

色の取得

なお、GUIコンポーネントに設定済みの色を取得するには、getComponentColor関数を呼び出します この関数の形式は以下の通りです:

- 関数の形式 -
int[ ][ ] getComponentColor ( int id )

引数idには、色を取得する対象のGUIコンポーネントIDを指定します。

この関数は要素数が[2][4]のint型配列を戻り値に返します。その配列内には、

  • 要素[0][0]〜[0][3]にそれぞれ前景色のRGBA値
  • 要素[1][0]〜[1][3]にそれぞれ背景色のRGBA値

が格納されています。

使用可能なコンポーネント

setComponentColorおよびgetComponentCoIor関数は、以下のGUIコンポーネントなどに対して使用できます。

ウィンドウ / ボタン / テキストフィールド / テキストエリア / チェックボックス / セレクトフィールド / テキストラベル / 画像ラベル

位置の変更 / 取得

位置の変更

GUIコンポネントの位置を変更するにはsetComponentLocation関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
void setComponentLocation ( int id, int x, int y )

引数は以下の通りです:

  • id: サイズを変更する対象のGUIコンポーネントIDを指定します。
  • x, y: 変更後の左上頂点の座標を指定します。

位置の取得

GUIコンポネントの位置を取得するには、getComponentLocation関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
int[ ] getComponentLocation ( int id )

引数 id には、取得対象のコンポーネントのIDを指定します。

この関数は要素数が2のint型配列を戻り値に返します。 戻り値の配列には、要素[0]にx値、要素 [1]にy値が格納されています。

使用可能なコンポーネント

setComponentLocationおよびgetComponentLocation関数は、 以下のGUIコンポーネントなどに対して使用できます。

ウィンドウ / ボタン / テキストフィールド / テキストエリア / チェックボックス / セレクトフィールド / テキストラベル / 画像ラベル

サイズの変更 / 取得

サイズの変更

GUIコンポネントのサイズを変更するにはsetComponentSize関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
void setComponentSize ( int id, int width, int height )

引数は以下の通りです:

  • id: サイズを変更する対象のGUIコンポーネントIDを指定します。
  • width, height: それぞれ変更後の幅、高さを指定します。

サイズの取得

GUIコンポネントのサイズを取得するにはgetComponentSize関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
int[ ] getComponentSize ( int id )

引数 id には、取得対象のコンポーネントのIDを指定します。

この関数は要素数が2のint型配列を戻り値に返します。 戻り値の配列には、要素[0]に幅、要素 [1]に高さの値が格納されています。

使用可能なコンポーネント

setComponentSizeおよびgetComponentSize関数は、以下のGUIコンポーネントなどに対して使用できます。

ウィンドウ / ボタン / テキストフィールド / テキストエリア / チェックボックス / セレクトフィールド / テキストラベル / 画像ラベル

テキスト値の変更 / 取得

テキスト値の変更

GUIコンポーネントのテキストを変更するにはsetComponentText関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
void setComponentText( int id, string text )

引数は以下の通りです:

  • id: テキストを変更する対象のGUIコンポーネントIDを指定します。
  • text: 変更後に表示するテキストを指定します。

テキスト値の取得

GUIコンポネントからテキストを取得するには、 getComponentText関数を呼び出します。この関数の形式は以下の通りです:

- 関数の形式 -
string getComponentText( int id )

引数 id には、取得対象のコンポーネントのIDを指定します。

この関数は、取得したテキストをstring型の戻り値として返します。

使用可能なコンポーネント

getComponentTextおよびsetComponentText関数は、 以下のGUIコンポーネントに対して使用できます。

ボタン / テキストフィールド / テキストエリア / チェックボックス / セレクトフィールド / テキストラベル

グラフィックスデータの変更 / 取得

グラフィックスデータの変更

画像ラベルなど、グラフィックスデータを扱うGUIコンポーネントにおいて、 表示するグラフィックスデータを変更するにはsetComponentGraphics関数を呼び出します。 この関数の形式は以下の通りです:

- 関数の形式 -
void setComponentGraphics( int componentID, int graphicsID )

引数は以下の通りです:

  • グラフィックスデータを変更する対象のGUIコンポーネントIDを指定します。
  • 変更後に表示するグラフィックスデータIDを指定します。

グラフィックスデータの取得

GUIコンポーネントの表示するグラフィックリソースIDを取得するには、 getComponentGraphics関数を呼び出します。この関数の形式は以下の通りです:

- 関数の形式 -
int getComponentGraphics( int componentID )

引数componentIDには、 グラフィックスデータを取得する対象のGUIコンポーネントIDを指定します。 この関数は、表示しているグラフィックスのリソースIDを返します。

使用可能なコンポーネント

setComponentGraphicsおよびgetComponentGraphics関数は、 以下のGUIコンポーネントに対して使用できます。

画像ラベル

論理値など、その他の値の変更 / 取得

論理値の変更

チェックボックスのように、ON/OFFの論理値(二択値)を持つGUIコンポーネントの値は、 setComponentBool関数で変更できます。この関数の形式は以下の通りです:

- 関数の形式 -
void setComponentBool ( int id, bool state )

引数は以下の通りです:

  • id: 論理値を変更する対象のGUIコンポーネントIDを指定します。
  • state: 変更後の論理値を指定します。

論理値の取得

GUIコンポーネントの論理値を取得するには、 getComponentBool関数を呼び出します。この関数の形式は以下の通りです:

- 関数の形式 -
bool getComponentBool ( int id )

引数idには、論理値を取得する対象のGUIコンポーネントIDを指定します。 この関数は、論理値をbool型変数で返します。例えばチェックボックスなら、 選択されているとtrueを、されていなければfalseを返します。

使用可能なコンポーネント

setComponentBoolおよびgetComponentBool関数は、以下のGUIコンポーネントに対して使用できます。

チェックボックス

その他の種類の値

なお、このガイドでは扱いませんが、論理値(bool)以外にもint値やfloat値のパラメータを操作するような GUIコンポーネント(スライダーなど)も存在します。

そういったGUIコンポーネントについては、 ここで扱った setComponentBool / getComponentBool と同様に:

  • setComponentInt / getComponentInt
  • setComponentFloat / getComponentFloat

といった関数でパラメータの設定・取得を行えます。 詳細はGUIライブラリの仕様書をご参照ください。



スポンサーリンク



Japanese English
この階層の目次
RINEARN からのお知らせ
※ VCSSL は RINEARN が開発しています。

VCSSLの最新版をリリース、Java 24上での非互換な挙動を対処
2025-04-22 - VCSSL 3.4.50をリリースしました。Java 24環境上でのネットワークドライブ関連のファイルパス解決で、従来環境とは異なる挙動が生じていたのを解消しました。詳細をお知らせします。

リニアングラフやVCSSLの最新版をリリース、目盛りの位置や内容を自由に指定可能に!
2024-11-24 - リニアングラフ3D/2Dを更新し、自由な位置に、自由な表記内容の目盛りを描けるようになりました! 併せて、Java言語やVCSSLでの、プログラム制御用APIも拡張しています。詳細をお知らせします。

Exevalator 2.2 をリリース、TypeScript 対応によりWebブラウザ上で動作可能に
2024-10-22 - オープンソースの式計算ライブラリ「Exevalator(エグゼバレータ)」の2.1をリリースしました。新たに TypeScript に対応し、Webブラウザ上での式計算にも使えるようになりました。詳細を解説します。

アシスタントAI作成の舞台裏(その2、作成編)
2024-10-12 - アシスタントAIの作成方法解説の後編です。実際にChatGPTの「GPTs」機能を用いて、アシスタントAIを作成する手順や、独自の知識をもたせたり、精度を出すためのノウハウなどを解説しています。

アシスタントAI作成の舞台裏(その1、基礎知識編)
2024-10-07 - アシスタントAI作成方法解説の前編です。今回はまず、アシスタントAIを作る前に抑えておきたい、基礎知識を延々と解説しています。そもそもLLM型AIとはどんな存在か? RAGとは何か? 等々です。

ソフトの利用をサポートしてくれるアシスタントAIを提供開始!
2024-09-20 - RINEARN製ソフトの使い方の質問応答や、一部作業のお手伝いをしてくれる、アシスタントAIを提供開始しました。ChatGPTアカウントさえあれば、誰でも無料で使用できます。使い方を解説します。

Exevalator 2.1 をリリース、新たに Visual Basic に対応
2024-07-28 - オープンソースの式計算ライブラリ「Exevalator(エグゼバレータ)」の2.1をリリースしました。今回から、新たに Visual Basic(VB.NET)でも使用できるようになりました。詳細を解説します。

関数電卓 RINPn(りんぷん)、Esc キーで計算式の一発クリアが可能に
2024-07-20 - 関数電 RINPn の Ver.1.0.2 をリリースしました。今回から、キーボードの「 Esc 」キーを押すと、入力中の計算式を一発でクリアできるようになりました。詳細を解説します。

Exevalator 2.0 をリリース、互換性に注意が必要なバグ修正が 1 件
2024-07-14 - オープンソースの式計算ライブラリ「Exevalator (エグゼバレータ)」の2.0をリリースしました。今回の更新では、互換性に注意を要する 1 件のバグ修正があります。詳細を解説します。

各ソフトウェアをアップデート、リニアングラフのコマンド拡張やVCSSLの英語対応など
2024-02-05 - 各ソフトの一斉アップデートの内容をお知らせします。今回は、リニアングラフのコマンド機能を大幅拡張したのがメインです。また、VCSSLのメッセージ類の英語対応も行いました。