ContainerControl.ActiveControl プロパティ

.NET Framework クラス ライブラリ リファレンス

ContainerControl.ActiveControl プロパティ

コンテナ コントロール上のアクティブ コントロールを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property ActiveControl As
 Control

Visual Basic (使用法)

Dim instance As ContainerControl
Dim value As Control

value = instance.ActiveControl

instance.ActiveControl = value

C#

public Control ActiveControl { get; set;
 }

C++

public:
virtual property Control^ ActiveControl {
    Control^ get () sealed;
    void set (Control^ value) sealed;
}

J#

/** @property */
public final Control get_ActiveControl ()

/** @property */
public final void set_ActiveControl (Control
 value)

JScript

public final function get
 ActiveControl () : Control

public final function set
 ActiveControl (value : Control)

プロパティ値
ContainerControl で現在アクティブな Control。

例外

例外の種類	条件
ArgumentException	割り当てられた Control をアクティブにできませんでした。

解説

ActiveControl プロパティは、コンテナ コントロール上のコントロールをアクティブにするか、コンテナ コントロール上のアクティブ コントロールを取得します。

このプロパティから有効値を受け取るには、呼び出し元のオブジェクトが、呼び出し先のコントロールを格納しているか、そのコントロールに格納されている必要があります。あるフォームから別のフォームの ActiveControl プロパティを呼び出すと、未定義の値が返されます。この場合、このデータを受け渡すための独自のコミュニケーション機構をフォーム間に定義する必要があります。

使用例

ScrollableControl クラスから継承し、IContainerControl インターフェイスを実装するコード例を次に示します。実装は、ActiveControl プロパティおよび ActivateControl メソッドに追加されます。

Visual Basic

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  

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ContainerControl クラス
ContainerControl メンバ
System.Windows.Forms 名前空間
ScrollableControl
Control