IContainerControl Interfejs

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Udostępnia funkcje kontrolki do działania jako element nadrzędny dla innych kontrolek.

public interface class IContainerControl

public interface IContainerControl

type IContainerControl = interface

Public Interface IContainerControl

Pochodne

System.Windows.Forms.ContainerControl

Przykłady

Poniższy przykład dziedziczy z ScrollableControl klasy i implementuje IContainerControl interfejs. Implementacja ActiveControl jest dodawana do właściwości i ActivateControl metody.

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;
   }
};

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;
        }
    }

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

Uwagi dotyczące implementowania

Zaimplementuj ten interfejs w klasach, które mają być nadrzędne dla kolekcji kontrolek. Członkowie tego interfejsu umożliwiają aktywowanie kontrolki podrzędnej lub określenie, która kontrolka jest obecnie aktywna. W przypadku implementacji w klasie ActivateControl(Control) przyjmuje Control jako parametr i aktywuje określoną kontrolkę. Właściwość ActiveControl aktywuje lub pobiera kontrolkę, która jest aktywna.

W większości typowych scenariuszy nie trzeba bezpośrednio implementować tego interfejsu. Jeśli na przykład utworzysz projekt biblioteki sterowania Windows, Visual Studio wygeneruje początkową klasę. Ta klasa dziedziczy z UserControl klasy i UserControl implementuje IContainerControl dla Ciebie.

Właściwości

ActiveControl

Pobiera lub ustawia kontrolkę, która jest aktywna w kontrolce kontenera.

Metody

ActivateControl(Control)

Aktywuje określoną kontrolkę.

Zobacz też

• ContainerControl
• Control