Styly statických ovládacích prvků

Chcete-li vytvořit statický ovládací prvek pomocí funkce CreateWindow nebo CreateWindowEx , zadejte statickou třídu, odpovídající konstanty stylu okna a kombinaci následujících stylů statických ovládacích prvků.

Konstanta	Popis
SS_BITMAP	Rastrový obrázek se zobrazí ve statickém ovládacím prvku. Text je název rastrového obrázku (nikoli názvu souboru) definovaný jinde v souboru prostředků. Styl ignoruje parametry nWidth a nHeight ; ovládací prvek se automaticky rozsadí tak, aby se přizpůsobil rastru.
SS_BLACKFRAME	Pole s rámečkem nakresleným ve stejné barvě jako rámečky oken. Tato barva je ve výchozím barevném schématu černá.
SS_BLACKRECT	Obdélník vyplněný aktuální barvou rámečku okna Tato barva je ve výchozím barevném schématu černá.
SS_CENTER	Jednoduchý obdélník a zacentruje text do obdélníku. Text je naformátovaný před zobrazením. Slova, která přesahují konec řádku, se automaticky zalomí na začátek dalšího na středového řádku. Slova, která jsou delší než šířka ovládacího prvku, jsou zkrácena.
SS_CENTERIMAGE	Rastrový obrázek je zacentrován ve statickém ovládacím prvku, který ho obsahuje. Ovládací prvek není změněný, takže rastrový obrázek je příliš velký pro ovládací prvek oříznut. Pokud statický ovládací prvek obsahuje jeden řádek textu, text je svisle zarovnaný do klientské oblasti ovládacího prvku.
SS_EDITCONTROL	Statický ovládací prvek duplikuje vlastnosti zobrazení textu ovládacího prvku pro víceřádkové úpravy. Konkrétně se průměrná šířka znaků vypočítá stejným způsobem jako u ovládacího prvku pro úpravy a funkce nezobrazuje částečně viditelný poslední řádek.
SS_ENDELLIPSIS	Pokud se konec řetězce nevejde do obdélníku, zkrátí se a přidají se tři tečky. Pokud slovo, které není na konci řetězce, přesahuje limity obdélníku, je zkrácen bez tří teček. Použití tohoto stylu vynutí, aby text ovládacího prvku byl na jednom řádku bez zalamování slov. Porovnejte SS_PATHELLIPSIS aSS_WORDELLIPSIS.
SS_ENHMETAFILE	Rozšířený metasoubor se zobrazí ve statickém ovládacím prvku. Text je název metasouboru. Statický ovládací prvek rozšířeného metasouboru má pevnou velikost; metasoubor se škáluje tak, aby odpovídal klientské oblasti statického ovládacího prvku.
SS_ETCHEDFRAME	Nakreslí rámeček statického ovládacího prvku pomocí stylu EDGE_ETCHED hrany. Další informace naleznete v DrawEdge funkce.
SS_ETCHEDHORZ	Nakreslí horní a dolní okraje statického ovládacího prvku pomocí stylu EDGE_ETCHED hrany. Další informace naleznete v DrawEdge funkce.
SS_ETCHEDVERT	Nakreslí levý a pravý okraj statického ovládacího prvku pomocí stylu EDGE_ETCHED hrany. Další informace naleznete v DrawEdge funkce.
SS_GRAYFRAME	Pole s rámečkem nakresleným se stejnou barvou jako pozadí obrazovky (plocha). Tato barva je ve výchozím barevném schématu šedá.
SS_GRAYRECT	Obdélník vyplněný aktuální barvou pozadí obrazovky Tato barva je ve výchozím barevném schématu šedá.
SS_ICON	Ikona, která se má zobrazit v dialogovém okně Pokud je ovládací prvek vytvořen jako součást dialogového okna, text je název ikony (nikoli názvu souboru) definovaný jinde v souboru prostředků. Pokud je ovládací prvek vytvořen prostřednictvím CreateWindow nebo související funkce, text je název ikony (nikoli název souboru) definovaný v souboru prostředku přidruženém k modulu určenému parametrem hInstancecreateWindow. Ikona může být animovaný kurzor. Styl ignoruje parametry CreateWindownWidth a nHeight; ovládací prvek se automaticky přizpůsobí ikoně. Při použití funkce LoadIcon může styl SS_ICON načíst pouze ikony dimenzí SM_CXICON a SM_CYICON. Toto omezení je možné obejít pomocí stylu SS_REALSIZEIMAGE kromě SS_ICON. Pokud nelze načíst ikonu prostřednictvím LoadIconu, pokusí se načíst zadaný prostředek jako kurzor pomocí LoadCursoru. Pokud se to také nezdaří, provede se pokus o načtení z ovladače zařízení pomocí LoadImage.
SS_LEFT	Jednoduchý obdélník a text v obdélníku zarovná doleva. Text je naformátovaný před zobrazením. Slova, která přesahují konec řádku, se automaticky zalomí na začátek dalšího řádku zarovnaného doleva. Slova, která jsou delší než šířka ovládacího prvku, jsou zkrácena.
SS_LEFTNOWORDWRAP	Jednoduchý obdélník a text v obdélníku zarovná doleva. Tabulátory jsou rozbalené, ale slova nejsou zabalená. Text, který přesahuje konec řádku, se ořízne.
SS_NOPREFIX	Zabraňuje interpretaci libovolných znaků ampersandu (&) v textu ovládacího prvku jako předpony akcelerátoru. Zobrazí se s odebraným ampersandem a dalším znakem v podtrženém řetězci. Tento styl statického ovládacího prvku může být součástí některého z definovaných statických ovládacích prvků. SS_NOPREFIX můžete kombinovat s jinými styly. To může být užitečné, když názvy souborů nebo jiné řetězce, které mohou obsahovat ampersand (&) musí být zobrazeny ve statickém ovládacím prvku v dialogovém okně.
SS_NOTIFY	Odešle nadřazené okno STN_CLICKED, STN_DBLCLK, STN_DISABLE a STN_ENABLE kódy oznámení, když uživatel klikne nebo poklikne na ovládací prvek.
SS_OWNERDRAW	Vlastník statického ovládacího prvku zodpovídá za vykreslení ovládacího prvku. Okno vlastníka obdrží WM_DRAWITEM zprávu pokaždé, když je potřeba ovládací prvek nakreslit.
SS_PATHELLIPSIS	Nahradí znaky uprostřed řetězce třemi tečkami, aby se výsledek vešl do zadaného obdélníku. Pokud řetězec obsahuje znaky zpětného lomítka (\), SS_PATHELLIPSIS zachová co nejvíce textu za posledním zpětným lomítkem. Použití tohoto stylu vynutí, aby text ovládacího prvku byl na jednom řádku bez zalamování slov. Porovnejte SS_ENDELLIPSIS aSS_WORDELLIPSIS.
SS_REALSIZECONTROL	Upraví rastrový obrázek tak, aby odpovídal velikosti statického ovládacího prvku. Změna národního prostředí může například změnit systémové písmo, a proto se můžou změnit velikost ovládacích prvků. Pokud má statický ovládací prvek rastrový obrázek, rastrový obrázek se už nevejde do ovládacího prvku. Tento bit stylu určuje automatické opakování rastrových obrázků tak, aby vyhovovalo jejich ovládacím prvkům. Pokud je zadán SS_CENTERIMAGE , rastrový obrázek nebo ikona se zacentruje (a v případě potřeby ořízne). Pokud není zadaný SS_CENTERIMAGE , rastrový obrázek nebo ikona se roztáhne nebo zvětší. Všimněte si, že redimenze ve dvou osách jsou nezávislé a výsledek může mít změněný poměr stran. Porovnejte s SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE	Určuje, že se použije skutečná šířka prostředku a ikona se načte pomocí LoadImage. SS_REALSIZEIMAGE se vždy používá ve spojení s SS_ICON. SS_REALSIZEIMAGE používá LoadImage, přepíše proces normálně následovaný SS_ICON. Nenačítá kurzory; Pokud loadImage selže, neprovedou se žádné další pokusy o načtení. Používá skutečnou šířku prostředku. Statický ovládací prvek se odpovídajícím způsobem změní, ale ikona zůstane zarovnaná k původně zadaným levým a horním okrajům ovládacího prvku. Všimněte si, že pokud je zadána také SS_CENTERIMAGE , ikona se zacentruje do prostoru ovládacího prvku, který byl zadán pomocí parametrů CreateWindownWidth a nHeight. Porovnejte SS_REALSIZECONTROL.
SS_RIGHT	Jednoduchý obdélník a zarovná text do obdélníku doprava. Text je naformátovaný před zobrazením. Slova, která přesahují konec řádku, se automaticky zalomí na začátek dalšího řádku zarovnaného doprava. Slova, která jsou delší než šířka ovládacího prvku, jsou zkrácena.
SS_RIGHTJUST	Pravý dolní roh statického ovládacího prvku se stylem SS_BITMAP nebo SS_ICON zůstane při změně velikosti ovládacího prvku pevný. Pouze horní a levé strany jsou upraveny tak, aby vyhovovaly novému rastru nebo ikoně.
SS_SIMPLE	Jednoduchý obdélník a zobrazí jeden řádek textu zarovnaného doleva v obdélníku. Řádek textu nelze žádným způsobem zkrátit ani změnit. Pokud je ovládací prvek také zakázaný, ovládací prvek nezůsedá jeho text.
SS_SUNKEN	Nakreslí kolem statického ovládacího prvku půlkládku ohraničení.
SS_TYPEMASK	Složený bit stylu, který je výsledkem použití operátoru OR u bitů stylu SS_*. Lze použít k maskování platných SS_* bitů z dané masky bitů. Mějte na paměti, že je zastaralý a neobsahuje správně všechny platné styly. Proto byste tento styl neměli používat.
SS_WHITEFRAME	Pole s rámečkem nakresleným se stejnou barvou jako pozadí okna. Tato barva je bílá ve výchozím barevném schématu.
SS_WHITERECT	Obdélník vyplněný aktuální barvou pozadí okna Tato barva je bílá ve výchozím barevném schématu.
SS_WORDELLIPSIS	Zkrátí všechna slova, která se nevejdou do obdélníku, a přidá tři tečky. Použití tohoto stylu vynutí, aby text ovládacího prvku byl na jednom řádku bez zalamování slov. Porovnejte SS_ENDELLIPSIS aSS_PATHELLIPSIS.

Poznámky

Chcete-li použít styl, který zkracuje slova nebo řetězce se třemi tečkami pro víceřádkový text, lze DrawThemeText nebo DrawText použít u ovládacího prvku owner-draw s formátovacími příznaky DT_WORDBREAK a DT_ENDELLIPSIS sadu.

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows Vista [pouze desktopové aplikace]
Minimální podporovaný server	Windows Server 2003 [pouze desktopové aplikace]
Záhlaví	Winuser.h (včetně Windows.h)