Actualización: noviembre 2007
Aloja controles personalizados o controles de formularios Windows Forms.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
Public Class ToolStripControlHost _ Inherits ToolStripItem
Dim instance As ToolStripControlHost
public class ToolStripControlHost : ToolStripItem
public ref class ToolStripControlHost : public ToolStripItem
public class ToolStripControlHost extends ToolStripItem
public class ToolStripControlHost extends ToolStripItem
ToolStripControlHost es la clase base abstracta para ToolStripComboBox, ToolStripTextBox y ToolStripProgressBar. ToolStripControlHost puede alojar otros controles, incluso controles personalizados, de dos maneras:
-
Construir un ToolStripControlHost con una clase que derive de Control. Para tener acceso total al control y las propiedades alojados, debe volver a convertir la propiedad Control en la clase real que representa.
-
Extender ToolStripControlHost y, en el constructor predeterminado de la clase heredada, llamar al constructor de clase base pasando una clase que derive de Control. Esta opción permite incluir propiedades y métodos de control comunes en ToolStrip para facilitar el acceso.
Utilice la clase ToolStripControlHost para alojar controles personalizados o cualquier otro control de formularios Windows Forms.
Para personalizar un control ToolStripItem, derive de ToolStripControlHost y cree una implementación personalizada. Puede reemplazar métodos, como por ejemplo OnSubscribeControlEvents, para controlar los eventos que desencadenan los controles alojados y puede asignar una funcionalidad personalizada en las propiedades para mejorar el control alojado.
En el código siguiente se muestra cómo se crea un control ToolStripControlHost con un control MonthCalendar utilizando el método OnSubscribeControlEvents para controlar eventos y exponiendo algunos de sus miembros en ToolStripControlHost.
'Declare a class that inherits from ToolStripControlHost. Public Class ToolStripMonthCalendar Inherits ToolStripControlHost ' Call the base constructor passing in a MonthCalendar instance. Public Sub New() MyBase.New(New MonthCalendar()) End Sub Public ReadOnly Property MonthCalendarControl() As MonthCalendar Get Return CType(Control, MonthCalendar) End Get End Property ' Expose the MonthCalendar.FirstDayOfWeek as a property. Public Property FirstDayOfWeek() As Day Get Return MonthCalendarControl.FirstDayOfWeek End Get Set value = MonthCalendarControl.FirstDayOfWeek End Set End Property ' Expose the AddBoldedDate method. Public Sub AddBoldedDate(ByVal dateToBold As DateTime) MonthCalendarControl.AddBoldedDate(dateToBold) End Sub ' Subscribe and unsubscribe the control events you wish to expose. Protected Overrides Sub OnSubscribeControlEvents(ByVal c As Control) ' Call the base so the base events are connected. MyBase.OnSubscribeControlEvents(c) ' Cast the control to a MonthCalendar control. Dim monthCalendarControl As MonthCalendar = _ CType(c, MonthCalendar) ' Add the event. AddHandler monthCalendarControl.DateChanged, _ AddressOf HandleDateChanged End Sub Protected Overrides Sub OnUnsubscribeControlEvents(ByVal c As Control) ' Call the base method so the basic events are unsubscribed. MyBase.OnUnsubscribeControlEvents(c) ' Cast the control to a MonthCalendar control. Dim monthCalendarControl As MonthCalendar = _ CType(c, MonthCalendar) ' Remove the event. RemoveHandler monthCalendarControl.DateChanged, _ AddressOf HandleDateChanged End Sub ' Declare the DateChanged event. Public Event DateChanged As DateRangeEventHandler ' Raise the DateChanged event. Private Sub HandleDateChanged(ByVal sender As Object, _ ByVal e As DateRangeEventArgs) RaiseEvent DateChanged(Me, e) End Sub End Class
//Declare a class that inherits from ToolStripControlHost. public class ToolStripMonthCalendar : ToolStripControlHost { // Call the base constructor passing in a MonthCalendar instance. public ToolStripMonthCalendar() : base (new MonthCalendar()) { } public MonthCalendar MonthCalendarControl { get { return Control as MonthCalendar; } } // Expose the MonthCalendar.FirstDayOfWeek as a property. public Day FirstDayOfWeek { get { return MonthCalendarControl.FirstDayOfWeek; } set { value = MonthCalendarControl.FirstDayOfWeek; } } // Expose the AddBoldedDate method. public void AddBoldedDate(DateTime dateToBold) { MonthCalendarControl.AddBoldedDate(dateToBold); } // Subscribe and unsubscribe the control events you wish to expose. protected override void OnSubscribeControlEvents(Control c) { // Call the base so the base events are connected. base.OnSubscribeControlEvents(c); // Cast the control to a MonthCalendar control. MonthCalendar monthCalendarControl = (MonthCalendar) c; // Add the event. monthCalendarControl.DateChanged += new DateRangeEventHandler(OnDateChanged); } protected override void OnUnsubscribeControlEvents(Control c) { // Call the base method so the basic events are unsubscribed. base.OnUnsubscribeControlEvents(c); // Cast the control to a MonthCalendar control. MonthCalendar monthCalendarControl = (MonthCalendar) c; // Remove the event. monthCalendarControl.DateChanged -= new DateRangeEventHandler(OnDateChanged); } // Declare the DateChanged event. public event DateRangeEventHandler DateChanged; // Raise the DateChanged event. private void OnDateChanged(object sender, DateRangeEventArgs e) { if (DateChanged != null) { DateChanged(this, e); } } }
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.ToolStripItem
System.Windows.Forms.ToolStripControlHost
System.Windows.Forms.ToolStripComboBox
System.Windows.Forms.ToolStripProgressBar
System.Windows.Forms.ToolStripTextBox
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.