Dela via


Statiska kontrollformat

Om du vill skapa en statisk kontroll med funktionen CreateWindow eller CreateWindowEx anger du static-klassen, lämpliga konstanter i fönsterformat och en kombination av följande statiska kontrollformat.

Konstant Beskrivning
SS_BITMAP
En bitmapp ska visas i den statiska kontrollen. Texten är namnet på en bitmapp (inte ett filnamn) som definierats någon annanstans i resursfilen. Formatet ignorerar parametrarna nWidth och nHeight . kontrollen automatiskt storleksanpassar sig för att hantera bitmappen.
SS_BLACKFRAME
En ruta med en ram ritad i samma färg som fönsterrutorna. Den här färgen är svart i standardfärgschemat.
SS_BLACKRECT
En rektangel fylld med den aktuella fönsterrutefärgen. Den här färgen är svart i standardfärgschemat.
SS_CENTER
En enkel rektangel och centrerar texten i rektangeln. Texten formateras innan den visas. Ord som sträcker sig förbi slutet av en rad omsluts automatiskt till början av nästa centrerad rad. Ord som är längre än kontrollens bredd trunkeras.
SS_CENTERIMAGE
En bitmapp är centrerad i den statiska kontroll som innehåller den. Kontrollen har inte storleksanpassats, så att en bitmapp för stor för kontrollen klipps bort. Om den statiska kontrollen innehåller en enda textrad centreras texten lodrätt i kontrollens klientområde.
SS_EDITCONTROL
Den statiska kontrollen duplicerar textvisningsegenskaperna för en redigeringskontroll med flera rader. Mer specifikt beräknas den genomsnittliga teckenbredden på samma sätt som med en redigeringskontroll, och funktionen visar inte en delvis synlig sista rad.
SS_ENDELLIPSIS
Om slutet av en sträng inte passar i rektangeln trunkeras den och ellipserna läggs till. Om ett ord som inte finns i slutet av strängen överskrider gränserna för rektangeln trunkeras det utan ellipser. Om du använder det här formatet tvingas kontrollens text att finnas på en rad utan radbrytning. Jämför med SS_PATHELLIPSIS och SS_WORDELLIPSIS.
SS_ENHMETAFILE
En förbättrad metafil ska visas i den statiska kontrollen. Texten är namnet på en metafil. En förbättrad statisk metafilkontroll har en fast storlek. metafilen skalas för att passa den statiska kontrollens klientområde.
SS_ETCHEDFRAME
Ritar ramen för den statiska kontrollen med hjälp av EDGE_ETCHED kantformat. Mer information finns i funktionen DrawEdge .
SS_ETCHEDHORZ
Ritar den statiska kontrollens övre och nedre kanter med hjälp av EDGE_ETCHED kantformat. Mer information finns i funktionen DrawEdge .
SS_ETCHEDVERT
Ritar den statiska kontrollens vänster- och högerkant med hjälp av EDGE_ETCHED kantformat. Mer information finns i funktionen DrawEdge .
SS_GRAYFRAME
En ruta med en ram ritad med samma färg som skärmbakgrunden (skrivbordet). Den här färgen är grå i standardfärgschemat.
SS_GRAYRECT
En rektangel fylld med den aktuella skärmbakgrundsfärgen. Den här färgen är grå i standardfärgschemat.
SS_ICON
En ikon som ska visas i dialogrutan. Om kontrollen skapas som en del av en dialogruta är texten namnet på en ikon (inte ett filnamn) som definierats någon annanstans i resursfilen. Om kontrollen skapas via CreateWindow eller en relaterad funktion är texten namnet på en ikon (inte ett filnamn) som definierats i resursfilen som är associerad med modulen som anges av parametern hInstance till CreateWindow.
Ikonen kan vara en animerad markör.
Formatet ignorerar CreateWindow-parametrarnanWidth och nHeight. kontrollen automatiskt storleksanpassar sig för att rymma ikonen. Eftersom den använder loadicon-funktionen kan SS_ICON format bara läsa in ikoner för dimensioner SM_CXICON och SM_CYICON. Den här begränsningen kan kringgås med hjälp av SS_REALSIZEIMAGE formatmall utöver SS_ICON.
Om det inte går att läsa in en ikon via LoadIcon görs ett försök att läsa in den angivna resursen som en markör med LoadCursor. Om det också misslyckas görs ett försök att läsa in från enhetsdrivrutinen med hjälp av LoadImage.
SS_LEFT
En enkel rektangel och vänsterjusterar texten i rektangeln. Texten formateras innan den visas. Ord som sträcker sig förbi slutet av en rad omsluts automatiskt till början av nästa vänsterjusterade linje. Ord som är längre än kontrollens bredd trunkeras.
SS_LEFTNOWORDWRAP
En enkel rektangel och vänsterjusterar texten i rektangeln. Flikar expanderas, men ord är inte omslutna. Text som sträcker sig förbi slutet av en rad klipps.
SS_NOPREFIX
Förhindrar tolkning av alla tecken (&) i kontrollens text som acceleratorprefixtecken. Dessa visas med et-tecknet borttaget och nästa tecken i strängen understruket. Den här statiska kontrollstilen kan ingå i någon av de definierade statiska kontrollerna. Du kan kombinera SS_NOPREFIX med andra formatmallar. Detta kan vara användbart när filnamn eller andra strängar som kan innehålla ett et-tecken (&) måste visas i en statisk kontroll i en dialogruta.
SS_NOTIFY
Skickar det överordnade fönstret STN_CLICKED, STN_DBLCLK, STN_DISABLE och STN_ENABLE meddelandekoder när användaren klickar eller dubbelklickar på kontrollen.
SS_OWNERDRAW
Ägaren till den statiska kontrollen ansvarar för att rita kontrollen. Ägarfönstret tar emot ett WM_DRAWITEM meddelande när kontrollen behöver ritas.
SS_PATHELLIPSIS
Ersätter tecken i mitten av strängen med ellipser så att resultatet passar i den angivna rektangeln. Om strängen innehåller omvänt snedstreck (\) tecken bevarar SS_PATHELLIPSIS så mycket som möjligt av texten efter det senaste omvänt snedstrecket. Om du använder det här formatet tvingas kontrollens text att finnas på en rad utan radbrytning. Jämför med SS_ENDELLIPSIS och SS_WORDELLIPSIS.
SS_REALSIZECONTROL
Justerar bitmappen så att den passar storleken på den statiska kontrollen. Om du till exempel ändrar språkvarianten kan du ändra systemteckensnittet och därmed kan kontroller ändras. Om en statisk kontroll hade en bitmapp skulle bitmappen inte längre passa kontrollen. Den här formatbiten dikterar automatisk omdimensionering av bitmappar för att passa deras kontroller.
Om SS_CENTERIMAGE anges centreras bitmappen eller ikonen (och klipps om det behövs). Om SS_CENTERIMAGE inte anges sträcks bitmappen eller ikonen ut eller krymps.
Observera att omdimensioneringen i de två axlarna är oberoende och att resultatet kan ha ett ändrat proportioner.
Jämför med SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE
Anger att den faktiska resursbredden används och att ikonen läses in med LoadImage. SS_REALSIZEIMAGE används alltid tillsammans med SS_ICON.
SS_REALSIZEIMAGE använder LoadImage och åsidosättar den process som normalt följs under SS_ICON. Den läser inte in markörer. Om LoadImage misslyckas görs inga ytterligare försök att läsa in. Den använder den faktiska resursbredden. Den statiska kontrollen ändras i enlighet med detta, men ikonen förblir justerad till kontrollens ursprungligen angivna vänstra och övre kanter.
Observera att om SS_CENTERIMAGE också anges centreras ikonen inom kontrollens utrymme, som angavs med hjälp av CreateWindow-parametrarnanWidth och nHeight.
Jämför med SS_REALSIZECONTROL.
SS_RIGHT
En enkel rektangel och högerjusterar texten i rektangeln. Texten formateras innan den visas. Ord som sträcker sig förbi slutet av en rad omsluts automatiskt till början av nästa högerjusterade linje. Ord som är längre än kontrollens bredd trunkeras.
SS_RIGHTJUST
Det nedre högra hörnet i en statisk kontroll med SS_BITMAP eller SS_ICON formatmall ska förbli fast när kontrollen ändras. Endast de övre och vänstra sidorna justeras för att rymma en ny bitmapp eller ikon.
SS_SIMPLE
En enkel rektangel och visar en enda rad med vänsterjusterad text i rektangeln. Textraden kan inte förkortas eller ändras på något sätt. Om kontrollen är inaktiverad gråmarkeras inte kontrollens text.
SS_SUNKEN
Ritar en halvsjunken kantlinje runt en statisk kontroll.
SS_TYPEMASK
En sammansatt formatbit som resulterar från att använda OR-operatorn på SS_* formatbitar. Kan användas för att maskera giltiga SS_* bitar från en viss bitmask. Observera att detta är inaktuellt och inte innehåller alla giltiga formatmallar korrekt. Därför bör du inte använda det här formatet.
SS_WHITEFRAME
En ruta med en ram ritad med samma färg som fönstrets bakgrund. Den här färgen är vit i standardfärgschemat.
SS_WHITERECT
En rektangel fylld med aktuell bakgrundsfärg för fönstret. Den här färgen är vit i standardfärgschemat.
SS_WORDELLIPSIS
Trunkerar alla ord som inte passar i rektangeln och lägger till ellipser. Om du använder det här formatet tvingas kontrollens text att finnas på en rad utan radbrytning.
Jämför med SS_ENDELLIPSIS och SS_PATHELLIPSIS.

Anmärkningar

Om du vill använda ett format som trunkerar ord eller strängar med en ellips för flerradstext kan DrawThemeText eller DrawText användas på en ägardragningskontroll med formateringsflaggor DT_WORDBREAK och DT_ENDELLIPSIS angivna.

Kravspecifikation

Krav Värde
Lägsta klient som stöds
Windows Vista [endast skrivbordsappar]
Lägsta server som stöds
Windows Server 2003 [endast skrivbordsappar]
Rubrik
Winuser.h (inkludera Windows.h)