DesignSurface 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í.
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. |