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

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 または関連関数を使用して作成された場合、テキストは、CreateWindow に対する hInstance パラメーターで指定されたモジュールに関連付けられているリソース ファイルで定義されたアイコンの名前 (ファイル名ではありません) です。 アイコンには、アニメーション カーソルを指定できます。 このスタイルでは、 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 [デスクトップ アプリのみ]
Header	Winuser.h (Windows.h を含む)