diff --git a/Array-and-Table-Formulas.md b/Array-and-Table-Formulas.md index 8acf763..864ae6b 100644 --- a/Array-and-Table-Formulas.md +++ b/Array-and-Table-Formulas.md @@ -1,7 +1,7 @@ --- layout: post -title: Array and Table Formulas in Essential Calculate -description: Explains about the support of array and table formulas in Essential Calculate +title: Array and Table Formulas in Syncfusion Essential Calculate +description: Explains about the support of array and table formulas in the Syncfusion Essential Calculate control platform: windowsforms control: Calculate documentation: ug diff --git a/WindowsForms/Calendar/Getting-Started.md b/WindowsForms/Calendar/Getting-Started.md index 5759749..8e34686 100644 --- a/WindowsForms/Calendar/Getting-Started.md +++ b/WindowsForms/Calendar/Getting-Started.md @@ -357,3 +357,29 @@ calendar.ShowWeekNumber = True {% endtabs %} ![SfCalendar shows week number](appearance-images/showweeknumber.png) + +## Configure the calculation of week number based on culture + +You can get the current week number in `SfCalendar` control by changing the `CalendarWeekRule` property value of date time format in `CultureInfo`. The default value of `CalendarWeekRule` property is `FirstDay`. + +{% tabs %} + +{% highlight C# %} + +SfCalendar sfCalendar1 = new SfCalendar(); +CultureInfo info = new CultureInfo("en-EN"); +info.DateTimeFormat.CalendarWeekRule = CalendarWeekRule.FirstFullWeek; +sfCalendar1.Culture = info; + +{% endhighlight %} + +{% highlight VB %} + +Dim sfCalendar1 As SfCalendar = New SfCalendar() +Dim info As CultureInfo = New CultureInfo("en-EN") +info.DateTimeFormat.CalendarWeekRule = CalendarWeekRule.FirstFullWeek +sfCalendar1.Culture = info + +{% endhighlight %} + +{% endtabs %} \ No newline at end of file diff --git a/WindowsForms/Calendar/navigation.md b/WindowsForms/Calendar/navigation.md index 5aad58c..21674dc 100644 --- a/WindowsForms/Calendar/navigation.md +++ b/WindowsForms/Calendar/navigation.md @@ -9,7 +9,7 @@ documentation: ug # Navigation in Windows Forms Calendar (SfCalendar) -By default, the calendar displays the month view. You can move from current month to previous or next month in the calendar control by clicking navigation buttons in the header, and also you can move from month view to other views (year, decade, century) to select the dates from other year or decade by click the header text of the calendar. +By default, the calendar displays the month view. You can move from current month to previous or next month in the calendar control by clicking navigation buttons in the header, and also you can move from month view to other views (year, decade, century) to select the dates from other year or decade by clicking the header text of the calendar. ## Different views diff --git a/WindowsForms/Calendar/selection-images/disable_Weekends.png b/WindowsForms/Calendar/selection-images/disable_Weekends.png new file mode 100644 index 0000000..1e94466 Binary files /dev/null and b/WindowsForms/Calendar/selection-images/disable_Weekends.png differ diff --git a/WindowsForms/Calendar/selection.md b/WindowsForms/Calendar/selection.md index f65c509..b7e2b28 100644 --- a/WindowsForms/Calendar/selection.md +++ b/WindowsForms/Calendar/selection.md @@ -393,3 +393,27 @@ calendar.ClearSelection(new DateTime(2018, 02, 16)); {% endtabs %} ![Clear selection dates](selection-images/selection.png) + +## Disable weekends from selection + +Weekends of the calendar can be disabled by providing the Date collection to [BlackoutDates](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Input.SfCalendar.html#Syncfusion_WinForms_Input_SfCalendar_BlackoutDates). The following code snippet illustrates how to disable weekends from selection: + +{% tabs %} + +{% highlight C# %} + +// disabling the weekends + +sfCalendar1.MinDate = new DateTime(2000, 1, 05); +sfCalendar1.MaxDate = new DateTime(2500, 1, 25); +for (var date = sfCalendar1.MinDate; date <= sfCalendar1.MaxDate; date = date.AddDays(1)) + { + if (date.DayOfWeek == DayOfWeek.Sunday || date.DayOfWeek == DayOfWeek.Saturday) + sfCalendar1.BlackoutDates.Add(date); + } + +{% endhighlight %} + +{% endtabs %} + +![Disable WeekEnds](selection-images/disable_Weekends.png) diff --git a/WindowsForms/Classic/ComboBox/Event-handling.md b/WindowsForms/Classic/ComboBox/Event-handling.md index 6354d63..11a7737 100644 --- a/WindowsForms/Classic/ComboBox/Event-handling.md +++ b/WindowsForms/Classic/ComboBox/Event-handling.md @@ -97,7 +97,7 @@ No No -Drop-Down Close by Click +Drop-Down Close by clicking Yes:1 Yes:2 Yes:3 diff --git a/WindowsForms/ComboBox/DataBinding.md b/WindowsForms/ComboBox/DataBinding.md index 5544584..535bc0e 100644 --- a/WindowsForms/ComboBox/DataBinding.md +++ b/WindowsForms/ComboBox/DataBinding.md @@ -97,6 +97,113 @@ End Class [View sample in GitHub](https://github.com/SyncfusionExamples/How-to-bind-the-data-in-WinForms-SfComboBox) + +## Binding Data from Microsoft Access + +SfComboBox control supports to bind data from Microsoft Access database. This section describes about how to bind the data from Microsoft Access database to SfComboBox. + +### Importing Microsoft Access Database +To load the data from Microsoft Access database, follow the below steps. + +1) On the **View** menu, select **Other Windows > Data Sources**. + +2) In the **Data Sources** window, click **Add New Data Source**, the DataSource configuration wizard will be opened. + +![Choose the datasource type through the visual studio](DataBinding_images/DataBinding_img1.jpeg) + +3) Select **Database** on the **Choose a Data Source Type** page, and then select **Next**. + +![Choose the datasource model through the visual studio](DataBinding_images/DataBinding_img2.jpeg) + +4) On the **Choose your Data Connection** page, select **New Connection** to configure a new data connection and Change the **Data source** to **.NET Framework Data Provider for OLE DB**. + +![Choose the data connetion through the visual studio](DataBinding_images/DataBinding_img3.jpeg) + +5) In **OLE DB Provider**, select **Microsoft Office 12.0 Access Database Engine OLE DB Provider**. In **Server or file name**, specify the path and name of the .accdb file to which want to connect, and then select **OK**. + +![Choose the data provider through the visual studio](DataBinding_images/DataBinding_img4.jpeg) + +6) Select **Next** on the **Choose your Data Connection** page. + +7) Select **Next** on the **Save connection string to the Application Configuration file** page. + +8) Expand the **Tables** node on the **Choose your Database Objects** page. + +![Choose the data base objects through the visual studio](DataBinding_images/DataBinding_img5.jpg) + +9) Select whatever tables or views in the dataset, and then select **Finish**. + +### Loading Data from Microsoft Access Database +To access the Microsoft Access database, follow the below steps. +1) The **DataSource** property can be customized at designer level like below, + +![Choose the data source through the visual studio](DataBinding_images/DataBinding_img6.jpg) + +2) The value for **DisplayMember** and **ValueMember** properties can be selected as like below, + +![Choose the display member through the visual studio](DataBinding_images/DataBinding_img7.jpg) + +![Choose the value member through the visual studio](DataBinding_images/DataBinding_img8.jpg) + +3) Based on the **DataSource** binding with the SfComboBox control, the items can be displayed by using **DisplayMember** and **ValueMember** properties. + +![Displayed the items using data source binding through the visual studio](DataBinding_images/DataBinding_img9.jpg) + +## Binding Data from LINQ to SQL +SfComboBox control supports to bind data from LINQ to SQL. This walkthrough, describes about binding data from LINQ to SQL and save back the changes to the Database. + +### Adding Data Model using LINQ to SQL +To create data model using LINQ to SQL in WF project follow the below steps. +1) Right click on the project, Select **Add** option and then click **New Item**. +2) The Add New Item wizard appears, Select **LINQ to SQL Classes** from the **Visual C#**. +3) Name the file as **Northwind** and then select **Add** option to add the **Northwind.dbml** in the project. + +![Choose the data model from LINQ to SQL from the visual studio](DataBinding_images/DataBinding_img10.jpeg) + +4) Once the **Northwind.dbml** is added in the project, then the design view is opened. + +![Connect the database through the visual studio](DataBinding_images/DataBinding_img11.jpeg) + +5) New Database connection can be added by clicking add icon button in Server Explorer. + +6) The **Add Connection** wizard appeared with the default data source as **Microsoft SQL Server Database File (SqlClient**). + +![Connect the database through the visual studio](DataBinding_images/DataBinding_img12.jpeg) + +7) Click **Change** to open the **Change Data Source** dialog box and select the type of data source as **Microsoft SQL Server Database File (SqlClient).** + +![Change the database through the visual studio](DataBinding_images/DataBinding_img13.jpeg) + +8) Select the Database file name and click on **Test Connection** to check the connection with the database. + +![Choose the database through the visual studio](DataBinding_images/DataBinding_img14.jpeg) + +9) Once the connection is succeeded, click **OK** button to add database in the server explorer. + +![Connected databases in the projects](DataBinding_images/DataBinding_img15.jpg) + +10) Drag **Employees** table in to design view of **Northwind.dbml**. The Entity model diagram for **Employees** table is generated once it is dropped in to design view. + + +### Loading Data from LINQ to SQL Classes + +The data from the defined data model of the LINQ to SQL classes can be loaded as a data source to the SfComboBox by loading the **Employees** table by the created data context for the **Northwnd** database. + +1) The **DataSource** property can be customized at designer level like below, + +![Choose the data source through the visual studio](DataBinding_images/DataBinding_img6.jpg) + +2) The value for **DisplayMember** and **ValueMember** properties can be selected as like below, + +![Choose the display member through the visual studio](DataBinding_images/DataBinding_img7.jpg) + +![Choose the value member through the visual studio](DataBinding_images/DataBinding_img8.jpg) + +3) Based on the **DataSource** binding with the SfComboBox control, the items can be displayed by using **DisplayMember** and **ValueMember** properties. + +![Displayed the items using data source binding through the visual studio](DataBinding_images/DataBinding_img9.jpg) + + ## See Also [How to disable some items WinForms ComboBox dropdown?](https://www.syncfusion.com/kb/11254/how-to-disable-some-items-winforms-combobox-dropdown) diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img1.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img1.jpeg new file mode 100644 index 0000000..4e79ead Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img1.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img10.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img10.jpeg new file mode 100644 index 0000000..efd6c71 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img10.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img11.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img11.jpeg new file mode 100644 index 0000000..05fbca6 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img11.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img12.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img12.jpeg new file mode 100644 index 0000000..3b712d4 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img12.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img13.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img13.jpeg new file mode 100644 index 0000000..fa86f30 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img13.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img14.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img14.jpeg new file mode 100644 index 0000000..005d775 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img14.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img15.jpg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img15.jpg new file mode 100644 index 0000000..44a80d7 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img15.jpg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img2.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img2.jpeg new file mode 100644 index 0000000..6483f9d Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img2.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img3.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img3.jpeg new file mode 100644 index 0000000..8a159fd Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img3.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img4.jpeg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img4.jpeg new file mode 100644 index 0000000..4c7150c Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img4.jpeg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img5.jpg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img5.jpg new file mode 100644 index 0000000..ec707fb Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img5.jpg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img6.jpg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img6.jpg new file mode 100644 index 0000000..d61a522 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img6.jpg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img7.jpg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img7.jpg new file mode 100644 index 0000000..cb730eb Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img7.jpg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img8.jpg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img8.jpg new file mode 100644 index 0000000..16f0a45 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img8.jpg differ diff --git a/WindowsForms/ComboBox/DataBinding_images/DataBinding_img9.jpg b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img9.jpg new file mode 100644 index 0000000..ea44182 Binary files /dev/null and b/WindowsForms/ComboBox/DataBinding_images/DataBinding_img9.jpg differ diff --git a/WindowsForms/ComboBox/DropDown.md b/WindowsForms/ComboBox/DropDown.md index e7c82fe..d8823dc 100644 --- a/WindowsForms/ComboBox/DropDown.md +++ b/WindowsForms/ComboBox/DropDown.md @@ -79,6 +79,47 @@ End Sub {% endhighlight %} {% endtabs %} +## Customizing drop-down position + +The `SfComboBox` allows to change the position of the dropdown list by using the `DropDownPosition` property. The default value is `PopupRelativeAlignment.Center`. + +{% tabs %} + +{% highlight c# %} + +public partial class Form1 : Form +{ + public Form1() + { + InitializeComponent(); + Syncfusion.WinForms.ListView.SfComboBox sfComboBox1 = new Syncfusion.WinForms.ListView.SfComboBox(); + sfComboBox1.DropDownPosition = Syncfusion.WinForms.Core.Enums.PopupRelativeAlignment.RightTop; + sfComboBox1.Location = new Point(300, 180); + sfComboBox1.Size = new Size(120, 30); + sfComboBox1.ThemeName = "Office2016Colorful"; + + List usStates = new List(); + usStates.Add("Alaska"); + usStates.Add("Arizona"); + usStates.Add("Arkansas"); + usStates.Add("California"); + usStates.Add("Colorado"); + usStates.Add("Connecticut"); + usStates.Add("Delaware"); + usStates.Add("Florida"); + usStates.Add("Georgia"); + sfComboBox1.DataSource = usStates; + + this.Controls.Add(sfComboBox1); + } +} + +{% endhighlight %} + +{% endtabs %} + +![Dropdown with position](DropDown_images/DropDown_img4.png) + ## Load custom control in drop-down SfComboBox allows you to show the header and footer items in drop-down by enabling the [SfComboBox.DropDownListView.ShowHeader](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.ListView.SfListView.html#Syncfusion_WinForms_ListView_SfListView_ShowHeader) and [SfComboBox.DropDownListView.ShowFooter](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.ListView.SfListView.html#Syncfusion_WinForms_ListView_SfListView_ShowFooter) properties. This also allows you to load a custom control using the [SfComboBox.DropDownListView.HeaderControl](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.ListView.SfListView.html#Syncfusion_WinForms_ListView_SfListView_HeaderControl) and [SfComboBox.DropDownListView.FooterControl](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.ListView.SfListView.html#Syncfusion_WinForms_ListView_SfListView_FooterControl) properties. diff --git a/WindowsForms/ComboBox/DropDown_images/DropDown_img4.png b/WindowsForms/ComboBox/DropDown_images/DropDown_img4.png new file mode 100644 index 0000000..e9fba8a Binary files /dev/null and b/WindowsForms/ComboBox/DropDown_images/DropDown_img4.png differ diff --git a/WindowsForms/ComboBox/Selection.md b/WindowsForms/ComboBox/Selection.md index 6ca5527..6217472 100644 --- a/WindowsForms/ComboBox/Selection.md +++ b/WindowsForms/ComboBox/Selection.md @@ -7,7 +7,7 @@ control: SfComboBox documentation: ug --- -# Selection +# Selection in SfComboBox The SfComboBox allows you to select single or multiple items in the drop-down list. The selection mode can be set by using the [ComboBoxMode](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.ListView.SfComboBox.html#Syncfusion_WinForms_ListView_SfComboBox_ComboBoxMode) property. @@ -268,3 +268,95 @@ Private Sub SfComboBox1_ToolTipOpening(ByVal sender As Object, ByVal e As ComboB End Sub {% endhighlight %} {% endtabs %} + + +## Clear selection + +The `SfComboBox` allows to show or hide the clear button by using the `ShowClearButton` property. When pressing the clear button it will clear the selected items and editor portion. + +N> This clear button will be visible only when the selection or editing takes place inside the SfComboBox. + +{% tabs %} + +{% highlight c# %} + +public partial class Form1 : Form +{ + public Form1() + { + InitializeComponent(); + Syncfusion.WinForms.ListView.SfComboBox sfComboBox1 = new Syncfusion.WinForms.ListView.SfComboBox(); + sfComboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend; + sfComboBox1.Location = new Point(300, 180); + sfComboBox1.Size = new Size(120, 30); + sfComboBox1.ShowClearButton = true; + sfComboBox1.ThemeName = "Office2016Colorful"; + + List usStates = new List(); + usStates.Add("Alaska"); + usStates.Add("Arizona"); + usStates.Add("Arkansas"); + usStates.Add("California"); + usStates.Add("Colorado"); + usStates.Add("Connecticut"); + usStates.Add("Delaware"); + usStates.Add("Florida"); + usStates.Add("Georgia"); + sfComboBox1.DataSource = usStates; + + this.Controls.Add(sfComboBox1); + } +} + +{% endhighlight %} + +{% endtabs %} + +![ClearButton image](Selection_images/Selection_img9.png) + +### Clear button appearance + +Appearance of the clear button can be customized by setting the `ClearButtonStyle` property. + +{% tabs %} + +{% highlight c# %} + +public partial class Form1 : Form +{ + public Form1() + { + InitializeComponent(); + Syncfusion.WinForms.ListView.SfComboBox sfComboBox1 = new Syncfusion.WinForms.ListView.SfComboBox(); + sfComboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend; + sfComboBox1.Location = new Point(300, 180); + sfComboBox1.Size = new Size(120, 30); + sfComboBox1.ShowClearButton = true; + sfComboBox1.ThemeName = "Office2016Colorful"; + + List usStates = new List(); + usStates.Add("Alaska"); + usStates.Add("Arizona"); + usStates.Add("Arkansas"); + usStates.Add("California"); + usStates.Add("Colorado"); + usStates.Add("Connecticut"); + usStates.Add("Delaware"); + usStates.Add("Florida"); + usStates.Add("Georgia"); + sfComboBox1.DataSource = usStates; + + sfComboBox1.Style.ClearButtonStyle.BackColor = Color.Yellow; + sfComboBox1.Style.ClearButtonStyle.ForeColor = Color.Red; + sfComboBox1.Style.ClearButtonStyle.HoverBackColor = Color.OrangeRed; + sfComboBox1.Style.ClearButtonStyle.HoverForeColor = Color.Yellow; + + this.Controls.Add(sfComboBox1); + } +} + +{% endhighlight %} + +{% endtabs %} + +![ClearButton with appearance](Selection_images/Selection_img10.png) diff --git a/WindowsForms/ComboBox/Selection_images/Selection_img10.png b/WindowsForms/ComboBox/Selection_images/Selection_img10.png new file mode 100644 index 0000000..5179abc Binary files /dev/null and b/WindowsForms/ComboBox/Selection_images/Selection_img10.png differ diff --git a/WindowsForms/ComboBox/Selection_images/Selection_img9.png b/WindowsForms/ComboBox/Selection_images/Selection_img9.png new file mode 100644 index 0000000..89c965b Binary files /dev/null and b/WindowsForms/ComboBox/Selection_images/Selection_img9.png differ diff --git a/WindowsForms/ComboBoxBase/Event-Handling.md b/WindowsForms/ComboBoxBase/Event-Handling.md index 04ae12d..5c66b0c 100644 --- a/WindowsForms/ComboBoxBase/Event-Handling.md +++ b/WindowsForms/ComboBoxBase/Event-Handling.md @@ -66,7 +66,7 @@ No No -Drop-Down Close by Click +Drop-Down Close by clicking Yes:1 Yes:2 Yes:3 diff --git a/WindowsForms/DataGrid/ColumnTypes.md b/WindowsForms/DataGrid/ColumnTypes.md index 4af75c3..6c6e9c3 100644 --- a/WindowsForms/DataGrid/ColumnTypes.md +++ b/WindowsForms/DataGrid/ColumnTypes.md @@ -742,7 +742,7 @@ TryCast(Me.sfDataGrid1.Columns("IsClosed"), GridCheckBoxColumn).AllowCheckBoxOnH All the checkboxes in a column will be checked/unchecked by clicking on the CheckBox in the header. -![Winforms datagrid shows to display the all checked/unchecked by click on the checkbox in the header in datagrid windows form](ColumnTypes_images/ColumnTypes_img22.png) +![Winforms datagrid shows to display the all checked/unchecked by clicking on the checkbox in the header in datagrid windows form](ColumnTypes_images/ColumnTypes_img22.png) By default, enabling the [AllowCheckBoxOnHeader](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.DataGrid.GridCheckBoxColumn.html#Syncfusion_WinForms_DataGrid_GridCheckBoxColumn_AllowCheckBoxOnHeader) property will display the checkbox with text on the header cell of [GridCheckBoxColumn](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.DataGrid.GridCheckBoxColumn.html). The text in the header cell can be disabled by setting empty value for the [HeaderText](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.DataGrid.GridColumnBase.html#Syncfusion_WinForms_DataGrid_GridColumnBase_HeaderText) property of the column. diff --git a/WindowsForms/DateTimePicker/Appearance.md b/WindowsForms/DateTimePicker/Appearance.md index e80980e..2359dc6 100644 --- a/WindowsForms/DateTimePicker/Appearance.md +++ b/WindowsForms/DateTimePicker/Appearance.md @@ -273,7 +273,7 @@ Me.dateTimeEdit.Width = 294 ## Show Week Numbers -Week numbers can be displayed by setting `[ShowWeekNumbers](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Input.SfCalendar.html#Syncfusion_WinForms_Input_SfCalendar_ShowWeekNumbers) property as `true`. +Week numbers can be displayed by setting [ShowWeekNumbers](https://help.syncfusion.com/cr/windowsforms/Syncfusion.WinForms.Input.SfCalendar.html#Syncfusion_WinForms_Input_SfCalendar_ShowWeekNumbers) property as `true`. {% tabs %} diff --git a/WindowsForms/DateTimePicker/Getting-Started.md b/WindowsForms/DateTimePicker/Getting-Started.md index 99b9335..b3b3105 100644 --- a/WindowsForms/DateTimePicker/Getting-Started.md +++ b/WindowsForms/DateTimePicker/Getting-Started.md @@ -237,3 +237,29 @@ Me.dateTimeEdit.ShowUpDown = true {% endtabs %} ![Up down DateTimeEdit](getting-started-images/daterange.png) + +## Configure the calculation of week number based on culture + +You can get the current week number in `SfDateTimeEdit` control by changing the `CalendarWeekRule` property value of date time format in `CultureInfo`. The default value of `CalendarWeekRule` property is `FirstDay`. + +{% tabs %} + +{% highlight C# %} + +SfDateTimeEdit sfdateTimeEdit1 = new SfDateTimeEdit(); +CultureInfo info = new CultureInfo("en-EN"); +info.DateTimeFormat.CalendarWeekRule = CalendarWeekRule.FirstFullWeek; +sfdateTimeEdit1.Culture = info; + +{% endhighlight %} + +{% highlight VB %} + +Dim sfdateTimeEdit1 As SfDateTimeEdit = New SfDateTimeEdit() +Dim info As CultureInfo = New CultureInfo("en-EN") +info.DateTimeFormat.CalendarWeekRule = CalendarWeekRule.FirstFullWeek +sfdateTimeEdit1.Culture = info + +{% endhighlight %} + +{% endtabs %} diff --git a/WindowsForms/Html-Viewer/Unsupported-Formats_images/HTML_DirectLink.png b/WindowsForms/Html-Viewer/Unsupported-Formats_images/HTML_DirectLink.png new file mode 100644 index 0000000..a29c31a Binary files /dev/null and b/WindowsForms/Html-Viewer/Unsupported-Formats_images/HTML_DirectLink.png differ diff --git a/WindowsForms/MessageBox/Button-Parameters.md b/WindowsForms/MessageBox/Button-Parameters.md index 66bc6d2..2dc13c9 100644 --- a/WindowsForms/MessageBox/Button-Parameters.md +++ b/WindowsForms/MessageBox/Button-Parameters.md @@ -1,13 +1,13 @@ --- layout: post title: Button-Parameters | WindowsForms | Syncfusion -description: Button Parameters +description: Learn about various button parameters, Right to Left, Details view and Resizing support in Windows Forms MessageBoxAdv platform: WindowsForms control: MessageBoxAdv documentation: ug --- -# Parameters +# Button Parameters in Windows Forms MessageBox (MessageBoxAdv) [Show](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.MessageBoxAdv.html#Syncfusion_Windows_Forms_MessageBoxAdv_Show_System_String_) function helps to display a MessageBoxAdv. This section explains regarding the parameters available in [Show](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.MessageBoxAdv.html#Syncfusion_Windows_Forms_MessageBoxAdv_Show_System_String_) function. @@ -303,3 +303,26 @@ Eg: Collapsed view ![Collapsed view](MessageBoxAdv_images/MessageBoxAdv_img19.jpg) +## Resizing support + +MessageBoxAdv allows you to adjust the size of the control at run time by dragging the gripper at bottom right. It can be achieved by using the [CanResize](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.MessageBoxAdv.html#Syncfusion_Windows_Forms_MessageBoxAdv_CanResize) property.Its default value is false. + +{% tabs %} + +{% highlight C# %} + +MessageBoxAdv.CanResize = true; + +{% endhighlight %} + +{% highlight VB %} + +MessageBoxAdv.CanResize = True + +{% endhighlight %} + +{% endtabs %} + +![Resizing support](MessageBoxAdv_images/MessageBoxAdv_img34.png) + +You can download the sample from [here](https://github.com/SyncfusionExamples/Messageboxadv-resize-support-in-Winforms) \ No newline at end of file diff --git a/WindowsForms/MessageBox/MessageBoxAdv_images/MessageBoxAdv_img34.png b/WindowsForms/MessageBox/MessageBoxAdv_images/MessageBoxAdv_img34.png new file mode 100644 index 0000000..9960e62 Binary files /dev/null and b/WindowsForms/MessageBox/MessageBoxAdv_images/MessageBoxAdv_img34.png differ diff --git a/WindowsForms/MessageBox/Overview.md b/WindowsForms/MessageBox/Overview.md index 11535a7..285c787 100644 --- a/WindowsForms/MessageBox/Overview.md +++ b/WindowsForms/MessageBox/Overview.md @@ -7,7 +7,7 @@ control: MessageBoxAdv documentation: ug --- -# Overview +# Windows Forms MessageBox (MessageBoxAdv) Overview The [MessageBoxAdv](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.MessageBoxAdv.html) is an advanced MessageBox control that can be used to display a message to the end-user. It provides icons, buttons support and complete customization option for the control. @@ -22,4 +22,4 @@ The [MessageBoxAdv](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windo * **Visual Styles** - Provides rich set of VisualStyle to customize the look and feel of MessageBoxAdv. * **Icons** - Supports to display wide variety of built-in icons and also empowered with loading custom icons. * **Right-to-left support** - Supports to align all the control elements in right-to-left layout. - +* **Resizing support** - Supports to adjust the size of the control at run time. diff --git a/WindowsForms/MultiColumn-ComboBox/Event-Handling.md b/WindowsForms/MultiColumn-ComboBox/Event-Handling.md index 56d3206..035d944 100644 --- a/WindowsForms/MultiColumn-ComboBox/Event-Handling.md +++ b/WindowsForms/MultiColumn-ComboBox/Event-Handling.md @@ -69,7 +69,7 @@ No No -Drop-Down Close by Click +Drop-Down Close by clicking Yes:1 Yes:2 Yes:3 diff --git a/WindowsForms/MultiColumn-TreeView/Appearance.md b/WindowsForms/MultiColumn-TreeView/Appearance.md index 4181c60..177eb80 100644 --- a/WindowsForms/MultiColumn-TreeView/Appearance.md +++ b/WindowsForms/MultiColumn-TreeView/Appearance.md @@ -288,7 +288,7 @@ Apart from the Standard styles, you can create custom base styles for nodes, col For creating base styles follow the below steps, -1. Open the Base Style Collection Editor by click the BaseStyles property in property window. +1. Open the Base Style Collection Editor by clicking the BaseStyles property in property window. ![](Appearance_Images/Appearance_img7.jpg) diff --git a/WindowsForms/MultiColumn-TreeView/Filtering_Images/Filtering.png b/WindowsForms/MultiColumn-TreeView/Filtering_Images/Filtering.png new file mode 100644 index 0000000..b9344a3 Binary files /dev/null and b/WindowsForms/MultiColumn-TreeView/Filtering_Images/Filtering.png differ diff --git a/WindowsForms/Release-notes/v19.1.0.54.md b/WindowsForms/Release-notes/v19.1.0.54.md new file mode 100644 index 0000000..3d0a421 --- /dev/null +++ b/WindowsForms/Release-notes/v19.1.0.54.md @@ -0,0 +1,17 @@ +--- +title: Essential Studio for Windows Forms 2021 volume 1 Main Release Notes +description: Essential Studio for Windows Forms 2021 volume 1 Main Release Notes +platform: windowsforms +documentation: ug +--- + +# Essential Studio for Windows Forms Release Notes + +{% include release-info.html date="March 30, 2021" version="v19.1.0.54" %} + + +{% directory path: _includes/release-notes/v19.1.0.54 %} + +{% include {{file.url}} %} + +{% enddirectory %} \ No newline at end of file diff --git a/WindowsForms/Ribbon/Appearance.md b/WindowsForms/Ribbon/Appearance.md index 6aaff1d..7e1226d 100644 --- a/WindowsForms/Ribbon/Appearance.md +++ b/WindowsForms/Ribbon/Appearance.md @@ -1,13 +1,13 @@ --- layout: post title: Appearance | WindowsForms | Syncfusion -description: appearance +description: This topic showcases various visual styles and the customizations available in Syncfusion Windows Forms RibbonControlAdv. platform: WindowsForms control: RibbonControlAdv documentation: ug --- -# Appearance +# Appearance in Windows Forms Ribbon The Ribbon control ships with several built-in themes such as Office2007, Office2010, Office2013, TouchStyle and Office2016. All these themes can be applied with the ribbon property `RibbonStyle`. @@ -36,23 +36,23 @@ Me.ribbonControlAdv1.RibbonStyle = RibbonStyle.Office2016 * Office 2016 Style -![](Appearance_Images/Appearance_img1.jpg) +![Office 2016 style](Appearance_Images/Appearance_img1.jpg) * Touch Style -![](Appearance_Images/Appearance_img2.jpg) +![Touch style](Appearance_Images/Appearance_img2.jpg) * Office 2013 Style -![](Appearance_Images/Appearance_img3.jpg) +![Office 2013 Style](Appearance_Images/Appearance_img3.jpg) * Office 2010 Style -![](Appearance_Images/Appearance_img4.jpg) +![Office 2010 Style](Appearance_Images/Appearance_img4.jpg) * Office 2007 Style -![](Appearance_Images/Appearance_img5.jpg) +![Office 2007 Style](Appearance_Images/Appearance_img5.jpg) ## Style through SkinManager @@ -99,7 +99,7 @@ The RibbonControlAdv includes new color schemes as available in the Office 2016 * DarkGray * Black -![](Appearance_Images/Appearance_img6.jpg) +![Various Office 2016 Color Schemes](Appearance_Images/Appearance_img6.jpg) The following code sample illustrates how to set the Colorful theme for the Office 2016 style RibbonControlAdv. @@ -131,7 +131,7 @@ Office 2013 theme now supports three color schemes: * DarkGray * Managed -![](Appearance_Images/Appearance_img7.jpg) +![Various Office 2013 Color Schemes](Appearance_Images/Appearance_img7.jpg) The following code sample illustrates how to set the scheme for the Office 2013 style RibbonControlAdv. @@ -164,7 +164,7 @@ The Ribbon Control Adv has come up with the same visual style of Office 2007. Th It can be set through the `OfficeColorScheme` property of the RibbonControlAdv class. -![](Appearance_Images/Appearance_img8.jpg) +![Various Office 2007 Color Schemes](Appearance_Images/Appearance_img8.jpg) {% tabs %} @@ -211,7 +211,7 @@ Office12ColorTable.ApplyManagedColors(Me, Color.Red) {% endtabs %} -![](Appearance_Images/Appearance_img9.jpg) +![Custom Color Schemes](Appearance_Images/Appearance_img9.jpg) ## Color Table @@ -223,11 +223,11 @@ RibbonControlAdv can now be fully customized in Office2016 style under Colorful In the property window of the Ribbon, click the Office2016ColorTable property. The following window will be shown -![](Appearance_Images/Appearance_img10.jpg) +![Office 2016 Color Table Editor](Appearance_Images/Appearance_img10.jpg) Click Add button to customize the RibbonControlAdv with the Office2016ColorTable property. -![](Appearance_Images/Appearance_img11.jpg) +![Adding Office 2016 Color Table](Appearance_Images/Appearance_img11.jpg) To achieve the above customization through code behind @@ -260,6 +260,12 @@ color.BackStageItemSelectionColor = Color.FromArgb(62, 109, 181); // To set the BackStageButton ForeColor color.BackStageItemForeColor = Color.White; +// To set the hover fore color for BackStage items. +color.BackStageItemHoverForeColor = Color.White; + +// To set the selection fore color for BackStage items. +color.BackStageItemSelectionForeColor = Color.White; + // To set the Backstage title fore color color.BackStageTitleColor = ColorTranslator.FromHtml("#3a3a3a"); @@ -418,6 +424,10 @@ this.ribbonControlAdv1.Office2016ColorTable.Add(color); color.BackStageItemForeColor = Color.White + color.BackStageItemHoverForeColor = Color.White + + color.BackStageItemSelectionForeColor = Color.White + color.BackStageTitleColor = ColorTranslator.FromHtml("#3a3a3a") color.BackStageSystemButtonBackground = ColorTranslator.FromHtml("#c5c5c5") @@ -500,7 +510,7 @@ this.ribbonControlAdv1.Office2016ColorTable.Add(color); {% endtabs %} -![](Appearance_Images/Appearance_img12.jpg) +![Ribbon customized wth Office2016ColorTable](Appearance_Images/Appearance_img12.jpg) **Offcie2013 Style Color Table** @@ -693,7 +703,7 @@ Dim color As Office2013ColorTable = New Office2013ColorTable() {% endtabs %} -![](Appearance_Images/Appearance_img13.jpg) +![Ribbon customized wth Office2013ColorTable](Appearance_Images/Appearance_img13.jpg) **Touch Style Color Table** @@ -899,6 +909,14 @@ _touchColorTable.ToolStripSpliterColor = Color.Red; _touchColorTable.ToolstripTabItemForeColor = Color.White; +// To set the hover fore color for BackStage items. + +_touchColorTable.BackStageItemHoverForeColor = Color.White; + +// To set the selection fore color for BackStage items. + +_touchColorTable.BackStageItemSelectionForeColor = Color.White; + //To apply TouchStyleColorTable for RibbonControlAdv this.ribbonControlAdv1.ApplyTouchStyleColorTable(_touchColorTable); @@ -1005,13 +1023,21 @@ this.ribbonControlAdv1.ApplyTouchStyleColorTable(_touchColorTable); _touchColorTable.ToolstripTabItemForeColor = Color.White + // To set the hover fore color for BackStage items. + + _touchColorTable.BackStageItemHoverForeColor = Color.White + + // To set the selection fore color for BackStage items. + + _touchColorTable.BackStageItemSelectionForeColor = Color.White + Me.ribbonControlAdv1.ApplyTouchStyleColorTable(_touchColorTable) {% endhighlight %} {% endtabs %} -![](Appearance_Images/Appearance_img14.jpg) +![Ribbon customized wth TouchStyleColorTable](Appearance_Images/Appearance_img14.jpg) ## EnableHighContrastTheme diff --git a/WindowsForms/Ribbon/Appearance_Images/Appearance_img6.jpg b/WindowsForms/Ribbon/Appearance_Images/Appearance_img6.jpg index 59c81e7..f593811 100644 Binary files a/WindowsForms/Ribbon/Appearance_Images/Appearance_img6.jpg and b/WindowsForms/Ribbon/Appearance_Images/Appearance_img6.jpg differ diff --git a/WindowsForms/Ribbon/Appearance_Images/Appearance_img7.jpg b/WindowsForms/Ribbon/Appearance_Images/Appearance_img7.jpg index e5aa3ea..fd3ed66 100644 Binary files a/WindowsForms/Ribbon/Appearance_Images/Appearance_img7.jpg and b/WindowsForms/Ribbon/Appearance_Images/Appearance_img7.jpg differ diff --git a/WindowsForms/Ribbon/Appearance_Images/Appearance_img8.jpg b/WindowsForms/Ribbon/Appearance_Images/Appearance_img8.jpg index 2e7fa29..03fa6c8 100644 Binary files a/WindowsForms/Ribbon/Appearance_Images/Appearance_img8.jpg and b/WindowsForms/Ribbon/Appearance_Images/Appearance_img8.jpg differ diff --git a/WindowsForms/Ribbon/BackStage_Images/Backstage_img12.jpg b/WindowsForms/Ribbon/BackStage_Images/Backstage_img12.jpg new file mode 100644 index 0000000..9c7ece0 Binary files /dev/null and b/WindowsForms/Ribbon/BackStage_Images/Backstage_img12.jpg differ diff --git a/WindowsForms/Ribbon/BackStage_Images/Backstage_img3.jpg b/WindowsForms/Ribbon/BackStage_Images/Backstage_img3.jpg index 3ae0158..b6746fd 100644 Binary files a/WindowsForms/Ribbon/BackStage_Images/Backstage_img3.jpg and b/WindowsForms/Ribbon/BackStage_Images/Backstage_img3.jpg differ diff --git a/WindowsForms/Ribbon/BackStage_Images/Backstage_img9.jpg b/WindowsForms/Ribbon/BackStage_Images/Backstage_img9.jpg index 98f974e..f77b7f8 100644 Binary files a/WindowsForms/Ribbon/BackStage_Images/Backstage_img9.jpg and b/WindowsForms/Ribbon/BackStage_Images/Backstage_img9.jpg differ diff --git a/WindowsForms/Ribbon/Backstage.md b/WindowsForms/Ribbon/Backstage.md index 17d9c5a..f994b5e 100644 --- a/WindowsForms/Ribbon/Backstage.md +++ b/WindowsForms/Ribbon/Backstage.md @@ -1,43 +1,43 @@ --- layout: post title: Backstage | WindowsForms | Syncfusion -description: backstage +description: This section briefly describes the basic functions of BackStage in RibbonControlAdv for Windows Forms. platform: WindowsForms control: RibbonControlAdv documentation: ug --- -# Backstage +# BackStage settings in Ribbon The Ribbon Backstage will appear when the user clicks on Menu button, it allows to make actions for the whole document such as Save, Save As and print. It can be used to show the recent changes in the document and even closing the application. Backstage structure will have two areas, left side which contain all the items in backstage panel and the right side which shows content of the BackstageTab. -There are three items that can be used in Backtage. They are +There are three items that can be used in BackStage. They are * BackStage Button – A clickable item which acts as a simple button. * BackStageTab – A simple tab, as you click on it, displays its content. * BackStageSeparator – A simple line which separates neighboring items and can be used to differentiate different set of items to improve readability. -![](BackStage_Images/Backstage_img1.jpg) +![BackStage image](BackStage_Images/Backstage_img1.jpg) ## Open BackStage In designer backstage can be opened by using smart tag of the backstage control below the designer and select `ShowBackstage`. -![](BackStage_Images/Backstage_img2.jpg) +![ShowBackStage image](BackStage_Images/Backstage_img2.jpg) Or backstage can be accessed by going into BackStage property grid and changing `IsVisible` as true. In run time BackStage can be opened by right clicking on the `MenuButton`. -![](BackStage_Images/Backstage_img3.jpg) +![MenuButton image](BackStage_Images/Backstage_img3.jpg) ## Create BackStage Button BackStage Button can be added through Smart tag of backstage view and it can be customized using property grid of that button. -![](BackStage_Images/Backstage_img4.jpg) +![BackStage button image](BackStage_Images/Backstage_img4.jpg) Through coding @@ -91,7 +91,7 @@ Me.backStage1.Controls.Add(exitBackStageButton) BackStage Tab can be added through smart tag of backstage view and it can be customized using the property grid. -![](BackStage_Images/Backstage_img5.jpg) +![BackStage tab image](BackStage_Images/Backstage_img5.jpg) Through coding @@ -153,19 +153,19 @@ Me.backStage1.Controls.Add(printBackStageTab) {% endtabs %} -![](BackStage_Images/Backstage_img6.jpg) +![BackStage with items](BackStage_Images/Backstage_img6.jpg) ### Adding Controls into BackStageTab If backstage view is visible on the designer, select the tab and on left side empty space is available to add the controls for that tab, you can add the controls in that area from toolbox. -![](BackStage_Images/Backstage_img7.jpg) +![Controls with BackStageTab](BackStage_Images/Backstage_img7.jpg) ## Add Separator Separator can be added through Smart tag as explained in adding backstage button and tab. -![](BackStage_Images/Backstage_img8.jpg) +![BackStage Separator image](BackStage_Images/Backstage_img8.jpg) ## Add Header Image @@ -187,9 +187,9 @@ Me.ribbonControlAdv1.RibbonHeaderImage = RibbonHeaderImage.Lines {% endtabs %} -![](BackStage_Images/Backstage_img9.jpg) +![Header image with Ribbon](BackStage_Images/Backstage_img9.jpg) -![](BackStage_Images/Backstage_img10.jpg) +![Header image with BackStage](BackStage_Images/Backstage_img10.jpg) To set custom image to the Ribbon header, set an image to the property `CustomRibbonHeaderImage`. @@ -259,7 +259,7 @@ Me.ribbonControlAdv1.MenuButtonEnabled = False The file tab located at left end of the ribbon is the menu button, it is used to open backstage at run time. -![](BackStage_Images/Backstage_img11.jpg) +![MenuButton image](BackStage_Images/Backstage_img11.jpg) ### Menu Button Text @@ -320,3 +320,105 @@ Me.ribbonControlAdv1.MenuColor = Color.Red {% endhighlight %} {% endtabs %} + +## BackStage items placement + +The `BackStage` items listed below can be positioned either at top or bottom by using the `Placement` property. + +* BackStageButton +* BackStageTab +* BackStageSeparator + +The following code example illustrates how to position the BackStage items either at top or bottom. + +{% tabs %} + +{% highlight c# %} + +using Syncfusion.Windows.Forms.Tools; + +public partial class Form1 : RibbonForm +{ + private Syncfusion.Windows.Forms.Tools.RibbonControlAdv ribbonControlAdv1; + private Syncfusion.Windows.Forms.Tools.ToolStripTabItem homeTabItem; + private Syncfusion.Windows.Forms.Tools.ToolStripTabItem sendTabItem; + private Syncfusion.Windows.Forms.Tools.ToolStripTabItem folderTabItem; + private Syncfusion.Windows.Forms.Tools.ToolStripEx newToolStripEx; + private Syncfusion.Windows.Forms.BackStageView backStageView1; + private Syncfusion.Windows.Forms.BackStage backStage1; + private Syncfusion.Windows.Forms.BackStageTab openExportBackStageTab; + private Syncfusion.Windows.Forms.BackStageTab saveAttachmentsBackStageTab; + private Syncfusion.Windows.Forms.BackStageTab openBackStageTab; + private Syncfusion.Windows.Forms.BackStageTab officeAccountsBackStageTab; + private Syncfusion.Windows.Forms.BackStageSeparator backStageSeparator; + private Syncfusion.Windows.Forms.BackStageTab printBackStageTab; + private Syncfusion.Windows.Forms.BackStageButton closeBackStageButton; + + public Form1() + { + InitializeComponent(); + this.ribbonControlAdv1 = new Syncfusion.Windows.Forms.Tools.RibbonControlAdv(); + this.homeTabItem = new Syncfusion.Windows.Forms.Tools.ToolStripTabItem(); + this.sendTabItem = new Syncfusion.Windows.Forms.Tools.ToolStripTabItem(); + this.folderTabItem = new Syncfusion.Windows.Forms.Tools.ToolStripTabItem(); + this.newToolStripEx = new Syncfusion.Windows.Forms.Tools.ToolStripEx(); + this.backStageView1 = new Syncfusion.Windows.Forms.BackStageView(this.components); + this.backStage1 = new Syncfusion.Windows.Forms.BackStage(); + this.openExportBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.saveAttachmentsBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.openBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.officeAccountsBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.backStageSeparator = new Syncfusion.Windows.Forms.BackStageSeparator(); + this.printBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.closeBackStageButton = new Syncfusion.Windows.Forms.BackStageButton(); + + this.ribbonControlAdv1.BackStageView = this.backStageView1; + this.ribbonControlAdv1.MenuButtonText = "File"; + this.ribbonControlAdv1.Size = new System.Drawing.Size(1036, 160); + this.ribbonControlAdv1.RibbonStyle = RibbonStyle.Office2016; + this.Controls.Add(ribbonControlAdv1); + + this.homeTabItem.Text = "Home"; + this.sendTabItem.Text = "Send"; + this.folderTabItem.Text = "Folder"; + + this.ribbonControlAdv1.Header.AddMainItem(this.homeTabItem); + this.ribbonControlAdv1.Header.AddMainItem(this.sendTabItem); + this.ribbonControlAdv1.Header.AddMainItem(this.folderTabItem); + + this.newToolStripEx.GripStyle = System.Windows.Forms.ToolStripGripStyle.Hidden; + this.homeTabItem.Panel.Controls.Add(newToolStripEx); + + this.backStageView1.BackStage = this.backStage1; + this.backStageView1.HostControl = null; + this.backStageView1.HostForm = this; + + this.openExportBackStageTab.Text = "Open/Export"; + this.saveAttachmentsBackStageTab.Text = "Save Attachments"; + this.openBackStageTab.Text = "Open"; + this.officeAccountsBackStageTab.Text = "Office Accounts"; + this.printBackStageTab.Text = "Print"; + this.closeBackStageButton.Text = "Close"; + + this.backStageSeparator.Placement = Syncfusion.Windows.Forms.BackStageItemPlacement.Bottom; + this.printBackStageTab.Placement = Syncfusion.Windows.Forms.BackStageItemPlacement.Bottom; + this.closeBackStageButton.Placement = Syncfusion.Windows.Forms.BackStageItemPlacement.Bottom; + + this.backStage1.Controls.Add(openExportBackStageTab); + this.backStage1.Controls.Add(saveAttachmentsBackStageTab); + this.backStage1.Controls.Add(openBackStageTab); + this.backStage1.Controls.Add(officeAccountsBackStageTab); + this.backStage1.Controls.Add(backStageSeparator); + this.backStage1.Controls.Add(printBackStageTab); + this.backStage1.Controls.Add(closeBackStageButton); + } +} + +{% endhighlight %} + +{% endtabs %} + +![BackStage placement image](BackStage_Images/Backstage_img12.jpg) + +N>[View sample in GitHub](https://github.com/SyncfusionExamples/How-to-customize-backstage-items-placement) + diff --git a/WindowsForms/Ribbon/Ribbon-Form.md b/WindowsForms/Ribbon/Ribbon-Form.md index a191bc4..3b221c8 100644 --- a/WindowsForms/Ribbon/Ribbon-Form.md +++ b/WindowsForms/Ribbon/Ribbon-Form.md @@ -7,7 +7,7 @@ control: RibbonControlAdv documentation: ug --- -# Ribbon Form +# Ribbon Form in Windows Forms `RibbonForm` is an extension that replaces the default form to enable different Visual styles to the ribbon. This RibbonForm now gives similar look and feel of Microsoft office, to its controls. @@ -118,3 +118,112 @@ this.TopLeftRadius = 20; Me.TopLeftRadius = 20 {% endhighlight %} + +## Adding user control to the title bar + +The `RibbonForm` allows to load any user control into the right side of the title bar by using the `HeaderItem` property. + +The following code example illustrates how to add the header item in title bar of the RibbonForm. + +{% tabs %} + +{% highlight c# %} + +using Syncfusion.Windows.Forms.Tools; +using Syncfusion.WinForms.Controls; + +public partial class Form1 : RibbonForm +{ + private Syncfusion.Windows.Forms.Tools.RibbonControlAdv ribbonControlAdv1; + private Syncfusion.Windows.Forms.Tools.ToolStripTabItem homeTabItem; + private Syncfusion.Windows.Forms.Tools.ToolStripTabItem sendTabItem; + private Syncfusion.Windows.Forms.Tools.ToolStripTabItem folderTabItem; + private Syncfusion.Windows.Forms.Tools.ToolStripEx newToolStripEx; + private Syncfusion.Windows.Forms.BackStageView backStageView1; + private Syncfusion.Windows.Forms.BackStage backStage1; + private Syncfusion.Windows.Forms.BackStageTab openExportBackStageTab; + private Syncfusion.Windows.Forms.BackStageTab saveAttachmentsBackStageTab; + private Syncfusion.Windows.Forms.BackStageTab openBackStageTab; + private Syncfusion.Windows.Forms.BackStageTab officeAccountsBackStageTab; + private Syncfusion.Windows.Forms.BackStageSeparator backStageSeparator; + private Syncfusion.Windows.Forms.BackStageTab printBackStageTab; + private Syncfusion.Windows.Forms.BackStageButton closeBackStageButton; + private Syncfusion.WinForms.Controls.SfButton button; + + public Form1() + { + InitializeComponent(); + this.ribbonControlAdv1 = new Syncfusion.Windows.Forms.Tools.RibbonControlAdv(); + this.homeTabItem = new Syncfusion.Windows.Forms.Tools.ToolStripTabItem(); + this.sendTabItem = new Syncfusion.Windows.Forms.Tools.ToolStripTabItem(); + this.folderTabItem = new Syncfusion.Windows.Forms.Tools.ToolStripTabItem(); + this.newToolStripEx = new Syncfusion.Windows.Forms.Tools.ToolStripEx(); + this.backStageView1 = new Syncfusion.Windows.Forms.BackStageView(this.components); + this.backStage1 = new Syncfusion.Windows.Forms.BackStage(); + this.openExportBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.saveAttachmentsBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.openBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.officeAccountsBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.backStageSeparator = new Syncfusion.Windows.Forms.BackStageSeparator(); + this.printBackStageTab = new Syncfusion.Windows.Forms.BackStageTab(); + this.closeBackStageButton = new Syncfusion.Windows.Forms.BackStageButton(); + + this.ribbonControlAdv1.BackStageView = this.backStageView1; + this.ribbonControlAdv1.MenuButtonText = "File"; + this.ribbonControlAdv1.Size = new System.Drawing.Size(1036, 160); + this.ribbonControlAdv1.RibbonStyle = RibbonStyle.Office2016; + this.Controls.Add(ribbonControlAdv1); + + this.homeTabItem.Text = "Home"; + this.sendTabItem.Text = "Send"; + this.folderTabItem.Text = "Folder"; + + this.ribbonControlAdv1.Header.AddMainItem(this.homeTabItem); + this.ribbonControlAdv1.Header.AddMainItem(this.sendTabItem); + this.ribbonControlAdv1.Header.AddMainItem(this.folderTabItem); + + this.newToolStripEx.GripStyle = System.Windows.Forms.ToolStripGripStyle.Hidden; + this.homeTabItem.Panel.Controls.Add(newToolStripEx); + + this.button = new SfButton(); + this.button.ForeColor = Color.White; + this.button.Font = Font = new System.Drawing.Font("Segoe UI Semibold", 9F); + this.button.Size = new System.Drawing.Size(75, 50); + this.button.Text = "Sign-In"; + this.button.Style.BackColor = System.Drawing.Color.FromArgb(((int)(((byte)(42)))), ((int)(((byte)(120)))), ((int)(((byte)(212))))); + this.button.Style.HoverBackColor = System.Drawing.Color.FromArgb(((int)(((byte)(42)))), ((int)(((byte)(141)))), ((int)(((byte)(212))))); + this.button.Style.FocusedBackColor = System.Drawing.Color.FromArgb(((int)(((byte)(42)))), ((int)(((byte)(87)))), ((int)(((byte)(154))))); + this.button.Style.PressedBackColor = System.Drawing.Color.FromArgb(((int)(((byte)(42)))), ((int)(((byte)(87)))), ((int)(((byte)(154))))); + this.button.Style.PressedForeColor = Color.White; + this.button.Style.HoverForeColor = Color.White; + this.button.Style.FocusedForeColor = Color.White; + this.HeaderItem = button; + + this.backStageView1.BackStage = this.backStage1; + this.backStageView1.HostControl = null; + this.backStageView1.HostForm = this; + + this.openExportBackStageTab.Text = "Open/Export"; + this.saveAttachmentsBackStageTab.Text = "Save Attachments"; + this.openBackStageTab.Text = "Open"; + this.officeAccountsBackStageTab.Text = "Office Accounts"; + this.printBackStageTab.Text = "Print"; + this.closeBackStageButton.Text = "Close"; + + this.backStage1.Controls.Add(openExportBackStageTab); + this.backStage1.Controls.Add(saveAttachmentsBackStageTab); + this.backStage1.Controls.Add(openBackStageTab); + this.backStage1.Controls.Add(officeAccountsBackStageTab); + this.backStage1.Controls.Add(backStageSeparator); + this.backStage1.Controls.Add(printBackStageTab); + this.backStage1.Controls.Add(closeBackStageButton); + } +} + +{% endhighlight %} + +{% endtabs %} + +![HeaderItem image](Ribbon_Form_Images/Ribbon-Form_img3.jpg) + +N>[View sample in GitHub](https://github.com/SyncfusionExamples/How-to-load-user-control-to-titlebar-of-RibbonForm) \ No newline at end of file diff --git a/WindowsForms/Ribbon/Ribbon_Form_Images/Ribbon-Form_img3.jpg b/WindowsForms/Ribbon/Ribbon_Form_Images/Ribbon-Form_img3.jpg new file mode 100644 index 0000000..ff52f8d Binary files /dev/null and b/WindowsForms/Ribbon/Ribbon_Form_Images/Ribbon-Form_img3.jpg differ diff --git a/WindowsForms/chart/FAQ/How-to-add-image-on-chart-area/How-to-add-image-on-chart-area.png b/WindowsForms/chart/FAQ/How-to-add-image-on-chart-area/How-to-add-image-on-chart-area.png new file mode 100644 index 0000000..f3bceeb Binary files /dev/null and b/WindowsForms/chart/FAQ/How-to-add-image-on-chart-area/How-to-add-image-on-chart-area.png differ diff --git a/WindowsForms/treeview/Appearance.md b/WindowsForms/treeview/Appearance.md index 96f7a21..25a9f99 100644 --- a/WindowsForms/treeview/Appearance.md +++ b/WindowsForms/treeview/Appearance.md @@ -229,7 +229,7 @@ It defines the style for the Nodes. BaseStylePairs property is a collection prop Apart from the Standard style, we can also create custom Base styles using the following steps in Base Styles Collection Editor -1. Open the Base Style Collection Editor by click the BaseStyles property in property window. +1. Open the Base Style Collection Editor by clicking the BaseStyles property in property window. 2. Clicking the Add Base Style button, will add a new BaseStyle whose properties can be edited.