Control.CreateParams プロパティ


コントロール ハンドルが作成されるときに必要な作成パラメーターを取得します。Gets the required creation parameters when the control handle is created.

 virtual property System::Windows::Forms::CreateParams ^ CreateParams { System::Windows::Forms::CreateParams ^ get(); };
protected virtual System.Windows.Forms.CreateParams CreateParams { get; }
member this.CreateParams : System.Windows.Forms.CreateParams
Protected Overridable ReadOnly Property CreateParams As CreateParams



コントロールを識別するハンドルを作成するときに必要な作成パラメーターを格納している CreateParamsA CreateParams that contains the required creation parameters when the handle to the control is created.

派生クラスのプロパティを拡張するコード例を次に示し CreateParams Button ます。The following code example extends the CreateParams property of a Button derived class. CreateParams.Styleプロパティが変更されると、ボタンはで Icon はなくを表示し Image ます。The CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. この例では、クラスを継承するクラスが必要です ButtonThis example requires that you have a class that inherits from the Button class.

virtual System::Windows::Forms::CreateParams^ get() override
   // Extend the CreateParams property of the Button class.
   System::Windows::Forms::CreateParams^ cp = __super::CreateParams;

   // Update the button Style.
   cp->Style |= 0x00000040; // BS_ICON value
   return cp;
protected override CreateParams CreateParams
        new SecurityPermission(SecurityPermissionFlag.UnmanagedCode).Demand();

        // Extend the CreateParams property of the Button class.
        CreateParams cp = base.CreateParams;
        // Update the button Style.
        cp.Style |= 0x00000040; // BS_ICON value

        return cp;

Protected Overrides ReadOnly Property CreateParams() As System.Windows.Forms.CreateParams
        Dim SecPerm As New SecurityPermission(SecurityPermissionFlag.UnmanagedCode)

        ' Extend the CreateParams property of the Button class.
        Dim cp As System.Windows.Forms.CreateParams = MyBase.CreateParams
        ' Update the button Style.
        cp.Style = cp.Style Or &H40 ' BS_ICON value

        Return cp
    End Get
End Property


CreateParamsプロパティをオーバーライドして、派生したコントロールのプロパティを調整することはできません。The CreateParams property should not be overridden and used to adjust the properties of your derived control. 、、などのプロパティは CreateParams.Caption CreateParams.Width CreateParams.Height 、コントロールの対応するプロパティ (、、など) によって設定される必要があり Control.Text Control.Width Control.Height ます。Properties such as the CreateParams.Caption, CreateParams.Width, and CreateParams.Height should be set by the corresponding properties in your control such as Control.Text, Control.Width and Control.Height. は、 CreateParams 標準の Windows コントロールクラスをラップしている場合、または Windows フォーム名前空間で提供されていないスタイルを設定する場合にのみ拡張する必要があります。The CreateParams should only be extended when you are wrapping a standard Windows control class or to set styles not provided by the Windows Forms namespace. コントロールパラメーターの作成の詳細については、 CreateWindow および CreateWindowEx 関数と CREATESTRUCT structure のドキュメントを参照してください。For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

注意 (継承者)

派生クラスのプロパティをオーバーライドする場合は CreateParams 、基本クラスのプロパティを使用して CreateParams 基本実装を拡張します。When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. それ以外の場合は、すべての実装を指定する必要があります。Otherwise, you must provide all the implementation.