DesignerAutoFormat.Apply メソッド

.NET Framework クラス ライブラリ リファレンス

DesignerAutoFormat.Apply メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

関連付けられている書式を指定したコントロールに適用します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Sub
 Apply ( _
    control As Control _
)

Visual Basic (使用法)

Dim instance As DesignerAutoFormat
Dim control As Control

instance.Apply(control)

C#

public abstract void Apply (
    Control control
)

C++

public:
virtual void Apply (
    Control^ control
) abstract

J#

public abstract void Apply (
    Control control
)

JScript

public abstract function Apply (
    control : Control
)

パラメータ

control

書式の適用先の Web サーバー コントロール。

解説

Apply メソッドは、Name プロパティに基づいて指定したコントロールに書式を適用します。コントロールまたは Style プロパティに直接スタイルを適用した後、そのコントロールの MergeStyle メソッドを使用してスタイルの変更をコントロールに適用できます。

継承時の注意 DesignerAutoFormat クラスから継承する場合は、Apply メソッドをオーバーライドする必要があります。

使用例

DesignerAutoFormat オブジェクトを使用して Web サーバー コントロールに書式を適用する方法を次のコード例に示します。

Visual Basic

' 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

C#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerAutoFormat クラス
DesignerAutoFormat メンバ
System.Web.UI.Design 名前空間
DesignerAutoFormat クラス
ControlDesigner クラス
DesignerAutoFormatCollection
その他の技術情報
Web フォームのデザイン時サポート