DesignSurface Osztály

Definíció

Névtér:
System.ComponentModel.Design
Szerelvény:
System.Design.dll
Szerelvény:
System.Windows.Forms.Design.dll
Szerelvények:
System.Design.dll, System.Windows.Forms.Design.dll
Forrás:
DesignSurface.cs
Forrás:
DesignSurface.cs
Forrás:
DesignSurface.cs
Forrás:
DesignSurface.cs
Forrás:
DesignSurface.cs

Egy felhasználói felületet jelenít meg az összetevők tervezéséhez.

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
Öröklődés
Object
DesignSurface
Attribútumok
SecurityCriticalAttribute
Megvalósítás
IDisposable IServiceProvider

Megjegyzések

Az DesignSurface osztály megvalósítja, amit a felhasználó tervezőként érzékel. DesignSurface az a felhasználói felület, amelyet a felhasználó módosít a tervezési idő funkcióinak módosításához. DesignSurface teljesen önálló tervezési felületet biztosít.

Az DesignSurface osztály használható önálló tervezőként, vagy összekapcsolható az DesignSurfaceManager osztálysal, hogy közös implementációt biztosítson egy több DesignSurface objektumot üzemeltető alkalmazáshoz.

Az DesignSurface osztály önmagában is használható, vagy a felhasználó egy új osztályt is leküldhet belőle, és bővítheti a viselkedést.

Az DesignSurface osztály automatikusan számos tervezési időt biztosító szolgáltatást biztosít. Az DesignSurface osztály az összes szolgáltatást hozzáadja a konstruktorhoz. Ezeknek a szolgáltatásoknak a többségét felül lehet bírálni, ha lecseréli őket a védett ServiceContainer tulajdonságra. Egy szolgáltatás cseréjéhez felülbírálja a konstruktort, hívja meg az alapt, és végezze el a módosításokat a védett ServiceContainer tulajdonságon keresztül. A szolgáltatástárolóhoz hozzáadott és a megvalósításhoz IDisposable hozzáadott összes szolgáltatás a tervezési felület ártalmatlanításakor lesz megsemmisítve. Az osztály által biztosított lecserélhető szolgáltatások DesignSurface alapértelmezett készlete az alábbi táblázatban látható.

Szolgáltatás Leírás
IExtenderProviderService Lehetővé teszi, hogy a tároló összetevőinek gyűjteményéhez nem tartozó objektumok saját bővítőszolgáltatókat biztosítsanak.
IExtenderListService A TypeDescriptor bővítőszolgáltatók listájának lekéréséhez használható. Ezzel a szolgáltatással a bővítőszolgáltatók a tárolón kívül is élhetnek.
ITypeDescriptorFilterService Tervezői metaadat-horgokat biztosít. Ez a metaadatok szűrésének elsődleges felülete.
ISelectionService Lehetővé teszi az összetevők kiválasztását a tervezőben.
IReferenceService Lehetővé teszi az objektumok nevének lekérését, még akkor is, ha ezek az objektumok nincsenek helyhez adva.
DesignSurface A tervezési felületet szolgáltatásként kínálja.
DesignerOptionService Alaposztályt biztosít a tervezők beállításértékeinek lekéréséhez és beállításához.

Az alábbi táblázat az alapértelmezés szerint biztosított nem cserélhető szolgáltatásokat mutatja be.

Szolgáltatás Leírás
IComponentChangeService Eseményeket hoz elő az összetevők módosításakor.
IDesignerHost Szabályozza a típusokhoz, szolgáltatásokhoz és tranzakciókhoz való hozzáférést. Elsődleges felület tervezőknek.
IContainer A tervezett összetevők készletének tulajdonosa. Minden tervező rendelkezik az IContainer összetevők tulajdonosával.
IServiceContainer A szolgáltatások tervezőből való IServiceProvider hozzáadásának és eltávolításának módja.

Ezen szolgáltatások mellett az DesignSurface osztály egyetlen szolgáltatást is biztosít, amely egy összetevő webhelyén keresztül érhető el. Ez a szolgáltatás minden összetevőhöz egyedi. Az alábbi táblázat a nem lecserélhető szolgáltatásokat mutatja be.

Szolgáltatás Leírás
IDictionaryService Kulcs/érték párok általános szótára, amely tetszőleges adatok tárolására használható egy összetevőről.
INestedContainer Tároló, amely lehetővé teszi, hogy egy összetevő további gyermekösszetevőket adjon hozzá a tervezőhöz. Ezek az összetevők a tervezési felület részét képezik, de nem vesznek részt a szerializálásban. Ez akkor hasznos, ha olyan vezérlőt szeretne megtervezni, amely képes egy adott régiót megjeleníteni egy tervezőben, de nem szeretné, hogy a régió részt vegyen a szerializálásban.

ISiteEmellett a webhely a következő interfészeket is implementálja.

Figyelmeztetés

Ellenőrizze ezeknek a felületeknek a meglétét, és ne használjon válogatás nélküli öntést, mert más hely implementációi nem feltétlenül implementálják őket.

Szolgáltatás Leírás
IServiceContainer Lehetővé teszi a helyspecifikus szolgáltatások tárolójának eléréséhez. Például IDictionaryService egy helyspecifikus szolgáltatás. Ezzel a szolgáltatással további helyspecifikus szolgáltatásokat vehet fel.

Konstruktorok

Name Description
DesignSurface()

Inicializálja a DesignSurface osztály új példányát.
DesignSurface(IServiceProvider, Type)

Inicializálja a DesignSurface osztály új példányát.
DesignSurface(IServiceProvider)

Inicializálja a DesignSurface osztály új példányát.
DesignSurface(Type)

Inicializálja a DesignSurface osztály új példányát.

Tulajdonságok

Name Description
ComponentContainer

Lekéri a megvalósítást IContainer a tervezési felületen.
DtelLoading

Beolvas egy értéket, amely jelzi, hogy a tervezési idő hibalistája be van-e töltve.
IsLoaded

Egy értéket kap, amely jelzi, hogy a tervezőfelület jelenleg betöltve van-e.
LoadErrors

Betöltési hibák gyűjteményét vagy üres gyűjteményt ad vissza.
ServiceContainer

Lekéri a szolgáltatástárolót.
View

Lekéri a gyökértervező nézetét.

Metódusok

Name Description
BeginLoad(DesignerLoader)

A betöltési folyamat az adott tervezőbetöltővel kezdődik.
BeginLoad(Type)

Megkezdi a betöltési folyamatot.
CreateComponent(Type)
Elavult.

Egy összetevő egy példányát hozza létre.
CreateDesigner(IComponent, Boolean)

Tervezőt hoz létre, amikor egy összetevőt hozzáad a tárolóhoz.
CreateInstance(Type)

Létrehoz egy adott típusú példányt.
CreateNestedContainer(IComponent, String)

Vezérlők vagy összetevők beágyazására alkalmas tárolót hoz létre.
CreateNestedContainer(IComponent)

Vezérlők vagy összetevők beágyazására alkalmas tárolót hoz létre.
Dispose()

Felszabadítja a .DesignSurface
Dispose(Boolean)

Felszabadítja a .DesignSurface
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
Flush()

Szerializálja a tervezési felület módosításait.
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetService(Type)

Lekéri a szolgáltatást a szolgáltatástárolóból.
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
OnLoaded(LoadedEventArgs)

Az eseményt emeli Loaded ki.
OnLoading(EventArgs)

Az eseményt emeli Loading ki.
OnUnloaded(EventArgs)

Az eseményt emeli Unloaded ki.
OnUnloading(EventArgs)

Az eseményt emeli Unloading ki.
OnViewActivate(EventArgs)

Az eseményt emeli ViewActivated ki.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

esemény

Name Description
Disposed

Akkor fordul elő, ha a tervezőfelületet megsemmisítik.
Flushed

Akkor fordul elő, ha a metódushoz Flush()DesignSurfacehívás történik.
Loaded

Akkor következik be, ha a tervező betöltése befejeződött.
Loading

A tervező betöltésekor következik be.
Unloaded

Akkor fordul elő, ha egy tervező befejezte a kiürítést.
Unloading

Akkor fordul elő, ha egy tervező éppen ki szeretne üríteni.
ViewActivated

Akkor fordul elő, ha a Activate() metódus be IDesignerHostvan kapcsolva.

A következőre érvényes:

Lásd még