Control.CreateParams Propriété

Définition

Obtient le paramètre de création requis lors de la création du handle du contrôle.

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éé.

Exemples

L’exemple de code suivant étend la CreateParams propriété d’une Button classe dérivée. La CreateParams.Style propriété est modifiée, ce qui entraîne l’affichage d’un Icon bouton plutôt que d’un Image. Cet exemple nécessite que vous ayez une classe qui hérite de la Button classe .

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
    {
        // 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 remplacée et utilisée pour ajuster les propriétés de votre contrôle dérivé. Les propriétés telles que CreateParams.Caption, CreateParams.Widthet 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. Le CreateParams ne doit être étendu que 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. Pour plus d’informations sur la création de paramètres de contrôle, consultez les CreateWindow fonctions et CreateWindowEx et la documentation sur la structure CREATESTRUCT .

Notes pour les héritiers

Lorsque vous substituez la CreateParams propriété dans une classe dérivée, utilisez la propriété de la classe de CreateParams base pour étendre l’implémentation de base. Sinon, vous devez fournir toute l’implémentation.

S’applique à

Voir aussi