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

Definition

Ruft die benötigten Erstellungsparameter ab, wenn das Steuerelementhandle erstellt wird.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

Eigenschaftswert

Eine CreateParams-Eigenschaft, die die erforderlichen Erstellungsparameter enthält, wenn das Handle für das Steuerelement erstellt wird.A CreateParams that contains the required creation parameters when the handle to the control is created.

Beispiele

Im folgenden Codebeispiel wird die CreateParams -Eigenschaft einer Button abgeleiteten Klasse erweitert.The following code example extends the CreateParams property of a Button derived class. Die CreateParams.Style -Eigenschaft wird geändert, was bewirkt, dass die Schalt Icon Fläche anstelle eines Imageanzeigt.The CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. Für dieses Beispiel ist es erforderlich, dass Sie über eine Klasse verfügen Button , die von der-Klasse erbt.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

Hinweise

Die CreateParams -Eigenschaft sollte nicht überschrieben und verwendet werden, um die Eigenschaften des abgeleiteten Steuer Elements anzupassen.The CreateParams property should not be overridden and used to adjust the properties of your derived control. Eigenschaften CreateParams.Captionwie CreateParams.Width, und CreateParams.Height sollten durch Control.Heightdie entsprechenden Eigenschaften im Steuerelement festgelegt werden, z Control.Text. b. und. Control.WidthProperties 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 Sollte nur erweitert werden, wenn Sie eine standardmäßige Windows-Steuerelement Klasse umwickeln oder Stile festlegen, die nicht vom Windows Forms-Namespace bereitgestellt werden.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. Weitere Informationen zum Erstellen von Steuerelement Parametern finden Sie CreateWindow in CreateWindowEx den Funktionen und und in der Dokumentation zur Struktur der Struktur.For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

Hinweise für Vererber

Wenn Sie die CreateParams Eigenschaft in einer abgeleiteten Klasse überschreiben, verwenden Sie CreateParams die-Eigenschaft der Basisklasse, um die Basis Implementierung zu erweitern.When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. Andernfalls müssen Sie die gesamte-Implementierung bereitstellen.Otherwise, you must provide all the implementation.

Sicherheit

SecurityPermission
, damit der unmittelbare Aufrufer beim Abrufen des Eigenschafts Werts nicht verwalteten Code aufruft.for the immediate caller to call unmanaged code when getting the property value. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für:

Siehe auch