Sdílet prostřednictvím


DesignSurface Třída

Definice

Představuje uživatelské rozhraní pro navrhování komponent.

public ref class DesignSurface : IDisposable, IServiceProvider
public class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
[<System.Security.SecurityCritical>]
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
Dědičnost
DesignSurface
Atributy
Implementuje

Poznámky

Třída DesignSurface implementuje, co uživatel považuje za návrháře. DesignSurface je uživatelské rozhraní, které uživatel manipuluje se změnou funkcí návrhu. DesignSurface poskytuje zcela samostatnou plochu návrhu.

Třída DesignSurface může být použita jako samostatný návrhář nebo může být svázána s DesignSurfaceManager třídou, aby poskytovala společnou implementaci pro aplikaci, která hostuje více DesignSurface objektů.

Třídu DesignSurface lze použít samostatně nebo uživatel může odvodit novou třídu z ní a rozšířit chování.

Třída DesignSurface poskytuje několik služeb v době návrhu automaticky. Třída DesignSurface přidá všechny své služby v jeho konstruktoru. Většinu těchto služeb je možné přepsat nahrazením v chráněné ServiceContainer vlastnosti. Chcete-li nahradit službu, přepsat konstruktor, zavolat základ a provést jakékoli změny prostřednictvím chráněné ServiceContainer vlastnosti. Všechny služby, které jsou přidány do kontejneru služby a které implementují IDisposable , jsou uvolněny při odstranění návrhové plochy. Výchozí sada nahraditelných služeb, které třída poskytuje, DesignSurface je uvedena v následující tabulce.

Service Description
IExtenderProviderService Povolí objekty, které nejsou součástí kolekce komponent kontejneru, aby poskytovaly vlastní zprostředkovatele extenderu.
IExtenderListService TypeDescriptor Používá se k získání seznamu poskytovatelů extenderů. S touto službou můžou poskytovatelé extenderů žít mimo kontejner.
ITypeDescriptorFilterService Poskytuje háky metadat návrháře. Toto je primární rozhraní pro filtrování metadat.
ISelectionService Poskytuje způsob, jak vybrat komponenty v návrháři.
IReferenceService Poskytuje způsob, jak získat název pro objekty, i když tyto objekty nejsou webovány.
DesignSurface Nabízí návrhovou plochu jako službu.
DesignerOptionService Poskytuje základní třídu pro získání a nastavení hodnot možností pro návrháře.

Následující tabulka uvádí nenahrazovatelné služby poskytované ve výchozím nastavení.

Service Description
IComponentChangeService Vyvolává události při změnách komponent.
IDesignerHost Řídí přístup k typům, službám a transakcím. Primární rozhraní pro návrháře
IContainer Vlastní sadu komponent, které jsou navrženy. Každý návrhář má součásti IContainer , které vlastní.
IServiceContainer Odvozuje od IServiceProvider návrháře a poskytuje způsob, jak přidat a odebrat služby z návrháře.

Kromě těchto služeb DesignSurface třída také poskytuje jednu službu, která je k dispozici prostřednictvím lokality komponenty. Tato služba je jedinečná pro každou komponentu. Následující tabulka uvádí služby, které nelze nahradit.

Service Description
IDictionaryService Obecný slovník párů klíč/hodnota, které lze použít k ukládání libovolných dat o komponentě.
INestedContainer Kontejner, který komponentě umožňuje přidat do návrháře další podřízené komponenty. Tyto komponenty budou součástí návrhové plochy, ale nebudou se účastnit serializace. To je užitečné, když chcete navrhnout ovládací prvek, který je schopen vystavit oblast sebe sama v návrháři, ale nechcete, aby se oblast účastnila serializace.

Kromě ISitetoho lokalita také implementuje následující rozhraní.

Upozornění

Zkontrolujte existenci těchto rozhraní a nepoužívejte nerozlišující přetypování, protože jiné implementace lokality je nemusí implementovat.

Service Description
IServiceContainer Poskytuje způsob, jak se dostat ke kontejneru služeb specifických pro lokalitu. Jedná se například IDictionaryService o službu specifickou pro lokalitu. Pomocí této služby můžete přidat další služby specifické pro web.

Konstruktory

Name Description
DesignSurface()

Inicializuje novou instanci DesignSurface třídy.

DesignSurface(IServiceProvider, Type)

Inicializuje novou instanci DesignSurface třídy.

DesignSurface(IServiceProvider)

Inicializuje novou instanci DesignSurface třídy.

DesignSurface(Type)

Inicializuje novou instanci DesignSurface třídy.

Vlastnosti

Name Description
ComponentContainer

Získá implementaci IContainer v návrhové ploše.

DtelLoading

Získá hodnotu označující, zda se načítá seznam chyb v době návrhu .

IsLoaded

Získá hodnotu určující, zda návrhová plocha je aktuálně načtena.

LoadErrors

Vrátí kolekci chyb načítání nebo kolekce void.

ServiceContainer

Získá kontejner služby.

View

Získá zobrazení pro kořenový návrhář.

Metody

Name Description
BeginLoad(DesignerLoader)

Zahájí proces načítání s daným zavaděčem návrháře.

BeginLoad(Type)

Zahájí proces načítání.

CreateComponent(Type)
Zastaralé.

Vytvoří instanci komponenty.

CreateDesigner(IComponent, Boolean)

Vytvoří návrháře při přidání komponenty do kontejneru.

CreateInstance(Type)

Vytvoří instanci daného typu.

CreateNestedContainer(IComponent, String)

Vytvoří kontejner vhodný pro vnoření ovládacích prvků nebo součástí.

CreateNestedContainer(IComponent)

Vytvoří kontejner vhodný pro vnoření ovládacích prvků nebo součástí.

Dispose()

Uvolní prostředky používané nástrojem DesignSurface.

Dispose(Boolean)

Uvolní prostředky používané nástrojem DesignSurface.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
Flush()

Serializuje změny návrhové plochy.

GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetService(Type)

Získá službu z kontejneru služby.

GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
OnLoaded(LoadedEventArgs)

Loaded Vyvolá událost.

OnLoading(EventArgs)

Loading Vyvolá událost.

OnUnloaded(EventArgs)

Unloaded Vyvolá událost.

OnUnloading(EventArgs)

Unloading Vyvolá událost.

OnViewActivate(EventArgs)

ViewActivated Vyvolá událost.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Událost

Name Description
Disposed

Nastane, když je plocha návrhu uvolněna.

Flushed

Nastane při volání Flush() metody DesignSurface.

Loaded

Nastane, když se dokončí načtení návrháře.

Loading

Nastane, když se návrhář chystá načíst.

Unloaded

Nastane, když návrhář dokončí uvolnění.

Unloading

Nastane, když se návrhář chystá uvolnit.

ViewActivated

Nastane, když Activate() metoda byla volána IDesignerHost.

Platí pro

Viz také