DesignSurface Třída

Definice

Obor názvů:

System.ComponentModel.Design

Sestavení:

System.Windows.Forms.Design.dll

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

public ref class DesignSurface : IDisposable, IServiceProvider

public class DesignSurface : IDisposable, IServiceProvider

type DesignSurface = class
    interface IDisposable
    interface IServiceProvider

Public Class DesignSurface
Implements IDisposable, IServiceProvider

Dědičnost

Object

DesignSurface

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

Viz také

• IDesignerHost
• IServiceProvider
• DesignerLoader
• IDesignerLoaderService