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 chargée de gérer la collection d' DesignerActionItem objets pour chaque instance d’un composant qui existe sur un formulaire au moment du Design. Cette classe active un modèle direct push de création d’éléments et est principalement destinée à être utilisée par les développeurs d’outils au moment du design, bien qu’elle puisse également être utilisée par les développeurs de contrôles personnalisés et de composants.

Les développeurs d’outils au moment du design doivent déterminer la liste des éléments à afficher pour un composant et déterminer le moment où cette liste est modifiée. Ils peuvent également créer des compléments qui fonctionnent conjointement avec les objets du panneau des balises actives.

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

Notes

DesignerActionServiceEst en fait le service qui dirige les modèles push et pull ; Toutefois, dans le deuxième cas, il fonctionne implicitement.

DesignerActionService fournit une interface simple pour accéder aux éléments de chaque composant et les manipuler, y compris les méthodes et les é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 une instance de composant. 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 direct push de l’Association d’éléments de panneau à un composant. En revanche, le modèle d’extraction s’appuie sur la substitution ActionLists de la propriété de la classe de concepteur pour ce composant. L’environnement de conception est chargé d’ajouter ces éléments dans le actuel DesignerActionService lorsqu’un composant est créé sur l’aire de conception.

    Important

    Les Add méthodes,, Remove Contains et Clear ne considèrent ou n’affectent que les éléments de modèle push.

  • L' DesignerActionListsChanged événement 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 du design du composant et dans son panneau, il existe un grand degré d’interopérabilité entre les DesignerActionItem objets et les verbes de concepteur.

Si un concepteur de composants ne spécifie pas explicitement un DesignerActionList (autrement dit, qu’il ne contient pas de propriété substitué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 DesignerActionMethodItem qu’un soit utilisé à la fois comme entrée de panneau et comme entrée de menu contextuel au moment de la conception, vous pouvez définir le includeAsDesignerVerb paramètre dans le constructeur de l’élément.

Utilisez le DesignerActionUIService pour contrôler l’affichage du 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 de 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