DesignerActionService Classe

Définition

public ref class DesignerActionService : IDisposable

public class DesignerActionService : IDisposable

type DesignerActionService = class
    interface IDisposable

Public Class DesignerActionService
Implements IDisposable

Héritage

Object

DesignerActionService

Dérivé

System.Web.UI.Design.WebFormsDesignerActionService

Implémente

IDisposable

Remarques

La DesignerActionService classe est responsable de la gestion de la collection d’objets DesignerActionItem pour chaque instance d’un composant qui existe sur un formulaire au moment du design. Cette classe permet un modèle push direct de création d’éléments et est principalement destinée aux développeurs d’outils de conception, bien qu’elle puisse également être utilisée par les développeurs de composants et de contrôles personnalisés.

Les développeurs d’outils au moment de la conception devront déterminer la liste des éléments à afficher pour un composant et déterminer quand cette liste change. Ils peuvent également créer des compléments qui fonctionnent conjointement avec des objets de panneau de balises actives.

Les développeurs de composants avancés peuvent avoir besoin de contrôler dynamiquement les éléments associés à un composant, remplaçant ou complétant ainsi le modèle d’extraction standard. Par exemple, les commandes de panneau peuvent être modifiées en fonction du contexte de leur utilisation et de l’état au moment de la conception du composant.

DesignerActionService fournit une interface simple pour accéder aux éléments et les manipuler pour chaque composant, y compris les méthodes et événements suivants :

• La Contains méthode détermine si le DesignerActionService gère actuellement un composant particulier.

• La GetComponentActions méthode prend en charge l’énumération des listes d’éléments.

• La Add méthode permet d’ajouter un DesignerActionList ou DesignerActionListCollection à l’ensemble d’éléments existants pour un composant instance. En revanche, la Remove méthode supprime une ou toutes les listes d’éléments associées à un composant.

  Notes

  La Add méthode représente le modèle push direct d’association d’éléments de panneau à un composant. En revanche, le modèle d’extraction repose sur la substitution de la ActionLists propriété de la classe de concepteur pour ce composant. L’environnement de conception est chargé d’ajouter ces éléments dans le courant DesignerActionService lorsqu’un composant est créé sur l’aire de conception.

  Important

  Les Addméthodes , Remove, Containset Clear prennent uniquement en compte ou affectent les éléments de modèle push.

• L’événement DesignerActionListsChanged indique quand la collection d’éléments change pour un composant.

Étant donné qu’il est souvent souhaitable d’utiliser certains des mêmes éléments de panneau dans le menu contextuel au moment de la conception du composant et dans son panneau, il existe un grand degré d’interopérabilité entre DesignerActionItem les objets et les verbes du concepteur.

Si un concepteur de composants ne spécifie pas explicitement un DesignerActionList (autrement dit, il ne contient pas de propriété remplacée ActionLists ), une liste est créée à partir de verbes de concepteur existants. Ces verbes sont spécifiés par la Verbs propriété . Dans ce cas, une classe de liste de verbes interne est utilisée pour contenir la collection d’entrées de panneau d’élément de verbe.

Si vous souhaitez qu’un DesignerActionMethodItem soit utilisé à la fois comme entrée de panneau et comme entrée de menu contextuel au moment du design, vous pouvez définir le includeAsDesignerVerb paramètre dans le constructeur de l’élément.

Utilisez pour DesignerActionUIService contrôler l’affichage de votre concepteur ActionLists.

Constructeurs

Méthodes

Événements

S’applique à

Voir aussi

• DesignerActionListCollection
• ComponentDesigner
• DesignerActionItem
• DesignerActionUIService
• Commandes du concepteur et modèle objet DesignerAction pour les Windows Forms