Phi::BitBtn

super class

Phi::Button

class methods

new(parent[, name, caption]) : Phi::BitBtn

properties

glyph : Phi::Bitmap

選択したビットマップボタンに表示するビットマップ

1 つのビットマップに指定できるイメージは 4 つまでです。イメージはどれも同じサイズで，横に一列に並んでいなくてはなりません。ビットボタンは指定したイメージのいずれか 1 つをボタンの状態に従って表示します。

ビットマップ内のイメージの位置

ボタンの状態

説明

1 番目

上がっている

ボタンを選択していないとき ( 通常の状態のとき ) のイメージ。このイメージは，ボタンにフォーカスがある場合 ( ボタンを選択したときなど ) にも使われる。この場合はフォーカスの長方形がボタンの周囲に描画される。ビットマップに他のイメージがない場合は，どの状態でもこのイメージが使われる

2 番目

使用不可

ボタンが選択できないことを示すイメージ。淡色表示される

3 番目

下がっている

ボタンをクリックしたときのイメージ。マウスボタンから指を離すと上がった状態のイメージに戻る

4 番目

下がったまま

ボタンを押し下げたままのときのイメージ。選択されたままであることを示す

イメージが 1 つだけの場合は，下がったままの状態も上がっている状態と同じイメージになりますが，ビットボタンはイメージをやや異なる状態に変えて，他の状態になったことを表そうとします。

ビットマップに複数のイメージがある場合， num_glyphs を使ってビットマップ内のイメージの数を指定しなくてはなりません。

注意

ビットマップの左下のピクセルは「透過色」として予約されます。左下のピクセルと一致する色のビットマップのピクセルはすべて「透過色」になります。

num_glyphs : Fixnum

glyph で指定するグラフィック内のイメージ ( ビットマップボタンまたはスピードボタンで使うイメージ ) の数を示します。

ビットマップに複数のイメージがある場合， num_glyphs を使ってビットマップ内のイメージの数を指定しなくてはなりません。 num_glyphs の値は 1..3 ( スピードボタンでは 1..4) です。デフォルト値は 1 です。

kind : Fixnum

ビットマップボタンの種類

BK_CUSTOM

ボタンは glyph プロパティを使って表示するイメージを決める。押しボタンと同様に，ボタンの modal_result を選択することも on_click イベントに対応するコードを指定することもできる

BK_OK

緑色のチェックマークと「 OK 」という文字列がボタンに表示される。ボタンはデフォルトボタンになる (Default プロパティが自動的に True に設定される ) 。このボタンを選択すると，ダイアログボックスが閉じる。ビットマップボタンの modal_result 値は MR_OK となる

BK_CANCEL

赤い×印と「キャンセル」という文字列がボタンに表示される。ボタンは［キャンセル］ボタンになる (Cancel プロパティが自動的に True に設定される ) 。このボタンを押すと，ダイアログボックスが閉じる。ビットマップボタンの modal_result 値は MR_CANCEL となる

BK_YES

緑色のチェックマークと「はい」という文字列がボタンに表示される。ボタンはデフォルトボタンになる (Default プロパティが自動的に True に設定される ) 。このボタンを押すと，ダイアログボックスで変更した結果が受け入れられ，ダイアログボックスが閉じる。ビットマップボタンの modal_result 値は MR_YES となる

BK_NO

赤い否定マークと「いいえ」という文字列ボタンに表示される。ボタンは［キャンセル］ボタンになる (Cancel プロパティが自動的に True に設定される ) 。このボタンを押すと，ダイアログボックスで変更した結果がキャンセルされ，ダイアログボックスが閉じる。ビットマップボタンの modal_result 値は MR_NO となる

BK_HELP

水色の疑問符と「ヘルプ」という文字列がボタンに表示される。このボタンを押すとアプリケーションのヘルプファイル ( アプリケーションの HelpFile プロパティで指定したヘルプファイル ) のヘルプ画面が表示される。ボタンの HelpContext プロパティでヘルプファイルのどのヘルプ画面を表示するか指定する

BK_CLOSE

終了記号が付いた緑色のドアと「終了」という文字列がボタンに表示される。このボタンを押すとフォームが閉じる。ボタンの Default プロパティは True である

BK_ABORT

赤い×印と「中止」という文字列がボタンに表示される

BK_RETRY

緑色の環状矢印と「再試行」という文字列がボタンに表示される

BK_IGNORE

緑色の人が歩み去る絵と「無視」という文字列がボタンに表示される。エラーが発生した後に処理を続行する場合に使う

BK_ALL

緑色の二重チェックマークと「すべて」という文字列がボタンに表示される