Control.CreateParams プロパティ

定義

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

C#
protected virtual System.Windows.Forms.CreateParams CreateParams { get; }

プロパティ値

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

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

C#
protected override CreateParams CreateParams
{
    get
    {
        // Extend the CreateParams property of the Button class.
        CreateParams cp = base.CreateParams;
        // Update the button Style.
        cp.Style |= 0x00000040; // BS_ICON value

        return cp;
    }
}

注釈

プロパティを CreateParams オーバーライドして、派生コントロールのプロパティを調整するために使用しないでください。 、 などのCreateParams.CaptionCreateParams.Widthプロパティは、CreateParams.Heightコントロールの対応する プロパティ (、 などControl.HeightControl.TextControl.Width) で設定する必要があります。 はCreateParams、標準の Windows コントロール クラスをラップする場合、または Windows フォーム 名前空間によって提供されないスタイルを設定する場合にのみ拡張する必要があります。 コントロール パラメーターの作成の詳細については、 関数と CreateWindowExCREATESTRUCT 構造体に関するドキュメントを参照CreateWindowしてください。

注意 (継承者)

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

適用対象

製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

こちらもご覧ください