IConfigureToolboxItem.ConfigureToolboxItem, méthode

Article
08/01/2012

Appelé par le service de boîte à outils pour configurer des objets d'ToolboxItem.

Espace de noms : Microsoft.VisualStudio.Shell
Assembly : Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
Sub ConfigureToolboxItem ( _
    item As ToolboxItem _
)

void ConfigureToolboxItem(
    ToolboxItem item
)

Paramètres

item
Type : System.Drawing.Design.ToolboxItem
[in] l'objet d'ToolboxItem dont la configuration doit être modifiée.

Remarques

Les appels de service de boîte à outils cette méthode lorsque les objets d'ToolboxItem sont les premiers ajoutés à boîte à outils, ou lorsque boîte à outils est réinitialisé.Cette méthode modifie des données dans son dictionnaire de propriétés d'ToolboxItem spécifié et.Ces modifications sont sérialisées et enregistrées en tant que paramètres utilisateurs de Visual Studio IDE.

Exemples

Dans l'exemple ci-dessous, la classe ToolboxItemConfig implémente l'interface d'IConfigureToolboxItem pour toutes les bibliothèques dans l'espace de noms d'Vsip.Cette implémentation définit ToolboxItemFilterAttribute pour l'élément ToolboxControl1 de boîte à outils pour qu'elle soit disponible dans boîte à outils uniquement lorsque modifiant UserControl, et pour l'élément ToolboxControl2 de boîte à outils pour qu'elle soit non disponible dans boîte à outils en modifiant UserControl.

namespace Vsip.ItemConfiguration {
    [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]
    [Guid("11BA3E17-12F1-4e48-9E34-AC68335CD9EE")]
    public sealed class ToolboxConfig : IConfigureToolboxItem {
        ...
        public void ConfigureToolboxItem(ToolboxItem item) {
            if (item == null)
                return;
            ToolboxItemFilterAttribute newFilter = null;
            if (item.TypeName == typeof(ToolboxControl1).ToString()) {
                newFilter = new ToolboxItemFilterAttribute("System.Windows.Forms.UserControl",
                                                   ToolboxItemFilterType.Require);
            } 
            else if (item.TypeName == typeof(ToolboxControl2).ToString()) {
                newFilter = new ToolboxItemFilterAttribute("System.Windows.Forms.UserControl",
                                                      ToolboxItemFilterType.Prevent);
            }
            if (newFilter != null) {
                ArrayList array = new ArrayList();
                array.Add(newFilter);
                item.Filter = (ToolboxItemFilterAttribute[])
                        array.ToArray(typeof(ToolboxItemFilterAttribute));
            }
        }
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.