Control.CreateParams プロパティ

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

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

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

プロパティ値

CreateParams

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

例

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

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

注意 (継承者)

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

適用対象

こちらもご覧ください