LabelDesigner Třída

Definice

Obor názvů:

System.Web.UI.Design.WebControls

Sestavení:

System.Design.dll

Poskytuje podporu při návrhu ve vizuálním návrháři pro ovládací prvek webového Label serveru.

public ref class LabelDesigner : System::Web::UI::Design::TextControlDesigner

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type LabelDesigner = class
    inherit TextControlDesigner

Public Class LabelDesigner
Inherits TextControlDesigner

Dědičnost

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

TextControlDesigner

LabelDesigner

Atributy

SupportsPreviewControlAttribute

Příklady

Následující příklad kódu ukazuje, jak odvodit SampleLabel ovládací prvek z Label ovládacího prvku a použije DesignerAttribute atribut SampleLabel ovládacího prvku pro jeho přidružení ke SampleLabelDesigner třídě.

Příklad kódu také odvozuje SampleLabelDesigner z LabelDesigner třídy . Přepíše metodu GetDesignTimeHtml pro nastavení BorderStyle vlastnosti na Dashed, pokud byla NotSet původní BorderStyle hodnota neboNone. To zlepšuje viditelnost přidruženého ovládacího prvku v době návrhu.

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The SampleLabel is a copy of the Label.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.SampleLabelDesigner))]
    public class SampleLabel : Label
    {
    } // SampleLabel

    // Override members of the LabelDesigner.
    public class SampleLabelDesigner : LabelDesigner
    {
        // Generate the design-time markup.
        public override string GetDesignTimeHtml()
        {
            // Make the control more visible in the designer.  If the border 
            // style is None or NotSet, change the border to a dashed line. 
            SampleLabel sampleLabel = (SampleLabel)Component;
            string designTimeMarkup = null;

            // Check if the border style should be changed.
            if (sampleLabel.BorderStyle == BorderStyle.NotSet ||
                sampleLabel.BorderStyle == BorderStyle.None)
            {
                BorderStyle oldBorderStyle = sampleLabel.BorderStyle;

                try
                {
                    // Set the design-time BorderStyle.
                    sampleLabel.BorderStyle = BorderStyle.Dashed;

                    // Call the base method to generate the markup.
                    designTimeMarkup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    // If an exception occurs, generate an error message.
                    designTimeMarkup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // Restore the BorderStyle to its original setting.
                    sampleLabel.BorderStyle = oldBorderStyle;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                designTimeMarkup = base.GetDesignTimeHtml();
            }

            return designTimeMarkup;
        } // GetDesignTimeHtml
    } // SampleLabelDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The SampleLabel is a copy of the Label.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.SampleLabelDesigner))> _
    Public Class SampleLabel
        Inherits Label
    End Class

    ' Override members of the LabelDesigner.
    Public Class SampleLabelDesigner
        Inherits LabelDesigner

        ' Generate the design-time markup.
        Public Overrides Function GetDesignTimeHtml() As String

            ' Make the control more visible in the designer.  If the border 
            ' style is None or NotSet, change the border to a dashed line. 
            Dim sampleLabel As SampleLabel = CType(Component, SampleLabel)
            Dim designTimeMarkup As String = Nothing

            ' Check if the border style should be changed.
            If (sampleLabel.BorderStyle = BorderStyle.NotSet Or _
                sampleLabel.BorderStyle = BorderStyle.None) Then

                Dim oldBorderStyle As BorderStyle = sampleLabel.BorderStyle

                Try
                    ' Set the design-time BorderStyle.
                    sampleLabel.BorderStyle = BorderStyle.Dashed

                    ' Call the base method to generate the markup.
                    designTimeMarkup = MyBase.GetDesignTimeHtml()

                Catch ex As Exception
                    ' If an exception occurs, generate an error message.
                    designTimeMarkup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' Restore the BorderStyle to its original setting.
                    sampleLabel.BorderStyle = oldBorderStyle
                End Try

            Else
                ' Call the base method to generate the markup.
                designTimeMarkup = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeMarkup
        End Function ' GetDesignTimeHtml
    End Class
End Namespace ' Examples.VB.WebControls.Design

Poznámky

Ovládací Label prvek umožňuje programově zobrazovat text na webové stránce.

Když ve vizuálním návrháři přepnete ze zobrazení Zdroj na návrh, zdrojový kód značek, který popisuje Label ovládací prvek, se analyzuje a na návrhové ploše se vytvoří verze ovládacího prvku v době návrhu. Když přepnete zpět do zobrazení Zdroj, ovládací prvek doby návrhu se zachová ve zdrojovém kódu značek a upraví se do značek pro webovou stránku. Třída LabelDesigner poskytuje podporu ovládacího prvku v době návrhu Label .

Metoda OnComponentChanged je volána, pokud dojde ke změně přidruženého Label ovládacího prvku.

Konstruktory

LabelDesigner()

Inicializuje novou instanci LabelDesigner třídy.

Vlastnosti

ActionLists	Získá kolekci seznamu akcí pro návrháře ovládacích prvků. (Zděděno od ControlDesigner)
AllowResize	Získá hodnotu označující, zda lze změnit velikost ovládacího prvku v prostředí návrhu. (Zděděno od ControlDesigner)
AssociatedComponents	Získá kolekci komponent přidružených k komponentě spravované návrhářem. (Zděděno od ComponentDesigner)
AutoFormats	Získá kolekci předdefinovaných schémat automatického formátování k zobrazení v dialogovém okně Automatický formát pro přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner)
Behavior	Zastaralé. Získá nebo nastaví chování DHTML, která je přidružena k návrháři. (Zděděno od HtmlControlDesigner)
Component	Získá komponentu, která tento návrhář navrhuje. (Zděděno od ComponentDesigner)
DataBindings	Získá kolekci datových vazeb pro aktuální ovládací prvek. (Zděděno od HtmlControlDesigner)
DataBindingsEnabled	Získá hodnotu označující, zda je datová vazba podporována obsahující oblast pro přidružený ovládací prvek. (Zděděno od ControlDesigner)
DesignerState	Získá objekt, který se používá k zachování dat pro přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner)
DesignTimeElement	Zastaralé. Získá objekt návrhu představující ovládací prvek, který je přidružen k objektu HtmlControlDesigner na návrhové ploše. (Zděděno od HtmlControlDesigner)
DesignTimeElementView	Zastaralé. Získá ovládací prvek zobrazení objektu pro návrháře ovládacího prvku. (Zděděno od ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Zastaralé. Získá hodnotu označující, zda návrh hostitele musí dokončit načítání před metodu GetDesignTimeHtml lze volat. (Zděděno od ControlDesigner)
Expressions	Získá vazby výrazu pro aktuální ovládací prvek v době návrhu. (Zděděno od HtmlControlDesigner)
HidePropertiesInTemplateMode	Získá hodnotu označující, zda jsou vlastnosti přidruženého ovládacího prvku skryté, pokud je ovládací prvek v režimu šablony. (Zděděno od ControlDesigner)
ID	Získá nebo nastaví řetězec ID pro ovládací prvek. (Zděděno od ControlDesigner)
InheritanceAttribute	Získá atribut, který označuje typ dědičnosti přidružené komponenty. (Zděděno od ComponentDesigner)
Inherited	Získá hodnotu označující, zda je tato součást zděděna. (Zděděno od ComponentDesigner)
InTemplateMode	Získá hodnotu označující, zda je ovládací prvek v režimu zobrazení šablony nebo úprav v hostiteli návrhu. Vlastnost InTemplateMode je jen pro čtení. (Zděděno od ControlDesigner)
IsDirty	Zastaralé. Získá nebo nastaví hodnotu označující, zda byl ovládací prvek webového serveru označen jako změněn. (Zděděno od ControlDesigner)
ParentComponent	Získá nadřazenou komponentu pro tohoto návrháře. (Zděděno od ComponentDesigner)
ReadOnly	Zastaralé. Získá nebo nastaví hodnotu označující, zda jsou vlastnosti ovládacího prvku jen pro čtení v době návrhu. (Zděděno od ControlDesigner)
RootDesigner	Získá návrháře ovládacího prvku webové formuláře stránka, která obsahuje přidružený ovládací prvek. (Zděděno od ControlDesigner)
SetTextualDefaultProperty	Poskytuje podporu při návrhu ve vizuálním návrháři pro ovládací prvek webového Label serveru. (Zděděno od ComponentDesigner)
ShadowProperties	Získá kolekci hodnot vlastností, které přepíší nastavení uživatele. (Zděděno od ComponentDesigner)
ShouldCodeSerialize	Zastaralé. Získá nebo nastaví hodnotu označující, zda vytvořit deklaraci pole pro ovládací prvek v souboru kódu na pozadí aktuálního dokumentu návrhu během serializace. (Zděděno od HtmlControlDesigner)
Tag	Získá objekt představující html značky element pro přidružený ovládací prvek. (Zděděno od ControlDesigner)
TemplateGroups	Získá kolekci skupin šablon, z nichž každá obsahuje jednu nebo více definic šablon. (Zděděno od ControlDesigner)
UsePreviewControl	Získá hodnotu označující, zda návrhář ovládacího prvku používá dočasný náhled ovládacího prvku k vygenerování kódu HTML v době návrhu. (Zděděno od ControlDesigner)
Verbs	Získá příkazy v době návrhu podporované komponentou, která je přidružena k návrháři. (Zděděno od ComponentDesigner)
ViewControl	Získá nebo nastaví ovládací prvek webového serveru, který lze použít pro náhled kódu HTML v době návrhu. (Zděděno od ControlDesigner)
ViewControlCreated	Získá nebo nastaví hodnotu označující, zda View byl vytvořen ovládací prvek pro zobrazení na návrhové ploše. (Zděděno od ControlDesigner)
Visible	Získá hodnotu, která označuje, zda je ovládací prvek viditelný v době návrhu. (Zděděno od ControlDesigner)

Metody

CreateErrorDesignTimeHtml(String)	Vytvoří kód HTML pro zobrazení zadané chybové zprávy v době návrhu. (Zděděno od ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Vytvoří kód HTML pro zobrazení chybové zprávy o zadané výjimce v době návrhu. (Zděděno od ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Poskytuje jednoduchou obdélníkovou zástupnou reprezentaci, která zobrazuje typ a ID ovládacího prvku. (Zděděno od ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Poskytuje jednoduchou obdélníkovou zástupnou reprezentaci, která zobrazuje typ a ID ovládacího prvku a také další zadané pokyny nebo informace. (Zděděno od ControlDesigner)
CreateViewControl()	Vrátí kopii přidruženého ovládacího prvku pro zobrazení nebo vykreslení na návrhové ploše. (Zděděno od ControlDesigner)
Dispose()	Uvolní všechny prostředky používané nástrojem ComponentDesigner. (Zděděno od ComponentDesigner)
Dispose(Boolean)	Uvolní nespravované prostředky používané objektem HtmlControlDesigner a volitelně uvolní spravované prostředky. (Zděděno od HtmlControlDesigner)
DoDefaultAction()	Vytvoří podpis metody v souboru zdrojového kódu pro výchozí událost v komponentě a přejde kurzor uživatele do daného umístění. (Zděděno od ComponentDesigner)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBounds()	Načte souřadnice obdélníku představujícího hranice ovládacího prvku, jak je zobrazeno na návrhové ploše. (Zděděno od ControlDesigner)
GetDesignTimeHtml()	Získá kód, který se používá k reprezentaci přidruženého ovládacího prvku v době návrhu. (Zděděno od TextControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)	Načte kód HTML pro zobrazení ovládacího prvku a naplní kolekci aktuálními oblastmi návrháře ovládacího prvku. (Zděděno od ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Vrátí obsah pro upravitelnou oblast zobrazení v době návrhu přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
GetEmptyDesignTimeHtml()	Načte kód HTML, který představuje ovládací prvek webového serveru v době návrhu, který nebude mít žádné vizuální znázornění za běhu. (Zděděno od ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Načte kód HTML, který poskytuje informace o zadané výjimce. (Zděděno od ControlDesigner)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetPersistenceContent()	Načte trvalý vnitřní kód HTML ovládacího prvku v době návrhu. (Zděděno od ControlDesigner)
GetPersistInnerHtml()	Získá kód, který se má zachovat pro vnitřní značky ovládacího prvku. (Zděděno od TextControlDesigner)
GetService(Type)	Pokusí se načíst zadaný typ služby z webu režimu návrhu komponenty návrháře. (Zděděno od ComponentDesigner)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetViewRendering()	Načte objekt, který obsahuje značky v době návrhu pro obsah a oblasti přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
Initialize(IComponent)	Inicializuje návrhář se zadanou komponentou. (Zděděno od TextControlDesigner)
InitializeExistingComponent(IDictionary)	Znovu inicializuje existující komponentu. (Zděděno od ComponentDesigner)
InitializeNewComponent(IDictionary)	Inicializuje nově vytvořenou komponentu. (Zděděno od ComponentDesigner)
InitializeNonDefault()	Zastaralé. Inicializuje nastavení pro importovanou komponentu, která je již inicializována do jiných než výchozích nastavení. (Zděděno od ComponentDesigner)
Invalidate()	Zruší platnost celé oblasti ovládacího prvku, který je zobrazen na návrhové ploše, a signalizuje návrháři ovládacích prvků překreslit ovládací prvek. (Zděděno od ControlDesigner)
Invalidate(Rectangle)	Zruší platnost zadané oblasti ovládacího prvku, který je zobrazen na návrhové ploše a signalizuje návrháři ovládacích prvků překreslit ovládací prvek. (Zděděno od ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Získá ze zadaného ComponentDesignerobjektu InheritanceAttribute . (Zděděno od ComponentDesigner)
IsPropertyBound(String)	Zastaralé. Načte hodnotu označující, zda je zadaná vlastnost přidruženého ovládacího prvku vázána na data. (Zděděno od ControlDesigner)
Localize(IDesignTimeResourceWriter)	Použije zadaný zapisovač prostředků k zachování lokalizovatelných vlastností přidruženého ovládacího prvku na prostředek v hostiteli návrhu. (Zděděno od ControlDesigner)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnAutoFormatApplied(DesignerAutoFormat)	Volá se, když bylo u přidruženého ovládacího prvku použito předdefinované schéma automatického formátování. (Zděděno od ControlDesigner)
OnBehaviorAttached()	Volána, když je návrhář ovládacího prvku připojen k objektu Behavior. (Zděděno od ControlDesigner)
OnBehaviorDetaching()	Zastaralé. Volána, když chování se oddělí od elementu. (Zděděno od HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Zastaralé. Volá se při změně kolekce datových vazeb. (Zděděno od ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Volá se hostitelem návrhu, když uživatel klikne na přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Volá se, když dojde ke změně přidruženého ovládacího prvku.
OnComponentChanging(Object, ComponentChangingEventArgs)	Představuje metodu, která bude zpracovávat ComponentChanging událost přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
OnControlResize()	Zastaralé. Volána, když byla v návrhovém hostiteli změněna velikost přidruženého ovládacího prvku webového serveru. (Zděděno od ControlDesigner)
OnPaint(PaintEventArgs)	Volá se, když návrhář ovládacího prvku nakreslí přidružený ovládací prvek na návrhovou plochu, pokud CustomPaint je truehodnota . (Zděděno od ControlDesigner)
OnSetComponentDefaults()	Zastaralé. Nastaví výchozí vlastnosti komponenty. (Zděděno od ComponentDesigner)
OnSetParent()	Poskytuje způsob, jak provést další zpracování, když je přidružený ovládací prvek připojen k nadřazený ovládací prvek. (Zděděno od HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Umožňuje návrháři změnit nebo odebrat položky ze sady atributů, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PostFilterEvents(IDictionary)	Umožňuje návrháři změnit nebo odebrat položky ze sady událostí, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PostFilterProperties(IDictionary)	Umožňuje návrháři změnit nebo odebrat položky ze sady vlastností, které zveřejňuje prostřednictvím objektu TypeDescriptor. (Zděděno od ComponentDesigner)
PreFilterAttributes(IDictionary)	Umožňuje návrháři přidat do sady atributů, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner)
PreFilterEvents(IDictionary)	Nastaví seznam událostí, které jsou vystaveny v době návrhu TypeDescriptor objektu pro komponentu. (Zděděno od HtmlControlDesigner)
PreFilterProperties(IDictionary)	Přidá vlastnosti do nebo odebere vlastnosti z mřížky Vlastnosti v návrhovém hostiteli v době návrhu nebo poskytuje nové vlastnosti v době návrhu, které mohou odpovídat vlastnostem přidruženého ovládacího prvku. (Zděděno od ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	IComponentChangeService Oznámí, že tato komponenta byla změněna. (Zděděno od ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	IComponentChangeService Oznámí, že se tato komponenta bude měnit. (Zděděno od ComponentDesigner)
RaiseResizeEvent()	Zastaralé. OnControlResize() Vyvolá událost. (Zděděno od ControlDesigner)
RegisterClone(Object, Object)	Registruje interní data v klonovaném ovládacím prvku. (Zděděno od ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Určuje obsah upravitelné oblasti ovládacího prvku v době návrhu. (Zděděno od ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Určuje obsah upravitelné oblasti v zobrazení návrhu ovládacího prvku. (Zděděno od ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Přiřadí zadaný bitový ViewFlags výčet zadané hodnotě příznaku. (Zděděno od ControlDesigner)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UpdateDesignTimeHtml()	Aktualizuje kód HTML v době návrhu pro přidružený ovládací prvek webového serveru voláním GetDesignTimeHtml metody . (Zděděno od ControlDesigner)

Explicitní implementace rozhraní

IDesignerFilter.PostFilterAttributes(IDictionary)	Popis tohoto členu najdete v PostFilterAttributes(IDictionary) metodě . (Zděděno od ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Popis tohoto členu najdete v PostFilterEvents(IDictionary) metodě . (Zděděno od ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Popis tohoto členu najdete v PostFilterProperties(IDictionary) metodě . (Zděděno od ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Popis tohoto členu najdete v PreFilterAttributes(IDictionary) metodě . (Zděděno od ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Popis tohoto členu najdete v PreFilterEvents(IDictionary) metodě . (Zděděno od ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Popis tohoto členu najdete v PreFilterProperties(IDictionary) metodě . (Zděděno od ComponentDesigner)
ITreeDesigner.Children	Popis tohoto členu najdete ve Children vlastnosti . (Zděděno od ComponentDesigner)
ITreeDesigner.Parent	Popis tohoto členu najdete ve Parent vlastnosti . (Zděděno od ComponentDesigner)

Viz také

• Label
• WebControl
• BorderStyle
• TextControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Úvod do návrhářů ovládacích prvků ASP.NET
• Návod: Vytvoření základního návrháře ovládacích prvků pro ovládací prvek webového serveru