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

Definición

Obtiene los parámetros de creación necesarios cuando se crea el identificador del control.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

Valor de propiedad

CreateParams que contiene los parámetros de creación necesarios cuando se crea el identificador del control.A CreateParams that contains the required creation parameters when the handle to the control is created.

Ejemplos

En el ejemplo de código siguiente se amplía el CreateParams propiedad de un Button clase derivada.The following code example extends the CreateParams property of a Button derived class. El CreateParams.Style propiedad ha cambiado, lo que hace que el botón para mostrar un Icon en lugar de un Image.The CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. En este ejemplo requiere que tenga una clase que hereda de la Button clase.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

Comentarios

El CreateParams propiedad no se debe invalidar y utiliza para ajustar las propiedades del control derivado.The CreateParams property should not be overridden and used to adjust the properties of your derived control. Propiedades, como el CreateParams.Caption, CreateParams.Width, y CreateParams.Height debe establecer las propiedades correspondientes en el control como Control.Text, Control.Width y 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. El CreateParams sólo debe extenderse cuando se está ajustando una clase de control estándar de Windows o para establecer estilos no proporcionados por el espacio de nombres de 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. Para obtener más información acerca de cómo crear parámetros de control, vea el CreateWindow y CreateWindowEx funciones y la CREATESTRUCT documentación de la estructura.For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

Notas a los desarrolladores de herederos

Cuando se reemplaza el CreateParams propiedad en una clase derivada, utilice la clase base CreateParams propiedad para extender la implementación base.When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. En caso contrario, debe proporcionar toda la implementación.Otherwise, you must provide all the implementation.

Seguridad

SecurityPermission
Para que el llamador inmediato llamar a código no administrado al obtener el valor de propiedad.for the immediate caller to call unmanaged code when getting the property value. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Se aplica a

Consulte también: