Partager via


DesignerActionService Classe

Définition

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

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
Héritage
DesignerActionService
Dérivé
Implémente

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.

Notes

Le DesignerActionService est en fait le service de conduite derrière les deux modèles push et pull ; cependant, dans ce dernier cas, il fonctionne implicitement.

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

DesignerActionService(IServiceProvider)

Initialise une nouvelle instance de la classe DesignerActionService.

Méthodes

Add(IComponent, DesignerActionList)

Ajoute DesignerActionList à la collection actuelle de balises actives managées.

Add(IComponent, DesignerActionListCollection)

Ajoute DesignerActionListCollection à la collection actuelle de balises actives managées.

Clear()

Libère tous les composants de la gestion et efface toutes les listes de balises actives de modèle push.

Contains(IComponent)

Détermine si le service de balises actives actuel gère les listes d'actions pour le composant spécifié.

Dispose()

Libère toutes les ressources utilisées par la classe DesignerActionService.

Dispose(Boolean)

Libère les ressources non managées utilisées par DesignerActionService et libère éventuellement les ressources managées.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetComponentActions(IComponent)

Retourne la collection de listes d'éléments de balises actives associée à un composant.

GetComponentActions(IComponent, ComponentActionsType)

Retourne la collection de listes d'éléments de balises actives du type spécifié associée à un composant.

GetComponentActions(IComponent, ComponentActionsType)

Retourne la collection de listes d’éléments d’action du concepteur du type spécifié associé à un composant.

GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Récupère les balises actives de modèle d'extraction associées à un composant.

GetComponentServiceActions(IComponent, DesignerActionListCollection)

Récupère les balises actives de modèle push associées à un composant.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Remove(DesignerActionList)

Supprime la liste de balises actives spécifiée de tous les composants gérés par le service actuel.

Remove(IComponent)

Supprime toutes les listes de balises actives associées au composant spécifié.

Remove(IComponent, DesignerActionList)

Supprime la liste de balises actives spécifiée du composant spécifié.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Événements

DesignerActionListsChanged

Se produit lorsque DesignerActionList est supprimé ou ajouté pour n'importe quel composant.

S’applique à

Voir aussi