DesignerAutoFormat.Apply(Control) 方法

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

將相關的格式套用到指定的控制項上。

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)

參數

control

Control

一個網頁伺服器控制項，用來套用格式化。

範例

以下程式碼範例說明如何使用 DesignerAutoFormat 物件對網頁伺服器控制項套用格式化。

// 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

備註

該方法根據 Apply 屬性 Name 對指定的控制項套用格式化。 你可以直接套用樣式到控制項，或者先設定 Style 屬性，然後用 MergeStyle 控制項的方法來套用項式變更。

給實施者的注意事項

當你從 DesignerAutoFormat 該類別繼承時，必須覆寫該 Apply(Control) 方法。

另請參閱

• DesignerAutoFormat
• ControlDesigner
• DesignerAutoFormatCollection
• ASP.NET 控制設計師概述