Statische Steuerelementstile

Um ein statisches Steuerelement mithilfe der CreateWindow- oder CreateWindowEx-Funktion zu erstellen, geben Sie die STATIC-Klasse, die entsprechenden Fensterstilkonstanten und eine Kombination der folgenden statischen Steuerelementstile an.

Konstante BESCHREIBUNG
SS _ BITMAP
Eine Bitmap soll im statischen Steuerelement angezeigt werden. Der Text ist der Name einer Bitmap (kein Dateiname), die an anderer Stelle in der Ressourcendatei definiert ist. Der Stil ignoriert die Parameter nWidth und nHeight. die Größe des Steuerelements automatisch an die Bitmap angepasst wird.
SS _ BLACKFRAME
Ein Feld mit einem Rahmen, der in der gleichen Farbe wie die Fensterrahmen gezeichnet wird. Diese Farbe ist im Standardfarbschema schwarz.
SS _ BLACKRECT
Ein Rechteck, das mit der aktuellen Fensterrahmenfarbe gefüllt ist. Diese Farbe ist im Standardfarbschema schwarz.
SS _ CENTER
Ein einfaches Rechteck, das den Text im Rechteck zentrt. Der Text wird formatiert, bevor er angezeigt wird. Wörter, die sich über das Ende einer Zeile erstrecken, werden automatisch bis zum Anfang der nächsten zentrierten Zeile umschlossen. Wörter, die länger als die Breite des Steuerelements sind, werden abgeschnitten.
SS _ CENTERIMAGE
Eine Bitmap wird im statischen Steuerelement zentriert, das sie enthält. Die Größe des Steuerelements wird nicht geändert, sodass eine Bitmap, die für das Steuerelement zu groß ist, abgeschnitten wird. Wenn das statische Steuerelement eine einzelne Textzeile enthält, wird der Text vertikal im Clientbereich des Steuerelements zentriert.
SS _ EDITCONTROL
Das statische Steuerelement dupliziert die Textanzeigemerkmale eines mehrzeiligen Bearbeitungssteuerelements. Insbesondere wird die durchschnittliche Zeichenbreite auf die gleiche Weise wie bei einem Bearbeitungssteuerelement berechnet, und die Funktion zeigt keine teilweise sichtbare letzte Zeile an.
SS _ ENDELLIPSIS
Wenn das Ende einer Zeichenfolge nicht in das Rechteck passt, wird es abgeschnitten, und Ellipsen werden hinzugefügt. Wenn ein Wort, das sich nicht am Ende der Zeichenfolge befindet, die Grenzen des Rechtecks übersteigt, wird es ohne Ellipsen abgeschnitten. Wenn Sie diesen Stil verwenden, wird der Text des Steuerelements in einer Zeile ohne Zeilenumbruch angezeigt. Vergleichen Sie mit SS _ PATHELLIPSIS und SS _ WORDELLIPSIS.
SS _ ENHMETAFILE
Eine erweiterte Metadatei wird im statischen Steuerelement angezeigt. Der Text ist der Name einer Metadatei. Ein erweitertes statisches Metafile-Steuerelement hat eine feste Größe. Die Metadatei wird so skaliert, dass sie dem Clientbereich des statischen Steuerelements entspricht.
SS _ ETCHEDFRAME
Zeichnet den Rahmen des statischen Steuerelements mithilfe des EDGE ETCHED-Edgestils. _ Weitere Informationen finden Sie in der DrawEdge-Funktion.
SS _ ETCHEDHORZ
Zeichnet die oberen und unteren Ränder des statischen Steuerelements mithilfe des EDGE ETCHED-Edgestils. _ Weitere Informationen finden Sie in der DrawEdge-Funktion.
SS _ ETCHEDVERT
Zeichnet die linken und rechten Ränder des statischen Steuerelements mithilfe des EDGE ETCHED-Edgestils. _ Weitere Informationen finden Sie in der DrawEdge-Funktion.
SS _ GRAYFRAME
Ein Feld mit einem Rahmen, der mit der gleichen Farbe wie der Bildschirmhintergrund (Desktop) gezeichnet wird. Diese Farbe ist im Standardfarbschema grau.
SS _ GRAYRECT
Ein Rechteck, das mit der aktuellen Hintergrundfarbe des Bildschirms gefüllt ist. Diese Farbe ist im Standardfarbschema grau.
_SS-SYMBOL
Ein Symbol, das im Dialogfeld angezeigt werden soll. Wenn das Steuerelement als Teil eines Dialogfelds erstellt wird, ist der Text der Name eines Symbols (kein Dateiname), das an anderer Stelle in der Ressourcendatei definiert ist. Wenn das Steuerelement über CreateWindow oder eine verwandte Funktion erstellt wird, ist der Text der Name eines Symbols (nicht eines Dateinamens), der in der Ressourcendatei definiert ist, die dem modul zugeordnet ist, das durch den hInstance-Parameter für CreateWindow angegeben wird.
Das Symbol kann ein animierter Cursor sein.
Der Stil ignoriert die CreateWindow-Parameter nWidth und nHeight; die Größe des Steuerelements automatisch an das Symbol angepasst wird. Da die LoadIcon-Funktion verwendet wird, kann der SS _ ICON-Stil nur Symbole der Dimensionen SM _ CXICON und SM _ CYICON laden. Diese Einschränkung kann umgangen werden, indem zusätzlich zum _ SS-SYMBOL der SS _ REALSIZEIMAGE-Stil verwendet wird.
Wenn ein Symbol nicht über LoadIcongeladen werden kann, wird versucht, die angegebene Ressource mithilfe von LoadCursorals Cursor zu laden. Wenn auch dies fehlschlägt, wird versucht, mit LoadImageaus dem Gerätetreiber zu laden.
SS _ LEFT
Ein einfaches Rechteck, das den Text im Rechteck links ausrichtet. Der Text wird formatiert, bevor er angezeigt wird. Wörter, die über das Ende einer Zeile hinaus reichen, werden automatisch bis zum Anfang der nächsten linksbündig ausgerichteten Zeile umschlossen. Wörter, die länger als die Breite des Steuerelements sind, werden abgeschnitten.
SS _ LEFTNOWORDWRAP
Ein einfaches Rechteck, das den Text im Rechteck links ausrichtet. Registerkarten werden erweitert, Aber Wörter werden nicht umschlossen. Text, der sich über das Ende einer Zeile erstreckt, wird abgeschnitten.
SS _ NOPREFIX
Verhindert die Interpretation von Ampersandzeichen (&) im Text des Steuerelements als Zugriffstastenpräfixzeichen. Diese werden angezeigt, wobei das Ampersand entfernt und das nächste Zeichen in der Zeichenfolge unterstrichen wird. Dieser statische Steuerelementstil kann in jedem der definierten statischen Steuerelemente enthalten sein. Sie können SS _ NOPREFIX mit anderen Stilen kombinieren. Dies kann nützlich sein, wenn Dateinamen oder andere Zeichenfolgen, die möglicherweise ein ampersand (&) enthalten, in einem statischen Steuerelement in einem Dialogfeld angezeigt werden müssen.
SS _ NOTIFY
Sendet die Benachrichtigungscodes STN _ CLICKED, STN _ DBLCLK, STN _ DISABLEund STN _ ENABLE, wenn der Benutzer auf das Steuerelement klickt oder doppelklickt.
SS _ OWNERDRAW
Der Besitzer des statischen Steuerelements ist für das Zeichnen des Steuerelements verantwortlich. Das Besitzerfenster empfängt immer dann eine WM _ DRAWITEM-Meldung, wenn das Steuerelement gezeichnet werden muss.
SS _ PATHELLIPSIS
Ersetzt Zeichen in der Mitte der Zeichenfolge durch Ellipsen, sodass das Ergebnis in das angegebene Rechteck passt. Wenn die Zeichenfolge umgekehrte Schrägstriche \ () enthält, behält SS _ PATHELLIPSIS den Text nach dem letzten umgekehrten Schrägstrich so weit wie möglich bei. Wenn Sie diesen Stil verwenden, wird der Text des Steuerelements in einer Zeile ohne Zeilenumbruch angezeigt. Vergleichen Sie mit SS _ ENDELLIPSIS und SS _ WORDELLIPSIS.
SS _ REALSIZECONTROL
Passt die Bitmap an die Größe des statischen Steuerelements an. Beispielsweise kann das Ändern des Gebietsschemas die Systemschriftart ändern, und daher kann die Größe der Steuerelemente geändert werden. Wenn ein statisches Steuerelement eine Bitmap hätte, würde die Bitmap nicht mehr zum Steuerelement passen. Dieses Stilbit bestimmt die automatische Neudimensionierung von Bitmaps, damit sie ihren Steuerelementen entsprechen.
Wenn SS _ CENTERIMAGE angegeben ist, wird die Bitmap oder das Symbol zentriert (und bei Bedarf abgeschnitten). Wenn SS _ CENTERIMAGE nicht angegeben ist, wird die Bitmap oder das Symbol gestreckt oder verknumpft.
Beachten Sie, dass die Neudimensionierung in den beiden Achsen unabhängig ist und das Ergebnis ein geändertes Seitenverhältnis aufweisen kann.
Vergleichen Sie mit SS _ REALSIZEIMAGE.
SS _ REALSIZEIMAGE
Gibt an, dass die tatsächliche Ressourcenbreite verwendet wird und das Symbol mit LoadImagegeladen wird. SS _ REALSIZEIMAGE wird immer in Verbindung mit dem _ SS-SYMBOL verwendet.
SS _ REALSIZEIMAGE verwendet LoadImageund überschreibt den Prozess, der normalerweise unter dem _ SS-SYMBOL folgt. Es werden keine Cursor geladen. Wenn LoadImage fehlschlägt, werden keine weiteren Ladeversuche unternommen. Dabei wird die tatsächliche Ressourcenbreite verwendet. Die Größe des statischen Steuerelements wird entsprechend angepasst, aber das Symbol bleibt am ursprünglich angegebenen linken und oberen Rand des Steuerelements ausgerichtet.
Beachten Sie, dass, wenn SS _ CENTERIMAGE ebenfalls angegeben wird, das Symbol im Bereich des Steuerelements zentriert ist, der mithilfe der CreateWindow-Parameter nWidth und nHeight angegeben wurde.
Vergleichen Sie mit SS _ REALSIZECONTROL.
SS _ RIGHT
Ein einfaches Rechteck und richtet den Text im Rechteck rechts aus. Der Text wird formatiert, bevor er angezeigt wird. Wörter, die sich über das Ende einer Zeile erstrecken, werden automatisch bis zum Anfang der nächsten rechtsbündig ausgerichteten Zeile umschlossen. Wörter, die länger als die Breite des Steuerelements sind, werden abgeschnitten.
SS _ RIGHTJUST
Die untere rechte Ecke eines statischen Steuerelements mit dem Stil SS BITMAP oder SS ICON muss beim Ändern der Größe des _ _ Steuerelements fixiert bleiben. Nur die obere und linke Seite werden angepasst, um eine neue Bitmap oder ein neues Symbol aufnehmen zu können.
SS _ SIMPLE
Ein einfaches Rechteck und zeigt eine einzelne Zeile mit linksbündig ausgerichteten Text im Rechteck an. Die Textzeile kann nicht verkürzt oder in irgendeiner Weise geändert werden. Wenn das Steuerelement deaktiviert ist, wird der Text des Steuerelements ebenfalls nicht abgeblendet.
SS _ SUNKEN
Zeichnet einen halb versenkten Rahmen um ein statisches Steuerelement.
SS _ TYPEMASK
Ein zusammengesetztes Stilbit, das sich aus der Verwendung des OR-Operators für SS-Stilbits _ * ergibt. Kann verwendet werden, um gültige SS-Bits _ * aus einer bestimmten Bitmaske zu maskieren. Beachten Sie, dass dies veraltet ist und nicht alle gültigen Stile enthält. Daher sollten Sie diesen Stil nicht verwenden.
_SS-WHITEFRAME
Ein Feld mit einem Rahmen, der mit der gleichen Farbe wie der Fensterhintergrund gezeichnet wird. Diese Farbe ist im Standardfarbschema weiß.
SS _ WHITERECT
Ein Rechteck, das mit der aktuellen Hintergrundfarbe des Fensters gefüllt ist. Diese Farbe ist im Standardfarbschema weiß.
SS _ WORDELLIPSIS
Schneidt alle Wörter ab, die nicht in das Rechteck passen, und fügt Ellipsen hinzu. Wenn Sie diesen Stil verwenden, wird der Text des Steuerelements in einer Zeile ohne Zeilenumbruch erzwingen.
Vergleichen Sie mit SS _ ENDELLIPSIS und SS _ PATHELLIPSIS.

Bemerkungen

Um ein Format zu verwenden, das Wörter oder Zeichenfolgen mit Auslassungszeichen für mehrzeiligen Text abschneiden, können DrawThemeText oder DrawText auf einem Owner-Draw-Steuerelement mit den Formatierungsflags DT _ WORDBREAK und DT _ ENDELLIPSIS verwendet werden.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)