title: Phi::BitBtn
author: YOSHIDA Kazuhiro
mailto: moriq@moriq.com

1. Phi::BitBtn

1.1. super class

  Phi::Button#

1.1. class methods

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

1.1. properties

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

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

  : ビットマップ内のイメージの位置
    ボタンの状態

    説明

  : 1 番目
    上がっている

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

  : 2 番目
    使用不可

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

  : 3 番目
    下がっている

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

  : 4 番目
    下がったまま

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

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

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

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

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

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

: kind : Fixnum
  ビットマップボタンの種類

  : BK_CUSTOM
    ボタンは %c: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
    緑色の二重チェックマークと「すべて」という文字列がボタンに表示される
