ボタン スタイル
ここでは、ボタンの種類とスタイルについて説明します。
ボタンの種類
次の表は、ボタンの種類の一覧です。 次のいずれかを必要に応じて選択できます。 ボタンの種類を指定しない場合、既定値は BS_PUSHBUTTON です。
次のように入力します。 |
説明 |
---|---|
BS_3STATE |
チェック ボックス ボタンの 3 つの状態を作成します。BST_CHECKED, BST_INDETERMINATE, and BST_UNCHECKED. このボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信されますが、ボタンの状態は変更されません。 既定では、関連付けられたテキストはチェック ボックスの右側に表示されます。 チェック ボックスの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。 |
BS_AUTO3STATE |
チェック ボックス ボタンの 3 つの状態を作成します。BST_CHECKED, BST_INDETERMINATE, and BST_UNCHECKED. このボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信され、ボタンの状態が変更されます。 ボタンの状態は、BST_CHECKED、BST_INDETERMINATE、BST_UNCHECKED の順序で循環します。 既定では、関連付けられたテキストはチェック ボックスの右側に表示されます。 チェック ボックスの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。 |
BS_AUTOCHECKBOX |
チェック ボックスのボタンと 2 つの状態を作成します。BST_CHECKED および BST_UNCHECKED。 このボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信され、ボタンの状態が変更されます。 既定では、関連付けられたテキストはチェック ボックスの右側に表示されます。 チェック ボックスの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。 |
BS_AUTORADIOBUTTON |
ラジオ ボタンと 2 つの状態を作成します。BST_CHECKED および BST_UNCHECKED。 通常、オプション ボタンはグループで使用します。各グループで一度に選択できるオプションは 1 つだけです。 このボタンをクリックすると、BN_CLICKED 通知がオーナー ウィンドウに送信され、クリックしたオプション ボタンの状態が BST_CHECKED に設定されて、そのボタン グループに含まれる他のすべてのオプション ボタンの状態が BST_UNCHECKED に設定されます。 既定では、関連付けられたテキストはオプション ボタンの右側に表示されます。 オプション ボタンの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。 |
BS_CHECKBOX |
チェック ボックスのボタンと 2 つの状態を作成します。BST_CHECKED および BST_UNCHECKED。 このボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信されますが、ボタンの状態は変更されません。 既定では、関連付けられたテキストはチェック ボックスの右側に表示されます。 チェック ボックスの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。 |
BS_COMMANDLINK |
コマンド リンク ボタンを作成します。 コマンド リンク ボタンは Windows Vista に固有のコマンド ボタンで、メイン テキストの左側に緑の矢印が表示され、メイン テキストの下に注釈が表示されます。 注釈テキストは CButton::SetNote を使用して設定できます。 |
BS_DEFCOMMANDLINK |
コマンド リンク ボタンを作成します。 コマンド リンク ボタンは Windows Vista に固有のコマンド ボタンで、メイン テキストの左側に緑の矢印が表示され、メイン テキストの下に注釈が表示されます。 注釈テキストは CButton::SetNote を使用して設定できます。 このボタンがダイアログ ボックス内にある場合、ボタンに入力フォーカスがなくても、Enter キーを押すとダイアログ ボックスに BN_CLICKED 通知が送信されます。 |
BS_DEFPUSHBUTTON |
境界線が黒くて太いコマンド ボタンを作成します。 このボタンがダイアログ ボックス内にある場合、ボタンに入力フォーカスがないときでも、Enter キーを押すと、BN_CLICKED 通知がダイアログ ボックスに送信されます。 |
BS_DEFSPLITBUTTON |
分割ボタンを作成します。 分割ボタンは Windows Vista に固有のコマンド ボタンで、ボタンとドロップダウン矢印が並んで表示されます。 ボタンをクリックすると、既定のコマンドが実行されます。 ドロップダウン矢印をクリックすると、追加のコマンドのメニューが表示されます。 この分割ボタンがダイアログ ボックス内にある場合、ボタンに入力フォーカスがなくても、Enter キーを押すとダイアログ ボックスに BN_CLICKED 通知が送信されます。 |
BS_GROUPBOX |
他のボタンをグループ化する四角形を作成します。 このスタイルに関連付けられたテキストは、この四角形の左上隅に表示されます。 |
BS_OWNERDRAW |
オーナー描画ボタンを作成します。 ボタンの外観が変更されると、フレームワークは DrawItem メソッドを呼び出します。 CBitmapButton クラスを使用するときは、このスタイルを設定する必要があります。 |
BS_PUSHBUTTON |
コマンド ボタンを作成します。ユーザーがボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信されます。 |
BS_RADIOBUTTON |
ラジオ ボタンと 2 つの状態を作成します。BST_CHECKED および BST_UNCHECKED。 通常、オプション ボタンはグループで使用します。各グループで一度に選択できるオプションは 1 つだけです。 このボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信されますが、グループ内のどのボタンの状態も自動的には変更されません。 既定では、関連付けられたテキストはオプション ボタンの右側に表示されます。 オプション ボタンの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。 |
BS_SPLITBUTTON |
分割ボタンを作成します。 分割ボタンは Windows Vista に固有のコマンド ボタンで、ボタンとドロップダウン矢印が並んで表示されます。 ボタンをクリックすると、既定のコマンドが実行されます。 ドロップダウン矢印をクリックすると、追加のコマンドのメニューが表示されます。 |
BS_USERBUTTON |
現在では使用されていないスタイルですが、16 ビット バージョンの Windows との下位互換性のために残されています。 Win32 ベースのアプリケーションでは、このスタイルではなく BS_OWNERDRAW を使用してください。 |
オプション ボタンおよびチェック ボックスのスタイル
次の表は、オプション ボタンとチェック ボックスに固有のスタイルの一覧です。 これらのスタイルは、オプション ボタンおよびチェック ボックス以外のボタンの種類では無視されます。 次の中から 1 つ以上を必要に応じて選択できます。
スタイル |
説明 |
---|---|
BS_LEFTTEXT |
オプション ボタンまたはチェック ボックスのスタイルと組み合わせて指定すると、オプション ボタンまたはチェック ボックスの左側にテキストが表示されます。 |
BS_RIGHTBUTTON |
オプション ボタンまたはチェック ボックスのスタイルと組み合わせて指定すると、オプション ボタンまたはチェック ボックスの左側にテキストが表示されます。 このスタイルは BS_LEFTTEXT スタイルと同じです。 |
BS_PUSHLIKE |
チェック ボックスまたはオプション ボタンの外観と動作をコマンド ボタンのようにします。 ボタンは、ボタンの状態が BST_CHECKED の場合は押された状態で表示され、ボタンの状態が BST_INDETERMINATE の場合は押された状態で淡色表示され、ボタンの状態が BST_UNCHECKED の場合は押されていない状態で表示されます。 |
テキストの配置スタイル
次の表は、水平方向と垂直方向のテキストの配置オプションの一覧です。 次のいずれかを必要に応じて選択できます。
スタイル |
説明 |
---|---|
BS_LEFT |
ボタンの四角形の内部にテキストを左寄せで配置します。 ただし、BS_RIGHTBUTTON スタイルが適用されていないチェック ボックスまたはオプション ボタンの場合、テキストはそのチェック ボックスまたはオプション ボタンの右側に、左寄せで配置されます。 |
BS_RIGHT |
ボタンの四角形の内部にテキストを右寄せで配置します。 ただし、BS_RIGHTBUTTON スタイルが適用されていないチェック ボックスまたはオプション ボタンの場合、テキストはそのチェック ボックスまたはオプション ボタンの右側に、右寄せで配置されます。 |
BS_CENTER |
ボタンの四角形内でテキストを水平方向に中央揃えで配置します。 |
BS_TOP |
ボタンの四角形の上部にテキストを配置します。 |
BS_BOTTOM |
ボタンの四角形の下部にテキストを配置します。 |
BS_VCENTER |
ボタンの四角形内でテキストを垂直方向に中央揃えで配置します。 |
ボタンの内容に関するオプション
次の表は、ボタンに表示する内容を指定するオプションの一覧です。 テキストしか表示されないボタンの種類では、これらのスタイルは無視されます。 次のいずれかを必要に応じて選択できます。
スタイル |
説明 |
---|---|
BS_BITMAP |
ボタンにビットマップを表示することを指定します。 |
BS_ICON |
ボタンにアイコンを表示することを指定します。 |
BS_TEXT |
ボタンにテキストを表示することを指定します。 |
その他のオプション
次の表は、任意のボタンの種類で使用できるその他のオプションの一覧です。 次の中から 1 つ以上を必要に応じて選択できます。
スタイル |
説明 |
---|---|
BS_FLAT |
ボタンが 2 次元であり、3 次元イメージを作成するための既定の網かけは描画しないように指定します。 |
BS_MULTILINE |
文字列が長すぎてボタンの四角形の内部に 1 行で収まらない場合は、ボタン テキストを複数行に折り返します。 |
BS_NOTIFY |
ボタンが BN_DBLCLK、BN_KILLFOCUS、BN_SETFOCUS の各通知メッセージを親ウィンドウに送信できるようになります。 ボタンは、このスタイルが指定されているかどうかに関係なく、BN_CLICKED 通知を送信します。 |
参照
参照
BN_CLICKED Notification