CheckedListBox.CreateParams プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

CheckedListBox.CreateParams プロパティ

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

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

Visual Basic (宣言)

Protected Overrides ReadOnly
 Property CreateParams As CreateParams

Visual Basic (使用法)

Dim value As CreateParams

value = Me.CreateParams

protected override CreateParams CreateParams { get;
 }

C++

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

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

JScript

protected override function get
 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 クラスから継承したクラスが存在している必要があります。

/** @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