<Style>-Element

Aktualisiert: November 2007

Das <Style>-Element stellt die Style-Basisklasse dar und enthält Stileigenschaften, die allen ASP.NET Mobile-Steuerelementen gemein sind. Klassen, die von der Style-Klasse erben, enthalten spezifische zusätzliche Stileigenschaften für das jeweils zugeordnete Steuerelement. Das <Style>-Element strukturiert diese Stileigenschaften für ein mobiles Steuerelement.

Das <Style>-Element ist kein Steuerelement und erbt nicht von der Form-Klasse. Sie können ein <Style>-Element nur innerhalb eines StyleSheet-Steuerelements auf einer ASP.NET Mobile-Webseite verwenden.

Jedes mobile Steuerelement enthält intern ein Style-Objekt. Dieses Style-Objekt wird jedoch nicht über öffentliche Schnittstellen verfügbar gemacht. Stattdessen besitzt das Format für jede Formateigenschaft eine öffentlich zugängliche Eigenschaft, die intern auf das private Format verweist. Zum Beispiel macht die MobileControl-Klasse die Eigenschaften Font-Name, Font-Bold, Font-Size usw. verfügbar.

Bestimmte andere Steuerelemente enthalten möglicherweise intern eine Alternative zum Style-Objekt. Zum Beispiel enthält das Form-Steuerelement ein PagerStyle-Objekt, das von der Style-Klasse abgeleitet wird.

Sie können Stile auch in einem StyleSheet-Steuerelement organisieren. In einem Stylesheet können Sie eine beliebige Anzahl von Stilelementen deklarieren. Stile werden genauso deklariert wie Steuerelemente, nur ein -Attribut ist nicht erforderlich.

Ein Stil kann auf Eigenschaften in einem externen Stylesheet verweisen. Weitere Informationen zu externen Stylesheets finden Sie unter Erstellen neuer Formate.

Damit ein Steuerelement die Stile von einem Stilobjekt im Stylesheet übernimmt, legen Sie die StyleReference-Eigenschaft des Stilobjekts auf den Name fest, indem Sie das StyleReference-Attribut deklarieren.

Aufgrund der Unterschiedlichkeit der Geräte, die von den mobilen Steuerelementen unterstützt werden, dienen die Stileigenschaften lediglich als Vorschlag. Je nach Funktionen des Zielgeräts werden diese Vorschläge möglicherweise nicht umgesetzt.

<Style
    Name="name"
    Font-Name="fontName"
    Font-Size={NotSet|normal|small|large}
    Font-Bold={NotSet|false|true}
    Font-Italic="{NotSet|false|true}
    ForeColor="foregroundColor"
    BackColor="backgroundColor"
    Alignment={NotSet|Left|Center|Right}
    Name="uniqueStyleName"
    StyleReference="styleReference"
    Wrapping={NotSet|Wrap|NoWrap}>

    <DeviceSpecific>
                Insert choices here.
    </DeviceSpecific>
</Style>

Eigenschaften

Eigenschaft

Beschreibung

Alignment

Legt die Ausrichtung des Stils fest oder gibt diese zurück, was als eine der folgenden Alignment-Enumerationen ausgedrückt werden kann:

  • Center

  • Left

  • NotSet

  • Right

BackColor

Legt die Hintergrundfarbe des Steuerelements fest oder gibt sie zurück. In einem mobilen Steuerelement können Sie einen Farbwert mit Standard-HTML-Farbbezeichnern festlegen: dem Namen einer Farbe ("Schwarz" oder "Rot") oder einem im Hexadezimalformat ausgedrückten RGB-Wert ("#ffffff").

Control

Gibt das dem Stilobjekt entsprechende Steuerelement zurück.

DeviceSpecific

Legt das in diesem Stilobjekt enthaltene <DeviceSpecific>-Element fest oder gibt dieses zurück.

Font

Gibt ein FontInfo-Objekt mit Schriftartinformationen zum Steuerelement zurück.

ForeColor

Legt die Textfarbe des Steuerelements fest oder gibt sie zurück. In einem mobilen Steuerelement können Sie einen Farbwert mit Standard-HTML-Farbbezeichnern festlegen: dem Namen einer Farbe ("Schwarz" oder "Rot") oder einem im Hexadezimalformat ausgedrückten RGB-Wert ("#ffffff").

IsTemplated

Gibt true zurück, wenn der Stil ein <DeviceSelect>/<Choice>-Konstrukt mit einer Auswahl besitzt, die über Vorlagen verfügt.

Item

Gibt die Stileigenschaft mit dem angegebenen Namen zurück. Sie können das Element mit oder ohne Vererbung zurückgeben.

Name

Legt den eindeutigen Namen für den Stil fest oder gibt diesen zurück. Diese Einstellung ist erforderlich.

StyleReference

Legt einen Verweis auf ein anderes Style-Steuerelement fest oder gibt diesen zurück. Sie legen diese Eigenschaft durch Verweis auf Name des gewünschten Stiles fest. Der Standardwert für diese Eigenschaft ist null.

Wrapping

Legt fest, ob der Text in die nächste Zeile umbrochen wird, oder gibt diese Möglichkeit zurück, was als eine der folgenden Wrapping-Enumerationen ausgedrückt werden kann:

  • NotSet

  • NoWrap

  • Wrap

Kapselungsregeln

Die folgenden Steuerelemente können ein <Style>-Element enthalten.

Steuerelement

Kommentar

System.Web.UI.MobileControls.StyleSheet

Ein StyleSheet-Steuerelement kann jede Anzahl von <Style>-Elementen enthalten.

Ein <Style>-Element kann die folgenden Steuerelemente enthalten.

Steuerelement

Kommentar

System.Web.UI.MobileControls.DeviceSpecific

Ein <Style>-Element kann 0 (null) oder ein DeviceSpecific-Steuerelement enthalten.

Siehe auch

Konzepte

Gerätespezifische Wiedergabe

Formate

Referenz

Style

Weitere Ressourcen

Erstellen neuer Formate