DesignerAutoFormat Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan kelas dasar abstrak untuk membuat format yang dapat diterapkan ke kontrol server Web kustom pada waktu desain.
public ref class DesignerAutoFormat abstractpublic abstract class DesignerAutoFormattype DesignerAutoFormat = classPublic MustInherit Class DesignerAutoFormat- Warisan
-
DesignerAutoFormat
Contoh
Contoh kode berikut menunjukkan cara menerapkan pemformatan otomatis dalam perancang kontrol kustom. Perancang kontrol turunan mengimplementasikan AutoFormats properti dengan menambahkan tiga instans format otomatis kustom yang berasal dari DesignerAutoFormat kelas .
using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Web.UI;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Web.UI.WebControls;
namespace CustomControls.Design.CS
{
// A custom Label control whose contents can be indented
[Designer(typeof(IndentLabelDesigner)),
ToolboxData("<{0}:IndentLabel Runat=\"server\"></{0}:IndentLabel>")]
public class IndentLabel : Label
{
private int _indent = 0;
// Property to indent all text within the label
[Category("Appearance"), DefaultValue(0),
PersistenceMode(PersistenceMode.Attribute)]
public int Indent
{
get { return _indent; }
set
{
_indent = value;
// Get the number of pixels to indent
int ind = value * 8;
// Add the indent style to the control
if (ind > 0)
this.Style.Add(HtmlTextWriterStyle.MarginLeft, ind.ToString() + "px");
else
this.Style.Remove(HtmlTextWriterStyle.MarginLeft);
}
}
}
// A design-time ControlDesigner for the IndentLabel control
[SupportsPreviewControl(true)]
public class IndentLabelDesigner : LabelDesigner
{
private DesignerAutoFormatCollection _autoFormats = null;
// The collection of AutoFormat objects for the IndentLabel object
public override DesignerAutoFormatCollection AutoFormats
{
get
{
if (_autoFormats == null)
{
// Create the collection
_autoFormats = new DesignerAutoFormatCollection();
// Create and add each AutoFormat object
_autoFormats.Add(new IndentLabelAutoFormat("MyClassic"));
_autoFormats.Add(new IndentLabelAutoFormat("MyBright"));
_autoFormats.Add(new IndentLabelAutoFormat("Default"));
}
return _autoFormats;
}
}
// An AutoFormat object for the IndentLabel control
private class IndentLabelAutoFormat : DesignerAutoFormat
{
public IndentLabelAutoFormat(string name) : base(name)
{ }
// 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;
}
}
}
}
}
}
Imports System.Drawing
Imports System.Collections
Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace CustomControls.Design
' A custom Label control whose contents can be indented
<Designer(GetType(IndentLabelDesigner)), _
ToolboxData("<{0}:IndentLabel Runat=""server""></{0}:IndentLabel>")> _
Public Class IndentLabel
Inherits System.Web.UI.WebControls.Label
Dim _indent As Integer = 0
<Category("Appearance"), DefaultValue(0), _
PersistenceMode(PersistenceMode.Attribute)> _
Property Indent() As Integer
Get
Return _indent
End Get
Set(ByVal Value As Integer)
_indent = Value
' Get the number of pixels to indent
Dim ind As Integer = _indent * 8
' Add the indent style to the control
If ind > 0 Then
Me.Style.Add(HtmlTextWriterStyle.MarginLeft, ind.ToString() & "px")
Else
Me.Style.Remove(HtmlTextWriterStyle.MarginLeft)
End If
End Set
End Property
End Class
' A design-time ControlDesigner for the IndentLabel control
Public Class IndentLabelDesigner
Inherits LabelDesigner
Private _autoFormats As DesignerAutoFormatCollection = Nothing
' The collection of AutoFormat objects for the IndentLabel object
Public Overrides ReadOnly Property AutoFormats() As DesignerAutoFormatCollection
Get
If _autoFormats Is Nothing Then
' Create the collection
_autoFormats = New DesignerAutoFormatCollection()
' Create and add each AutoFormat object
_autoFormats.Add(New IndentLabelAutoFormat("MyClassic"))
_autoFormats.Add(New IndentLabelAutoFormat("MyBright"))
_autoFormats.Add(New IndentLabelAutoFormat("Default"))
End If
Return _autoFormats
End Get
End Property
' An AutoFormat object for the IndentLabel control
Public Class IndentLabelAutoFormat
Inherits DesignerAutoFormat
Public Sub New(ByVal name As String)
MyBase.New(name)
End Sub
' 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
End Class
End Class
End Namespace
Keterangan
DesignerAutoFormat menyediakan kelas dasar yang dapat diwarisi dari dan diperluas untuk menampilkan kontrol server Web kustom yang diformat pada waktu desain di alat desainer visual seperti Visual Studio 2005.
Pengembang kontrol menyediakan pemformatan otomatis untuk membantu pengembang yang menggunakan kontrol untuk memilih tampilan pilihan. Objek kustom DesignerAutoFormat bekerja dengan perancang kontrol kustom untuk menyediakan pemformatan otomatis pada waktu desain untuk kontrol kustom. Misalnya, Calendar kontrol menyediakan berbagai format yang dapat diterapkan oleh pengembang pada waktu desain.
Untuk menerapkan pemformatan otomatis untuk kontrol kustom:
Buat kontrol kustom.
Dapatkan kelas perancang dari ControlDesigner kelas atau kelas desainer lain yang sesuai untuk kontrol Anda, seperti TextControlDesigner.
Dapatkan kelas format dari DesignerAutoFormat kelas yang memformat kontrol kustom Anda dengan mengambil alih Apply metode .
Di kelas perancang Anda, isi AutoFormats properti , yang merupakan DesignerAutoFormatCollection objek , dengan satu instans kelas format Anda untuk setiap format bernama yang dapat diterapkan desainer Anda.
Kelas DesignerAutoFormat ini menyediakan anggota berikut untuk mendukung pemformatan otomatis pada waktu desain:
Metode Apply , yang menerapkan format bernama ke kontrol yang ditentukan.
Metode GetPreviewControl , yang menyediakan salinan kontrol untuk pratinjau dalam kotak dialog FormatOtomatis dari desainer visual seperti Visual Studio 2005.
Properti Name , yang menyediakan teks untuk ditampilkan dalam daftar format dalam desainer visual.
Catatan Bagi Implementer
Saat mewarisi dari DesignerAutoFormat kelas , Anda harus mengambil alih Apply(Control) metode untuk mempratinjau kontrol yang diformat dan menerapkan format yang dipilih ke kontrol Anda.
Konstruktor
| DesignerAutoFormat(String) |
Menginisialisasi instans baru kelas DesignerAutoFormat. |
Properti
| Name |
Mendapatkan nama DesignerAutoFormat objek. |
| Style |
DesignerAutoFormatStyle Mendapatkan objek yang digunakan oleh DesignerAutoFormat objek untuk merender pratinjau waktu desain kontrol terkait. |
Metode
| Apply(Control) |
Menerapkan pemformatan terkait ke kontrol yang ditentukan. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetPreviewControl(Control) |
Mengembalikan salinan kontrol terkait untuk menyediakan pratinjau sebelum menerapkan format ke kontrol. |
| GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini DesignerAutoFormat . |
