BCM_GETIDEALSIZE メッセージ

画像リストが存在する場合に、そのテキストと画像に最適なボタンのサイズを取得します。 このメッセージは明示的に送信することも、 Button_GetIdealSize マクロを使用することもできます。

パラメーター

wParam

使用されません。は 0 である必要があります。

lParam

テキストと画像リスト (存在する場合) を含む、ボタンの目的のサイズを受け取る SIZE 構造体へのポインター。 呼び出し元のアプリケーションは、この構造体を割り当てる役割を担います。 CX メンバーと cy メンバーを 0 に設定して、SIZE 構造体で返される理想的な高さと幅を設定します。 ボタンの幅を指定するには、 cx メンバーを目的のボタン幅に設定します。 システムは、この幅に最適な高さを計算し、 cy メンバーで返します。

戻り値

メッセージが成功すると、 TRUE が返されます。 それ以外の場合は FALSE を返します。

注釈

注意

特別なボタン幅が必要ない場合は、 SIZE の両方のメンバーを 0 に設定して、理想的な高さと幅を計算して返す必要があります。 cx メンバーの値が 0 より大きい場合、この値は目的のボタン幅と見なされ、この幅に最適な高さが計算され、cy メンバーで返されます。

このメッセージは、PushButtons に最も適しています。 PushButton に送信されると、メッセージはボタンのテキストを表示するために必要な外接する四角形を取得します。 さらに、PushButton にイメージ リストがある場合は、ボタンのイメージを含むように外接する四角形のサイズも調整されます。

他の種類のボタンに送信されると、コントロールのウィンドウ四角形のサイズが取得されます。

注意

このメッセージを使用するには、バージョン 6.0 Comclt32.dll指定するマニフェストを指定する必要があります。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
Header	Commctrl.h