DesignerActionService Klas

Definitie

public ref class DesignerActionService : IDisposable

public class DesignerActionService : IDisposable

type DesignerActionService = class
    interface IDisposable

Public Class DesignerActionService
Implements IDisposable

Overname

Object

DesignerActionService

Afgeleid

System.Web.UI.Design.WebFormsDesignerActionService

Implementeringen

IDisposable

Opmerkingen

De DesignerActionService klasse is verantwoordelijk voor het beheren van DesignerActionItem de verzameling objecten voor elk exemplaar van een onderdeel dat op het ontwerptijd van een formulier aanwezig is. Deze klasse maakt een direct push-model van het maken van items mogelijk en is voornamelijk bedoeld voor gebruik door ontwikkelaars van ontwerphulpprogramma's, hoewel het ook kan worden gebruikt door onderdeel- en aangepaste controleontwikkelaars.

Ontwikkelaars van ontwerphulpprogramma's moeten de lijst met items bepalen die moeten worden weergegeven voor een onderdeel en bepalen wanneer deze lijst verandert. Ze kunnen ook invoegtoepassingen maken die werken in combinatie met smart tag panel-objecten.

Ontwikkelaars van geavanceerde onderdelen moeten mogelijk dynamisch de items beheren die zijn gekoppeld aan een onderdeel, waardoor het standaard pull-model wordt vervangen of aangevuld. Deelvensteropdrachten kunnen bijvoorbeeld worden gewijzigd, afhankelijk van de context van hun gebruik en de ontwerptijdstatus van het onderdeel.

DesignerActionService biedt een eenvoudige interface voor het openen en bewerken van de items voor elk onderdeel, inclusief de volgende methoden en gebeurtenissen:

• De Contains methode bepaalt of het DesignerActionService momenteel een bepaald onderdeel beheert.

• De GetComponentActions methode ondersteunt de opsomming van de lijsten met items.

• Met de Add methode kunt u een DesignerActionList of DesignerActionListCollection meer bestaande items voor een onderdeelexemplaren toevoegen. De methode verwijdert daarentegen Remove een of alle itemlijsten die aan een onderdeel zijn gekoppeld.

  Note

  De Add methode vertegenwoordigt het directe pushmodel voor het koppelen van paneelitems aan een onderdeel. Het pull-model is daarentegen afhankelijk van het overschrijven van de ActionLists eigenschap van de ontwerpklasse voor dat onderdeel. De ontwerpomgeving is verantwoordelijk voor het toevoegen van deze items aan de huidige DesignerActionService wanneer een onderdeel wordt gemaakt op het ontwerpoppervlak.

  Important

  De Addmethoden , Removeen ContainsClear methoden houden alleen rekening met of beïnvloeden push-modelitems.

• De DesignerActionListsChanged gebeurtenis geeft aan wanneer de verzameling items voor een onderdeel wordt gewijzigd.

Omdat het vaak wenselijk is om sommige van dezelfde paneelitems te gebruiken in het snelmenu ontwerptijd van het onderdeel en het paneel, bestaat er een grote mate van interoperabiliteit tussen DesignerActionItem objecten en ontwerpwerkwoorden.

Als een onderdeelontwerper geen expliciete eigenschap opgeeft (dat wil zeggen DesignerActionList dat deze geen overschreven ActionLists eigenschap bevat), wordt er een lijst gemaakt op basis van bestaande ontwerpwerkwoorden. Deze werkwoorden worden opgegeven door de Verbs eigenschap. In dit geval wordt een interne klasse werkwoordlijst gebruikt om de verzameling itemitems in het werkwoordvenster te bevatten.

Als u zowel DesignerActionMethodItem een paneelinvoer als een snelmenu-item in de ontwerptijd wilt gebruiken, kunt u de includeAsDesignerVerb parameter instellen in de constructor van het item.

Gebruik de DesignerActionUIService functie om de weergave van de ontwerpfunctie ActionListste bepalen.

Zie ook

• DesignerActionListCollection
• ComponentDesigner
• DesignerActionItem
• DesignerActionUIService
• Designer Commands and the DesignerAction Object Model for Windows Forms