ContainerControl-Klasse
Stellt Fokusverwaltungsfunktionen für Steuerelemente bereit, die als Container für andere Steuerelemente verwendet werden können.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class ContainerControl
Inherits ScrollableControl
Implements IContainerControl
'Usage
Dim instance As ContainerControl
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class ContainerControl : ScrollableControl, IContainerControl
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class ContainerControl : public ScrollableControl, IContainerControl
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class ContainerControl extends ScrollableControl implements IContainerControl
ComVisibleAttribute(true)
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)
public class ContainerControl extends ScrollableControl implements IContainerControl
Hinweise
Ein ContainerControl stellt ein Steuerelement dar, das als Container für andere Steuerelemente verwendet werden kann und Fokusverwaltung bereitstellt. Von dieser Klasse erbende Steuerelemente können das aktive Steuerelement, das sie enthalten, auch dann überwachen, wenn der Fokus an einen anderen Container übergeben wird.
ContainerControl-Objekte stellen eine logische Begrenzung für enthaltene Steuerelemente dar. Das Containersteuerelement kann das Drücken der TAB-TASTE abfangen und den Fokus zum nächsten Steuerelement in der Auflistung verschieben.
Hinweis
Das Containersteuerelement erhält nicht den Fokus. Dieser wird immer auf das erste untergeordnete Steuerelement in der Auflistung enthaltener Steuerelemente festgelegt.
In der Regel wird die ContainerControl-Klasse nicht direkt geerbt. Die Klassen Form, UserControl und UpDownBase erben von ContainerControl.
Beispiel
Im folgenden Codebeispiel wird die ScrollableControl-Klasse geerbt. Außerdem wird die IContainerControl-Schnittstelle implementiert. Der ActiveControl-Eigenschaft und der ActivateControl-Methode wird eine Implementierung hinzugefügt.
Imports System
Imports System.Windows.Forms
Imports System.Drawing
Public Class MyContainerControl
Inherits ScrollableControl
Implements IContainerControl
Private myActiveControl As Control
Public Sub New()
' Make the container control Blue so it can be distinguished on the form.
Me.BackColor = Color.Blue
' Make the container scrollable.
Me.AutoScroll = True
End Sub
' Add implementation to the IContainerControl.ActiveControl property.
Public Property ActiveControl() As Control Implements IContainerControl.ActiveControl
Get
Return Me.myActiveControl
End Get
Set
' Make sure the control is a member of the ControlCollection.
If Me.Controls.Contains(value) Then
Me.myActiveControl = value
End If
End Set
End Property
' Add implementation to the IContainerControl.ActivateControl(Control) method.
public Function ActivateControl(active As Control) As Boolean Implements IContainerControl.ActivateControl
If Me.Controls.Contains(active) Then
' Select the control and scroll the control into view if needed.
active.Select()
Me.ScrollControlIntoView(active)
Me.myActiveControl = active
Return True
End If
Return False
End Function
End Class
using System;
using System.Windows.Forms;
using System.Drawing;
public class MyContainer : ScrollableControl, IContainerControl
{
private Control activeControl;
public MyContainer()
{
// Make the container control Blue so it can be distinguished on the form.
this.BackColor = Color.Blue;
// Make the container scrollable.
this.AutoScroll = true;
}
// Add implementation to the IContainerControl.ActiveControl property.
public Control ActiveControl
{
get
{
return activeControl;
}
set
{
// Make sure the control is a member of the ControlCollection.
if(this.Controls.Contains(value))
{
activeControl = value;
}
}
}
// Add implementations to the IContainerControl.ActivateControl(Control) method.
public bool ActivateControl(Control active)
{
if(this.Controls.Contains(active))
{
// Select the control and scroll the control into view if needed.
active.Select();
this.ScrollControlIntoView(active);
this.activeControl = active;
return true;
}
return false;
}
}
using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
public ref class MyContainer: public ScrollableControl, public IContainerControl
{
private:
Control^ activeControl;
public:
MyContainer()
{
// Make the container control Blue so it can be distinguished on the form.
this->BackColor = Color::Blue;
// Make the container scrollable.
this->AutoScroll = true;
}
property Control^ ActiveControl
{
// Add implementation to the IContainerControl.ActiveControl property.
virtual Control^ get()
{
return activeControl;
}
virtual void set( Control^ value )
{
// Make sure the control is a member of the ControlCollection.
if ( this->Controls->Contains( value ) )
{
activeControl = value;
}
}
}
// Add implementations to the IContainerControl.ActivateControl(Control) method.
virtual bool ActivateControl( Control^ active )
{
if ( this->Controls->Contains( active ) )
{
// Select the control and scroll the control into view if needed.
active->Select( );
this->ScrollControlIntoView( active );
this->activeControl = active;
return true;
}
return false;
}
};
import System.*;
import System.Windows.Forms.*;
import System.Drawing.*;
public class MyContainer extends ScrollableControl implements IContainerControl
{
private Control activeControl;
public MyContainer()
{
// Make the container control Blue so it can be
// distinguished on the form.
this.set_BackColor(Color.get_Blue());
// Make the container scrollable.
this.set_AutoScroll(true);
} //MyContainer
// Add implementation to the IContainerControl.ActiveControl property.
/** @property
*/
public Control get_ActiveControl()
{
return activeControl;
} //get_ActiveControl
/** @property
*/
public void set_ActiveControl(Control value)
{
// Make sure the control is a member of the ControlCollection.
if (this.get_Controls().Contains(value)) {
activeControl = value;
}
} //set_ActiveControl
// Add implementations to the IContainerControl.
// ActivateControl(Control) method.
public boolean ActivateControl(Control active)
{
if (this.get_Controls().Contains(active)) {
// Select the control and scroll the control into view if needed.
active.Select();
this.ScrollControlIntoView(active);
this.activeControl = active;
return true;
}
return false;
} //ActivateControl
} //MyContainer
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.ContainerControl
Abgeleitete Klassen
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
ContainerControl-Member
System.Windows.Forms-Namespace
Form
UserControl
UpDownBase
IContainerControl
ScrollableControl