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

Определение

Возвращает параметры, необходимые для создания дескриптора элемента управления.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

Значение свойства

Объект CreateParams, содержащий необходимые параметры процедуры создания дескриптора элемента управления.A CreateParams that contains the required creation parameters when the handle to the control is created.

Примеры

В следующем примере кода расширяется CreateParams свойство Button производного класса.The following code example extends the CreateParams property of a Button derived class. Свойство изменяется, что приводит к Icon отображению кнопки, а не Image. CreateParams.StyleThe CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. В этом примере предполагается, что у вас есть класс, наследующий от 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

Комментарии

CreateParams Свойство не следует переопределять и использовать для настройки свойств производного элемента управления.The CreateParams property should not be overridden and used to adjust the properties of your derived control. Такие CreateParams.Captionсвойства Control.Height, CreateParams.Widthкак, и CreateParams.Height , должны быть заданы соответствующими свойствами в элементе управления Control.Text, например, Control.Width и.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. CreateParams Должен быть расширен только при создании оболочки стандартного класса элемента управления Windows или при установке стилей, не предоставляемых 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. Дополнительные сведения о создании параметров элементов управления см. в CreateWindow разделе CreateWindowEx функции и документации по структуре CREATESTRUCT .For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

Примечания для тех, кто наследует этот метод

При переопределении CreateParams свойства в производном классе используйте CreateParams свойство базового класса для расширения базовой реализации.When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. В противном случае необходимо предоставить всю реализацию.Otherwise, you must provide all the implementation.

Безопасность

SecurityPermission
для немедленного вызывающего объекта, чтобы вызвать неуправляемый код при получении значения свойства.for the immediate caller to call unmanaged code when getting the property value. Связанное перечисление:UnmanagedCodeAssociated enumeration: UnmanagedCode

Применяется к

Дополнительно