Control.CreateParams Control.CreateParams Control.CreateParams Control.CreateParams Property

定義

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

protected:
 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. この例では、継承するクラスが必要です、Buttonクラス。This 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
{
    get
    {
        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
    Get
        Dim SecPerm As New SecurityPermission(SecurityPermissionFlag.UnmanagedCode)
        SecPerm.Demand()

        ' 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.CaptionCreateParams.Width、およびCreateParams.Heightなどのコントロールでの対応するプロパティを設定する必要がありますControl.TextControl.WidthControl.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. コントロールのパラメーターを作成する方法の詳細については、次を参照してください。、CreateWindowCreateWindowEx関数とCREATESTRUCTドキュメントの構造体。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.

セキュリティ

SecurityPermission
プロパティ値を取得するときに、アンマネージ コードを呼び出す直前の呼び出し元。for the immediate caller to call unmanaged code when getting the property value. 関連付けられた列挙体。 UnmanagedCodeAssociated enumeration: UnmanagedCode

適用対象

こちらもご覧ください