DesignerActionService Klasse

  • Referenz

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.Design.dll
Assembly:
System.Windows.Forms.Design.dll

Richtet einen Dienst zur Entwurfszeit ein, der die Auflistung der DesignerActionItem-Objekte für Komponenten verwaltet.

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
Vererbung
Object
DesignerActionService
Abgeleitet
Implementiert
IDisposable

Hinweise

Die DesignerActionService -Klasse ist für die Verwaltung der Auflistung von DesignerActionItem -Objekten für jede instance einer Komponente verantwortlich, die zur Entwurfszeit in einem Formular vorhanden ist. Diese Klasse ermöglicht ein direktes Pushmodell der Elementerstellung und ist in erster Linie für die Verwendung durch Entwickler von Entwurfszeittools vorgesehen, kann aber auch von Komponenten- und benutzerdefinierten Steuerelemententwicklern verwendet werden.

Entwickler von Entwurfszeittools müssen die Liste der Elemente bestimmen, die für eine Komponente angezeigt werden sollen, und bestimmen, wann sich diese Liste ändert. Sie können auch Add-Ins erstellen, die in Verbindung mit Smarttagpanel-Objekten funktionieren.

Entwickler von erweiterten Komponenten müssen möglicherweise die elemente, die einer Komponente zugeordnet sind, dynamisch steuern und so das Standard pull model ersetzen oder ergänzen. Beispielsweise können Panelbefehle abhängig vom Kontext ihrer Verwendung und dem Entwurfszeitzustand der Komponente geändert werden.

Hinweis

Der DesignerActionService ist eigentlich der Fahrdienst hinter dem Push- und Pull-Modell, aber im letzteren Fall funktioniert er implizit.

DesignerActionService bietet eine einfache Schnittstelle zum Zugreifen auf und Bearbeiten der Elemente für jede Komponente, einschließlich der folgenden Methoden und Ereignisse:

  • Die Contains -Methode bestimmt, ob derzeit DesignerActionService eine bestimmte Komponente verwaltet wird.

  • Die GetComponentActions -Methode unterstützt die Enumeration der Listen von Elementen.

  • Die Add -Methode ermöglicht das Hinzufügen eines DesignerActionList oder DesignerActionListCollection zum Satz vorhandener Elemente für eine Komponente instance. Im Gegensatz dazu entfernt die Remove -Methode eine oder alle Elementlisten, die einer Komponente zugeordnet sind.

    Hinweis

    Die Add -Methode stellt das direkte Pushmodell zum Zuordnen von Panelelementen zu einer Komponente dar. Im Gegensatz dazu basiert das Pullmodell darauf, die ActionLists Eigenschaft der Designerklasse für diese Komponente zu überschreiben. Die Entwurfsumgebung ist für das Hinzufügen dieser Elemente in den aktuellen DesignerActionService verantwortlich, wenn eine Komponente auf der Entwurfsoberfläche erstellt wird.

    Wichtig

    Die AddMethoden , Remove, Contains, und Clear berücksichtigen oder wirken sich nur auf Pushmodellelemente aus.

  • Das DesignerActionListsChanged -Ereignis gibt an, wenn sich die Auflistung von Elementen für eine Komponente ändert.

Da es häufig wünschenswert ist, einige der gleichen Panelelemente sowohl im Entwurfszeit-Kontextmenü der Komponente als auch im zugehörigen Bereich zu verwenden, besteht ein hohes Maß an Interoperabilität zwischen DesignerActionItem Objekten und Designerverben.

Wenn ein Komponenten-Designer nicht explizit einen DesignerActionList angibt (d. h. keine überschriebene ActionLists Eigenschaft enthält), wird eine Liste aus vorhandenen Designerverben erstellt. Diese Verben werden durch die Verbs -Eigenschaft angegeben. In diesem Fall wird eine interne Verblistenklasse verwendet, um die Auflistung von Verbelementbereichseinträgen zu enthalten.

Wenn Ein sowohl als Paneleintrag als auch als Kontextmenüeintrag zur Entwurfszeit verwendet werden soll DesignerActionMethodItem , können Sie den includeAsDesignerVerb Parameter im Konstruktor des Elements festlegen.

Verwenden Sie den DesignerActionUIService , um die Anzeige ihres Designers ActionListszu steuern.

Konstruktoren

DesignerActionService(IServiceProvider)

Initialisiert eine neue Instanz der DesignerActionService-Klasse.

Methoden

Add(IComponent, DesignerActionList)

Fügt der aktuellen Auflistung verwalteter Smarttags eine DesignerActionList hinzu.
Add(IComponent, DesignerActionListCollection)

Fügt der aktuellen Auflistung verwalteter Smarttags eine DesignerActionListCollection hinzu.
Clear()

Gibt alle Komponenten von der Verwaltung frei und löscht alle Pushmodellsmarttaglisten.
Contains(IComponent)

Bestimmt, ob der aktuelle Smarttagdienst die Aktionslisten für die angegebene Komponente verwaltet.
Dispose()

Gibt alle von der DesignerActionService-Klasse verwendeten Ressourcen frei.
Dispose(Boolean)

Gibt die von DesignerActionService verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetComponentActions(IComponent)

Gibt die Auflistung von einer Komponente zugeordneten Smarttagelementlisten zurück.
GetComponentActions(IComponent, ComponentActionsType)

Gibt die Auflistung von Smarttagelementlisten des angegebenen Typs zurück, der einer Komponente zugeordnet ist.
GetComponentActions(IComponent, ComponentActionsType)

Gibt die Auflistung der Designeraktionselementlisten des angegebenen Typs zurück, der einer Komponente zugeordnet ist.
GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Ruft die einer Komponente zugeordneten Pullmodellsmarttags ab.
GetComponentServiceActions(IComponent, DesignerActionListCollection)

Ruft die einer Komponente zugeordneten Pushmodellsmarttags ab.
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Remove(DesignerActionList)

Entfernt die angegebene Smarttagliste aus allen vom aktuellen Dienst verwalteten Komponenten.
Remove(IComponent)

Entfernt alle der angegebenen Komponente zugeordneten Smarttaglisten.
Remove(IComponent, DesignerActionList)

Entfernt die angegebene Smarttagliste aus der angegebenen Komponente.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Ereignisse

DesignerActionListsChanged

Tritt auf, wenn eine DesignerActionList für eine Komponente entfernt oder hinzugefügt wird.

Gilt für:

Weitere Informationen