Control.CreateParams Свойство

Определение

Возвращает параметры, необходимые для создания дескриптора элемента управления.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. Изменено свойство CreateParams.Style, в результате чего на кнопке отображается Icon, а не Image.The 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, CreateParams.Widthи CreateParams.Height, должны быть заданы соответствующими свойствами в элементе управления, например Control.Text, Control.Width и 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. 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

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

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