Control.CreateParams Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

CreateParams

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 Icon Imageanzeigt. 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.Height CreateParams.Width CreateParams.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: