DesignerActionService Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Établit un service au moment du design qui gère la collection d’objets DesignerActionItem pour les composants.
public ref class DesignerActionService : IDisposablepublic class DesignerActionService : IDisposabletype DesignerActionService = class
interface IDisposablePublic Class DesignerActionService
Implements IDisposable- Héritage
-
DesignerActionService
- Dérivé
- Implémente
Remarques
La DesignerActionService classe 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 permet un modèle push direct de création d’éléments et est principalement destiné à être utilisé par les développeurs d’outils au moment du design, bien qu’il puisse également être utilisé par les 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 d’étiquettes actives.
Les développeurs de composants avancés peuvent avoir besoin de contrôler dynamiquement les éléments associés à un composant, en remplaçant ou en complément du modèle d’extraction standard. Par exemple, les commandes du panneau peuvent être modifiées en fonction du contexte de leur utilisation et de l’état au moment du design du composant.
Note
Il DesignerActionService s’agit en fait du service de conduite derrière les modèles push et pull ; toutefois, 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 composant 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.
Note
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 pull s’appuie 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.
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 du design du composant et de son panneau, un grand degré d’interopérabilité existe 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é 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 du volet d’éléments verbes.
Si vous souhaitez utiliser à DesignerActionMethodItem la fois comme entrée de panneau et une entrée de menu contextuel au moment du design, vous pouvez définir le paramètre dans le includeAsDesignerVerb constructeur de l’élément.
Utilisez la commande DesignerActionUIService pour contrôler l’affichage des éléments de ActionListsvotre concepteur.
Constructeurs
| Nom | Description |
|---|---|
| DesignerActionService(IServiceProvider) |
Initialise une nouvelle instance de la classe DesignerActionService. |
Méthodes
| Nom | Description |
|---|---|
| Add(IComponent, DesignerActionList) |
Ajoute une DesignerActionList collection actuelle de balises actives gérées. |
| Add(IComponent, DesignerActionListCollection) |
Ajoute une DesignerActionListCollection collection actuelle de balises actives géré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 d’étiquettes actives actuel gère les listes d’actions du composant spécifié. |
| Dispose() |
Libère toutes les ressources utilisées par la DesignerActionService classe. |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les DesignerActionService ressources gérées 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, ComponentActionsType) |
Retourne la collection de listes d’éléments de balise active du type spécifié associé à un composant. |
| GetComponentActions(IComponent, ComponentActionsType) |
Retourne la collection de listes d’éléments d’action du concepteur du type spécifié associé à un composant. |
| GetComponentActions(IComponent) |
Retourne la collection de listes d’éléments de balise active associées à 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() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (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, DesignerActionList) |
Supprime la liste de balises actives spécifiée du composant spécifié. |
| Remove(IComponent) |
Supprime toutes les listes de balises actives associées au composant spécifié. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Événements
| Nom | Description |
|---|---|
| DesignerActionListsChanged |
Se produit lorsqu’un DesignerActionList composant est supprimé ou ajouté. |
