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 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 propriété CreateParams d’une classe dérivée Button.The following code example extends the CreateParams property of a Button derived class. La propriété CreateParams.Style est modifiée, ce qui amène le bouton à afficher une Icon au lieu d’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 classe Button.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 propriété CreateParams 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 les 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. Le CreateParams doit ê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 fonctions CreateWindow et CreateWindowEx 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 propriété CreateParams dans une classe dérivée, utilisez la propriété CreateParams de la classe de base 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écurité

SecurityPermission
pour que l’appelant immédiat appelle du code non managé lors de l’obtention de la valeur de la propriété.for the immediate caller to call unmanaged code when getting the property value. Énumération associée : UnmanagedCodeAssociated enumeration: UnmanagedCode

S’applique à

Voir aussi