静的コントロール のスタイル

CreateWindow 関数または CreateWindowEx 関数を使用して静的コントロールを作成するには、STATIC クラス、適切なウィンドウ スタイル定数、および次の静的コントロール スタイルの組み合わせを指定します。

定数	説明
SS_BITMAP	ビットマップは、静的コントロールに表示されます。 テキストは、リソース ファイル内の別の場所で定義されたビットマップの名前です (ファイル名ではありません)。 このスタイルでは、 nWidth パラメーターと nHeight パラメーターは 無視されます。コントロールは、ビットマップに合わせて自動的にサイズを設定します。
SS_BLACKFRAME	ウィンドウ フレームと同じ色で描画されたフレームを含むボックス。 この色は、既定の配色では黒です。
SS_BLACKRECT	現在のウィンドウ フレームの色で塗りつぶされた四角形。 この色は、既定の配色では黒です。
SS_CENTER	単純な四角形で、テキストを四角形の中央に配置します。 テキストは表示前に書式設定されます。 行の末尾を超える単語は、自動的に次の中央揃え行の先頭に折り返されます。 コントロールの幅より長い単語は切り捨てられます。
SS_CENTERIMAGE	ビットマップは、それを含む静的コントロールの中央に配置されます。 コントロールのサイズが変更されないため、コントロールに対してビットマップが大きすぎるとクリップされます。 静的コントロールに 1 行のテキストが含まれている場合、テキストはコントロールのクライアント領域の垂直方向の中央に配置されます。
SS_EDITCONTROL	静的コントロールは、複数行の編集コントロールのテキスト表示特性を複製します。 具体的には、平均文字幅は編集コントロールと同じ方法で計算され、関数は部分的に表示される最後の行を表示しません。
SS_ENDELLIPSIS	文字列の末尾が四角形に収まらない場合は、切り捨てられ、省略記号が追加されます。 文字列の末尾にない単語が四角形の制限を超えた場合は、省略記号なしで切り捨てられます。 このスタイルを使用すると、コントロールのテキストがワード ラップのない 1 行に強制的に適用されます。 SS_PATHELLIPSISとSS_WORDELLIPSISと比較します。
SS_ENHMETAFILE	拡張メタファイルは、静的コントロールに表示されます。 テキストはメタファイルの名前です。 拡張メタファイル静的コントロールのサイズは固定です。メタファイルは、静的コントロールのクライアント領域に合わせてスケーリングされます。
SS_ETCHEDFRAME	EDGE_ETCHEDエッジ スタイルを使用して、静的コントロールのフレーム を 描画します。 詳細については、「 DrawEdge 関数」を参照してください。
SS_ETCHEDHORZ	EDGE_ETCHEDエッジ スタイルを使用して、静的コントロールの上端と下端を描画します。 詳細については、「 DrawEdge 関数」を参照してください。
SS_ETCHEDVERT	EDGE_ETCHEDエッジ スタイルを使用して、静的コントロールの左端と右端を描画します。 詳細については、「 DrawEdge 関数」を参照してください。
SS_GRAYFRAME	画面の背景 (デスクトップ) と同じ色で描画されたフレームを持つボックス。 この色は、既定の配色では灰色です。
SS_GRAYRECT	現在の画面の背景色で塗りつぶされた四角形。 この色は、既定の配色では灰色です。
SS_ICON	ダイアログ ボックスに表示されるアイコン。 コントロールがダイアログ ボックスの一部として作成される場合、テキストはリソース ファイル内の別の場所で定義されているアイコンの名前 (ファイル名ではありません) になります。 コントロールが CreateWindow または関連する関数を使用して作成される場合、テキストは、hInstance パラメーターによって CreateWindow に指定されたモジュールに関連付けられているリソース ファイルで定義されているアイコンの名前 (ファイル名ではありません) です。 アイコンには、アニメーションカーソルを指定できます。 このスタイルでは、 CreateWindow パラメーター nWidth と nHeight は無視されます。コントロールは、アイコンに合わせて自動的にサイズを設定します。 LoadIcon 関数を使用しているため、SS_ICON スタイルでは、ディメンションSM_CXICONとSM_CYICONのアイコンのみを読み込むことができます。 この制限は、SS_ICONに加えて SS_REALSIZEIMAGEスタイルを使用してバイパスできます。 LoadIcon を介してアイコンを読み込めない場合は、LoadCursor を使用して、指定したリソースをカーソルとして読み込もうとします。 これも失敗した場合は、 LoadImage を使用してデバイス ドライバーから読み込もうとします。
SS_LEFT	単純な四角形で、四角形内のテキストを左揃えにします。 テキストは表示前に書式設定されます。 行の末尾を超える単語は、次の左揃え行の先頭に自動的に折り返されます。 コントロールの幅より長い単語は切り捨てられます。
SS_LEFTNOWORDWRAP	単純な四角形で、四角形内のテキストを左揃えにします。 タブは展開されますが、単語は折り返されません。 行の末尾を越えて拡張されたテキストはクリップされます。
SS_NOPREFIX	コントロールのテキスト内のアンパサンド (&) 文字をアクセラレータ プレフィックス文字として解釈できないようにします。 アンパサンドが削除され、文字列の次の文字が下線付きで表示されます。 この静的コントロール スタイルは、定義されている任意の静的コントロールに含めることができます。 SS_NOPREFIXを他のスタイルと組み合わせることができます。 これは、アンパサンド (&) を含むファイル名またはその他の文字列をダイアログ ボックスの静的コントロールに表示する必要がある場合に便利です。
SS_NOTIFY	ユーザーがコントロール をクリックまたはダブルクリック したときに、親ウィンドウのSTN_CLICKED、 STN_DBLCLK、 STN_DISABLE 、およびSTN_ENABLE通知コードを送信します。
SS_OWNERDRAW	静的コントロールの所有者は、コントロールの描画を担当します。 所有者ウィンドウは、コントロールを描画する必要があるときに常に WM_DRAWITEM メッセージを受け取ります。
SS_PATHELLIPSIS	文字列の中央にある文字を省略記号に置き換えて、指定した四角形に結果が収まるようにします。 文字列に円記号 (\) 文字が含まれている場合、 SS_PATHELLIPSIS は最後の円記号の後のテキストを可能な限り保持します。 このスタイルを使用すると、コントロールのテキストがワード ラップのない 1 行に強制的に適用されます。 SS_ENDELLIPSISとSS_WORDELLIPSISと比較します。
SS_REALSIZECONTROL	静的コントロールのサイズに合わせてビットマップを調整します。 たとえば、ロケールを変更するとシステム フォントが変更され、コントロールのサイズが変更される場合があります。 静的コントロールにビットマップがある場合、ビットマップはコントロールに適合しなくなります。 このスタイル ビットは、コントロールに合わせてビットマップの自動再調整を指示します。 SS_CENTERIMAGEを指定すると、ビットマップまたはアイコンが中央に配置されます (必要に応じてクリップされます)。 SS_CENTERIMAGEを指定しない場合、ビットマップまたはアイコンは拡大または縮小されます。 2 つの軸の再調整は独立しており、結果の縦横比が変更される可能性があることに注意してください。 SS_REALSIZEIMAGEと比較します。
SS_REALSIZEIMAGE	実際のリソース幅が使用され、 アイコンが LoadImage を使用して読み込まれることを指定します。 SS_REALSIZEIMAGE は常に SS_ICONと組み合わせて使用されます。 SS_REALSIZEIMAGE は LoadImage を使用し、通常は SS_ICON の後に続くプロセスをオーバーライドします。 カーソルは読み込まれません。 LoadImage が 失敗した場合、それ以上読み込もうとしません。 実際のリソース幅が使用されます。 静的コントロールのサイズは適宜変更されますが、アイコンはコントロールの最初に指定された左端と上端に揃えられます。 SS_CENTERIMAGEも指定した場合、アイコンはコントロールの領域内の中央に配置され、CreateWindow パラメーター nWidth と nHeight を使用して指定されていることに注意してください。 SS_REALSIZECONTROLと比較します。
SS_RIGHT	単純な四角形で、四角形内のテキストを右揃えにします。 テキストは表示前に書式設定されます。 行の末尾を超える単語は、右揃えの次の行の先頭に自動的に折り返されます。 コントロールの幅より長い単語は切り捨てられます。
SS_RIGHTJUST	SS_BITMAPスタイルまたはSS_ICONスタイルを持つ静的コントロールの右下隅は、コントロールのサイズが変更されたときに固定されたままになります。 新しいビットマップまたはアイコンに合わせて、上部と左側のみが調整されます。
SS_SIMPLE	単純な四角形で、左揃えのテキストの 1 行を四角形に表示します。 テキスト行を短くしたり、変更したりすることはできません。 また、コントロールが無効になっている場合、コントロールはテキストを灰色で表示しません。
SS_SUNKEN	静的コントロールの周囲に半分くぼんだ境界線を描画します。
SS_TYPEMASK	SS_* スタイル ビットで OR 演算子を使用した結果の複合スタイル ビット。 特定のビットマスクから有効なSS_* ビットをマスクするために使用できます。 これは古く、すべての有効なスタイルが正しく含まれていないことに注意してください。 したがって、このスタイルは使用しないでください。
SS_WHITEFRAME	ウィンドウの背景と同じ色で描画されたフレームを含むボックス。 この色は、既定の配色では白です。
SS_WHITERECT	現在のウィンドウの背景色で塗りつぶされた四角形。 この色は、既定の配色では白です。
SS_WORDELLIPSIS	四角形に収まらない単語を切り捨て、省略記号を追加します。 このスタイルを使用すると、コントロールのテキストが 1 行に強制的に挿入され、ワード ラップは行われません。 SS_ENDELLIPSISとSS_PATHELLIPSISと比較します。

解説

複数行テキストの省略記号で単語または文字列を切り捨てるスタイルを使用するには、書式フラグがDT_WORDBREAKされ、設定DT_ENDELLIPSIS所有者描画コントロールで DrawThemeText または DrawText を使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)