Cette documentation est archivée et n’est pas conservée.

DesignerActionService, classe

Mise à jour : novembre 2007

Établit un service au moment du design qui gère la collection d'objets DesignerActionItem pour les composants.

Espace de noms :  System.ComponentModel.Design
Assembly :  System.Design (dans System.Design.dll)

public class DesignerActionService : IDisposable
public class DesignerActionService implements IDisposable
public class DesignerActionService implements IDisposable

La classe DesignerActionService est chargée de gérer la collection d'objets DesignerActionItem pour chaque instance d'un composant qui existe sur un formulaire au moment du design. Cette classe active un modèle push direct de création d'éléments et a été prévue à l'origine pour être utilisée par des développeurs d'outils au moment du design, bien qu'elle puisse également être utilisée par des développeurs de composants et de contrôles personnalisés.

Les développeurs d'outils au moment du design 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 des balises actives.

Il se peut que les développeurs de composants avancés aient à 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 du design du composant.

Remarque :

DesignerActionService est en fait le service qui dirige derrière les modèles push et d'extraction ; dans le dernier cas, il fonctionne implicitement.

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

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

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

  • La méthode Add autorise l'ajout de DesignerActionList ou DesignerActionListCollection au jeu d'éléments existants pour une instance de composant. Par contre, la méthode Remove supprime une ou toutes les listes d'éléments associées à un composant.

    Remarque :

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

    Remarque importante :

    Les méthodes Add, Remove, Contains et Clear se contentent d'examiner ou d'affecter des éléments de modèle push.

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

Parce qu'il est souvent souhaitable d'utiliser plusieurs éléments d'un même panneau dans le menu contextuel au moment du design du composant et son panneau, il existe une interopérabilité importante entre les objets DesignerActionItem et les verbes de concepteur.

Si un concepteur de composants ne spécifie pas explicitement DesignerActionList (c'est-à-dire qu'il ne contient pas de propriété ActionLists substituée), une liste sera créée à partir des verbes de concepteur existants. Ces verbes sont spécifiés par la propriété Verbs. Dans ce cas, une classe de liste de verbes interne est utilisée pour contenir la collection d'entrées du panneau d'éléments de verbe.

Si vous souhaitez que 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 paramètre includeAsDesignerVerb dans le constructeur de l'élément.

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

System.Object
  System.ComponentModel.Design.DesignerActionService
    System.Web.UI.Design.WebFormsDesignerActionService

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: