Control クラス (System.Windows.Forms)

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2008/.NET Framework 3.5

その他のバージョンについては、以下の情報を参照してください。

.NET Framework クラスライブラリ

Control クラス

更新 : 2007 年 11 月

ビジュアルな表示のコンポーネントであるコントロールの基本クラスを定義します。

名前空間 : System.Windows.Forms
アセンブリ : System.Windows.Forms (System.Windows.Forms.dll 内)

構文

Visual Basic (宣言)

<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class Control _
    Inherits Component _
    Implements IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent,  _
    IComponent, IDisposable

Visual Basic (使用法)

Dim instance As Control

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
public class Control : Component, IDropTarget, 
    ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Visual C++

[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[ComVisibleAttribute(true)]
public ref class Control : public Component, 
    IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, 
    IDisposable

/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute ComVisibleAttribute(true) */
public class Control extends Component implements IDropTarget, 
    ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

JScript

public class Control extends Component implements IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

解説

独自のコントロールクラスを作成するには、UserControl クラス、Control クラス、または提供されたその他の Windows フォームコントロールから継承します。カスタムコントロールの作成方法の詳細については、「.NET Framework を使用したカスタム Windows フォームコントロールの開発」を参照してください。

Control クラスは、ユーザーに情報を表示するクラスが必要とする基本的な機能を実装します。ユーザー入力は、キーボードとポインティングデバイスをとおして処理されます。また、メッセージのルーティングとセキュリティも処理されます。コントロールの範囲 (サイズと位置) は定義されますが、描画は実装されません。ウィンドウのハンドル (hWnd) も用意されます。

Windows フォームコントロールはアンビエントプロパティを使用するため、子コントロールを周囲の環境のように表示できます。アンビエントプロパティは、コントロールプロパティです。設定しない場合は、親コントロールから取得されます。コントロールに Parent がなく、プロパティが設定されていない場合、コントロールは Site プロパティをとおしてアンビエントプロパティの値を決定しようとします。コントロールが配置されていない場合、そのサイトがアンビエントプロパティをサポートしていない場合、または AmbientProperties にプロパティが設定されていない場合、コントロールは独自の既定値を使用します。一般的に、アンビエントプロパティは、子コントロールに伝えられる BackColor などのコントロールの特性を表します。たとえば、Button は、既定では親の Form と同じ BackColor を持ちます。Control クラスで提供されるアンビエントプロパティには、Cursor、Font、BackColor、ForeColor、および RightToLeftがあります。

メモ :
Windows フォームアプリケーションを Windows XP visual スタイルをサポートするように設定するには、必ず FlatStyle プロパティを System に設定して、実行可能ファイルにマニフェストを含めます。マニフェストは、アプリケーション実行可能ファイルの中のリソースとして、または実行可能ファイルと同じディレクトリに存在する別個のファイルとして含まれる XML ファイルです。マニフェストの例については、FlatStyle 列挙体のトピックで「例」を参照してください。Windows XP で使用できる visual スタイルの使用方法の詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja.) の「Using Windows XP Visual Styles」を参照してください。

メモ :

Windows フォームアプリケーションを Windows XP visual スタイルをサポートするように設定するには、必ず FlatStyle プロパティを System に設定して、実行可能ファイルにマニフェストを含めます。マニフェストは、アプリケーション実行可能ファイルの中のリソースとして、または実行可能ファイルと同じディレクトリに存在する別個のファイルとして含まれる XML ファイルです。マニフェストの例については、FlatStyle 列挙体のトピックで「例」を参照してください。Windows XP で使用できる visual スタイルの使用方法の詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja.) の「Using Windows XP Visual Styles」を参照してください。

Windows フォームには、ユーザー補助のサポートが組み込まれており、ユーザー補助クライアントアプリケーションと協調して動作するための、アプリケーションに関する情報が提供されます。ユーザー補助クライアントアプリケーションには、画面拡大ユーティリティとレビューアユーティリティ、音声入力ユーティリティ、オンスクリーンキーボード、代替入力デバイス、キーボード拡張ユーティリティなどがあります。こうしたユーザー補助クライアントアプリケーションに対して、追加情報を提供する必要が生じる場合があります。この追加情報を提供するには 2 つの方法があります。1 つは、ユーザー補助クライアントアプリケーションに報告される AccessibleName、AccessibleDescription、AccessibleDefaultActionDescription、AccessibleRole の各プロパティ値を設定する方法です。この方法は、一般に、既存のコントロール用の限定されたユーザー補助情報を提供するために使用されます。もう 1 つの方法として、AccessibleObject クラスまたは Control..::.ControlAccessibleObject クラスから派生させて独自のクラスを作成し、必要なユーザー補助情報をすべて提供することもできます。

メモ :
優れたパフォーマンスを維持するには、コンストラクタでコントロールのサイズを設定しないでください。DefaultSize プロパティをオーバーライドする方法をお勧めします。

System.Windows.Forms 名前空間にあるコントロールの多くは、基になる Windows コモンコントロールをベースとしてその上に構築されています。Windows コモンコントロールの詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja.) の「General Control Reference」を参照してください。

個別のプロセスから Windows フォームコントロールを識別するには、標準の SendMessage 呼び出しを使用して WM_GETCONTROLNAME メッセージを渡します。WM_GETCONTROLNAME は、言語および Windows 階層には依存しません。詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja) で「Automating Windows Forms」の「Recommended Solution for Windows Forms」を参照してください。

複数のスレッドからのコントロールへのアクセスを同期するには、InvokeRequired プロパティを使用します。マルチスレッド処理された Windows フォームコントロールの詳細については、「方法 : Windows フォームコントロールのスレッドセーフな呼び出しを行う」を参照してください。

継承階層

スレッドセーフ

コントロールのハンドルが既に作成されている場合、スレッドセーフであるメンバは、BeginInvoke、EndInvoke、Invoke、InvokeRequired、および CreateGraphics だけです。コントロールのハンドルがバックグラウンドスレッドで作成される前に CreateGraphics を呼び出すと、無効なスレッド間の呼び出しが発生する可能性があります。

プラットフォーム

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, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報