Share via


ボタン スタイル

ここでは、ボタンの種類とスタイルについて説明します。

ボタンの種類

次の表は、ボタンの種類の一覧です。次のいずれかを必要に応じて選択できます。ボタンの種類を指定しない場合、既定値は BS_PUSHBUTTON です。

種類

Description

BS_3STATE

3 つの状態を持つチェック ボックス ボタンを作成します。このボタンには、BST_CHECKED、BST_INDETERMINATE、および BST_UNCHECKED の状態があります。このボタンをクリックすると、オーナー ウィンドウに BN_CLICKED 通知が送信されますが、ボタンの状態は変更されません。既定では、関連付けられたテキストはチェック ボックスの右側に表示されます。チェック ボックスの左側にテキストを表示するには、BS_LEFTTEXT スタイルまたは BS_RIGHTBUTTON スタイルを使用します。

BS_AUTO3STATE

3 つの状態を持つチェック ボックス ボタンを作成します。このボタンには、BST_CHECKED、BST_INDETERMINATE、および 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 つ以上を必要に応じて選択できます。

スタイル

Description

BS_LEFTTEXT

オプション ボタンまたはチェック ボックスのスタイルと組み合わせて指定すると、オプション ボタンまたはチェック ボックスの左側にテキストが表示されます。

BS_RIGHTBUTTON

オプション ボタンまたはチェック ボックスのスタイルと組み合わせて指定すると、オプション ボタンまたはチェック ボックスの左側にテキストが表示されます。このスタイルは BS_LEFTTEXT スタイルと同じです。

BS_PUSHLIKE

チェック ボックスまたはオプション ボタンの外観と動作をコマンド ボタンのようにします。ボタンは、ボタンの状態が BST_CHECKED の場合は押された状態で表示され、ボタンの状態が BST_INDETERMINATE の場合は押された状態で淡色表示され、ボタンの状態が BST_UNCHECKED の場合は押されていない状態で表示されます。

テキストの配置スタイル

次の表は、水平方向と垂直方向のテキストの配置オプションの一覧です。次のいずれかを必要に応じて選択できます。

スタイル

Description

BS_LEFT

ボタンの四角形の内部にテキストを左寄せで配置します。ただし、BS_RIGHTBUTTON スタイルが適用されていないチェック ボックスまたはオプション ボタンの場合、テキストはそのチェック ボックスまたはオプション ボタンの右側に、左寄せで配置されます。

BS_RIGHT

ボタンの四角形の内部にテキストを右寄せで配置します。ただし、BS_RIGHTBUTTON スタイルが適用されていないチェック ボックスまたはオプション ボタンの場合、テキストはそのチェック ボックスまたはオプション ボタンの右側に、右寄せで配置されます。

BS_CENTER

ボタンの四角形内でテキストを水平方向に中央揃えで配置します。

BS_TOP

ボタンの四角形の上部にテキストを配置します。

BS_BOTTOM

ボタンの四角形の下部にテキストを配置します。

BS_VCENTER

ボタンの四角形内でテキストを垂直方向に中央揃えで配置します。

ボタンの内容に関するオプション

次の表は、ボタンに表示する内容を指定するオプションの一覧です。テキストしか表示されないボタンの種類では、これらのスタイルは無視されます。次のいずれかを必要に応じて選択できます。

スタイル

Description

BS_BITMAP

ボタンにビットマップを表示することを指定します。

BS_ICON

ボタンにアイコンを表示することを指定します。

BS_TEXT

ボタンにテキストを表示することを指定します。

その他のオプション

次の表は、任意のボタンの種類で使用できるその他のオプションの一覧です。次の中から 1 つ以上を必要に応じて選択できます。

スタイル

Description

BS_FLAT

ボタンが 2 次元であり、3 次元イメージを作成するための既定の網かけは描画しないように指定します。

BS_MULTILINE

文字列が長すぎてボタンの四角形の内部に 1 行で収まらない場合は、ボタン テキストを複数行に折り返します。

BS_NOTIFY

ボタンが BN_DBLCLK、BN_KILLFOCUS、BN_SETFOCUS の各通知メッセージを親ウィンドウに送信できるようになります。ボタンは、このスタイルが指定されているかどうかに関係なく、BN_CLICKED 通知を送信します。

参照

関連項目

CButton::Create

ボタン スタイル

BN_CLICKED Notification

その他の技術情報

MFC で使用するスタイル