DesignerAutoFormat.Apply(Control) Methode

Referenz

Definition

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wendet die zugeordnete Formatierung auf das angegebene Steuerelement an.

public:
 abstract void Apply(System::Web::UI::Control ^ control);

public abstract void Apply (System.Web.UI.Control control);

abstract member Apply : System.Web.UI.Control -> unit

Public MustOverride Sub Apply (control As Control)

Parameter

control: Control

Ein Webserversteuerelement, auf das die Formatierungen angewendet werden sollen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe eines DesignerAutoFormat -Objekts Formatierungen auf ein Webserversteuerelement anwenden.

// Applies styles based on the Name of the AutoFormat
public override void Apply(Control inLabel)
{
    if (inLabel is IndentLabel)
    {
        IndentLabel ctl = (IndentLabel)inLabel;

        // Apply formatting according to the Name
        if (this.Name == "MyClassic")
        {
            // For MyClassic, apply style elements directly to the control
            ctl.ForeColor = Color.Gray;
            ctl.BackColor = Color.LightGray;
            ctl.Font.Size = FontUnit.XSmall;
            ctl.Font.Name = "Verdana,Geneva,Sans-Serif";
        }
        else if (this.Name == "MyBright")
        {
            // For MyBright, apply style elements to the Style property
            this.Style.ForeColor = Color.Maroon;
            this.Style.BackColor = Color.Yellow;
            this.Style.Font.Size = FontUnit.Medium;

            // Merge the AutoFormat style with the control's style
            ctl.MergeStyle(this.Style);
        }
        else
        {
            // For the Default format, apply style elements to the control
            ctl.ForeColor = Color.Black;
            ctl.BackColor = Color.Empty;
            ctl.Font.Size = FontUnit.XSmall;
        }
    }
}

' Applies styles based on the Name of the AutoFormat
Public Overrides Sub Apply(ByVal inLabel As Control)
    If TypeOf inLabel Is IndentLabel Then
        Dim ctl As IndentLabel = CType(inLabel, IndentLabel)

        ' Apply formatting according to the Name
        If Me.Name.Equals("MyClassic") Then
            ' For MyClassic, apply style elements directly to the control
            ctl.ForeColor = Color.Gray
            ctl.BackColor = Color.LightGray
            ctl.Font.Size = FontUnit.XSmall
            ctl.Font.Name = "Verdana,Geneva,Sans-Serif"
        ElseIf Me.Name.Equals("MyBright") Then
            ' For MyBright, apply style elements to the Style object
            Me.Style.ForeColor = Color.Maroon
            Me.Style.BackColor = Color.Yellow
            Me.Style.Font.Size = FontUnit.Medium

            ' Merge the AutoFormat style with the control's style
            ctl.MergeStyle(Me.Style)
        Else
            ' For the Default format, apply style elements to the control
            ctl.ForeColor = Color.Black
            ctl.BackColor = Color.Empty
            ctl.Font.Size = FontUnit.XSmall
        End If
    End If
End Sub

Hinweise

Die Apply -Methode wendet die Formatierung auf das angegebene Steuerelement basierend auf der Name -Eigenschaft an. Sie können die Formatvorlagen direkt auf das Steuerelement anwenden oder die Style -Eigenschaft festlegen und dann die MergeStyle -Methode für das Steuerelement verwenden, um die Formatvorlagenänderungen auf das Steuerelement anzuwenden.

Hinweise für Ausführende

Wenn Sie von der DesignerAutoFormat -Klasse erben, müssen Sie die Apply(Control) -Methode überschreiben.

Gilt für: