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

Definizione

Ottiene i parametri necessari per la creazione quando viene creato l'handle del controllo.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

Valore della proprietà

Oggetto CreateParams contenente i parametri di creazione necessari quando viene creato l'handle del controllo.A CreateParams that contains the required creation parameters when the handle to the control is created.

Esempi

L'esempio di codice seguente estende la CreateParams proprietà di un Button classe derivata.The following code example extends the CreateParams property of a Button derived class. Il CreateParams.Style proprietà viene modificata, in modo che il pulsante per visualizzare un' Icon anziché un oggetto Image.The CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. In questo esempio è necessario disporre una classe che eredita dal Button classe.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

Commenti

Il CreateParams proprietà non deve essere sottoposto a override e usata per modificare le proprietà del controllo derivato.The CreateParams property should not be overridden and used to adjust the properties of your derived control. Proprietà, ad esempio la CreateParams.Caption, CreateParams.Width, e CreateParams.Height deve essere impostato per le proprietà corrispondenti nel controllo, ad esempio Control.Text, Control.Width e Control.Height.Properties 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. Il CreateParams deve essere esteso solo quando si esegue il wrapping di una classe di controlli Windows standard o per impostare gli stili non forniti dallo spazio dei nomi di Windows Form.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. Per altre informazioni sulla creazione di parametri di controllo, vedere la CreateWindow e CreateWindowEx funzioni e i CREATESTRUCT documentazione relativa alla struttura.For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

Note per gli eredi

Quando si esegue l'override di CreateParams proprietà in una classe derivata, usare la classe di base CreateParams proprietà per estendere l'implementazione di base.When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. In caso contrario, è necessario fornire tutti l'implementazione.Otherwise, you must provide all the implementation.

Sicurezza

SecurityPermission
per il chiamante immediato chiamare codice non gestito quando si recupera il valore della proprietà.for the immediate caller to call unmanaged code when getting the property value. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

Si applica a

Vedi anche