Control.CreateParams-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Protected Overridable ReadOnly Property CreateParams As CreateParams
'Usage
Dim value As CreateParams

value = Me.CreateParams

protected virtual CreateParams CreateParams { get; }

protected:
virtual property CreateParams^ CreateParams {
    CreateParams^ get ();
}

/** @property */
protected CreateParams get_CreateParams ()

protected function get CreateParams () : CreateParams

Eigenschaftenwert

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

Hinweise

Die CreateParams-Eigenschaft darf nicht überschrieben und zum Anpassen der Eigenschaften des abgeleiteten Steuerelements verwendet werden. Bestimmte Eigenschaften, z. B. CreateParams.Caption, CreateParams.Width und CreateParams.Height sollten von den entsprechenden Steuerelementeigenschaften Control.Text, Control.Width und Control.Height festgelegt werden. CreateParams darf nur erweitert werden, wenn Sie eine Windows-Standardsteuerelementklasse einbinden oder Stile festlegen, die nicht vom Windows Forms-Namespace bereitgestellt werden. Weitere Informationen zum Erstellen von Steuerelementparametern finden Sie in der CreateWindow-Funktion und in der CreateWindowEx-Funktion sowie in der Dokumentation zur CREATESTRUCT-Struktur in der Windows Platform SDK-Referenz der MSDN Library unter https://msdn.microsoft.com/library/deu.

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

Beispiel

Im folgenden Codebeispiel wird die CreateParams-Eigenschaft einer abgeleiteten Button-Klasse erweitert. Da sich die CreateParams.Style-Eigenschaft ändert, wird auf der Schaltfläche statt eines Image ein Icon angezeigt. In diesem Beispiel ist eine Klasse erforderlich, die von der Button-Klasse erbt.

/** @property 
 */
protected CreateParams get_CreateParams()
{
    // Extend the CreateParams property of the Button class.
    CreateParams cp = super.get_CreateParams();

    // Update the button Style.
    cp.set_Style(cp.get_Style() | 0x40); // BS_ICON value
    return cp;
} //get_CreateParams

.NET Framework-Sicherheit

SecurityPermission für erbende Klassen, um nicht verwalteten Code beim Abrufen des Eigenschaftenwerts aufzurufen. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode
SecurityPermission für den unmittelbaren Aufrufer, um nicht verwalteten Code beim Abrufen des Eigenschaftenwerts aufzurufen. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
CreateParams
CreateControl
CreateHandle
DestroyHandle
Handle
IsHandleCreated
OnHandleCreated
RecreateHandle
RecreatingHandle
UpdateStyles

Freigeben über