Udostępnij przez


Style statycznej kontrolki

Aby utworzyć kontrolkę statyczną przy użyciu funkcji CreateWindow lub CreateWindowEx , określ klasę STATIC, odpowiednie stałe stylu okna i kombinację następujących stylów statycznych kontrolek.

Stały Opis
SS_BITMAP
Mapa bitowa ma być wyświetlana w kontrolce statycznej. Tekst jest nazwą mapy bitowej (nie nazwy pliku) zdefiniowanej w innym miejscu w pliku zasobu. Styl ignoruje parametry nWidth i nHeight ; kontrolka automatycznie rozmiaruje się, aby pomieścić mapę bitową.
SS_BLACKFRAME
Pole z ramką rysowaną w tym samym kolorze co ramy okienne. Ten kolor jest w domyślnym schemacie kolorów.
SS_BLACKRECT
Prostokąt wypełniony bieżącym kolorem ramki okna. Ten kolor jest w domyślnym schemacie kolorów.
SS_CENTER
Prosty prostokąt i wyśrodkuje tekst w prostokątze. Tekst jest sformatowany przed jego wyświetleniem. Wyrazy, które rozciągają się obok końca wiersza, są automatycznie opakowane na początku następnego wyśrodkowanego wiersza. Wyrazy dłuższe niż szerokość kontrolki są obcinane.
SS_CENTERIMAGE
Mapa bitowa jest wyśrodkowana w statycznej kontrolce zawierającej ją. Rozmiar kontrolki nie jest zmieniany, więc mapa bitowa dla kontrolki zostanie obcięta. Jeśli kontrolka statyczna zawiera pojedynczy wiersz tekstu, tekst jest wyśrodkowany w pionie w obszarze klienta kontrolki.
SS_EDITCONTROL
Kontrolka statyczna duplikuje charakterystykę wyświetlania tekstu kontrolki edycji wielowierszowej. W szczególności średnia szerokość znaku jest obliczana w taki sam sposób, jak w przypadku kontrolki edycji, a funkcja nie wyświetla częściowo widocznego ostatniego wiersza.
SS_ENDELLIPSIS
Jeśli koniec ciągu nie pasuje do prostokąta, zostanie obcięty i dodawany jest wielokropek. Jeśli słowo, które nie znajduje się na końcu ciągu wykracza poza granice prostokąta, jest obcinane bez wielokropka. Użycie tego stylu spowoduje, że tekst kontrolki będzie znajdować się w jednym wierszu bez zawijania wyrazów. Porównaj z SS_PATHELLIPSIS i SS_WORDELLIPSIS.
SS_ENHMETAFILE
Rozszerzony metaplik ma być wyświetlany w kontrolce statycznej. Tekst jest nazwą metapliku. Ulepszona kontrolka statyczna metapliku ma stały rozmiar; metaplik jest skalowany w celu dopasowania do obszaru klienta kontrolki statycznej.
SS_ETCHEDFRAME
Rysuje ramkę kontrolki statycznej przy użyciu stylu krawędzi EDGE_ETCHED . Aby uzyskać więcej informacji, zobacz funkcję DrawEdge .
SS_ETCHEDHORZ
Rysuje górne i dolne krawędzie kontrolki statycznej przy użyciu stylu krawędzi EDGE_ETCHED . Aby uzyskać więcej informacji, zobacz funkcję DrawEdge .
SS_ETCHEDVERT
Rysuje lewe i prawe krawędzie kontrolki statycznej przy użyciu stylu krawędzi EDGE_ETCHED . Aby uzyskać więcej informacji, zobacz funkcję DrawEdge .
SS_GRAYFRAME
Pole z ramką rysowaną z tym samym kolorem co tło ekranu (pulpit). Ten kolor jest szary w domyślnym schemacie kolorów.
SS_GRAYRECT
Prostokąt wypełniony bieżącym kolorem tła ekranu. Ten kolor jest szary w domyślnym schemacie kolorów.
SS_ICON
Ikona, która ma być wyświetlana w oknie dialogowym. Jeśli kontrolka jest tworzona w ramach okna dialogowego, tekst jest nazwą ikony (a nie nazwy pliku) zdefiniowanej gdzie indziej w pliku zasobu. Jeśli kontrolka jest tworzona za pomocą polecenia CreateWindow lub powiązanej funkcji, tekst jest nazwą ikony (a nie nazwy pliku) zdefiniowanej w pliku zasobów skojarzonym z modułem określonym przez parametr hInstance do polecenia CreateWindow.
Ikona może być animowanym kursorem.
Styl ignoruje parametry CreateWindownWidth i nHeight; kontrolka automatycznie rozmiaruje się, aby pomieścić ikonę. Ponieważ używa funkcji LoadIcon , styl SS_ICON może ładować tylko ikony wymiarów SM_CXICON i SM_CYICON. To ograniczenie można pominąć przy użyciu stylu SS_REALSIZEIMAGE oprócz SS_ICON.
Jeśli nie można załadować ikony za pośrednictwem modułu LoadIcon, podjęto próbę załadowania określonego zasobu jako kursora przy użyciu klasy LoadCursor. Jeśli to również zakończy się niepowodzeniem, zostanie podjęta próba załadowania ze sterownika urządzenia przy użyciu funkcji LoadImage.
SS_LEFT
Prosty prostokąt i lewy wyrównuje tekst w prostokątze. Tekst jest sformatowany przed jego wyświetleniem. Wyrazy, które rozciągają się obok końca wiersza, są automatycznie opakowane na początku następnego wyrównanego do lewej linii. Wyrazy dłuższe niż szerokość kontrolki są obcinane.
SS_LEFTNOWORDWRAP
Prosty prostokąt i lewy wyrównuje tekst w prostokątze. Karty są rozwinięte, ale wyrazy nie są opakowane. Tekst, który rozszerza koniec wiersza, jest obcięty.
SS_NOPREFIX
Zapobiega interpretowaniu wszystkich znaków i (&) w tekście kontrolki jako znaki prefiksu akceleratora. Są one wyświetlane z znakiem ampersand usuniętym i następnym znakiem w podkreśleniu ciągu. Ten statyczny styl kontrolki może być dołączony do dowolnych zdefiniowanych kontrolek statycznych. Możesz połączyć SS_NOPREFIX z innymi stylami. Może to być przydatne, gdy nazwy plików lub inne ciągi, które mogą zawierać ampersand (&) muszą być wyświetlane w statycznej kontrolce w oknie dialogowym.
SS_NOTIFY
Wysyła STN_CLICKED okna nadrzędnego, STN_DBLCLK, STN_DISABLE i STN_ENABLE kody powiadomień, gdy użytkownik kliknie lub kliknie dwukrotnie kontrolkę.
SS_OWNERDRAW
Właściciel kontrolki statycznej jest odpowiedzialny za rysowanie kontrolki. Okno właściciela otrzymuje komunikat WM_DRAWITEM za każdym razem, gdy kontrolka musi zostać narysowana.
SS_PATHELLIPSIS
Zamienia znaki w środku ciągu wielokropkiem, tak aby wynik mieścił się w określonym prostokątze. Jeśli ciąg zawiera znaki ukośnika odwrotnego (\), SS_PATHELLIPSIS zachowuje jak najwięcej tekstu po ostatnim ukośniku odwrotnym. Użycie tego stylu spowoduje, że tekst kontrolki będzie znajdować się w jednym wierszu bez zawijania wyrazów. Porównaj z SS_ENDELLIPSIS i SS_WORDELLIPSIS.
SS_REALSIZECONTROL
Dostosowuje mapę bitową tak, aby pasowała do rozmiaru kontrolki statycznej. Na przykład zmiana ustawień regionalnych może spowodować zmianę czcionki systemowej, a tym samym zmiany rozmiaru kontrolek. Jeśli kontrolka statyczna ma mapę bitową, mapa bitowa nie będzie już pasowała do kontrolki. Ten bit stylu nakazuje automatyczne redymensje map bitowych, aby dopasować ich kontrolki.
Jeśli określono SS_CENTERIMAGE , mapa bitowa lub ikona jest wyśrodkowana (i w razie potrzeby obcięta). Jeśli nie określono SS_CENTERIMAGE , mapa bitowa lub ikona jest rozciągnięta lub skurczona.
Należy pamiętać, że ponowne wprowadzenie dwóch osi jest niezależne, a wynik może mieć zmieniony współczynnik proporcji.
Porównaj z SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE
Określa, że jest używana rzeczywista szerokość zasobu, a ikona jest ładowana przy użyciu funkcji LoadImage. SS_REALSIZEIMAGE jest zawsze używany w połączeniu z SS_ICON.
SS_REALSIZEIMAGE używa funkcji LoadImage, przesłaniając proces zwykle obserwowany w SS_ICON. Nie ładuje kursorów; Jeśli polecenie LoadImage zakończy się niepowodzeniem, nie zostaną wykonane dalsze próby załadowania. Używa rzeczywistej szerokości zasobu. Rozmiar kontrolki statycznej jest odpowiednio zmieniany, ale ikona pozostaje wyrównana do pierwotnie określonych lewej i górnej krawędzi kontrolki.
Należy pamiętać, że jeśli SS_CENTERIMAGE jest również określona, ikona jest wyśrodkowana w przestrzeni kontrolki, która została określona przy użyciu parametrów CreateWindownWidth i nHeight.
Porównaj z SS_REALSIZECONTROL.
SS_RIGHT
Prosty prostokąt i wyrówna tekst w prawo w prostokątze. Tekst jest sformatowany przed jego wyświetleniem. Wyrazy, które rozszerzają koniec wiersza, są automatycznie opakowane na początku następnego wyrównanego do prawej linii. Wyrazy dłuższe niż szerokość kontrolki są obcinane.
SS_RIGHTJUST
Prawy dolny róg kontrolki statycznej z stylem SS_BITMAP lub SS_ICON jest stały po zmianie rozmiaru kontrolki. Tylko górna i lewa strona są dostosowywane, aby pomieścić nową mapę bitową lub ikonę.
SS_SIMPLE
Prosty prostokąt i wyświetla pojedynczy wiersz tekstu wyrównanego do lewego w prostokątze. Nie można skrócić ani zmienić wiersza tekstu w żaden sposób. Ponadto, jeśli kontrolka jest wyłączona, kontrolka nie będzie szarać tekstu.
SS_SUNKEN
Rysuje pół zatopione obramowanie wokół statycznej kontrolki.
SS_TYPEMASK
Bit stylu złożonego, który wynika z używania operatora OR na bitach stylu SS_*. Może służyć do maskowania prawidłowych SS_* bitów z danej maski bitów. Należy pamiętać, że jest to nieaktualne i nie zawiera poprawnie wszystkich prawidłowych stylów. W związku z tym nie należy używać tego stylu.
SS_WHITEFRAME
Pole z ramką rysowaną z tym samym kolorem co tło okna. Ten kolor jest biały w domyślnym schemacie kolorów.
SS_WHITERECT
Prostokąt wypełniony bieżącym kolorem tła okna. Ten kolor jest biały w domyślnym schemacie kolorów.
SS_WORDELLIPSIS
Obcina wszystkie wyrazy, które nie mieszczą się w prostokątze i dodaje wielokropek. Użycie tego stylu spowoduje, że tekst kontrolki będzie znajdować się w jednym wierszu bez zawijania wyrazów.
Porównanie z SS_ENDELLIPSIS i SS_PATHELLIPSIS.

Uwagi

Aby użyć stylu, który obcina wyrazy lub ciągi z wielokropkiem dla tekstu wielowierszowego, można użyć metody DrawThemeText lub DrawText w kontrolce rysowania właściciela z flagami formatowania DT_WORDBREAK i zestawem DT_ENDELLIPSIS .

Wymagania

Wymaganie Wartość
Minimalny obsługiwany klient
Windows Vista [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer
Windows Server 2003 [tylko aplikacje klasyczne]
Nagłówek
Winuser.h (uwzględnij windows.h)