靜態控件樣式

若要使用 CreateWindow 或 CreateWindowEx 函式建立靜態控件，請指定 STATIC 類別、適當的視窗樣式常數，以及下列靜態控件樣式的組合。

持續性	描述
SS_BITMAP	位圖要顯示在靜態控件中。 文字是資源檔中其他地方所定義的點陣圖名稱（而非檔名）。 樣式會 忽略 nWidth 和 nHeight 參數;控件會自動調整大小以容納位圖。
SS_BLACKFRAME	以與視窗框架相同色彩繪製框架的方塊。 此色彩在預設色彩配置中為黑色。
SS_BLACKRECT	填滿目前視窗框架色彩的矩形。 此色彩在預設色彩配置中為黑色。
SS_CENTER	簡單的矩形，並將矩形中的文字置中。 文字會在顯示之前格式化。 延伸超過行尾的文字會自動包裝至下一個置中線的開頭。 超過控件寬度的文字會被截斷。
SS_CENTERIMAGE	位圖會置中於包含該位圖的靜態控件中。 控件不會重設大小，因此會裁剪控件的點陣圖太大。 如果靜態控件包含單行文字，則文字會垂直置中於控件的工作區。
SS_EDITCONTROL	靜態控件會複製多行編輯控件的文字顯示特性。 具體而言，平均字元寬度的計算方式與編輯控件相同，而且函式不會顯示部分可見的最後一行。
SS_ENDELLIPSIS	如果字串的結尾不符合矩形，則會截斷並新增省略號。 如果不在字串結尾的字超出矩形的限制，則會在不省略號的情況下截斷。 使用此樣式會強制控件的文字位於一行，且沒有自動換行。 與 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 參數 nWidth 和 nHeight;控件會自動調整其大小以容納圖示。 當它使用 LoadIcon 函式時，SS_ICON樣式只能載入維度的圖示SM_CXICON和SM_CYICON。 除了SS_ICON之外，也可以使用SS_REALSIZEIMAGE樣式來略過這項限制。 如果無法透過LoadIcon載入圖示，嘗試使用LoadCursor將指定的資源載入為資料指標。 如果太失敗，就會嘗試使用 LoadImage從設備驅動器載入。
SS_LEFT	簡單的矩形，並將矩形中的文字靠左對齊。 文字會在顯示之前格式化。 延伸超過行尾的文字會自動包裝至下一個靠左對齊線條的開頭。 超過控件寬度的文字會被截斷。
SS_LEFTNOWORDWRAP	簡單的矩形，並將矩形中的文字靠左對齊。 索引標籤會展開，但不會包裝單字。 延伸超過行尾的文字會裁剪。
SS_NOPREFIX	防止將控件文字中的任何連字元和字元解譯為快捷鍵前置字元。 這些會以已移除的 ampersand 和字串底線中的下一個字元顯示。 此靜態控件樣式可以包含在任何定義的靜態控件中。 您可以將SS_NOPREFIX與其他樣式結合。 當檔名或其他可能包含 ampersand （&） 的字串必須顯示在對話框的靜態控件中時，這非常有用。
SS_NOTIFY	當使用者按兩下或雙擊控件時，傳送父視窗 STN_CLICKED、 STN_DBLCLK、 STN_DISABLE和 STN_ENABLE 通知碼。
SS_OWNERDRAW	靜態控件的擁有者負責繪製控件。 每當需要繪製控件時，擁有者視窗就會 收到WM_DRAWITEM 訊息。
SS_PATHELLIPSIS	以省略號取代字串中間的字元，使結果符合指定的矩形。 如果字串包含反斜杠 （\） 字元， SS_PATHELLIPSIS 最後一個反斜杠之後盡可能保留文字。 使用此樣式會強制控件的文字位於一行，且沒有自動換行。 與 SS_ENDELLIPSIS 和 SS_WORDELLIPSIS比較。
SS_REALSIZECONTROL	調整位圖以符合靜態控件的大小。 例如，變更地區設定可以變更系統字型，因此控件可能會重設大小。 如果靜態控件有位圖，位圖就不會再符合控件。 此樣式位會指定位陣圖的自動重新定義，以符合其控件。 如果 指定SS_CENTERIMAGE ，位圖或圖示會置中（並視需要裁剪）。 如果未 指定SS_CENTERIMAGE ，則點圖或圖示會延展或縮小。 請注意，兩個座標軸中的重新定義是獨立的，而且結果可能會有變更的外觀比例。 與 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	簡單的矩形，並在矩形中顯示單行靠左對齊的文字。 文字行無法以任何方式縮短或改變。 此外，如果控件已停用，則控件不會呈現其文字灰色。
SS_SUNKEN	在靜態控件周圍繪製半沉沒的框線。
SS_TYPEMASK	復合樣式位，從在 SS_* 樣式位上使用 OR 運算子所產生。 可用來遮罩來自指定位掩碼的有效SS_* 位。 請注意，這已過期，且未正確包含所有有效的樣式。 因此，您不應該使用此樣式。
SS_WHITEFRAME	具有與視窗背景相同色彩繪製框架的方塊。 此色彩在預設色彩配置中為白色。
SS_WHITERECT	填滿目前視窗背景色彩的矩形。 此色彩在預設色彩配置中為白色。
SS_WORDELLIPSIS	截斷任何不符合矩形的字組，並新增省略號。 使用此樣式會強制控件的文字位於一行，且沒有自動換行。 與 SS_ENDELLIPSIS 和 SS_PATHELLIPSIS比較。

備註

若要使用以多行文字省略號截斷單字或字串的樣式，DrawThemeText 或 DrawText 可用於擁有者繪製控件，並設定格式旗標DT_WORDBREAK和DT_ENDELLIPSIS。

需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
頁首	Winuser.h （包括 Windows.h）