DesignSurface Třída

Definice

Představuje uživatelské rozhraní pro návrh součástí.

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 to, co uživatel vnímá jako návrhář. DesignSurface je uživatelské rozhraní, které uživatel manipuluje za účelem změny funkcí v době návrhu. DesignSurface poskytuje zcela samostatnou návrhovou plochu.

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

Třídu DesignSurface lze použít samostatně, nebo uživatel může od ní odvodit novou třídu 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 do svého konstruktoru. Většinu těchto služeb je možné přepsat tak, že je nahradíte v chráněné ServiceContainer vlastnosti. Chcete-li nahradit službu, přepište konstruktor, zavolejte základ a proveďte 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 , se odstraní 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.

Služba Popis
IExtenderProviderService Umožňuje objektům, které nejsou součástí kolekce komponent kontejneru, poskytovat vlastní zprostředkovatele rozšíření.
IExtenderListService Používá se TypeDescriptor k získání seznamu poskytovatelů extenderů. S touto službou můžou poskytovatelé rozšíření žít mimo kontejner.
ITypeDescriptorFilterService Poskytuje návrhář metadata hooks. Toto je primární rozhraní pro filtrování metadat.
ISelectionService Poskytuje způsob výběru komponent v návrháři.
IReferenceService Poskytuje způsob, jak získat název objektů, i když tyto objekty nejsou v lokalitě.
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í nenahraditelné služby poskytované ve výchozím nastavení.

Služba Popis
IComponentChangeService Vyvolá události při změnách součástí.
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é se navrhují. Každý návrhář má vlastní IContainer součásti.
IServiceContainer Je odvozen od IServiceProvider 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 pro každou komponentu jedinečná. Následující tabulka uvádí služby, které nelze nahradit.

Služba Popis
IDictionaryService Obecný slovník párů klíč/hodnota, který lze použít k ukládání libovolných dat o komponentě.
INestedContainer Kontejner, který umožňuje komponentě přidat do návrháře další podřízené komponenty. Tyto komponenty budou součástí návrhové plochy, ale nebudou se podílet na serializaci. 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ě nástroje ISiteweb implementuje také následující rozhraní.

Upozornění

Zkontrolujte, jestli tato rozhraní existují, a nepoužívejte nerozlišující přetypování, protože jiné implementace webu je nemusí implementovat.

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

Konstruktory

DesignSurface()

Inicializuje novou instanci DesignSurface třídy .

DesignSurface(IServiceProvider)

Inicializuje novou instanci DesignSurface třídy .

DesignSurface(IServiceProvider, Type)

Inicializuje novou instanci DesignSurface třídy .

DesignSurface(Type)

Inicializuje novou instanci DesignSurface třídy .

Vlastnosti

ComponentContainer

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

DtelLoading

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

IsLoaded

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

LoadErrors

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

ServiceContainer

Získá kontejner služby.

View

Získá zobrazení pro kořenového návrháře.

Metody

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ář při přidání komponenty do kontejneru.

CreateInstance(Type)

Vytvoří instanci daného typu.

CreateNestedContainer(IComponent)

Vytvoří kontejner vhodný pro vnořování ovládacích prvků nebo komponent.

CreateNestedContainer(IComponent, String)

Vytvoří kontejner vhodný pro vnořování ovládacích prvků nebo komponent.

Dispose()

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

Dispose(Boolean)

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

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

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

Serializuje změny návrhové plochy.

GetHashCode()

Slouží jako výchozí hashovací funkce.

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

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

GetType()

Type Získá z aktuální instance.

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

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

(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

Disposed

Vyvolá se při odstranění návrhové plochy.

Flushed

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

Loaded

Vyvolá se po dokončení načítání návrháře.

Loading

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

Unloaded

Vyvolá se, když návrhář dokončil uvolňování.

Unloading

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

ViewActivated

Vyvolá se při zavolání Activate() metody v .IDesignerHost

Platí pro

Viz také