Control.CreateParams Propriété

Définition

Obtient le paramètre de création requis lors de la création du handle du contrôle.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

Valeur de propriété

CreateParams

CreateParams qui contient les paramètres de création requis quand le handle du contrôle est créé.A CreateParams that contains the required creation parameters when the handle to the control is created.

Exemples

L’exemple de code suivant étend la CreateParams propriété d’une Button classe dérivée.The following code example extends the CreateParams property of a Button derived class. La CreateParams.Style propriété est modifiée, ce qui amène le bouton à afficher un Icon plutôt qu’un Image .The CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. Cet exemple nécessite que vous disposiez d’une classe qui hérite de la 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

Remarques

La CreateParams propriété ne doit pas être substituée et utilisée pour ajuster les propriétés de votre contrôle dérivé.The CreateParams property should not be overridden and used to adjust the properties of your derived control. Les propriétés telles que CreateParams.Caption , CreateParams.Width et CreateParams.Height doivent être définies par les propriétés correspondantes dans votre contrôle, telles que Control.Text , Control.Width et 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. CreateParamsDoit être étendu uniquement lorsque vous encapsulez une classe de contrôle Windows standard ou pour définir des styles non fournis par l’espace de noms Windows Forms.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. Pour plus d’informations sur la création de paramètres de contrôle, consultez les CreateWindow CreateWindowEx fonctions et et la documentation de la structure CREATESTRUCT .For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

Notes pour les héritiers

Lors de la substitution de la CreateParams propriété dans une classe dérivée, utilisez la propriété de la classe de base CreateParams pour étendre l’implémentation de base.When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. Sinon, vous devez fournir toute l’implémentation.Otherwise, you must provide all the implementation.

S’applique à

Voir aussi