LabelDesigner Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje podporu času 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
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner
type LabelDesigner = class
inherit TextControlDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type LabelDesigner = class
inherit TextControlDesigner
Public Class LabelDesigner
Inherits TextControlDesigner
- Dědičnost
- Atributy
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 na ovládacím SampleLabel 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 GetDesignTimeHtmlBorderStyle nastavit vlastnost na Dashed, pokud původní BorderStyle byla NotSet nebo None hodnota. Tím se zlepší 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 zobrazení textu na webové stránce prostřednictvím kódu programu.
Když v návrháři vizuálů přepnete ze zdrojového zobrazení na návrhový kód, zdrojový kód značky Label , který popisuje 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 čas návrhu se zachová ve zdrojovém kódu značky a upraví se do revize pro webovou stránku. Třída LabelDesigner poskytuje podporu návrhu pro Label ovládací prvek.
Metoda OnComponentChanged se volá, když dojde ke změně přidruženého Label ovládacího prvku.
Konstruktory
| Name | Description |
|---|---|
| LabelDesigner() |
Inicializuje novou instanci LabelDesigner třídy. |
Vlastnosti
| Name | Description |
|---|---|
| ActionLists |
Získá kolekci seznamu akcí pro návrháře ovládacích prvků. (Zděděno od ControlDesigner) |
| AllowResize |
Získá hodnotu určující, zda lze změnit velikost ovládacího prvku v návrhovém prostředí. (Zděděno od ControlDesigner) |
| AssociatedComponents |
Získá kolekci komponent přidružených ke komponentě spravované návrhářem. (Zděděno od ComponentDesigner) |
| AutoFormats |
Získá kolekci předdefinovaných schémat automatického formátování, která se mají zobrazit v dialogovém okně Automatické formátování přidruženého ovládacího prvku v době návrhu. (Zděděno od ControlDesigner) |
| Behavior |
Zastaralé.
Získá nebo nastaví chování DHTML přidružené 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 určující, zda datové vazby je podporováno 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 přidruženého ovládacího prvku v době návrhu. (Zděděno od ControlDesigner) |
| DesignTimeElement |
Zastaralé.
Získá design-time objekt představující ovládací prvek, který je přidružen k HtmlControlDesigner objektu na návrhové ploše. (Zděděno od HtmlControlDesigner) |
| DesignTimeElementView |
Zastaralé.
Získá objekt view-control pro návrhář ovládacího prvku. (Zděděno od ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Zastaralé.
Získá hodnotu určující, zda návrhový hostitel musí dokončit načítání, než lze volat metodu GetDesignTimeHtml . (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 určující, zda vlastnosti přidruženého ovládacího prvku jsou skryty, 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 určující, zda je tato komponenta zděděna. (Zděděno od ComponentDesigner) |
| InTemplateMode |
Získá hodnotu označující, zda je ovládací prvek v režimu zobrazení nebo úprav šablony v hostiteli návrhu. Vlastnost InTemplateMode je určena jen pro čtení. (Zděděno od ControlDesigner) |
| IsDirty |
Zastaralé.
Získá nebo nastaví hodnotu urč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 určující, zda vlastnosti ovládacího prvku jsou jen pro čtení v době návrhu. (Zděděno od ControlDesigner) |
| RootDesigner |
Získá návrhář ovládacího prvku pro webové formuláře stránky, který obsahuje přidružený ovládací prvek. (Zděděno od ControlDesigner) |
| ShadowProperties |
Získá kolekci hodnot vlastností, které přepíší uživatelská nastavení. (Zděděno od ComponentDesigner) |
| ShouldCodeSerialize |
Zastaralé.
Získá nebo nastaví hodnotu určující, zda vytvořit deklaraci pole pro ovládací prvek v souboru kódu za kód pro aktuální návrh dokumentu 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 |
| Visible |
Získá hodnotu, která označuje, zda je ovládací prvek viditelný v době návrhu. (Zděděno od ControlDesigner) |
Metody
| Name | Description |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Vytvoří kód HTML pro zobrazení zadané chybové zprávy výjimky v době návrhu. (Zděděno od ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Vytvoří kód HTML pro zobrazení zadané chybové zprávy 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, které objekt používá 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 komponenty a přejde kurzor uživatele na toto místo. (Zděděno od ComponentDesigner) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetBounds() |
Načte souřadnice obdélníku představující hranice ovládacího prvku, jak je znázorněno na návrhové ploše. (Zděděno od ControlDesigner) |
| GetDesignTimeHtml() |
Získá revize, 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 oblastmi aktuálního návrháře ovládacích prvků. (Zděděno od ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Vrátí obsah pro upravitelnou oblast návrhového zobrazení 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 vizuální reprezentaci 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í funkce hash. (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 pro trvalé 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() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetViewRendering() |
Načte objekt, který obsahuje kód návrhu pro obsah a oblasti přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| Initialize(IComponent) |
Inicializuje návrháře 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é.
Zastaralé.
Inicializuje nastavení pro importovanou komponentu, která je již inicializována na jiná nastavení než výchozí hodnoty. (Zděděno od ComponentDesigner) |
| Invalidate() |
Zneplatní celou oblast ovládacího prvku, který se zobrazí na návrhové ploše, a signalizuje návrháře ovládacích prvků, aby ovládací prvek překreslil. (Zděděno od ControlDesigner) |
| Invalidate(Rectangle) |
Zneplatní zadanou oblast ovládacího prvku zobrazeného na návrhové ploše a signalizuje návrháře ovládacích prvků, aby ovládací prvek překreslil. (Zděděno od ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
InheritanceAttribute Získá zadanou ComponentDesigner. (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 svázaná s daty. (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 k prostředku v hostiteli návrhu. (Zděděno od ControlDesigner) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Volá se při předdefinovaném schématu automatického formátování u přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| OnBehaviorAttached() |
Volá se, když je návrhář ovládacího prvku připojen k objektu Chování. (Zděděno od ControlDesigner) |
| OnBehaviorDetaching() |
Zastaralé.
Volá se, když chování se od elementu oddružuje. (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. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Volá se při změně přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| 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á se při změně velikosti přidruženého ovládacího prvku webového serveru v hostiteli návrhu v době návrhu. (Zděděno od ControlDesigner) |
| OnPaint(PaintEventArgs) |
Volá se, když návrhář ovládacích prvků nakreslí přidružený ovládací prvek na návrhové ploše, pokud CustomPaint je |
| OnSetComponentDefaults() |
Zastaralé.
Zastaralé.
Nastaví výchozí vlastnosti komponenty. (Zděděno od ComponentDesigner) |
| OnSetParent() |
Poskytuje způsob, jak provést další zpracování při připojení přidruženého ovládacího prvku k nadřazeného ovládacího prvku. (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 objektu 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 objektu 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á nebo odebere vlastnosti z mřížky Vlastnosti v hostiteli návrhu v době návrhu nebo poskytuje nové vlastnosti návrhu, které mohou odpovídat vlastnostem přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Upozorní tuto komponentu IComponentChangeService , že byla změněna. (Zděděno od ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Upozorní tuto komponentu IComponentChangeService , že se chystáte změnit. (Zděděno od ComponentDesigner) |
| RaiseResizeEvent() |
Zastaralé.
OnControlResize() Vyvolá událost. (Zděděno od ControlDesigner) |
| RegisterClone(Object, Object) |
Zaregistruje interní data v klonovaném ovládacím prvku. (Zděděno od ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Určuje obsah pro upravitelnou oblast ovládacího prvku v době návrhu. (Zděděno od ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Určuje obsah pro upravitelnou oblast v návrhovém zobrazení ovládacího prvku. (Zděděno od ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Přiřadí zadanou bitovou ViewFlags výčtu k 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 přidruženého ovládacího prvku webového serveru voláním GetDesignTimeHtml metody. (Zděděno od ControlDesigner) |