メインコンテンツまでスキップ
バージョン: 20 R6 BETA

ピクチャーボタン

ピクチャーボタンは 標準のボタン と似ていますが、 3つの状態 (有効、無効、クリック) を持てる標準ボタンとは異なり、ピクチャーボタンでは、その名前が表わすようにそれぞれの状態を別々のピクチャーにより表わします。

ピクチャーボタンは、次の 2つの方法で使用します:

  • フォーム上のコマンドボタンとして。 この場合、ピクチャーボタンには通常 4種類の状態があります (有効、無効、クリック、ロールオーバー)。
    たとえば、1行 4列からなるサムネールテーブルの場合、各サムネールはデフォルト、クリック、ロールオーバー、無効という状態に対応しています。

    プロパティJSON 名
    rowCount1
    columnCount4
    マウスアップで戻るswitchBackWhenReleasedtrue
    ロールオーバー効果switchWhenRollovertrue
    無効時に最終フレームを使用useLastFrameAsDisabledtrue
  • 複数の選択項目の中からユーザーに選ばせるためのピクチャーボタンとして。 この場合、ピクチャーボタンをポップアップピクチャーメニューの代わりに使用することができます。 ピクチャーポップアップメニュー ではすべての選択肢が (ポップアップメニューの項目として) 同時に表示されます。他方ピクチャーボタンは、選択候補を連続的に表示します (ボタンをクリックする度に変わります)。
    次に示すのは、ピクチャーボタンの例です。 たとえば、カスタムアプリケーションのユーザーに、アプリケーションのインタフェース言語を選ばせたいものとします。 そこで下図のように、選択候補をピクチャーボタンとしてカスタムプロパティダイアログボックスに組み込みます:

オブジェクトをクリックするとピクチャーが変わります。

ピクチャーボタンの使用

次の方法でピクチャーボタンを導入します。

  1. まず初めに 1つの画像を用意し、一連のピクチャーを横、縦、または縦横の格子状に並べてその中に納めておきます。

ピクチャーは、縦、横、または縦横格子状に整理することができます (上図を参照)。 ピクチャーを格子状に並べた場合、各ピクチャーには上の行から順に左から右へと、0から始まる番号が振られます。 たとえば、4行と 3列で構成される格子において、2行目の 2番目の画像の番号は 4 になります (上の例では英国旗)。

  1. プロジェクトの Resouces フォルダーに画像があるのを確認し、そのファイルパスを パス名 プロパティに入力します。

  2. 画像の 行と列 プロパティを設定します。

  3. 画像の切り替え条件を アニメーション テーマのプロパティから選択します。

アニメーション

ピクチャーボタンは、標準的な配置や見た目の設定以外にも、表示モードと動作モードを指定する専用プロパティを設定することができます。 これらのオプションは組み合わせて使用することができます。

  • デフォルト (アニメーションオプション 未選択) の場合、ユーザーがクリックすると、系列中の次のピクチャーを表示します。Shift キーを押しながらクリックすると、系列中の前のピクチャーを表示します。 系列中の最後のピクチャーに到達すると、もう一度クリックしてもピクチャーは変わりません。 つまりこの設定では、系列中の最初のピクチャーへ一巡して戻ることはありません。

次のモードを選択することができます:

ピクチャーボタンに 関連付けた変数 は、ピクチャーのサムネールテーブルで現在表示されているピクチャーのインデックス番号を返します。 このテーブル内のピクチャー番号は 0 から始まります。

プロパティ一覧

タイプ - オブジェクト名 - 変数あるいは式 - タイトル - CSSクラス - パス名 - - - マウス押下中は自動更新 - 先頭フレームに戻る - ロールオーバー効果 - マウスアップで戻る - 無効時に最終フレームを使用 - アニメーション間隔 (tick) - ボタンスタイル - - - - - - 高さ - 横方向サイズ変更 - 縦方向サイズ変更 - フォーカス可 - ショートカット - 表示状態 - 境界線スタイル - フォント - 太字 - イタリック - フォントカラー - ヘルプTips - 標準アクション