DesignerActionService DesignerActionService DesignerActionService DesignerActionService Class

Definition

Richtet einen Entwurfszeit-Dienst, der die Auflistung der verwaltet DesignerActionItem -Objekte für Komponenten.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 dient zum Verwalten der Auflistung der DesignerActionItem Objekte für jede Instanz einer Komponente, die in einem Formular zur Entwurfszeit 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, dass eine direct Pushmodell der Erstellung des Eintrags, und ist hauptsächlich für die Verwendung von Entwicklern während der Entwurfszeit-Tool, obwohl es auch von der Komponente und Entwickler von benutzerdefinierten Steuerelementen 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.

Bestimmen die Liste der Elemente, die für eine Komponente anzuzeigen und zu bestimmen, wann diese Liste ändert sich müssen während der Entwurfszeit die Entwickler.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, die ausgeführt werden erstellen, in Verbindung mit der Smarttag-Bereich-Objekten.They may also create add-ins that operate in conjunction with smart tag panel objects.

Erweiterte Komponente, die Entwickler möglicherweise eine Komponente gehörigen Elemente dynamisch zu steuern. daher ersetzen oder ergänzen die standard-Pull-Modell müssen.Advanced component developers may need to dynamically control the items associated with a component, thus replacing or supplementing the standard pull model. Panel-Befehlen können z. B. je nach Zusammenhang, deren Verwendung und die 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

Die DesignerActionService ist tatsächlich der fahrmuster – Dienst, sowohl die Push-und Pull; allerdings im zweiten Fall sie implizit ausgeführt wird.The DesignerActionService is actually the driving service behind both the push and pull models; however, in the latter case it operates implicitly.

DesignerActionService bietet eine einfache Schnittstelle zum Aufrufen und bearbeiten die 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, ob die DesignerActionService wird zurzeit von einer bestimmten 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 Hinzufügen einer DesignerActionList oder DesignerActionListCollection auf den Satz von vorhandenen Elementen für eine Instanz der Komponente.The Add method allows adding a DesignerActionList or DesignerActionListCollection to the set of existing items for a component instance. Im Gegensatz dazu die Remove Methode entfernt einen oder alle der einer Komponente zugeordneten Elementlisten.In contrast, the Remove method removes one or all of the item lists associated with a component.

    Hinweis

    Die Add Methode darstellt, das direct Push-Modell von Panel-Elemente mit einer Komponente.The Add method represents the direct push model of associating panel items with a component. Im Gegensatz dazu Pull-Modell basiert, überschreiben die ActionLists Eigenschaft der Designer-Klasse für die jeweilige Komponente.In contrast, the pull model relies on overriding the ActionLists property of the designer class for that component. Die entwurfsumgebung ist verantwortlich für das Hinzufügen dieser Elemente in der aktuellen DesignerActionService Wenn eine Komponente auf der Entwurfsoberflä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, Contains, und Clear Methoden berücksichtigen und Push-Modell Elemente beeinflussen nur.The Add, Remove, Contains, and Clear methods only consider or affect push-model items.

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

Da es oft wünschenswert sein ist, einige der in der Komponente zur Entwurfszeit Kontextmenü und dessen Bereich die gleichen Panel-Elemente verwenden, gibt es ein hohes Maß an Interoperabilität zwischen DesignerActionItem Objekte und Designerverben.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 angeben, wird eine DesignerActionList (d. h., er enthält keine überschriebene ActionLists Eigenschaft), und klicken Sie dann eine Liste von vorhandenen Designerverben erstellt wird.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 angegeben, indem die Verbs Eigenschaft.These verbs are specified by the Verbs property. In diesem Fall wird eine interne Verb-List-Klasse verwendet, auf die Auflistung von bereichseinträgen für Verb-Element enthalten.In this case, an internal verb list class is used to contain the collection of verb item panel entries.

Wenn Sie möchten eine DesignerActionMethodItem sowohl als Bereichseintrag und als während der Entwurfszeit Kontextmenüeintrag verwendet werden, können Sie festlegen der includeAsDesignerVerb Parameter im Konstruktor des Elements.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 der DesignerActionUIService zum Steuern der Anzeige des Designers ActionLists.Use 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 eine DesignerActionList mit der aktuellen Auflistung verwalteter Smarttags.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 eine DesignerActionListCollection mit der aktuellen Auflistung verwalteter Smarttags.Adds a DesignerActionListCollection to the current collection of managed smart tags.

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

Alle Komponenten von der Verwaltung frei und löscht alle Pushmodellsmarttaglisten Smarttaglisten.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 Smarttagelementlisten, der mit einer Komponente 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 der Smarttag-Elementlisten vom angegebenen Typ einer Komponente zugeordneten zurück.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 Smarttags ab.Retrieves the pull-model smart tags associated with a component.

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

Ruft ab, der die Smarttags Push-Modell, einer Komponente zugeordneten.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 Komponenten, die vom aktuellen Dienst verwaltet werden.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 entfernt oder für eine Komponente hinzugefügt wird.Occurs when a DesignerActionList is removed or added for any component.

Gilt für:

Siehe auch