Control.CreateParams プロパティ

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

Control.CreateParams プロパティ

コントロール ハンドルが作成されるときに必要な作成パラメータを取得します。

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

Visual Basic (宣言)

Protected Overridable ReadOnly
 Property CreateParams As CreateParams

Visual Basic (使用法)

Dim value As CreateParams

value = Me.CreateParams

C#

protected virtual CreateParams CreateParams { get;
 }

C++

protected:
virtual property CreateParams^ CreateParams {
    CreateParams^ get ();
}

J#

/** @property */
protected CreateParams get_CreateParams ()

JScript

protected function get CreateParams
 () : CreateParams

プロパティ値
コントロールを識別するハンドルを作成するときに必要な作成パラメータを格納している CreateParams。

解説

CreateParams プロパティは派生コントロールのプロパティを調整するために使用し、オーバーライドしないでください。CreateParams.Caption、CreateParams.Width、および CreateParams.Height などのプロパティは、Control.Text、Control.Width、Control.Height など、コントロールの対応するプロパティによって設定されます。CreateParams は、標準の Windows コントロール クラスをラップしているときだけ、または Windows フォーム名前空間によって提供されていないスタイルを設定するためにだけ拡張します。コントロール パラメータの作成方法の詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja) にある Windows プラットフォーム SDK のリファレンスで、CreateWindow 関数と CreateWindowEx 関数および CREATESTRUCT 構造体のドキュメントを参照してください。

継承時の注意 派生クラスで CreateParams プロパティをオーバーライドする場合は、基本クラスの CreateParams プロパティを使用して、基本の実装を拡張します。それ以外の場合は、すべての実装を提供する必要があります。

使用例

Button 派生クラスの CreateParams プロパティを拡張するコード例を次に示します。CreateParams.Style プロパティが変更されると、ボタンは Image ではなく Icon を表示します。この例では、Button クラスから継承したクラスが存在している必要があります。

J#

/** @property 
 */
protected CreateParams get_CreateParams()
{
    // Extend the CreateParams property of the Button class.
    CreateParams cp = super.get_CreateParams();

    // Update the button Style.
    cp.set_Style(cp.get_Style() | 0x40); // BS_ICON value
    return cp;
} //get_CreateParams

.NET Framework のセキュリティ

• SecurityPermission  (プロパティ値を取得するときに、継承クラスがアンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
• SecurityPermission  (プロパティ値を取得するときに、直前の呼び出し元がアンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
CreateParams
CreateControl
CreateHandle
DestroyHandle
Handle
IsHandleCreated
OnHandleCreated
RecreateHandle
RecreatingHandle
UpdateStyles