Control.CreateParams Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene los parámetros de creación necesarios cuando se crea el identificador del control.
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.
Ejemplos
En el ejemplo de código siguiente se extiende la CreateParams propiedad de una Button clase derivada. La CreateParams.Style propiedad se cambia, lo que hace que el botón muestre un en Icon lugar de .Image Este ejemplo requiere que tenga una clase que herede de la Button clase .
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
Comentarios
La CreateParams propiedad no debe invalidarse y usarse para ajustar las propiedades del control derivado. Las propiedades como CreateParams.Caption, CreateParams.Widthy CreateParams.Height deben establecerse mediante las propiedades correspondientes del control, como Control.Text, Control.Width y Control.Height. El CreateParams solo debe extenderse al encapsular una clase de control estándar de Windows o para establecer estilos no proporcionados por el espacio de nombres Windows Forms. Para obtener más información sobre cómo crear parámetros de control, consulte las CreateWindow
funciones y CreateWindowEx
y la documentación de la estructura CREATESTRUCT .
Notas a los desarrolladores de herederos
Al invalidar la CreateParams propiedad en una clase derivada, use la propiedad de CreateParams la clase base para ampliar la implementación base. De lo contrario, debe proporcionar toda la implementación.