DesignSurface Klass

Definition

Visar ett användargränssnitt för att utforma komponenter.

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
Arv
DesignSurface
Attribut
Implementeringar

Kommentarer

Klassen DesignSurface implementerar det som användaren uppfattar som en designer. DesignSurface är användargränssnittet som användaren manipulerar för att ändra designtidsfunktioner. DesignSurface ger en helt fristående designyta.

Klassen DesignSurface kan användas som fristående designer, eller så kan den DesignSurfaceManager kopplas till klassen för att tillhandahålla en gemensam implementering för ett program som är värd för flera DesignSurface objekt.

Klassen DesignSurface kan användas av sig själv, eller så kan användaren härleda en ny klass från den och utöka beteendet.

Klassen DesignSurface tillhandahåller flera designtidstjänster automatiskt. Klassen DesignSurface lägger till alla sina tjänster i konstruktorn. De flesta av dessa tjänster kan åsidosättas genom att ersätta dem i den skyddade ServiceContainer egenskapen. Om du vill ersätta en tjänst åsidosätter du konstruktorn, anropar basen och gör ändringar via den skyddade ServiceContainer egenskapen. Alla tjänster som läggs till i tjänstcontainern och som implementeras IDisposable tas bort när designytan tas bort. Standarduppsättningen med utbytbara tjänster som DesignSurface klassen tillhandahåller visas i följande tabell.

Tjänst Description
IExtenderProviderService Gör det möjligt för objekt som inte ingår i containerns komponentsamling att tillhandahålla sina egna förlängarproviders.
IExtenderListService Används av TypeDescriptor för att hämta en lista över förlängarproviders. Med den här tjänsten kan förlängarproviders leva utanför containern.
ITypeDescriptorFilterService Tillhandahåller designermetadatakrokar. Det här är det primära gränssnittet för metadatafiltrering.
ISelectionService Ger ett sätt att välja komponenter i designern.
IReferenceService Ger ett sätt att hämta ett namn för objekt, även om dessa objekt inte är platsade.
DesignSurface Erbjuder själva designytan som en tjänst.
DesignerOptionService Tillhandahåller en basklass för att hämta och ange alternativvärden för en designer.

I följande tabell visas de tjänster som inte kan ersättas som standard.

Tjänst Description
IComponentChangeService Genererar händelser när ändringar görs i komponenter.
IDesignerHost Styr åtkomsten till typer, tjänster och transaktioner. Primärt gränssnitt för designers.
IContainer Äger den uppsättning komponenter som utformas. Varje designer har en IContainer som äger komponenterna.
IServiceContainer Härleds från IServiceProvider och ger ett sätt att lägga till och ta bort tjänster från designern.

Förutom dessa tjänster DesignSurface tillhandahåller klassen även en enda tjänst som är tillgänglig via en komponents webbplats. Den här tjänsten är unik för varje komponent. I följande tabell visas de tjänster som inte kan ersättas.

Tjänst Description
IDictionaryService En allmän ordlista med nyckel/värde-par som kan användas för att lagra godtyckliga data om en komponent.
INestedContainer En container som gör det möjligt för en komponent att lägga till ytterligare underordnade komponenter i designern. Dessa komponenter kommer att ingå i designytan, men de kommer inte att delta i serialiseringen. Det här är användbart när du vill utforma en kontroll som kan exponera en region i en designer, men du inte vill att regionen ska delta i serialiseringen.

Förutom ISiteimplementerar webbplatsen även följande gränssnitt.

Caution

Kontrollera att dessa gränssnitt finns i stället för att använda urskillningslös gjutning eftersom andra platsimplementeringar kanske inte implementerar dem.

Tjänst Description
IServiceContainer Ger ett sätt att komma till containern med platsspecifika tjänster. Till exempel IDictionaryService är en platsspecifik tjänst. Med den här tjänsten kan du lägga till ytterligare platsspecifika tjänster.

Konstruktorer

Name Description
DesignSurface()

Initierar en ny instans av DesignSurface klassen.

DesignSurface(IServiceProvider, Type)

Initierar en ny instans av DesignSurface klassen.

DesignSurface(IServiceProvider)

Initierar en ny instans av DesignSurface klassen.

DesignSurface(Type)

Initierar en ny instans av DesignSurface klassen.

Egenskaper

Name Description
ComponentContainer

Hämtar implementeringen IContainer inom designytan.

DtelLoading

Hämtar ett värde som anger om fellistan designtid läses in.

IsLoaded

Hämtar ett värde som anger om designytan för närvarande är inläst.

LoadErrors

Returnerar en samling inläsningsfel eller en void-samling.

ServiceContainer

Hämtar tjänstcontainern.

View

Hämtar vyn för rotdesignern.

Metoder

Name Description
BeginLoad(DesignerLoader)

Påbörjar inläsningsprocessen med den angivna designerinläsaren.

BeginLoad(Type)

Påbörjar inläsningsprocessen.

CreateComponent(Type)
Föråldrad.

Skapar en instans av en komponent.

CreateDesigner(IComponent, Boolean)

Skapar en designer när en komponent läggs till i containern.

CreateInstance(Type)

Skapar en instans av den angivna typen.

CreateNestedContainer(IComponent, String)

Skapar en container som lämpar sig för kapsling av kontroller eller komponenter.

CreateNestedContainer(IComponent)

Skapar en container som lämpar sig för kapsling av kontroller eller komponenter.

Dispose()

Släpper de resurser som används av DesignSurface.

Dispose(Boolean)

Släpper de resurser som används av DesignSurface.

Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Flush()

Serialiserar ändringar i designytan.

GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetService(Type)

Hämtar en tjänst från tjänstcontainern.

GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnLoaded(LoadedEventArgs)

Genererar händelsen Loaded .

OnLoading(EventArgs)

Genererar händelsen Loading .

OnUnloaded(EventArgs)

Genererar händelsen Unloaded .

OnUnloading(EventArgs)

Genererar händelsen Unloading .

OnViewActivate(EventArgs)

Genererar händelsen ViewActivated .

ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Händelser

Name Description
Disposed

Inträffar när designytan tas bort.

Flushed

Inträffar när ett anrop görs till Flush() metoden DesignSurface.

Loaded

Inträffar när designerbelastningen har slutförts.

Loading

Inträffar när designern är på väg att läsas in.

Unloaded

Inträffar när en designer har avslutat avlastningen.

Unloading

Inträffar när en designer håller på att ta bort.

ViewActivated

Inträffar när Activate() metoden har anropats på IDesignerHost.

Gäller för

Se även