Freigeben über


Statische Steuerelementstile

Um ein statisches Steuerelement mit der CreateWindow - oder CreateWindowEx-Funktion zu erstellen, geben Sie die STATIC-Klasse, die entsprechenden Fensterstilkonstanten und eine Kombination aus den folgenden statischen Steuerelementstilen 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. Die Formatvorlage ignoriert die Parameter nWidth und nHeight . das -Steuerelement wird automatisch so groß, dass es die Bitmap aufnehmen kann.
SS_BLACKFRAME
Ein Feld mit einem Rahmen, der in der gleichen Farbe wie die Fensterrahmen gezeichnet wurde. 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 und zentriert den Text im Rechteck. Der Text wird formatiert, bevor er angezeigt wird. Wörter, die sich über das Ende einer Zeile erstrecken, werden automatisch an den 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 in dem 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 Textanzeigeeigenschaften eines mehrlineigen 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 Auslassungspunkte werden hinzugefügt. Wenn ein Wort, das sich nicht am Ende der Zeichenfolge befindet, die Grenzen des Rechtecks überschreitet, wird es ohne Auslassungspunkte abgeschnitten. Wenn Sie diese Formatvorlage verwenden, wird erzwungen, dass sich der Text des Steuerelements in einer Zeile ohne Zeilenumbruch befindet. Vergleichen Sie mit SS_PATHELLIPSIS und SS_WORDELLIPSIS.
SS_ENHMETAFILE
Eine erweiterte Metadatei soll im statischen Steuerelement angezeigt werden. Der Text ist der Name einer Metadatei. Ein erweitertes statisches Metafile-Steuerelement hat eine feste Größe. Die Metadatei wird entsprechend dem Clientbereich des statischen Steuerelements skaliert.
SS_ETCHEDFRAME
Zeichnet den Rahmen des statischen Steuerelements mithilfe des EDGE_ETCHED Kantenformats. Weitere Informationen finden Sie unter der DrawEdge-Funktion .
SS_ETCHEDHORZ
Zeichnet den oberen und unteren Rand des statischen Steuerelements unter Verwendung des EDGE_ETCHED Kantenformats. Weitere Informationen finden Sie unter der DrawEdge-Funktion .
SS_ETCHEDVERT
Zeichnet den linken und rechten Rand des statischen Steuerelements unter Verwendung des EDGE_ETCHED-Kantenformats. Weitere Informationen finden Sie unter der DrawEdge-Funktion .
SS_GRAYFRAME
Ein Feld mit einem Rahmen, der mit der gleichen Farbe wie der Bildschirmhintergrund (Desktop) gezeichnet wurde. 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_ICON
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 zugehörige Funktion erstellt wird, ist der Text der Name eines Symbols (kein Dateiname), das 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.
Die Formatvorlage ignoriert die CreateWindow-ParameternWidth und nHeight. das -Steuerelement wird automatisch an das Symbol angepasst. Da die LoadIcon-Funktion verwendet wird, kann die SS_ICON-Formatvorlage nur Symbole von Dimensionen SM_CXICON und SM_CYICON laden. Diese Einschränkung kann umgangen werden, indem zusätzlich zum SS_ICON der StilSS_REALSIZEIMAGE verwendet wird.
Wenn ein Symbol nicht über LoadIcon geladen werden kann, wird versucht, die angegebene Ressource mithilfe von LoadCursor als Cursor zu laden. Wenn auch dies fehlschlägt, wird versucht, mithilfe von LoadImage vom Gerätetreiber zu laden.
SS_LEFT
Ein einfaches Rechteck und richtet den Text im Rechteck links aus. Der Text wird formatiert, bevor er angezeigt wird. Wörter, die sich über das Ende einer Zeile erstrecken, werden automatisch an den Anfang der nächsten linksbündigen Zeile umschlossen. Wörter, die länger als die Breite des Steuerelements sind, werden abgeschnitten.
SS_LEFTNOWORDWRAP
Ein einfaches Rechteck und richtet den Text im Rechteck links aus. Registerkarten werden erweitert, wörter werden jedoch nicht umschlossen. Text, der sich über das Ende einer Zeile erstreckt, wird abgeschnitten.
SS_NOPREFIX
Verhindert die Interpretation von Amper- und Zeichen (&) im Text des Steuerelements als Präfixzeichen. Diese werden angezeigt, wobei das amper und entfernte 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 hilfreich sein, wenn Dateinamen oder andere Zeichenfolgen, die ein amper und (&) enthalten können, in einem statischen Steuerelement in einem Dialogfeld angezeigt werden müssen.
SS_NOTIFY
Sendet das übergeordnete Fenster STN_CLICKED, STN_DBLCLK, STN_DISABLE und STN_ENABLE Benachrichtigungscodes, wenn der Benutzer auf das Steuerelement klickt oder doppelklicken.
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 Auslassungspunkte, 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 diese Formatvorlage verwenden, wird erzwungen, dass sich der Text des Steuerelements in einer Zeile ohne Zeilenumbruch befindet. 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, sodass die Größe von Steuerelementen möglicherweise geändert wird. Wenn ein statisches Steuerelement über eine Bitmap verfügt, würde die Bitmap nicht mehr in das Steuerelement passen. Dieses Formatvorlagenbit schreibt die automatische Neudimensionierung von Bitmaps vor, die an ihre Steuerelemente angepasst werden.
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 verkleinert.
Beachten Sie, dass die Neudimensionierung in den beiden Achsen unabhängig ist und das Ergebnis möglicherweise ein geändertes Seitenverhältnis aufweisen kann.
Vergleichen Sie mit SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE
Gibt an, dass die tatsächliche Ressourcenbreite verwendet und das Symbol mithilfe von LoadImage geladen wird. SS_REALSIZEIMAGE wird immer in Verbindung mit SS_ICON verwendet.
SS_REALSIZEIMAGE verwendet LoadImage und überschreibt den Prozess, der normalerweise unter SS_ICON ausgeführt wird. Cursor werden nicht geladen. Wenn LoadImage fehlschlägt, werden keine weiteren Ladeversuche durchgeführt. Dabei wird die tatsächliche Ressourcenbreite verwendet. Die Größe des statischen Steuerelements wird entsprechend geändert, aber das Symbol bleibt am ursprünglich angegebenen linken und oberen Rand des Steuerelements ausgerichtet.
Beachten Sie, dass, wenn auch SS_CENTERIMAGE angegeben wird, das Symbol innerhalb des Bereichs des Steuerelements zentriert wird, der mit den CreateWindow-ParameternnWidth 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 an den Anfang der nächsten rechtsbündigen 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 SS_BITMAP oder SS_ICON Stil soll beim Ändern der Größe des Steuerelements fest bleiben. Nur die obere und linke Seite werden angepasst, um eine neue Bitmap oder ein neues Symbol aufzunehmen.
SS_SIMPLE
Ein einfaches Rechteck und zeigt eine einzelne Textzeile mit linksbündigem Text im Rechteck an. Die Textzeile kann in keiner Weise gekürzt oder geändert werden. Wenn das Steuerelement deaktiviert ist, graut das Steuerelement seinen Text nicht.
SS_SUNKEN
Zeichnet einen halb versunkenen 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 Formatvorlagen ordnungsgemäß 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 wurde. 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
Schneidet jedes Wort ab, das nicht in das Rechteck passt, und fügt Auslassungspunkte hinzu. Wenn Sie diese Formatvorlage verwenden, wird erzwungen, dass sich der Text des Steuerelements in einer Zeile ohne Zeilenumbruch befindet.
Vergleichen Sie mit SS_ENDELLIPSIS und SS_PATHELLIPSIS.

Bemerkungen

Um eine Formatvorlage zu verwenden, die Wörter oder Zeichenfolgen mit einer Auslassungspunkte für mehrlinen Text abschneidet, können DrawThemeText oder DrawText für ein Besitzer-Zeichen-Steuerelement verwendet werden, wobei Formatierungsflags DT_WORDBREAK und DT_ENDELLIPSIS festgelegt sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Winuser.h (windows.h einschließen)