Share via


ツール バーのコントロールとボタンのスタイル

次のウィンドウ スタイルは、ツール バーに固有のものです。 これらは、ツール バーの作成時に他のウィンドウ スタイルと組み合わされます。

メモ Common Controls バージョン 6.00 では、ツール バーで ビジュアル スタイル が使用されている場合、ボタンはスタイル設定に関係なく常に透明になります。 それ以外の場合、透過性の動作は、TBSTYLE_FLATまたはTBSTYLE_TRANSPARENT スタイルの使用によって示される通常の動作です。

Note

Comctl32.dllバージョン 6 は再頒布可能ではありませんが、Windows に含まれています。 バージョン 6 Comctl32.dll使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

定数 説明
TBSTYLE_ALTDRAG
Alt キーを押しながらドラッグすることで、ツール バー ボタンの位置を変更できます。 このスタイルを指定しない場合、ユーザーは Shift キーを押しながらボタンをドラッグする必要があります。 ツール バー ボタンをドラッグできるようにするには、 CCS_ADJUSTABLE スタイルを指定する必要があることに注意してください。
TBSTYLE_CUSTOMERASE
バージョン 4.70。 ツール バー がWM_ERASEBKGND メッセージを処理するときに、NM_CUSTOMDRAW通知コード 生成します。
TBSTYLE_FLAT
バージョン 4.70。 フラット ツール バーを作成します。 フラット ツール バーでは、ツール バーとボタンの両方が透明になり、ホット トラッキングが有効になります。 ボタンのテキストはボタンのビットマップの下に表示されます。 再描画の問題を回避するには、ツール バー コントロールが表示される前に、このスタイルを設定する必要があります。
TBSTYLE_LIST
バージョン 4.70。 ビットマップの右側にボタン テキストを含むフラット ツール バーを作成します。 それ以外の場合、このスタイルは TBSTYLE_FLATと同じです。 再描画の問題を回避するには、ツール バー コントロールが表示される前に、このスタイルを設定する必要があります。
TBSTYLE_REGISTERDROP
バージョン 4.71。 カーソルがツール バー ボタン 上に移動したときにドロップ ターゲット オブジェクトを要求するTBN_GETOBJECT通知コードを生成します。
TBSTYLE_TOOLTIPS
ツール バーのボタンの説明テキストを表示するためにアプリケーションで使用できるツールヒント コントロールを作成します。
TBSTYLE_TRANSPARENT
バージョン 4.71。 透明なツール バーを作成します。 透明なツールバーでは、ツールバーは透明ですが、ボタンは透明ではありません。 ボタンのテキストはボタンのビットマップの下に表示されます。 再描画の問題を回避するには、ツール バー コントロールが表示される前に、このスタイルを設定する必要があります。
TBSTYLE_WRAPABLE
複数行のボタンを含めることができるツール バーを作成します。 ツールバーが狭すぎて同じ行にすべてのボタンを含めることができなくなると、ツールバーのボタンが次の行に折り返されることがあります。 ツールバーを折り返すと、バーに区切り記号がない場合は、右端の区切り記号または右端のボタンで区切りが発生します。 このスタイルは、ツールバーが垂直鉄筋コントロールの一部である場合に垂直ツールバー コントロールを表示するように設定する必要があります。 このスタイルをCCS_VERTと組み合わせることはできません。

メモ: ツール バー ボタンには、次のスタイルを組み合わせて使用できます。 ボタン スタイルを指定するには、ボタンの TBBUTTON 構造体の fsStyle メンバーに適切なフラグを設定します。 すべてのスタイルを組み合わせることができるわけではありません。

Shell バージョン 4.72 以前の場合、ウィンドウスタイルフラグとボタンスタイルフラグの両方にフォームTBSTYLE_XXXがありました。 バージョン 4.72 以前の Commctrl.h を使用してアプリケーションをコンパイルする場合は、TBSTYLE_XXX ボタン スタイル フラグを使用する必要があります。 バージョン 5.80 以降では、すべてのボタン スタイルにフォーム BTNS_XXXがあります。 すべてのTBSTYLE_XXX値には、同じ意味と数値を持つ同等のBTNS_XXX値があります。 便宜上、両方のフォームを次の表に示します。

定数 説明
BTNS_AUTOSIZE
バージョン 5.80。 ツール バー コントロールがボタンに標準の幅を割り当てないように指定します。 代わりに、ボタンの幅は、テキストの幅とボタンの画像に基づいて計算されます。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_AUTOSIZEを使用します。
BTNS_BUTTON
バージョン 5.80。 標準ボタンを作成します。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_BUTTONを使用します。 このフラグは 0 として定義されており、他のフラグが設定されていないことを示すために使用する必要があります。
BTNS_CHECK
バージョン 5.80。 ユーザーがクリックするたびに押された状態と非圧縮状態を切り替えるデュアル状態のプッシュ ボタンを作成します。 ボタンが押された状態の場合、ボタンの背景色が異なります。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_CHECKを使用します。
BTNS_CHECKGROUP
バージョン 5.80。 オプション ボタン (ラジオ ボタンとも呼ばれます) と同様に、グループ内の別のボタンが押されるまで押された状態を維持するボタンを作成します。 これは、BTNS_CHECKとBTNS_GROUPの組み合わせと同じです。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_CHECKGROUPを使用します。
BTNS_DROPDOWN
バージョン 5.80。 ボタンがクリックされたときにリストを表示できるドロップダウン スタイル ボタンを作成します。 ドロップダウン ボタンは、通常のボタンに使用されるWM_COMMAND メッセージではなく、 TBN_DROPDOWN 通知コードを送信します。 アプリケーションでは、通知ハンドラーにオプションの一覧を表示させることができます。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_DROPDOWNを使用します。
ツールバーに 拡張スタイルTBSTYLE_EX_DRAWDDARROWS がある場合、ドロップダウン ボタンにはドロップダウン矢印が右側の別のセクションに表示されます。 矢印をクリックすると、TBN_DROPDOWN通知コードが送信されます。 関連付けられたボタンをクリックすると、WM_COMMANDメッセージが送信されます。
BTNS_GROUP
バージョン 5.80。 BTNS_CHECKと組み合わせると、グループ内の別のボタンが押されるまで押された状態を維持するボタンが作成されます。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_GROUPを使用します。
BTNS_NOPREFIX
バージョン 5.80。 ボタン テキストにアクセラレータ プレフィックスが関連付けられていないことを指定します。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_NOPREFIXを使用します。
BTNS_SEP
バージョン 5.80。 ボタン グループ間の小さな間隔を提供する区切り記号を作成します。 このスタイルのボタンは、ユーザー入力を受け入れません。 バージョン 4.72 以前 の場合は、同等のスタイル フラグ TBSTYLE_SEPを使用します。
BTNS_SHOWTEXT
バージョン 5.81。 ボタン テキストを表示することを指定します。 すべてのボタンにテキストを含めることができますが、BTNS_SHOWTEXTボタン スタイルのボタンのみが表示されます。 このボタン スタイルは、TBSTYLE_LIST スタイルとTBSTYLE_EX_MIXEDBUTTONS拡張スタイルと共に使用する必要があります。 BTNS_SHOWTEXT スタイルを持たないボタンにテキストを設定すると、カーソルがボタンの上に置かれたときにツール バー コントロールにツール ヒントとして自動的に表示されます。 この機能を使用すると、アプリケーションでツール バーの TBN_GETINFOTIP または TTN_GETDISPINFO 通知コードの処理を回避できます。
BTNS_WHOLEDROPDOWN
バージョン 5.80。 ボタンにドロップダウン矢印を付け、別のセクションとして使用しないことを指定します。 このスタイルのボタンは、 TBSTYLE_EX_DRAWDDARROWS 拡張スタイルが設定されているかどうかに関係なく、同じように動作します。
TBSTYLE_AUTOSIZE
BTNS_AUTOSIZEと同じです。 バージョン 4.72 以前の場合は、TBSTYLE_AUTOSIZEを使用します。
TBSTYLE_BUTTON
BTNS_BUTTONと同じです。 バージョン 4.72 以前のTBSTYLE_BUTTONを使用します。
TBSTYLE_CHECK
BTNS_CHECKと同じです。 バージョン 4.72 以前の場合は、TBSTYLE_CHECKを使用します。
TBSTYLE_CHECKGROUP
BTNS_CHECKGROUPと同じです。 バージョン 4.72 以前には TBSTYLE_CHECKGROUP を使用します。
TBSTYLE_DROPDOWN
BTNS_DROPDOWNと同じです。 バージョン 4.72 以前の場合は、TBSTYLE_DROPDOWNを使用します。
TBSTYLE_GROUP
BTNS_GROUPと同じです。 バージョン 4.72 以前のTBSTYLE_GROUPを使用します。
TBSTYLE_NOPREFIX
BTNS_NOPREFIXと同じです。 バージョン 4.72 以前の場合は、TBSTYLE_NOPREFIXを使用します。
TBSTYLE_SEP
BTNS_SEPと同じです。 バージョン 4.72 以前の場合は、TBSTYLE_SEPを使用します。

要件

要件
ヘッダー
CommCtrl.h