diff --git a/wpf/Classic/GridData/Data-Binding.md b/wpf/Classic/GridData/Data-Binding.md index 7f14e57c0..cf1523f9a 100644 --- a/wpf/Classic/GridData/Data-Binding.md +++ b/wpf/Classic/GridData/Data-Binding.md @@ -8,7 +8,7 @@ documentation: ug --- # Data Binding in WPF GridDataControl -Data binding is the master feature of the GridData control. Grid must be bound to an external data source to display the data. GDC supports the following data sources such as, Data Tables, Data Sets or Custom collections of type List, Binding List, Observable Collection or Collection View Source. These data source can have multiple nested tables that is displayed hierarchically by the grouping grid. +Data binding is the master feature of the GridDataControl. Grid must be bound to an external data source to display the data. GDC supports the following data sources such as, Data Tables, Data Sets or Custom collections of type List, Binding List, Observable Collection or Collection View Source. These data source can have multiple nested tables that is displayed hierarchically by the grouping grid. ## Data Binding mechanisms @@ -60,7 +60,7 @@ When set to true, this property assigns the cell editor to the column depending ## Data Providers -An ObjectDataProvider is a class which creates an object that you can use as a binding source. The GridData control supports this class (offered by WPF platform) that creates an object in the XAML code and can be used for data binding. The ObjectDataProvider allows you to specify binding expressions against an object and its methods. You can also write custom data providers, if required. +An ObjectDataProvider is a class which creates an object that you can use as a binding source. The GridDataControl supports this class (offered by WPF platform) that creates an object in the XAML code and can be used for data binding. The ObjectDataProvider allows you to specify binding expressions against an object and its methods. You can also write custom data providers, if required. ### Example @@ -136,7 +136,7 @@ The GDC is bound with a data source provided by an object. ADO.NET is an object-oriented set of libraries that allows you to interact with different types of data sources and different types of databases. It is used by data-oriented applications for connecting to the data sources and manipulating data. It owns a set of data providers that retrieves data from the underlying sources and place it in an ADO.NET DataSet object. The DataSet object, which holds a collection of ADO.NET DataTable objects (represents the tables of data source), is created to populate a data-aware control like the grid with database data. These DataSet objects can operate independent of the .NET data providers. -Here is an example that illustrates the binding of ADO.NET Data Table with the GridData control. +Here is an example that illustrates the binding of ADO.NET Data Table with the GridDataControl. Code that Sets Up a DataTable {% highlight c# %} @@ -215,7 +215,7 @@ Some of the collection classes are as follows: Of the above classes, the ObservableCollection is widely preferred as it is more user-friendly to use in a WPF application, and can be easily created by using XAML. -Let us see an example usage of this collection class with our GridData control. +Let us see an example usage of this collection class with our GridDataControl. ### Example @@ -471,7 +471,7 @@ The GDC is bound with data using XAML code. ## Complex Property Binding -GridData control provides support to bind to complex properties through the Complex Property Binding feature. A Complex Property is one that contains multiple values, for example, an object of type "size" which contains two values – Width and Height, is represented as one property. Such complex properties are displayed in grid columns in the "Property.Member" format. For Size property, for example, the grid populates two columns namely, "Size.Width" and "Size.Height". +GridDataControl provides support to bind to complex properties through the Complex Property Binding feature. A Complex Property is one that contains multiple values, for example, an object of type "size" which contains two values – Width and Height, is represented as one property. Such complex properties are displayed in grid columns in the "Property.Member" format. For Size property, for example, the grid populates two columns namely, "Size.Width" and "Size.Height". Complex Property Binding feature is useful when the user has nested data, i.e., when data of one table is mapped to another table. @@ -589,7 +589,7 @@ Essential Grid now provides support to validate the grid data and display error To validate data errors, follow the steps below: 1. Ensure that your data source implements the IDataErrorInfo interface, in which two of the properties, Error (which we can be left empty optionally) and Indexer (where the validation code is placed) must be defined. -2. Then display the error information by setting the ShowErrorToolTips property of the GridData control to true. +2. Then display the error information by setting the ShowErrorToolTips property of the GridDataControl to true. {% capture codesnippet1 %} {% highlight c# %} @@ -600,7 +600,7 @@ dataGrid.ShowErrorTooltips = true; {% endcapture %} {{ codesnippet1 | OrderList_Indent_Level_1 }} -The following code example illustrates how the GridData control throws an error message when the Freight value becomes lesser than 10. +The following code example illustrates how the GridDataControl throws an error message when the Freight value becomes lesser than 10. {% capture codesnippet2 %} @@ -662,7 +662,7 @@ partial class Orders : IDataErrorInfo {% endcapture %} {{ codesnippet2 | OrderList_Indent_Level_2 }} -The following screenshot illustrates Data Error Validation in the GridData control. +The following screenshot illustrates Data Error Validation in the GridDataControl. ![Data binding in WPF GridData ilustrating error validation](Getting-Started_images/Getting-Started_img37.jpeg) @@ -670,7 +670,7 @@ The following screenshot illustrates Data Error Validation in the GridData contr ## Custom Data Error Validation -The GridData control supports two types of custom error validation methods. They are: +The GridDataControl supports two types of custom error validation methods. They are: * Cell Level Validation * Row Level Validation @@ -707,7 +707,7 @@ Adding CurrentCellValidating Event to an Application To add the CurrentCellValidating event to an application: -1. Add the GridData control to the application. Refer to the following section to add the GridData control to an application +1. Add the GridDataControl to the application. Refer to the following section to add the GridDataControl to an application 2. In the following code example, we have set ProductList as ItemsSource. Hooking the CurrentCellValidating event follows.  @@ -865,7 +865,7 @@ Adding RowValidating Event to an Application To add the RowValidating event to an application: -1. Add the GridData control to the application. Refer to the following section to add the GridData control to an application: +1. Add the GridDataControl to the application. Refer to the following section to add the GridDataControl to an application: In the following code we have set ProductList as ItemsSource. Hooking the RowValidating event follows. @@ -1051,7 +1051,7 @@ To add the RowValidating event to an application: ## Synchronize Current Selection -The GridData control provides support to keep any Selector-derived control synchronized with its current selection. If you change the current record in the grid, then the current selection of the other control also shifts to this new position and vice versa. It is obvious that the controls should be bound to the same data source. +The GridDataControl provides support to keep any Selector-derived control synchronized with its current selection. If you change the current record in the grid, then the current selection of the other control also shifts to this new position and vice versa. It is obvious that the controls should be bound to the same data source. The IsSynchronizedWithCurrentItem property does this work for you. It is a dependency property of Boolean type. You have to associate this property to the control that should be in sync. When this property is set to true, it keeps the controls synchronized and relieve this behavior, when set to false. @@ -1059,7 +1059,7 @@ Technically, this synchronization is achieved through CollectionView, by binding ### Example -Following is the code example that synchronizes GridData control with a ListView control. +Following is the code example that synchronizes GridDataControl with a ListView control. ListView Implementation with IsSynchronizedWithCurrentItem Set to True {% highlight xaml %} @@ -1092,7 +1092,7 @@ ScrollViewer.HorizontalScrollBarVisibility="Disabled" Background="Transparent" N {% endhighlight %} -### GridData Control Implementation +### GridDataControl Implementation {% highlight xaml %} @@ -1249,7 +1249,7 @@ Sorting can be done interactively by clicking the header or can be declared by u ### Filtering Operation -We have two modes of filtering in the WPF GridData control: Excel-like Filtering and Advanced Filtering. Both these modes are supported by unbound columns. +We have two modes of filtering in the WPF GridDataControl: Excel-like Filtering and Advanced Filtering. Both these modes are supported by unbound columns. ### Excel-like Filtering Mode @@ -1444,7 +1444,7 @@ The above method wraps the unbound column's lambda expression into an expression ### Selected Items Collection -GridData control allows you to select the required records and retrieve selected record values. Once a record is selected, it is added to the GridDataControl.SelectedItems collection and GridDataControl.SelectedItem highlights the current record in selection. +GridDataControl allows you to select the required records and retrieve selected record values. Once a record is selected, it is added to the GridDataControl.SelectedItems collection and GridDataControl.SelectedItem highlights the current record in selection. Following is the code example that iterates through the SelectedItems collections and prints the values of those records that are in selection. {% highlight c# %} diff --git a/wpf/Classic/GridData/Data-Presentation.md b/wpf/Classic/GridData/Data-Presentation.md index f827e62bc..484c0d8d8 100644 --- a/wpf/Classic/GridData/Data-Presentation.md +++ b/wpf/Classic/GridData/Data-Presentation.md @@ -8,7 +8,7 @@ documentation: ug --- # Data Presentation in WPF GridDataControl -GridData control data can be presented in several ways. +GridDataControl data can be presented in several ways. This section illustrates those data presentation techniques in the following topics: @@ -262,7 +262,7 @@ You can also perform sorting through the code. This requires you to define a num The following screenshot shows a GDC enabled with sorting feature: -![Sorting feature is now enabled in WPF GridData control](Getting-Started_images/Getting-Started_img57.jpeg) +![Sorting feature is now enabled](Getting-Started_images/Getting-Started_img57.jpeg) ### Enable/Disable Sorting @@ -320,7 +320,7 @@ N> When the grid is sorted against multiple columns, the affected column headers The following screenshot shows a multicolumn sorting enabled GDC: -![Multicolumn sorting feature is enabled in GridData control](Getting-Started_images/Getting-Started_img58.jpeg) +![Multicolumn sorting feature is enabled](Getting-Started_images/Getting-Started_img58.jpeg) ### Custom Sorting @@ -497,11 +497,11 @@ Enable Filter for the Whole Grid {% endhighlight %} -The following image shows a GridData control with filter feature enabled for "CompanyName" column: +The following image shows a GridDataControl with filter feature enabled for "CompanyName" column: ![Filter the CompanyName column in WPF GridDataControl](Getting-Started_images/Getting-Started_img60.jpeg) -CompanyName in GridData control is now enabled with filtering feature. +CompanyName in GridDataControl is now enabled with filtering feature. Here is an example code that enables filter on all the columns: @@ -1175,7 +1175,7 @@ Data Type DetailsViewTemplate -Get the user-defined UI of the details view in the form of DataTemplate. This is the core input to have the details view in the GridData control. +Get the user-defined UI of the details view in the form of DataTemplate. This is the core input to have the details view in the GridDataControl. Dependency property DataTemplate @@ -1273,7 +1273,7 @@ To view samples: ### Adding Details View to an Application -One can easily add the details view to the GridData control by defining the DetailsViewTemplate and binding it to the corresponding GridData control. In the following procedure we have bound the GridData control with a list of product information and created a details view template and bound it to the GridData control. +One can easily add the details view to the GridDataControl by defining the DetailsViewTemplate and binding it to the corresponding control. In the following procedure we have bound the GridDataControl with a list of product information and created a details view template and bound it to the control. 1. Bind an items source to the grid. Refer to the following link for more information about binding items source to the grid. [Data Binding](http://help.syncfusion.com/wpf/griddata/data-binding) 2. Define a data template for the details view. You can bind the data by fetching it through Record.Data (data is the underlying object bound). @@ -1360,7 +1360,7 @@ One can easily add the details view to the GridData control by defining the Deta ~~~ -3. Bind the defined data template to the GridData control. +3. Bind the defined data template to the GridDataControl. ~~~ xaml @@ -1484,9 +1484,9 @@ dataGrid.Model.TableProperties.DragIndicatorOuterBrush = Brushes.Black; ## Column Options -The GridData control provides support to customize the individual columns in the grid by using the Column Options feature. The customization options are wrapped up into a panel that pops up on clicking the ColumnOptions icon in the column header, so that the users can work with them in an interactive manner. With this feature now available, you can toggle the customization options within seconds, without writing much code. +The GridDataControl provides support to customize the individual columns in the grid by using the Column Options feature. The customization options are wrapped up into a panel that pops up on clicking the ColumnOptions icon in the column header, so that the users can work with them in an interactive manner. With this feature now available, you can toggle the customization options within seconds, without writing much code. -You can enable or disable this feature by using the ShowColumnOptions property of the GridData control. +You can enable or disable this feature by using the ShowColumnOptions property of the GridDataControl. {% tabs %} @@ -1512,7 +1512,7 @@ The following screenshot illustrates how the ColumnOptions icon is displayed for ### Customization Options -The following are the column customization options provided by the GridData control. +The following are the column customization options provided by the GridDataControl. Column Option @@ -2323,7 +2323,7 @@ summaryRow.RowStyle.Background = new SolidColorBrush(Colors.LightGreen); ## Hierarchy -GridData control can display nested tables in a hierarchy using a master-detail configuration. In a hierarchical view, all the tables in the data source are inter-connected by means of relations. Generally a relation between any two tables can take one of the following forms: +GridDataControl can display nested tables in a hierarchy using a master-detail configuration. In a hierarchical view, all the tables in the data source are inter-connected by means of relations. Generally a relation between any two tables can take one of the following forms: * 1:1 (One parent record to one child record) * 1:n (One parent record to n child records) @@ -2332,7 +2332,7 @@ GridData control can display nested tables in a hierarchy using a master-detail where n is a number of records in a table -With the nested tables (one table nested inside another table), each record in the parent table has an associated set of records in the child table. Every record in the relation is provided with +/- button called RecordPlusMinus that can be expanded and collapsed to bring the underlying records in the child table for display. The number of tables that can be nested with relations using a GridData control is unlimited. +With the nested tables (one table nested inside another table), each record in the parent table has an associated set of records in the child table. Every record in the relation is provided with +/- button called RecordPlusMinus that can be expanded and collapsed to bring the underlying records in the child table for display. The number of tables that can be nested with relations using a GridDataControl is unlimited. ### The Relations Collection @@ -2440,7 +2440,7 @@ Auto Generate Relations The grid can automatically detect the data relations in a data set for display. By default, a relation is created for each such data relation found in the data set. Hence the data relations defined in a data set are sufficient enough for the grid. -To auto-generate the relations, set the AutoPopulateRelations property of the GridData control to _true_. +To auto-generate the relations, set the AutoPopulateRelations property of the GridDataControl to _true_. {% highlight xaml %} @@ -2518,7 +2518,7 @@ Output of the above given code is the following image: ![Stacked headers in WPF GridDataControl](Getting-Started_images/Getting-Started_img81.jpeg) -The preceding screenshot shows a GridData control with stacked headers. +The preceding screenshot shows a GridDataControl with stacked headers. ### Expression Fields @@ -2954,7 +2954,7 @@ This feature allows the grid columns to resize themselves automatically to fit t 1. GridControlLengthUnitType.Auto - In Auto type, column widths of the Grid control/GridData control are adjusted with respect to the cell and header content, i.e., each column's header length and cell content length is taken into account. + In Auto type, column widths of the Grid control/GridDataControl are adjusted with respect to the cell and header content, i.e., each column's header length and cell content length is taken into account. ~~~ csharp @@ -2968,11 +2968,11 @@ This feature allows the grid columns to resize themselves automatically to fit t ~~~ - ![Auto sizing the column in WPF GridDataControl](Getting-Started_images/Getting-Started_img87.jpeg) + ![Auto sizing the column](Getting-Started_images/Getting-Started_img87.jpeg) 2. GridControlLengthUnitType.AutoWithLastColumnFill - In AutoWithLastColumnFill type, column width of Grid Control/GridData Control is adjusted with respect to cell and header content. The last column's width fills the unoccupied space in the parent Framework element. + In AutoWithLastColumnFill type, column width of Grid Control/GridDataControl is adjusted with respect to cell and header content. The last column's width fills the unoccupied space in the parent Framework element. ~~~ csharp @@ -2986,11 +2986,11 @@ This feature allows the grid columns to resize themselves automatically to fit t ~~~ - ![Auto sizing the last column in WPF GridDataControl](Getting-Started_images/Getting-Started_img88.jpeg) + ![Auto sizing the last column](Getting-Started_images/Getting-Started_img88.jpeg) 3. GridControlLengthUnitType.SizeToCells - In SizeToCells type, column width of Grid Control/GridData Control is adjusted with respect to cell content only. + In SizeToCells type, column width of Grid Control/GridDataControl is adjusted with respect to cell content only. ~~~ csharp @@ -3004,12 +3004,12 @@ This feature allows the grid columns to resize themselves automatically to fit t ~~~ - ![Adjust cell based on content in WPF GridDataControl](Getting-Started_images/Getting-Started_img89.jpeg) + ![Adjust cell based on content](Getting-Started_images/Getting-Started_img89.jpeg) 4. GridControlLengthUnitType.SizeToHeader - In SizeToHeader type, column widths of Grid Control/GridData Control are adjusted with respect to header content only. + In SizeToHeader type, column widths of Grid Control/GridDataControl are adjusted with respect to header content only. ~~~ csharp @@ -3130,13 +3130,13 @@ void Model_QueryCellInfo(object sender, GridQueryCellInfoEventArgs e) The following image corresponds to the output of the above given code: -![Customize the row styles in WPF GridDataControl](Getting-Started_images/Getting-Started_img93.jpeg) +![Customize the row styles](Getting-Started_images/Getting-Started_img93.jpeg) The row styles of the GDC are customized by handling the QueryCellInfo event. ## Conditional Formatting -The GridData control has in-built support for conditional formatting. This feature allows you to format grid cells based on a certain condition. This can be achieved by defining a GridDataConditionalFormat for the grid. Using this class, you can specify the filter criteria for the cells and the style to be applied for the filtered cells. Once these specifications are defined, the given styles are applied to only those cells that satisfy the condition specified. +The GridDataControl has in-built support for conditional formatting. This feature allows you to format grid cells based on a certain condition. This can be achieved by defining a GridDataConditionalFormat for the grid. Using this class, you can specify the filter criteria for the cells and the style to be applied for the filtered cells. Once these specifications are defined, the given styles are applied to only those cells that satisfy the condition specified. Conditional formatting can be specified through the GridDataControl.ConditionalFormats property. This is an observable collection, into which you can add required number of formatters of type GridDataConditionalFormat. The filter criteria are specified by the GridDataConditionalFormat.Conditions property that is a collection of GridDataCondition objects. The following table describes the important properties involved: @@ -3249,7 +3249,7 @@ The preceding screenshot shows a GDC applied with conditional formatting. ### Table Options -There are numerous options to customize the appearance and behavior of the GridData control. These options are exposed in the following Grid.Model.TableProperties. +There are numerous options to customize the appearance and behavior of the GridDataControl. These options are exposed in the following Grid.Model.TableProperties. ### Property @@ -3430,7 +3430,7 @@ Specifies the skin for the grid. ### Font Settings -The GridData control lets you to set the grid font properties from the root grid. By setting the font related properties in the root GridDataControl instance, you can change the font settings for entire grid cells at once. +The GridDataControl lets you to set the grid font properties from the root grid. By setting the font related properties in the root GridDataControl instance, you can change the font settings for entire grid cells at once. ### Skins @@ -3523,7 +3523,7 @@ SkinStorage.SetVisualStyle(dataGrid2, "Office2007Blue"); ## Custom Skin -It is possible to define your own visual style for the GridData control. As a first step, you need to define a custom style by deriving from the IGridDataVisualStyle interface, and by defining custom brushes for various grid elements. +It is possible to define your own visual style for the GridDataControl. As a first step, you need to define a custom style by deriving from the IGridDataVisualStyle interface, and by defining custom brushes for various grid elements. You should direct the grid to use this custom style by specifying Custom option in its VisualStyle property. This can be done by using the following code:  @@ -4897,7 +4897,7 @@ ICommand ## GridDataControl Column Chooser -The GridData control’s column chooser allows you to add and remove columns dynamically from the current grid view via drag-and-drop operations. Dragging a column's header and dropping it onto the column chooser removes the column. To show the column, drag its header from the column chooser back to the view. +The GridDataControl’s column chooser allows you to add and remove columns dynamically from the current grid view via drag-and-drop operations. Dragging a column's header and dropping it onto the column chooser removes the column. To show the column, drag its header from the column chooser back to the view. ### Features @@ -4910,7 +4910,7 @@ By default, the column chooser doesn’t display headers of hidden columns. A co Display a Customized Column Chooser Window -The GridData control’s column chooser enables you to customize the column chooser from the application side. This can be done by passing the Action method as a parameter of the ShowColumnChooser() method. +The GridDataControl’s column chooser enables you to customize the column chooser from the application side. This can be done by passing the Action method as a parameter of the ShowColumnChooser() method. ### Use Case Scenarios @@ -4949,7 +4949,7 @@ Return Type ShowColumnChooser() -By invoking this method, the GridData control’s ColumnChooser window pops up. +By invoking this method, the GridDataControl’s ColumnChooser window pops up. Null ------ Void @@ -5056,7 +5056,7 @@ Choose the Export to PDF sample to launch. Bind a button command to the ColumnChooserCommand command -The following code shows how to show the Column Chooser window using the built-in command of the GridData control. +The following code shows how to show the Column Chooser window using the built-in command of the GridDataControl. {% tabs %} diff --git a/wpf/Classic/GridData/Events.md b/wpf/Classic/GridData/Events.md index 7da673b15..a00d170a5 100644 --- a/wpf/Classic/GridData/Events.md +++ b/wpf/Classic/GridData/Events.md @@ -8,9 +8,9 @@ documentation: ug --- # Events in WPF GridDataControl -The GridData control declares a number of events that it can handle, in response to the activities either by the end user or by the system. An event is a message that is handled, to notify an object or a class of the occurrence of an action. When an event is handled, all the event handlers are notified. +The GridDataControl declares a number of events that it can handle, in response to the activities either by the end user or by the system. An event is a message that is handled, to notify an object or a class of the occurrence of an action. When an event is handled, all the event handlers are notified. -The GridData control offers technical benefits by declaring all its events as Routed Events. Hence, being the high level visual element in the visual tree, it need not hook the same event on all of its descendants (e.g. rows, columns and cells), such as MouseMove. Instead, it hooks the event on itself and hence, when the mouse moves over one of its descendants, the grid can be notified appropriately, whenever the event is handled without expecting its descendants to notify it. +The GridDataControl offers technical benefits by declaring all its events as Routed Events. Hence, being the high level visual element in the visual tree, it need not hook the same event on all of its descendants (e.g. rows, columns and cells), such as MouseMove. Instead, it hooks the event on itself and hence, when the mouse moves over one of its descendants, the grid can be notified appropriately, whenever the event is handled without expecting its descendants to notify it. ## Subscribing to Events @@ -61,7 +61,7 @@ this.dataGrid.MouseMove-=new MouseEventHandler(dataGrid_MouseMove); {% endhighlight %} -_GridData Control Events_ +_GridDataControl Events_ diff --git a/wpf/Classic/GridData/Exporting-and-Persistence.md b/wpf/Classic/GridData/Exporting-and-Persistence.md index 3929b9a63..eca258db1 100644 --- a/wpf/Classic/GridData/Exporting-and-Persistence.md +++ b/wpf/Classic/GridData/Exporting-and-Persistence.md @@ -41,9 +41,9 @@ gridDataControl.ExportToExcel("Sample.xls", ExcelVersion.Excel97to2003 ); {% endhighlight %} -![Before exporting the data from WPF GridData control](Getting-Started_images/Getting-Started_img129.jpeg) +![Before exporting the data from WPF GridDataControl](Getting-Started_images/Getting-Started_img129.jpeg) -![After exporting the data to spreadsheet from WPF GridData control](Getting-Started_images/Getting-Started_img130.jpeg) +![After exporting the data to spreadsheet from WPF GridDataControl](Getting-Started_images/Getting-Started_img130.jpeg) The above images shows how the entire content of the GridDataControl is exported to an Excel Spreadsheet. @@ -77,9 +77,9 @@ gridDataControl.ExportToExcel("Sample.xls", ExcelVersion.Excel97to2003 ); N> Only the visible child's contents are exported. -![Before exporting the nested child data from WPF GridData control](Getting-Started_images/Getting-Started_img131.jpeg) +![Before exporting the nested child data](Getting-Started_images/Getting-Started_img131.jpeg) -![After exporting the nested child data from WPF GridData control](Getting-Started_images/Getting-Started_img132.jpeg) +![After exporting the nested child data](Getting-Started_images/Getting-Started_img132.jpeg) The above images shows how the GridControl, with Nested Child is exported to an Excel Spreadsheet. @@ -99,9 +99,9 @@ gridDataControl.ExportToExcel("Sample.xls", ExcelVersion.Excel97to2003 ); N> Only the visible grouping contents are exported. -![Before exporting the grouping data from WPF GridData control](Getting-Started_images/Getting-Started_img133.jpeg) +![Before exporting the grouping](Getting-Started_images/Getting-Started_img133.jpeg) -![After exporting the grouping data from WPF GridData control](Getting-Started_images/Getting-Started_img134.jpeg) +![After exporting the grouping data](Getting-Started_images/Getting-Started_img134.jpeg) The above images shows how the GridControl, with Grouping is exported to an Excel Spreadsheet. @@ -133,15 +133,15 @@ Me.gdc.Model.ExportToCSV("Sample.csv") When the code runs, the following output displays. -![Before exporting the grid from WPF GridData control to CSV](Getting-Started_images/Getting-Started_img135.jpeg) +![Before exporting the grid from WPF GridDataControl to CSV](Getting-Started_images/Getting-Started_img135.jpeg) When you are ready to export the entire grid, click Export to CSV; the grid content can then be converted to CSV format. -![After exporting the grid from WPF GridData control to CSV](Getting-Started_images/Getting-Started_img136.jpeg) +![After exporting the grid from WPF GridDataControl to CSV](Getting-Started_images/Getting-Started_img136.jpeg) ## Export to PDF -Essential GridData control enables you to export the content of the GridData control into a pdf file. This feature allows you to maintain the records as a pdf file. The pdf libraries are used to support the conversion of the GridData control’s content to pdf. The following dll files should be added along the default dll in the reference folder: +Essential GridDataControl enables you to export the content of the control into a pdf file. This feature allows you to maintain the records as a pdf file. The pdf libraries are used to support the conversion of the GridDataControl’s content to pdf. The following dll files should be added along the default dll in the reference folder: * Syncfusion.Pdf.Base. * Syncfusion.GridConverter.Wpf @@ -161,19 +161,19 @@ The export to pdf comprises the following features: * Export entire content. * Export selected range. -* Export GridData control with grouping. +* Export GridDataControl with grouping. * Export with styles and formatted cell value (This works by default). #### Export Entire Content -Essential GridData control allows you to export the GridData control’s entire content as a PDF file. +Essential GridDataControl allows you to export the control’s entire content as a PDF file. #### Use Case Scenario -A large data can be maintained as PDF file and the entire content of the GridData control can be exported iPDF a pdf file. +A large data can be maintained as PDF file and the entire content of the GridDataControl can be exported iPDF a pdf file. -The following XAML code example shows, how the GridData control is defined in an application. +The following XAML code example shows, how the GridDataControl is defined in an application. {% highlight xaml %} @@ -247,11 +247,11 @@ yncfusionyncfusion:GridDataVisibleColumn He”derText="Shi” Address"  {% endhighlight %} -![Export entire data to the WPF GridData control](Getting-Started_images/Getting-Started_img137.png) +![Export entire data](Getting-Started_images/Getting-Started_img137.png) #### Exporting to PdfGrid -The following code example illustrates how to export the entire content of the GridData control into a PdfGrid. +The following code example illustrates how to export the entire content of the GridDataControl into a PdfGrid. {% highlight c# %} @@ -297,11 +297,11 @@ if (sfd.ShowDialog() == true) The following screenshot shows the exported pdf document: -![Export the PDF document in WPF GridData control](Getting-Started_images/Getting-Started_img138.png) +![Export the PDF document](Getting-Started_images/Getting-Started_img138.png) #### Exporting to PdfLightTable Document -The following code example illustrates how to export the entire content of the GridData control into a PdfLightTable document file. +The following code example illustrates how to export the entire content of the GridDataControl into a PdfLightTable document file. {% highlight c# %} @@ -348,13 +348,13 @@ if (sfd.ShowDialog() == true) #### Export Selected Range -You can convert the selected range of the GridData control into a pdf file. +You can convert the selected range of the GridDataControl into a pdf file. -![Export selected ranges in WPF GridData control](Getting-Started_images/Getting-Started_img140.png) +![Export selected ranges](Getting-Started_images/Getting-Started_img140.png) #### Exporting to PdfGrid -The following code illustrates the conversion of a selected range of the GridData control to a PdfGrid. +The following code illustrates the conversion of a selected range of the GridDataControl to a PdfGrid. {% highlight c# %} @@ -399,13 +399,13 @@ if (sfd.ShowDialog() == true) } {% endhighlight %} -The following screenshot shows the exported pdf document of a selected range of the GridData control: +The following screenshot shows the exported pdf document of a selected range of the GridDataControl: -![Exproting to PDF grid in WPF GridData control](Getting-Started_images/Getting-Started_img141.png) +![Exproting to PDF grid](Getting-Started_images/Getting-Started_img141.png) #### Exporting to PdfLightTable Document -The following code illustrates the conversion of a selected range of the GridData control to a PdfLightTable document. +The following code illustrates the conversion of a selected range of the GridDataControl to a PdfLightTable document. {% highlight c# %} @@ -449,27 +449,27 @@ using ( Stream stream = sfd.OpenFile()) {% endhighlight %} -The following screenshot shows the exported PdfLightTable document of the selected range of the GridData control. +The following screenshot shows the exported PdfLightTable document of the selected range of the GridDataControl. -![Exporting to Adobe reader document in WPF GridData control](Getting-Started_images/Getting-Started_img142.png) +![Exporting to Adobe reader document](Getting-Started_images/Getting-Started_img142.png) #### Export GridDataControl with Grouping -The GridData control converts the content of the GridData control to a pdf document with grouping. +The GridDataControl converts the content of the control to a pdf document with grouping. -The following screenshot illustrates how the GridData control appears as a pdf file after grouping the data. +The following screenshot illustrates how the GridDataControl appears as a pdf file after grouping the data. -![Before exporting WPF GridData control with grouping data](Getting-Started_images/Getting-Started_img143.png) +![Before exporting control with grouping data](Getting-Started_images/Getting-Started_img143.png) -![After exporting WPF GridData control with grouping data](Getting-Started_images/Getting-Started_img144.png) +![After exporting control with grouping data](Getting-Started_images/Getting-Started_img144.png) -The following screenshot illustrates how the GridData control appears as a PdfLightTable document after grouping the data. +The following screenshot illustrates how the GridDataControl appears as a PdfLightTable document after grouping the data. -![Export the grouping data in WPF GridData control](Getting-Started_images/Getting-Started_img145.png) +![Export the grouping data](Getting-Started_images/Getting-Started_img145.png) -#### Exporting Customized GridData Control +#### Exporting Customized GridDataControl -Use the following code to customize the GridData control with blend styling. +Use the following code to customize the GridDataControl with blend styling. {% highlight xaml %} @@ -654,7 +654,7 @@ Use the following code to customize the GridData control with blend styling. {% endhighlight %} -Use the following code to export a customized GridData control: +Use the following code to export a customized GridDataControl: #### Button Code to Export: @@ -715,15 +715,15 @@ SaveFileDialog sfd = new SaveFileDialog #### GridDataControl with Blend Styling -The below screenshot shows the customized blend styling of the GridData control. +The below screenshot shows the customized blend styling of the GridDataControl. -![WPF GridData control with Blend style](Getting-Started_images/Getting-Started_img146.png) +![WPF GridDataControl with Blend style](Getting-Started_images/Getting-Started_img146.png) #### Exported PDF Document -The screenshot below shows a PDF document of the blend styling GridData control. +The screenshot below shows a PDF document of the blend styling GridDataControl. -![Export the WPF GridData control with Blend style to PDF document](Getting-Started_images/Getting-Started_img147.png) +![Export control with Blend style to PDF document](Getting-Started_images/Getting-Started_img147.png) ## Serialization in GridDataControl diff --git a/wpf/Classic/GridData/Getting-Started.md b/wpf/Classic/GridData/Getting-Started.md index f6f620953..ec7fc60f4 100644 --- a/wpf/Classic/GridData/Getting-Started.md +++ b/wpf/Classic/GridData/Getting-Started.md @@ -21,8 +21,8 @@ EssentialGrid for WPF is a package of powerful grid controls that provides cell- The EssentialGrid package is comprised of following three types of grid controls: * Grid Control -* GridData Control -* GridTree Control +* GridDataControl +* GridTreeControl Now, take closer look at the characteristics of each of these controls. @@ -34,9 +34,9 @@ In the Grid control, each cell acts as a single entity, which is suitable for ap ![WPF GridControl overview](Getting-Started_images/Getting-Started_img1.png) -### GridData Control +### GridDataControl -The GridData control is designed to be bound with a data source. In the GridData control, each column behaves as a single entity. This grid is more column-centric and can be used to display interrelated tabular data. Unlike the base grid, this grid does not store data values in its data structures; instead, it is connected to an external data source. +The GridDataControl is designed to be bound with a data source. In the GridDataControl, each column behaves as a single entity. This grid is more column-centric and can be used to display interrelated tabular data. Unlike the base grid, this grid does not store data values in its data structures; instead, it is connected to an external data source. For more detailed information about data source connections, refer to the Data Binding section. @@ -54,11 +54,11 @@ The following illustration depicts the Class Diagram for Essential Grid for WPF. ### Control Hierarchy -![Control hierarchy in WPF GridData control](Getting-Started_images/Getting-Started_img4.png) +![Control hierarchy](Getting-Started_images/Getting-Started_img4.png) ### Model Hierarchy -![Model hierarchy in WPF GridData control](Getting-Started_images/Getting-Started_img5.png) +![Model hierarchy](Getting-Started_images/Getting-Started_img5.png) ## Add Essential Grid to an Application @@ -98,7 +98,7 @@ Instead of adding it through a designer such a Visual Studio, you can add the Gr 3. Syncfusion.GridCommon.Wpf.dll 4. Syncfusion.Shared.Wpf.dll - ![Added assemblies to the WPF GridData control project](Getting-Started_images/Getting-Started_img9.png) + ![Added assemblies to the project](Getting-Started_images/Getting-Started_img9.png) 3. Name the root Grid as layoutRoot in the application’s XAML page. @@ -188,11 +188,11 @@ The Grid control is a cell-based control, so to populate it, RowCount and Column ![Show the data of WPF GridControl](Getting-Started_images/Getting-Started_img10.png) -### Add the GridData Control to a WPF Application +### Add the GridDataControl to a WPF Application -This section shows you how to add a GridData control to a WPF application and how to bind data from a database and an IEnumerable Collection to the GridData control. The GridData control can be added to an application through programmatically. +This section shows you how to add a GridDataControl to a WPF application and how to bind data from a database and an IEnumerable Collection to the control. The GridDataControl can be added to an application through programmatically. -### Programmatically Adding the GridData Control: +### Programmatically Adding the GridDataControl: 1. Create a new WPF application. @@ -229,17 +229,17 @@ This section shows you how to add a GridData control to a WPF application and ho ~~~ -### Binding a Data Source to the GridData Control +### Binding a Data Source to the GridDataControl -The previous section explained how to add a GridData control to an application. This section explains how to bind a data source with the GridData control after it is added. +The previous section explained how to add a GridDataControl to an application. This section explains how to bind a data source with the control after it is added. -The GridData control supports all popular data sources including observable collections, data tables, collection view sources, business objects generated by the ADO.NET Entity Framework, LINQ to SQL or any other ORM.ADO.NET, data views, ICollection views, object data providers, IEnumerable, IList, IBindingList, IQueryable, and ITypedList. +The GridDataControl supports all popular data sources including observable collections, data tables, collection view sources, business objects generated by the ADO.NET Entity Framework, LINQ to SQL or any other ORM.ADO.NET, data views, ICollection views, object data providers, IEnumerable, IList, IBindingList, IQueryable, and ITypedList. -This section explains how to bind data tables and IEnumerable collections to the GridData control. +This section explains how to bind data tables and IEnumerable collections to the control. -### Binding Data Tables to the GridData Control +### Binding Data Tables to the GridDataControl -This section explains how to bind a data table from a database to the GridData control. +This section explains how to bind a data table from a database to the GridDataControl. 1. Connect a database to the current application. The database can be connected several ways, such as ADO.NET, LNQ to SQL, classes, etc. In this example, we have directly established a connection to a simple Northwind.sdf database. @@ -343,7 +343,7 @@ This section explains how to bind a data table from a database to the GridData c Once the application runs, the following output is generated. -![Binding data tables to the WPF GridData control](Getting-Started_images/Getting-Started_img14.png) +![Binding data tables to the control](Getting-Started_images/Getting-Started_img14.png) #### Samples @@ -357,7 +357,7 @@ To view samples, follow these steps: ### Binding an IEnumerable Collection of GridDataControl -1. Create a collection of objects to bind with the GridData control. In this sample, we have created a collection of objects containing personnel information. +1. Create a collection of objects to bind with the GridDataControl. In this sample, we have created a collection of objects containing personnel information. ~~~ csharp @@ -499,7 +499,7 @@ To view samples, follow these steps: When the application runs, the following output is generated. -![Binding with IEnumerable collection of WPF GridData control](Getting-Started_images/Getting-Started_img15.png) +![Binding with IEnumerable collection](Getting-Started_images/Getting-Started_img15.png) ### Add the GridTree Control to a WPF Application diff --git a/wpf/Classic/GridData/MVVM-Enhancements.md b/wpf/Classic/GridData/MVVM-Enhancements.md index 95f5884e8..bea31349a 100644 --- a/wpf/Classic/GridData/MVVM-Enhancements.md +++ b/wpf/Classic/GridData/MVVM-Enhancements.md @@ -10,17 +10,17 @@ documentation: ug ## View – View Model Communication -In MVVM, commands are used to communicate between the View and View Model when a particular action takes place in the View. The GridData control contains events for all actions. In some cases, you may have to use events to meet requirements that do not adhere to the MVVM policy; you can overcome this with the EventToCommand approach. +In MVVM, commands are used to communicate between the View and View Model when a particular action takes place in the View. The GridDataControl contains events for all actions. In some cases, you may have to use events to meet requirements that do not adhere to the MVVM policy; you can overcome this with the EventToCommand approach. -To support the EventToCommand approach, commands have been added for all events in the GridData control and tables to provide complete MVVM support. +To support the EventToCommand approach, commands have been added for all events in the GridDataControl and tables to provide complete MVVM support. ![View and View Model communication](Getting-Started_images/Getting-Started_img162.png) -GridData control has two commands for each event. The first one passes the event argument to the command as parameter, and the second one does not pass any parameter to the command. This apart, the command parameter can also be changed at Sample level. +GridDataControl has two commands for each event. The first one passes the event argument to the command as parameter, and the second one does not pass any parameter to the command. This apart, the command parameter can also be changed at Sample level. -## Adding Commands to a GridData Control +## Adding Commands to a GridDataControl -You can add commands to a GridData control in the following three ways: +You can add commands to a GridDataControl in the following three ways: * By using Command with actual event arguments * By using Command with custom parameter @@ -28,7 +28,7 @@ You can add commands to a GridData control in the following three ways: ### By using a Command with Actual Event Arguments -This section explains how to add GridDataControlRecordsSelectionChangedCommandWithEventArgs command to the GridData control. The actual event arguments are passed to the Command method as parameters. +This section explains how to add GridDataControlRecordsSelectionChangedCommandWithEventArgs command to the GridDataControl. The actual event arguments are passed to the Command method as parameters. The following code example illustrates how to define the GridDataControlRecordsSelectionChangedCommandWithEventArgs command in XAML. @@ -85,7 +85,7 @@ this.SelectedCustomerID = "Customer ID : " + data.CustomerID; When you select a record while running your application, the SelectedItemChanged command is triggered with the actual GridDataRecordsSelectionChangedEventArgs event argument. -![Adding commands to WPF GridData control](Getting-Started_images/Getting-Started_img163.png) +![Adding commands](Getting-Started_images/Getting-Started_img163.png) ### Sample Location @@ -95,7 +95,7 @@ A sample application can be downloaded from the following location: ## By using a Command with a Custom Parameter -This section illustrates how to add the GridDataControlRecordsSelectionChangedCommand command to the GridData control and pass the GridData control as customer parameter. +This section illustrates how to add the GridDataControlRecordsSelectionChangedCommand command to the GridDataControl and pass the control as customer parameter. The following code example can be used to define GridDataControlRecordsSelectionChangedCommand in XAML. @@ -154,12 +154,12 @@ void SelectedItemChangedMethod(object parameter) When you select a record while running your application, the SelectedItemChanged command gets triggered with the custom GridDataControl parameter. -![Command with custom parameter in WPF GridData control](Getting-Started_images/Getting-Started_img164.png) +![Command with custom parameter](Getting-Started_images/Getting-Started_img164.png) If there is no parameter set in the View, then the parameter is passed in the method call. -![Null parameter value set in View of WPF GridData control](Getting-Started_images/Getting-Started_img165.png) +![Null parameter value set in View](Getting-Started_images/Getting-Started_img165.png) ### Sample Location @@ -212,7 +212,7 @@ public class MyGridDataControlMouseMoveCommand : GridDataControlCellMouseMov {% endhighlight %} -Now, bind the behavior to the GridData control. The following code example illustrates this. +Now, bind the behavior to the GridDataControl. The following code example illustrates this. {% highlight xaml %} @@ -224,7 +224,7 @@ Now, bind the behavior to the GridData control. The following code example illus When you hover the mouse over a row while running your application, the overridden behavior class triggers and returns the current record. -![Override the mouse hover behavior method in WPF GridData control](Getting-Started_images/Getting-Started_img166.png) +![Override the mouse hover behavior method](Getting-Started_images/Getting-Started_img166.png) #### Sample Location diff --git a/wpf/Classic/GridData/Overview.md b/wpf/Classic/GridData/Overview.md index 8982f24a4..f09e40f68 100644 --- a/wpf/Classic/GridData/Overview.md +++ b/wpf/Classic/GridData/Overview.md @@ -22,11 +22,11 @@ EssentialGrid for WPF can be applied to a variety of industries such as finance, Excel-Like UI: Essential Grid’s rich feature set allows you to build Excel-like UI applications. -![WPF Overview of GridData control](overview_images/wpf-classic-grid-data-ui-excel.png) +![WPF Overview of GridDataControl](overview_images/wpf-classic-grid-data-ui-excel.png) -High Performance - EssentialGrid is a great asset to high-performance applications, as it can display large amounts of real-time data that tends to periodic changes without any performance hits. Following is an illustration of a stock portfolio application using the GridData control. +High Performance - EssentialGrid is a great asset to high-performance applications, as it can display large amounts of real-time data that tends to periodic changes without any performance hits. Following is an illustration of a stock portfolio application using the GridDataControl. -![WPF Overview of high performance in GridData control](overview_images/wpf-classic-grid-data-high-perfomance.png) +![WPF Overview of high performance in GridDataControl](overview_images/wpf-classic-grid-data-high-perfomance.png) File Explorer - Applications that deal with hierarchical data can make use of Essential Grid’s file explorer feature, which allows child items to be displayed on-demand by using the GridTree control. @@ -48,7 +48,7 @@ You can find the following features of EssentialGrid for WPF: * F4+ALT – To open/close the pop-up of a drop-down cell. * CTRL + Arrow – To move to the first or last row or column. * SHIFT + Arrow keys – To select cells. -* DELETE – To delete an entire row in the GridData control. +* DELETE – To delete an entire row in the GridDataControl. * CTRL+X, CTRL+V, CTRL+C – For common clipboard operations. * All keyboard operations can be customized. * Selection Modes - Essential Grid offers different kinds of selection modes such as row only, column only, and cell only for selecting a particular row, column, or cell, respectively. @@ -95,13 +95,13 @@ Represents additional information on the corresponding topic. This section provides basic information, such as definitions and usage, regarding important features of EssentialGrid. -### GridData Control +### GridDataControl -The GridData control is a data-bound control that supports editing, sorting, and grouping. It is specifically designed for the scenarios, where you need to bound the grid to an external data source and customize the data view by performing the operations such as grouping, sorting, summarizing, filtering, conditional formats and unbound fields. It attains the fundamental features by deriving from the GridControlBase class and hence adapts most of the features of Grid control. It can display nested grids with hierarchical data and can also display multiple unrelated tables in one grid. The main features of the GridData control are explained in the following list. +The GridDataControl is a data-bound control that supports editing, sorting, and grouping. It is specifically designed for the scenarios, where you need to bound the grid to an external data source and customize the data view by performing the operations such as grouping, sorting, summarizing, filtering, conditional formats and unbound fields. It attains the fundamental features by deriving from the GridControlBase class and hence adapts most of the features of Grid control. It can display nested grids with hierarchical data and can also display multiple unrelated tables in one grid. The main features of the GridDataControl are explained in the following list. #### Working with Data: -The GridData control supports all popular data sources including the following: +The GridDataControl supports all popular data sources including the following: * Observable collections. * Data tables. @@ -119,9 +119,9 @@ The GridData control supports all popular data sources including the following: * IQueryable. * ITypedList. -Complex objects can bind with the GridData control and the GridData control can display related information through hierarchies. The master-detail relationship can be represented through nested grids, which can be expanded and collapsed as required. Multilevel nesting is also supported. +Complex objects can bind with the GridDataControl and the control can display related information through hierarchies. The master-detail relationship can be represented through nested grids, which can be expanded and collapsed as required. Multilevel nesting is also supported. -![WPF Overview of GridData control](overview_images/wpf-classic-grid-data-hierarchies.png) +![WPF Overview of GridDataControl](overview_images/wpf-classic-grid-data-hierarchies.png) #### Major Control Classes @@ -135,7 +135,7 @@ Complex objects can bind with the GridData control and the GridData control can N> There are several other classes that assist the user in creating groups, summaries, filters, sorted columns, etc. -The following sections elaborate the properties of the GridData control: +The following sections elaborate the properties of the GridDataControl: * Data Binding-Elaborates on the data binding concept in GDC * Data Presentation-Discusses different data presentation techniques @@ -165,14 +165,14 @@ Cell Types - Several built-in cell types can be used to display and edit any und * Up-down edit cells. * Nested grid cells. -![WPF Overview of cell types in GridData control](overview_images/wpf-classic-grid-data-cell-types.png) +![WPF Overview of cell types](overview_images/wpf-classic-grid-data-cell-types.png) ## Interactive Features -The GridData control contains a number of features for managing data effectively, including grouping, sorting, and Excel-like filtering with filter bars and advanced filtering. You can choose a column with the ColumnChooser feature, and column-related options such as dragging, sorting, grouping, and resizing can be enabled or disabled dynamically by using a separate dialog called ColumnOptions. Other specialized interactive features include stacked headers, context menus, ToolTips, and paging. +The GridDataControl contains a number of features for managing data effectively, including grouping, sorting, and Excel-like filtering with filter bars and advanced filtering. You can choose a column with the ColumnChooser feature, and column-related options such as dragging, sorting, grouping, and resizing can be enabled or disabled dynamically by using a separate dialog called ColumnOptions. Other specialized interactive features include stacked headers, context menus, ToolTips, and paging. ## Visual Styles and Expression Blend -The GridData control has a rich selection of over 14 built-in styles that provide an attractive look and feel for the grid. The GridData control also allows you to customize all aspects of grid appearance by using Microsoft Expression Blend. +The GridDataControl has a rich selection of over 14 built-in styles that provide an attractive look and feel for the grid. The control also allows you to customize all aspects of grid appearance by using Microsoft Expression Blend. -![WPF Overview of expression blend in GridData control](overview_images/wpf-classic-grid-data-expression-blend.png) \ No newline at end of file +![WPF Overview of expression blend](overview_images/wpf-classic-grid-data-expression-blend.png) \ No newline at end of file diff --git a/wpf/Classic/GridData/Real-Time-Application.md b/wpf/Classic/GridData/Real-Time-Application.md index d777507f4..dd67a0686 100644 --- a/wpf/Classic/GridData/Real-Time-Application.md +++ b/wpf/Classic/GridData/Real-Time-Application.md @@ -14,7 +14,7 @@ Essential Grid finds a wide range of applications in real time. It is completely Essential Grid is the proper choice to use in portfolio applications, as it deals with both huge and real time data without a performance hit. This section illustrates how to employ the grid in portfolio applications. -This example displays three GridData controls (GDCs) and three Chart controls hosted in a Grid control using its CellTypes feature. The three GDCs display stock details in three different views – Overview, Sector Industry View and Stock Exchange View. Among the charts, one illustrates the performance of large portfolio account, and the other two illustrates the individual country contributions to specific portfolio accounts. You can click any portfolio account in the PortfolioAccounts chart to drill down to its contributions. +This example displays three GridDataControls (GDCs) and three Chart controls hosted in a Grid control using its CellTypes feature. The three GDCs display stock details in three different views – Overview, Sector Industry View and Stock Exchange View. Among the charts, one illustrates the performance of large portfolio account, and the other two illustrates the individual country contributions to specific portfolio accounts. You can click any portfolio account in the PortfolioAccounts chart to drill down to its contributions. The GDCs are extremely customized with appropriate groups and summaries in order to provide the desired view. It also highlights the change of stock values. Value increase is indicated by green foreground and decrease in values is indicated by red foreground.