Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions WindowsForms/Form/FormCustomization.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---
---
layout: post
title: Form Customization in Windows Forms Form | Syncfusion®
description: Form Customization in Form (SfForm) enables configuring icons, borders, shadow effects, and rounded corners for personalized window appearance.
Expand All @@ -9,13 +9,13 @@ documentation: ug

# Form Customization in Windows Forms Form (SfForm)

## Form icon
## WinForms Form icon

A form icon designates the picture that represents the form in the taskbar as well as the icon displayed on the title bar of the form.
A WinForms Form icon designates the image that represents it in the taskbar and appears on its title bar.

### Changing form icon
### Changing WinForms Form icon

The form icon displayed on the title bar and task bar can be changed by using the [Icon](https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.form.icon?view=windowsdesktop-7.0&viewFallbackFrom=net-5.0) property.
The WinForms Form icon displayed on the title bar and task bar can be changed by using the [Icon](https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.form.icon?view=windowsdesktop-7.0&viewFallbackFrom=net-5.0) property.

{% tabs %}
{% highlight c# %}
Expand All @@ -28,9 +28,9 @@ Me.Icon = New Icon("sfIcon.ico")

![WindowsForms Form shows icon](formcustomization_images/windowsforms-form-shows-icon.png)

### Form icon alignment
### WinForms Form icon alignment

The form icon can be aligned vertically and horizontally by using the [Style.TitleBar.IconVerticalAlignment](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.TitleBarStyleInfo.html#Syncfusion_WinForms_Controls_Styles_TitleBarStyleInfo_IconVerticalAlignment) and [Style.TitleBar.IconHorizontalAlignment](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.TitleBarStyleInfo.html#Syncfusion_WinForms_Controls_Styles_TitleBarStyleInfo_IconHorizontalAlignment) properties.
The WinForms Form icon can be aligned vertically and horizontally by using the [Style.TitleBar.IconVerticalAlignment](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.TitleBarStyleInfo.html#Syncfusion_WinForms_Controls_Styles_TitleBarStyleInfo_IconVerticalAlignment) and [Style.TitleBar.IconHorizontalAlignment](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.TitleBarStyleInfo.html#Syncfusion_WinForms_Controls_Styles_TitleBarStyleInfo_IconHorizontalAlignment) properties.

{% tabs %}
{% highlight c# %}
Expand All @@ -45,7 +45,7 @@ Me.Style.TitleBar.IconHorizontalAlignment = HorizontalAlignment.Right

![WindowsForms Form icon is alignment](formcustomization_images/windowsforms-form-icon-alignment.png)

## Form border
## WinForms Form border

Appearance of the border can be customized by using the [Style.Border](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_Border) and [Style.InactiveBorder](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_InactiveBorder) properties.

Expand All @@ -70,7 +70,7 @@ Me.Style.InactiveBorder = New Pen(Color.LightGray, 2)

## Shadow effect

Shadow effect of the form can be customized by using the [Style.ShadowOpacity](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_ShadowOpacity) and [Style.InactiveShadowOpacity](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_InactiveShadowOpacity) properties.
Shadow effect of the WinForms Form can be customized by using the [Style.ShadowOpacity](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_ShadowOpacity) and [Style.InactiveShadowOpacity](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_InactiveShadowOpacity) properties.

{% tabs %}
{% highlight c# %}
Expand All @@ -95,9 +95,9 @@ N> Shadow can be disabled by setting the `ShadowOpacity` property as zero.

## Rounded corner

Rounded corners for `SfForm` can be enabled by using the [AllowRoundedCorners](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.SfForm.html#Syncfusion_WinForms_Controls_SfForm_AllowRoundedCorners) property. Rounded corners are not supported in OS versions lower than Windows 11. Enabling `AllowRoundedCorners` property will have no effect on those operating systems.
Rounded corners for `WinForms Form` can be enabled by using the [AllowRoundedCorners](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.SfForm.html#Syncfusion_WinForms_Controls_SfForm_AllowRoundedCorners) property. Rounded corners are not supported in OS versions lower than Windows 11. Enabling `AllowRoundedCorners` property will have no effect on those operating systems.

N> When the rounded corners are enabled, the border and shadow of the Form are drawn by the operating system.
N> When the rounded corners are enabled, the border and shadow of the WinForms Form are drawn by the operating system.

{% tabs %}

Expand Down
12 changes: 6 additions & 6 deletions WindowsForms/Form/Getting-Started.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@ documentation: ug

Refer [control dependencies](https://help.syncfusion.com/windowsforms/control-dependencies#sfform) section to get the list of assemblies or NuGet package needs to be added as reference to use the control in any application.

## Converting Standard Form into SfForm
## Converting Standard Form into SfForm (WinForms Form)

The default form can be changed into SfForm by the following steps:
The default form can be changed into SfForm (WinForms Form) by the following steps:

**Step 1:** Create a new Windows Forms Application in Visual Studio.

Expand All @@ -38,7 +38,7 @@ Imports Syncfusion.WinForms.Controls
{% endcapture %}
{{ codesnippet1 | OrderList_Indent_Level_1 }}

**Step 4:** Change the base class of your form from `System.Windows.Forms.Form` to `SfForm`.
**Step 4:** Change the base class of your form from `System.Windows.Forms.Form` to `SfForm (WinForms Form)`.

{% capture codesnippet2 %}
{% tabs %}
Expand Down Expand Up @@ -68,7 +68,7 @@ End Class

## Title Bar Customization

By default, the SfForm loads with the default appearance, which can be customized by using the [TitleBarStyleInfo](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.TitleBarStyleInfo.html) property. It contains all the settings for the appearance of the title bar.
By default, the WinForms Form loads with the default appearance, which can be customized by using the [TitleBarStyleInfo](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.TitleBarStyleInfo.html) property. It contains all the settings for the appearance of the title bar.


{% tabs %}
Expand Down Expand Up @@ -119,7 +119,7 @@ Me.Style.TitleBar.MinimizeButtonPressedBackColor = Color.Gray

## Border Customization

The borders of the form can be customized by using the [Style.Border](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_Border) and [Style.InactiveBorder](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_InactiveBorder) properties.
The borders of the WinForms Form can be customized by using the [Style.Border](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_Border) and [Style.InactiveBorder](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.Styles.FormVisualStyle.html#Syncfusion_WinForms_Controls_Styles_FormVisualStyle_InactiveBorder) properties.


{% tabs %}
Expand All @@ -138,7 +138,7 @@ Me.Style.InactiveBorder = New Pen(Color.Gray, 5)

## Loading User Control to the Title Bar

You can load any user control to the title bar of the SfForm instead of the title bar text by using the [TitleBarTextControl](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.SfForm.html#Syncfusion_WinForms_Controls_SfForm_TitleBarTextControl) property.
You can load any user control to the title bar of the WinForms Form instead of the title bar text by using the [TitleBarTextControl](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Controls.SfForm.html#Syncfusion_WinForms_Controls_SfForm_TitleBarTextControl) property.


{% tabs %}
Expand Down
10 changes: 5 additions & 5 deletions WindowsForms/Form/Localization.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---
---
layout: post
title: Localization in Windows Forms Form control | Syncfusion®
description: Localization in Form (SfForm) enables translating form resources, customizing localized content, and supporting multiple cultures using resource files.
Expand All @@ -8,14 +8,14 @@ documentation: ug
---

# Localization in Windows Forms Form (SfForm)
Localization is the process of translating the application resources into different languages for specific cultures. The SfForm can be localized by adding a [resource](https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/aa992030(v=vs.100)) file. The application culture can be changed by setting the [CurrentUICulture](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo.currentuiculture?view=net-5.0) before the `InitializeComponent` method.
Localization is the process of translating the application resources into different languages for specific cultures. The WinForms Form can be localized by adding a [resource](https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2010/aa992030(v=vs.100)) file. The application culture can be changed by setting the [CurrentUICulture](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo.currentuiculture?view=net-5.0) before the `InitializeComponent` method.

## Localize at Sample Level
To localize the SfForm based on `CurrentUICulture` using resource files, follow the steps below.
To localize the WinForms Form based on `CurrentUICulture` using resource files, follow the steps below.

1. Create a new folder and name it **Resources** in your application.

2. Add the default resource file of SfForm into the **Resources** folder. You can download the `Syncfusion.Shared.Base.resx` from the [GitHub](https://github.com/syncfusion/winforms-controls-localization-resx-files/blob/master/Syncfusion.Shared.Base/Syncfusion.Shared.Base.resx).
2. Add the default resource file of WinForms Form into the **Resources** folder. You can download the `Syncfusion.Shared.Base.resx` from the [GitHub](https://github.com/syncfusion/winforms-controls-localization-resx-files/blob/master/Syncfusion.Shared.Base/Syncfusion.Shared.Base.resx).

![Added default resource file of winforms sfform shown in solution explorer](Localization_images/Localization_img1.png)

Expand Down Expand Up @@ -60,7 +60,7 @@ End Sub
![Winforms sfform localized with modified resources](Localization_images/Localization_img5.png)

## Editing Default Resource File
The default resource file can be edited by adding it to the **Resources** folder of the application, which is where SfForm reads the static texts from. The default resource file can be downloaded from the [GitHub](https://github.com/syncfusion/winforms-controls-localization-resx-files/blob/master/Syncfusion.Shared.Base/Syncfusion.Shared.Base.resx).
The default resource file can be edited by adding it to the **Resources** folder of the application, which is where WinForms Form reads the static texts from. The default resource file can be downloaded from the [GitHub](https://github.com/syncfusion/winforms-controls-localization-resx-files/blob/master/Syncfusion.Shared.Base/Syncfusion.Shared.Base.resx).

![Added default resource file of winforms sfform shown in solution explorer](Localization_images/Localization_img6.png)

Expand Down
4 changes: 2 additions & 2 deletions WindowsForms/Form/MDICustomization.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---
---
layout: post
title: MDI Customization in Windows Forms Form control | Syncfusion®
description: MDI Customization in Form (SfForm) supports creating MDI applications, managing child forms, customizing appearance, and handling active windows.
Expand All @@ -9,7 +9,7 @@ documentation: ug

# MDI Customization in Windows Forms Form (SfForm)

Multiple Document Interface (MDI) applications allow displaying multiple documents (or forms) in an application at the same time. An MDI parent is a form that contains MDI child windows, which are the sub-windows. A form can be changed to an MDI parent by enabling the [IsMDIContainer](https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.form.ismdicontainer?view=windowsdesktop-7.0&viewFallbackFrom=net-5.0) property.
Multiple Document Interface (MDI) applications allow displaying multiple documents (or forms) in an application at the same time. An MDI parent is a form that contains MDI child windows, which are the sub-windows. A WinForms Form can be changed to an MDI parent by enabling the [IsMDIContainer](https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.form.ismdicontainer?view=windowsdesktop-7.0&viewFallbackFrom=net-5.0) property.

## Adding MDI child form

Expand Down
Loading