DesignerActionService DesignerActionService DesignerActionService DesignerActionService Class

Definition

Richtet einen Dienst zur Entwurfszeit ein, der die Auflistung der DesignerActionItem-Objekte für Komponenten verwaltet.Establishes a design-time service that manages the collection of DesignerActionItem objects for components.

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

Hinweise

Die DesignerActionService -Klasse ist für die Verwaltung der Auflistung DesignerActionItem von-Objekten für jede Instanz einer Komponente zuständig, die zur Entwurfszeit in einem Formular vorhanden ist.The DesignerActionService class is responsible for managing the collection of DesignerActionItem objects for each instance of a component that exists on a form at design time. Diese Klasse ermöglicht ein direktes Push-Modell der Element Erstellung und ist hauptsächlich für die Verwendung durch Entwickler von Entwurfszeit Tools vorgesehen, obwohl Sie auch von Komponenten-und benutzerdefinierten Steuerelement Entwicklern verwendet werden kann.This class enables a direct push model of item creation, and is primarily intended for use by design-time tool developers, although it can also be used by component and custom control developers.

Entwickler des Entwurfszeit Tools müssen die Liste der Elemente bestimmen, die für eine Komponente angezeigt werden sollen, und bestimmen, wann diese Liste geändert wird.Design-time tool developers will need to determine the list of items to display for a component and determine when this list changes. Sie können auch Add-Ins erstellen, die in Verbindung mit smarttagpanel-Objekten arbeiten.They may also create add-ins that operate in conjunction with smart tag panel objects.

Erweiterte Komponenten Entwickler müssen möglicherweise die einer Komponente zugeordneten Elemente dynamisch Steuern und so das Standard-Pullmodell ersetzen oder ergänzen.Advanced component developers may need to dynamically control the items associated with a component, thus replacing or supplementing the standard pull model. Beispielsweise können Panel-Befehle abhängig vom Kontext ihrer Verwendung und des Entwurfszeit Status der Komponente geändert werden.For example, panel commands can be altered depending on the context of their use and the design-time state of the component.

Hinweis

Der DesignerActionService ist tatsächlich der treibende Dienst hinter den Push-und Pull-Modellen, aber im letzteren Fall wird er implizit betrieben.The DesignerActionService is actually the driving service behind both the push and pull models; however, in the latter case it operates implicitly.

DesignerActionServicebietet eine einfache Schnittstelle für den Zugriff auf und die Bearbeitung der Elemente für jede Komponente, einschließlich der folgenden Methoden und Ereignisse:DesignerActionService provides a straightforward interface for accessing and manipulating the items for each component, including the following methods and events:

  • Die Contains -Methode bestimmt, DesignerActionService ob gerade eine bestimmte Komponente verwaltet.The Contains method determines whether the DesignerActionService is currently managing a particular component.

  • Die GetComponentActions -Methode unterstützt die Enumeration der Listen von Elementen.The GetComponentActions method supports the enumeration of the lists of items.

  • Die Add -Methode ermöglicht das DesignerActionList hinzu DesignerActionListCollection fügen von oder zum Satz vorhandener Elemente für eine Komponenteninstanz.The Add method allows adding a DesignerActionList or DesignerActionListCollection to the set of existing items for a component instance. Im Gegensatz dazu entfernt Remove die-Methode eine oder alle Element Listen, die einer Komponente zugeordnet sind.In contrast, the Remove method removes one or all of the item lists associated with a component.

    Hinweis

    Die Add -Methode stellt das direkte Push-Modell der Zuordnung von Panel Elementen zu einer Komponente dar.The Add method represents the direct push model of associating panel items with a component. Im Gegensatz dazu setzt das Pull-Modell die ActionLists -Eigenschaft der Designer-Klasse für diese Komponente außer Kraft.In contrast, the pull model relies on overriding the ActionLists property of the designer class for that component. Die Entwurfs Umgebung ist für das Hinzufügen dieser Elemente zum aktuellen DesignerActionService verantwortlich, wenn eine Komponente auf der Entwurfs Oberfläche erstellt wird.The design environment is responsible for adding these items into the current DesignerActionService when a component is created on the design surface.

    Wichtig

    Die Add- Remove ,-Clear ,-und-Methoden können nurpushmodellelementeinErwägunggezogenoderbetreffen.ContainsThe Add, Remove, Contains, and Clear methods only consider or affect push-model items.

  • Das DesignerActionListsChanged -Ereignis gibt an, wann die Auflistung von Elementen für eine Komponente geändert wird.The DesignerActionListsChanged event indicates when the collection of items changes for a component.

Da es häufig wünschenswert ist, einige der gleichen Panel Elemente sowohl im Entwurfszeit-Kontextmenü der Komponente als auch in Ihrem Panel zu verwenden, besteht ein großer Grad an DesignerActionItem Interoperabilität zwischen Objekten und Designer Verben.Because it is often desirable to use some of the same panel items in both the component's design-time shortcut menu and its panel, a large degree of interoperability exists between DesignerActionItem objects and designer verbs.

Wenn ein Komponenten-Designer nicht explizit einen DesignerActionList angibt (d. h., er enthält keine überschriebene ActionLists Eigenschaft), wird eine Liste aus vorhandenen Designer Verben erstellt.If a component designer does not explicitly specify a DesignerActionList (that is, it does not contain an overridden ActionLists property), then a list will be created from existing designer verbs. Diese Verben werden von der Verbs -Eigenschaft angegeben.These verbs are specified by the Verbs property. In diesem Fall wird eine interne Verb List-Klasse verwendet, um die Auflistung von Verb Element-Bereichs Einträgen zu enthalten.In this case, an internal verb list class is used to contain the collection of verb item panel entries.

Wenn Sie sowohl als DesignerActionMethodItem Bereichs Eintrag als auch als Kontextmenü Eintrag für die Entwurfszeit Verwendung verwenden möchten, können Sie den includeAsDesignerVerb -Parameter im Konstruktor des Elements festlegen.If you want a DesignerActionMethodItem to be used both as a panel entry and a design-time shortcut menu entry, then you can set the includeAsDesignerVerb parameter in the item's constructor.

Verwenden Sie ActionLists, um die Anzeige des Designers zu steuern. DesignerActionUIServiceUse the DesignerActionUIService to control the display of your designer's ActionLists.

Konstruktoren

DesignerActionService(IServiceProvider) DesignerActionService(IServiceProvider) DesignerActionService(IServiceProvider) DesignerActionService(IServiceProvider)

Initialisiert eine neue Instanz der DesignerActionService-Klasse.Initializes a new instance of the DesignerActionService class.

Methoden

Add(IComponent, DesignerActionList) Add(IComponent, DesignerActionList) Add(IComponent, DesignerActionList) Add(IComponent, DesignerActionList)

Fügt der aktuellen Auflistung verwalteter Smarttags eine DesignerActionList hinzu.Adds a DesignerActionList to the current collection of managed smart tags.

Add(IComponent, DesignerActionListCollection) Add(IComponent, DesignerActionListCollection) Add(IComponent, DesignerActionListCollection) Add(IComponent, DesignerActionListCollection)

Fügt der aktuellen Auflistung verwalteter Smarttags eine DesignerActionListCollection hinzu.Adds a DesignerActionListCollection to the current collection of managed smart tags.

Clear() Clear() Clear() Clear()

Gibt alle Komponenten von der Verwaltung frei und löscht alle Pushmodellsmarttaglisten.Releases all components from management and clears all push-model smart tag lists.

Contains(IComponent) Contains(IComponent) Contains(IComponent) Contains(IComponent)

Bestimmt, ob der aktuelle Smarttagdienst die Aktionslisten für die angegebene Komponente verwaltet.Determines whether the current smart tag service manages the action lists for the specified component.

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der DesignerActionService-Klasse verwendeten Ressourcen frei.Releases all resources used by the DesignerActionService class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von DesignerActionService verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the DesignerActionService and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetComponentActions(IComponent) GetComponentActions(IComponent) GetComponentActions(IComponent) GetComponentActions(IComponent)

Gibt die Auflistung von einer Komponente zugeordneten Smarttagelementlisten zurück.Returns the collection of smart tag item lists associated with a component.

GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType)

Gibt die Auflistung von Smarttagelementlisten des angegebenen Typs zurück, der einer Komponente zugeordnet ist.Returns the collection of smart tag item lists of the specified type associated with a component.

GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType)
GetComponentDesignerActions(IComponent, DesignerActionListCollection) GetComponentDesignerActions(IComponent, DesignerActionListCollection) GetComponentDesignerActions(IComponent, DesignerActionListCollection) GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Ruft die einer Komponente zugeordneten Pullmodellsmarttags ab.Retrieves the pull-model smart tags associated with a component.

GetComponentServiceActions(IComponent, DesignerActionListCollection) GetComponentServiceActions(IComponent, DesignerActionListCollection) GetComponentServiceActions(IComponent, DesignerActionListCollection) GetComponentServiceActions(IComponent, DesignerActionListCollection)

Ruft die einer Komponente zugeordneten Pushmodellsmarttags ab.Retrieves the push-model smart tags associated with a component.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(DesignerActionList) Remove(DesignerActionList) Remove(DesignerActionList) Remove(DesignerActionList)

Entfernt die angegebene Smarttagliste aus allen vom aktuellen Dienst verwalteten Komponenten.Removes the specified smart tag list from all components managed by the current service.

Remove(IComponent) Remove(IComponent) Remove(IComponent) Remove(IComponent)

Entfernt alle der angegebenen Komponente zugeordneten Smarttaglisten.Removes all the smart tag lists associated with the specified component.

Remove(IComponent, DesignerActionList) Remove(IComponent, DesignerActionList) Remove(IComponent, DesignerActionList) Remove(IComponent, DesignerActionList)

Entfernt die angegebene Smarttagliste aus der angegebenen Komponente.Removes the specified smart tag list from the specified component.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

DesignerActionListsChanged DesignerActionListsChanged DesignerActionListsChanged DesignerActionListsChanged

Tritt auf, wenn eine DesignerActionList für eine Komponente entfernt oder hinzugefügt wird.Occurs when a DesignerActionList is removed or added for any component.

Gilt für:

Siehe auch