DesignerAutoFormatCollection Sınıf

Tanım

DesignerAutoFormatBir denetim Tasarımcısı içindeki nesne koleksiyonunu temsil eder.Represents a collection of DesignerAutoFormat objects within a control designer. Bu sınıf devralınamaz.This class cannot be inherited.

public ref class DesignerAutoFormatCollection sealed : System::Collections::IList
public sealed class DesignerAutoFormatCollection : System.Collections.IList
type DesignerAutoFormatCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class DesignerAutoFormatCollection
Implements IList
Devralma
DesignerAutoFormatCollection
Uygulamalar

Örnekler

Aşağıdaki kod örneği, AutoFormats özel bir denetim tasarımcısında özelliğin nasıl uygulanacağını gösterir.The following code example demonstrates how to implement the AutoFormats property in a custom control designer. Türetilmiş denetim Tasarımcısı, AutoFormats sınıfından türetilen özel bir Otomatik biçimin üç örneğini ekleyerek özelliğini uygular DesignerAutoFormat .The derived control designer implements the AutoFormats property by adding three instances of a custom automatic format that are derived from the DesignerAutoFormat class.

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

Açıklamalar

ControlDesignerSınıfı ve türetilmiş herhangi bir sınıf, AutoFormats özelliği bir nesne olarak tanımlar DesignerAutoFormatCollection .The ControlDesigner class and any derived class defines the AutoFormats property as a DesignerAutoFormatCollection object. Denetim geliştiricileri AutoFormats türetilmiş bir denetim tasarımcısında özelliği geçersiz kılabilir, özel otomatik biçimlendirme stilleri ekleyebilir ve desteklenen biçimlerin koleksiyonunu görsel tasarımcıya döndürebilir.Control developers can override the AutoFormats property in a derived control designer, add custom automatic formatting styles, and return the collection of supported formats to the visual designer.

Nesneler eklendikçe koleksiyon dinamik olarak artar.The collection dynamically increases as objects are added. Bu koleksiyondaki dizinler sıfır tabanlıdır.Indexes in this collection are zero-based. CountKoleksiyonda kaç tane otomatik stil biçiminin olduğunu anlamak için özelliğini kullanın.Use the Count property to determine how many automatic style formats are in the collection.

Ayrıca, DesignerAutoFormatCollection aşağıdaki işlevleri sağlamak için yöntemleri ve özellikleri kullanın:Additionally, use the DesignerAutoFormatCollection methods and properties to provide the following functionality:

  • AddKoleksiyona tek bir biçim ekleme yöntemi.The Add method to add a single format to the collection.

  • InsertKoleksiyon içindeki belirli bir dizine biçim ekleme yöntemi.The Insert method to add a format at a particular index within the collection.

  • RemoveBir biçimi kaldırma yöntemi.The Remove method to remove a format.

  • RemoveAtBelirli bir dizindeki biçimi kaldırma yöntemi.The RemoveAt method to remove the format at a particular index.

  • ContainsBelirli bir biçimin zaten koleksiyonda olup olmadığını belirleme yöntemi.The Contains method to determine whether a particular format is already in the collection.

  • IndexOfKoleksiyon içindeki bir biçimin dizinini alma yöntemi.The IndexOf method to retrieve the index of a format within the collection.

  • Item[]Dizi gösterimini kullanarak belirli bir dizinde biçim almak veya ayarlamak için özelliği.The Item[] property to get or set the format at a particular index, using array notation.

  • ClearKoleksiyondan tüm biçimleri kaldırma yöntemi.The Clear method to remove all formats from the collection.

  • CountKoleksiyondaki biçim sayısını belirleme özelliği.The Count property to determine the number of formats in the collection.

  • IndexOfKoleksiyon içindeki bir biçimin konumunu almak için yöntemi.The IndexOf method to get the position of a format within the collection.

Oluşturucular

DesignerAutoFormatCollection()

DesignerAutoFormatCollection sınıfının yeni bir örneğini başlatır.Initializes a new instance of the DesignerAutoFormatCollection class.

Özellikler

Count

Koleksiyondaki nesne sayısını alır DesignerAutoFormat .Gets the number of DesignerAutoFormat objects in the collection.

Item[Int32]

DesignerAutoFormatKoleksiyonda belirtilen dizindeki bir nesneyi alır veya ayarlar.Gets or sets a DesignerAutoFormat object at the specified index in the collection.

PreviewSize

Çalışma zamanında görünecek şekilde denetimin en fazla dış boyutunu alır.Gets the maximum outer dimensions of the control as it will appear at run time.

SyncRoot

Nesneye erişimi eşzamanlı hale getirmek için kullanılabilecek bir nesne alır DesignerAutoFormatCollection .Gets an object that can be used to synchronize access to the DesignerAutoFormatCollection object.

Yöntemler

Add(DesignerAutoFormat)

Belirtilen DesignerAutoFormat nesneyi koleksiyonun sonuna ekler.Adds the specified DesignerAutoFormat object to the end of the collection.

Clear()

Koleksiyondaki tüm biçimleri kaldırır.Removes all formats from the collection.

Contains(DesignerAutoFormat)

Belirtilen biçimin koleksiyon içinde içerilip içerilmeyeceğini belirler.Determines whether the specified format is contained within the collection.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
IndexOf(DesignerAutoFormat)

Koleksiyonda belirtilen nesnenin dizinini döndürür DesignerAutoFormat .Returns the index of the specified DesignerAutoFormat object within the collection.

Insert(Int32, DesignerAutoFormat)

DesignerAutoFormatBelirtilen dizindeki koleksiyona bir nesne ekler.Inserts a DesignerAutoFormat object into the collection at the specified index.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
Remove(DesignerAutoFormat)

Belirtilen DesignerAutoFormat nesneyi koleksiyondan kaldırır.Removes the specified DesignerAutoFormat object from the collection.

RemoveAt(Int32)

DesignerAutoFormatKoleksiyonu içindeki belirtilen dizindeki nesneyi kaldırır.Removes the DesignerAutoFormat object at the specified index within the collection.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

ICollection.CopyTo(Array, Int32)

Array Array DesignerAutoFormatCollection Nesne bir arabirime yayınlandığında, koleksiyonun öğelerini belirli bir dizinden başlayarak bir nesnesine kopyalar ICollection .Copies the elements of the collection to an Array object, starting at a particular Array index when the DesignerAutoFormatCollection object is cast to an ICollection interface.

ICollection.Count

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığında koleksiyonda yer alan öğelerin sayısını alır ICollection .Gets the number of elements that are contained in the collection when the DesignerAutoFormatCollection object is cast to an ICollection interface.

ICollection.IsSynchronized

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığında, koleksiyona erişimin eşitlenip eşitlenmeyeceğini (iş parçacığı açısından güvenli) gösteren bir değer alır ICollection .Gets a value that indicates whether access to the collection is synchronized (thread safe) when the DesignerAutoFormatCollection object is cast to an ICollection interface.

IEnumerable.GetEnumerator()

IEnumerator DesignerAutoFormatCollection Nesne bir arabirime yayınlandığınızda, koleksiyon üzerinden yinelenen bir arabirim döndürür IEnumerable .Returns an IEnumerator interface that iterates through the collection when the DesignerAutoFormatCollection object is cast to an IEnumerable interface.

IList.Add(Object)

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığınızda koleksiyona bir öğe ekler IList .Adds an item to the collection when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.Contains(Object)

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığınızda, koleksiyonun belirli bir değer içerip içermediğini belirler IList .Determines whether the collection contains a specific value when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.IndexOf(Object)

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığınızda koleksiyondaki belirli bir öğenin dizinini belirler IList .Determines the index of a specific item in the collection when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.Insert(Int32, Object)

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığınızda, belirtilen dizinde koleksiyona bir öğe ekler IList .Inserts an item into the collection at the specified index when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.IsFixedSize

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığında koleksiyonun sabit boyuta sahip olup olmadığını gösteren bir değer alır IList .Gets a value that indicates whether the collection has a fixed size when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.IsReadOnly

Bu yöntemin açıklaması için bkz IsReadOnly ..For a description of this method, see IsReadOnly.

IList.Item[Int32]

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığında belirtilen dizindeki öğeyi alır IList .Gets the element at the specified index when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.Remove(Object)

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığında, belirli bir nesnenin ilk oluşumunu koleksiyondan kaldırır IList .Removes the first occurrence of a specific object from the collection when the DesignerAutoFormatCollection object is cast to an IList interface.

IList.RemoveAt(Int32)

DesignerAutoFormatCollectionNesne bir arabirime yayınlandığında belirtilen dizindeki öğeyi kaldırır IList .Removes the item at the specified index when the DesignerAutoFormatCollection object is cast to an IList interface.

Uzantı Metotları

Cast<TResult>(IEnumerable)

Öğesinin öğelerini IEnumerable belirtilen türe yayınlar.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Öğesinin öğelerini IEnumerable belirtilen bir türe göre filtreler.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Bir sorgunun paralelleştirilmesini mümkün hale getirme.Enables parallelization of a query.

AsQueryable(IEnumerable)

Bir IEnumerable öğesine dönüştürür IQueryable .Converts an IEnumerable to an IQueryable.

Şunlara uygulanır

Ayrıca bkz.