- 目次 -
このライブラリ gui.ButtonPanel は、GUI部品として、ボタンが並ぶパネル ―― ボタンパネル ―― を提供します。
VCSSLの標準ライブラリ「 GUI 」では、GUI部品をint型のIDで扱いますが、このモジュールで提供されるGUI部品は、ButtonPanel 構造体として扱います。
ButtonPanel 構造体は、内部にリソースのID等を保持していますが、
生成・破棄のための関数が提供されるため、その中身を特に意識する必要はありません( むしろメンバへの直接的なアクセスは推奨されません )。
具体的には、 newButtonPanel 関数で生成し、deleteComponent 関数で破棄します。
またこのモジュールでは、ButtonPanel 構造体を標準ライブラリ「 GUI 」とほぼ同様の感覚でそのまま扱えるように、標準GUIライブラリ関数のオーバーロードも提供されます。
例えば、mountComponent 関数や、setComponentSize 関数、setComponentLocation 関数などが提供されます。
| 構造体名 | ButtonPanel |
| 宣言形式 | struct ButtonPanel |
| 説明 | ボタンパネルの構造体です。 |
- なし -
| 関数名 | newButtonPanel |
| 宣言形式 | ButtonPanel newButtonPanel(int x, int y, int width, int height, string labelText[ ]) |
| 説明 | ボタンパネルを生成します。 |
| 引数 |
(int型) x : パネルのX座標 (int型) y : パネルのY座標 (int型) width : パネルの幅 (int型) height : パネルの高さ (string[]型) labelText : ラベル文字列を格納する配列 buttonWidth : ボタンの幅 buttonText : ボタンの文字列を格納する配列 |
| 戻り値 | (ButtonPanel型) 生成したボタンパネル構造体 |
| 関数名 | deleteComponent |
| 宣言形式 | void deleteComponent(ButtonPanel &panelInstance) |
| 説明 | ボタンパネルを破棄します。 |
| 引数 | (ButtonPanel型) panelInstance : 破棄するボタンパネル |
| 戻り値 | (void型) |
| 関数名 | paintComponent |
| 宣言形式 | void paintComponent(ButtonPanel &panelInstance) |
| 説明 | ボタンパネルを再描画します。 |
| 引数 | (ButtonPanel型) panelInstance : 再描画するボタンパネル |
| 戻り値 | (void型) |
| 関数名 | mountComponent |
| 宣言形式 | void mountComponent(ButtonPanel &panelInstance, int componentID) |
| 説明 | ボタンパネルを、別のGUIコンポーネント上に配置します。 |
| 引数 |
(ButtonPanel型) panelInstance : 配置するボタンパネル (int型) componentID : 配置先GUIコンポーネントID |
| 戻り値 | (void型) |
| 関数名 | demountComponent |
| 宣言形式 | void demountComponent(ButtonPanel &panelInstance, int componentID) |
| 説明 | ボタンパネルを、別のGUIコンポーネントから配置解除します。 |
| 引数 |
(ButtonPanel型) panelInstance : 配置解除するボタンパネル (int型) componentID : 配置先GUIコンポーネントID |
| 戻り値 | (void型) |
| 関数名 | getPanel |
| 宣言形式 | int getPanel(ButtonPanel &panelInstance) |
| 説明 | パネルのコンポーネントIDを返します。 |
| 引数 | (ButtonPanel型) panelInstance : 取得対象のボタンパネル |
| 戻り値 | (int型) パネルのGUIコンポーネントID |
| 関数名 | getButton |
| 宣言形式 | int getButton(ButtonPanel &panelInstance, string labelText) |
| 説明 | 指定されたラベルに対応するボタンを取得します。 |
| 引数 |
(ButtonPanel型) panelInstance : 対象のボタンパネル (string型) labelText : 取得対象のボタンに対応するラベル文字列 |
| 戻り値 | (int型) ボタンのGUIコンポーネントID |
| 関数名 | getButton |
| 宣言形式 | int getButton(ButtonPanel &panelInstance, int index) |
| 説明 | 指定されたインデックスのボタンを取得します。 |
| 引数 |
(ButtonPanel型) panelInstance : 対象のボタンパネル (int型) index : ボタンのインデックス |
| 戻り値 | (int型) ボタンのGUIコンポーネントID |
| 関数名 | getComponentSize |
| 宣言形式 | int[ ] getComponentSize(ButtonPanel &panelInstance) |
| 説明 | パネルのサイズを返します。 |
| 引数 | (ButtonPanel型) panelInstance : 対象のボタンパネル |
| 戻り値 | (int[]型) パネルのサイズを格納する配列 |
| 関数名 | setComponentSize |
| 宣言形式 | void setComponentSize(ButtonPanel &panelInstance, int width, int height) |
| 説明 | パネルのサイズを設定します。 |
| 引数 |
(ButtonPanel型) panelInstance : 対象のボタンパネル (int型) width : パネルの幅 (int型) height : パネルの高さ |
| 戻り値 | (void型) |
| 関数名 | setComponentSize |
| 宣言形式 | void setComponentSize(ButtonPanel &panelInstance) |
| 説明 | パネルの現在のサイズに合わせて、内部コンポーネントのサイズを自動設定します。パネルのサイズを外部から変更した際に使用します。 |
| 引数 | (ButtonPanel型) panelInstance : 対象のボタンパネル |
| 戻り値 | (void型) |
| 関数名 | getComponentLocation |
| 宣言形式 | int[ ] getComponentLocation(ButtonPanel &panelInstance) |
| 説明 | パネルの位置を返します。 |
| 引数 | (ButtonPanel型) panelInstance : 対象のボタンパネル |
| 戻り値 | (int[]型) パネルの位置を格納する配列 |
| 関数名 | setComponentLocation |
| 宣言形式 | void setComponentLocation(ButtonPanel &panelInstance, int x, int y) |
| 説明 | パネルの位置を設定します。 |
| 引数 |
(ButtonPanel型) panelInstance : 対象のボタンパネル (int型) x : ウィンドウのX座標 (int型) y : ウィンドウのY座標 |
| 戻り値 | (void型) |