IConfigureToolboxItem.ConfigureToolboxItem(ToolboxItem) Метод

Определение

Вызывается службой панели элементов для настройки объектов ToolboxItem.Called by the toolbox service to configure ToolboxItem objects.

public:
 void ConfigureToolboxItem(System::Drawing::Design::ToolboxItem ^ item);
public void ConfigureToolboxItem (System.Drawing.Design.ToolboxItem item);
abstract member ConfigureToolboxItem : System.Drawing.Design.ToolboxItem -> unit
Public Sub ConfigureToolboxItem (item As ToolboxItem)

Параметры

item
ToolboxItem

[in] Объект ToolboxItem, конфигурацию которого необходимо изменить.[in] The ToolboxItem object whose configuration is to be modified.

Примеры

В приведенном ниже примере класс ToolboxItemConfig реализует IConfigureToolboxItem интерфейс для всех библиотек в Vsip пространстве имен.In the example below, the class ToolboxItemConfig implements the IConfigureToolboxItem interface for all libraries in the Vsip namespace. Эта реализация задает ToolboxItemFilterAttribute для элемента панели инструментов, ToolboxControl1 чтобы он был доступен на панели элементов только при редактировании UserControl , и для элемента панели инструментов ToolboxControl2 , чтобы он был недоступен на панели элементов при редактировании UserControl .This implementation sets the ToolboxItemFilterAttribute for the toolbox item ToolboxControl1 so that it is available in the Toolbox only when editing a UserControl, and for the toolbox item ToolboxControl2 so that it is not available in the Toolbox when editing a 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));  
            }  
        }  
    }  
}  

Комментарии

Служба панели элементов вызывает этот метод при ToolboxItem первом добавлении объектов в панель элементов или при сбросе панели элементов .The toolbox service calls this method when ToolboxItem objects are first added to the Toolbox, or when the Toolbox is reset. Этот метод изменяет данные в словаре свойств указанного ToolboxItem и.This method modifies data in its properties dictionary of the specified ToolboxItem and. Эти изменения сериализуются и сохраняются как Visual StudioVisual Studio Параметры пользователя IDE.These modifications are serialized and stored as Visual StudioVisual Studio IDE user settings.

Применяется к