Teilen über


Control.CreateParams Eigenschaft

Definition

Ruft die benötigten Erstellungsparameter ab, wenn das Steuerelementhandle erstellt wird.

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

Eigenschaftswert

Eine CreateParams-Eigenschaft, die die erforderlichen Erstellungsparameter enthält, wenn das Handle für das Steuerelement erstellt wird.

Beispiele

Im folgenden Codebeispiel wird die CreateParams -Eigenschaft einer Button abgeleiteten Klasse erweitert. Die CreateParams.Style -Eigenschaft wird geändert, wodurch die Schaltfläche anstelle eines IconImageanzeigt. Dieses Beispiel erfordert, dass Sie über eine Klasse verfügen, die von der Button -Klasse erbt.

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

Hinweise

Die CreateParams -Eigenschaft sollte nicht überschrieben und zum Anpassen der Eigenschaften des abgeleiteten Steuerelements verwendet werden. Eigenschaften wie , und sollten von den entsprechenden Eigenschaften in Ihrem Steuerelement festgelegt werden, zControl.Text. B. , Control.Width und Control.Height.CreateParams.HeightCreateParams.WidthCreateParams.Caption Sollte CreateParams nur erweitert werden, wenn Sie eine Standardmäßige Windows-Steuerelementklasse umschließen oder Stile festlegen, die nicht vom Windows Forms-Namespace bereitgestellt werden. Weitere Informationen zum Erstellen von Steuerelementparametern finden Sie in den CreateWindow Funktionen und CreateWindowEx sowie in der Dokumentation zur CREATESTRUCT-Struktur .

Hinweise für Vererber

Verwenden Sie beim Überschreiben der CreateParams -Eigenschaft in einer abgeleiteten Klasse die -Eigenschaft der CreateParams Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen.

Gilt für:

Weitere Informationen