986416 - Vol3, SP1 2025 UG content changes for ImageEditor team controls #3726
Conversation
…itor AnnotationsDeserialized event support
|
Build Status: INPROGRESS 🔃 |
|
CI Status: FAILURE ❌ |
|
Build Status: INPROGRESS 🔃 |
|
CI Status: FAILURE ❌ |
MAUI/ImageEditor/events.md
Outdated
|
|
||
| {% endtabs %} | ||
|
|
||
| ## AnnotationsDeserialized event |
There was a problem hiding this comment.
Rename to Annotations deserialized event and move this event to above annotation-selected-event
MAUI/ImageEditor/events.md
Outdated
|
|
||
| ## AnnotationsDeserialized event | ||
|
|
||
| The 'AnnotationsDeserialized' event is triggered each time deserialization completes and annotations are applied to the ImageEditor control. This allows users to validate the data, update the UI, or execute custom business logic. |
There was a problem hiding this comment.
This AnnotationsDeserialized event occurs when annotations are deserialized onto the image.
MAUI/ImageEditor/events.md
Outdated
|
|
||
| {% highlight xaml tabtitle="MainPage.xaml" %} | ||
|
|
||
| <imageEditor:SfImageEditor x:Name="imageEditor" |
There was a problem hiding this comment.
@AarthiArjunan, fix code alignment issue and highlight AnnotationsDeserialized line
There was a problem hiding this comment.
Alignment changed sir. but didn't know how to highlight xaml code.
MAUI/ImageEditor/events.md
Outdated
|
|
||
| private void OnAnnotationsDeserialized(object? sender, EventArgs e) | ||
| { | ||
There was a problem hiding this comment.
Add popup to display and add message Annotation are deserialized
MAUI/ImageEditor/events.md
Outdated
| private void OnAnnotationsDeserialized(object? sender, EventArgs e) | ||
| { | ||
| // Add anything here, like dispaly alert to show event raised |
There was a problem hiding this comment.
Check spell error and remove
MAUI/ImageEditor/events.md
Outdated
| N> Serialization and deserialization are not applicable for custom annotation views. | ||
|
|
||
| {% tabs %} | ||
|
|
There was a problem hiding this comment.
Remove unwanted line added in all places
MAUI/Kanban-Board/Sorting.md
Outdated
| keywords: .net maui Kanban sorting, sfKanban sorting in .net maui, .net maui Kanban sorting support. | ||
| --- | ||
|
|
||
| # Sorting in .NET MAUI Kanban (SfKanban) |
There was a problem hiding this comment.
Card Item Sorting in .NET MAUI Kanban (SfKanban)
MAUI/Kanban-Board/Sorting.md
Outdated
| @@ -0,0 +1,460 @@ | |||
| --- | |||
| layout: post | |||
| title: Sorting in .NET MAUI Kanban control | Syncfusion | |||
There was a problem hiding this comment.
Sorting in .NET MAUI Kanban control | Syncfusion®
MAUI/Kanban-Board/Sorting.md
Outdated
| title: Sorting in .NET MAUI Kanban control | Syncfusion | ||
| description: Learn here all about Sorting support in Syncfusion® .NET MAUI Kanban (SfKanban) control and more. | ||
| platform: maui | ||
| control: Kanban |
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| # Sorting in .NET MAUI Kanban (SfKanban) | ||
|
|
||
| This feature is used to sort the card items on Kanban Columns by following below properties |
There was a problem hiding this comment.
The Kanban control supports customizable card sorting within columns based on specific data fields such as priority, due date, or status. Sorting can be applied programmatically and updated dynamically at runtime using following properties
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| This feature is used to sort the card items on Kanban Columns by following below properties | ||
|
|
||
| * `SortingMappingPath` - This property should correspond to a property name in the KanbanModel or CustomModel. The default value is string.Empty in this case the cards won’t be sorted. |
There was a problem hiding this comment.
Used to map the sorting field to a property name in the KanbanModel or CustomModel. The default value is string.Empty, in which case the cards will not be sorted.
MAUI/Kanban-Board/Sorting.md
Outdated
| This feature is used to sort the card items on Kanban Columns by following below properties | ||
|
|
||
| * `SortingMappingPath` - This property should correspond to a property name in the KanbanModel or CustomModel. The default value is string.Empty in this case the cards won’t be sorted. | ||
| * `SortingOrder` - Defines the order in which cards appear. The default is Ascending. |
There was a problem hiding this comment.
SortingOrder - Used to define the direction of cards sorting within each column.
| * `SortingOrder` - Defines the order in which cards appear. The default is Ascending. | ||
| * `Ascending` - Cards with lower values appear first. | ||
| * `Descending` - Cards with higher values appear first. | ||
|
|
There was a problem hiding this comment.
Add note: This property is applicable only when a valid value is assigned to SortingMappingPath.
MAUI/Kanban-Board/Sorting.md
Outdated
| * `Ascending` - Cards with lower values appear first. | ||
| * `Descending` - Cards with higher values appear first. | ||
|
|
||
| ## Cards position updation while drag and drop |
There was a problem hiding this comment.
Remove all below topics and explain how various SortBy scenarios can be achieved at the sample level.
|
Build Status: INQUEUE 🕒 |
|
Build Status: INPROGRESS 🔃 |
|
CI Status: FAILURE ❌ |
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| # Card Item Sorting in .NET MAUI Kanban (SfKanban) | ||
|
|
||
| The Kanban control supports customizable card sorting within columns based on specific data fields such as priority, due date, or status. Sorting can be applied programmatically and updated dynamically at runtime using following properties |
There was a problem hiding this comment.
Highlight key words
|
Build Status: INPROGRESS 🔃 |
|
CI Status: FAILURE ❌ |
MAUI/Kanban-Board/Sorting.md
Outdated
| * `Ascending` - Cards with lower values appear first. | ||
| * `Descending` - Cards with higher values appear first. | ||
|
|
||
| N> This property is applicable only when a valid value is assigned to `SortingMappingPath`. |
There was a problem hiding this comment.
The SortingOrder property is applicable only when a valid value is assigned to SortingMappingPath.
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| N> This property is applicable only when a valid value is assigned to `SortingMappingPath`. | ||
|
|
||
| ## Sorting Behavior in DragEnd Event |
There was a problem hiding this comment.
Rename subtitle to Customize card order with sorting configuration
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| # Card Item Sorting in .NET MAUI Kanban (SfKanban) | ||
|
|
||
| The Kanban control supports customizable card sorting within columns based on specific data fields such as `priority`, `due date`, or `status`. Sorting can be applied programmatically and updated dynamically at runtime using following properties. |
There was a problem hiding this comment.
The Kanban control supports customizable card sorting within columns based on specific data fields such as Priority, DueDate, or Status. Sorting can be configured programmatically and updated dynamically at runtime using the following properties:
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| ## Sorting Behavior in DragEnd Event | ||
|
|
||
| The `DragEnd` event in the `Kanban` control supports three sorting approaches: |
There was a problem hiding this comment.
Sorting in the Kanban control can be implemented using the following approaches.
- Custom
- Index
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| ### Custom | ||
|
|
||
| The SortBy Custom approach must require SortingMappingPath value. In this behavior, cards are sorted and loaded based on the SortingMappingPath value and also cards are dropped based on the SortingMappingPath value to maintain consistent sorting behavior. |
There was a problem hiding this comment.
To enable custom sorting behavior, a valid property name from the ItemsSource must be mapped using the SortingMappingPath. This mapping ensures that cards are loaded and repositioned based on the corresponding property value, allowing consistent sorting during both initialization and drag-and-drop operations.
MAUI/Kanban-Board/Sorting.md
Outdated
| * Index | ||
| * ItemsSource Order | ||
|
|
||
| ### Custom |
There was a problem hiding this comment.
Rename to Custom Field Sorting
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| The SortBy Custom approach must require SortingMappingPath value. In this behavior, cards are sorted and loaded based on the SortingMappingPath value and also cards are dropped based on the SortingMappingPath value to maintain consistent sorting behavior. | ||
|
|
||
| The following code example describes the card position changing functionality. |
There was a problem hiding this comment.
This example demonstrates how card positions are updated based on sorting configurations and property mappings.
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| {% highlight c# tabtitle="CardDetails.cs" %} | ||
|
|
||
| public class CardDetails : INotifyPropertyChanged |
There was a problem hiding this comment.
@AarthiArjunan, just add API with gets or sets. please find below for reference
MAUI/Kanban-Board/Sorting.md
Outdated
| } | ||
|
|
||
| {% endhighlight %} | ||
|
|
There was a problem hiding this comment.
Don't add new line in between tags
|
|
||
| {% highlight c# tabtitle="SortingViewModel.cs" %} | ||
|
|
||
| public class SortingViewModel |
There was a problem hiding this comment.
@AarthiArjunan, follow same approach to reduce line. Add details in single line
| } | ||
|
|
||
| {% endhighlight %} | ||
| {% endtabs %} |
There was a problem hiding this comment.
Add note
To apply sorting after a drop operation, handle the DragEnd event and explicitly call the RefreshKanbanColumn method. This ensures the column updates to reflect the new card order based on the defined sorting logic.
MAUI/Kanban-Board/Sorting.md
Outdated
| {% endhighlight %} | ||
| {% endtabs %} | ||
|
|
||
| ### Index |
There was a problem hiding this comment.
Rename to Index-Based Sorting
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| ### Index | ||
|
|
||
| SortBy Index approach also depends SortingMappingPath value. This approach allows the users to drop the cards in the Kanban column where the placeholder view is created exactly. It is also helpful to render the cards based on the SortingMappingPath value. |
There was a problem hiding this comment.
The index-based approach in the Kanban control allows cards to be reordered based on their position within a column. This behavior is influenced by the SortingMappingPath property, which must reference a numeric field in the data model.
This method enables users to drop cards precisely where the placeholder view appears during drag-and-drop operations. It also ensures that cards are rendered according to their SortingMappingPath values.
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| SortBy Index approach also depends SortingMappingPath value. This approach allows the users to drop the cards in the Kanban column where the placeholder view is created exactly. It is also helpful to render the cards based on the SortingMappingPath value. | ||
|
|
||
| N> The SortingMappingPath property value must be in number format. |
There was a problem hiding this comment.
N>The SortingMappingPath property value must be in numeric field.
MAUI/Kanban-Board/Sorting.md
Outdated
|
|
||
| N> The SortingMappingPath property value must be in number format. | ||
|
|
||
| The following cases will dynamically change their SortingMappingPath value when dropping the cards. |
There was a problem hiding this comment.
Please remove dynamic cases
MAUI/Kanban-Board/Sorting.md
Outdated
| Consider, Column A has Card A with priority value 1, Card B with priority value 2, and Card C with priority value 3. | ||
| and Column B has Card D with priority value 5, then the dropped Card D will be placed between Card A and Card B. Now, the Cards D, B, and C will be dynamically changed to the priority values as 2, 3, and 4 respectively. | ||
|
|
||
| The following code example illustrate the index updation functionality. |
There was a problem hiding this comment.
The following code example illustrates how card positions are updated using the index-based sorting approach.
| { | ||
| this.ApplySortingWithoutPositionChange(e); | ||
| } | ||
|
|
There was a problem hiding this comment.
Add note:
The Index-based sorting logic can be achieved at the sample level. To implement dynamic sorting after a drag-and-drop operation, handle the DragEnd event and apply sorting logic to update the SortingMappingPath values accordingly. Once updated, invoke the RefreshKanbanColumn method to reflect the changes in the UI.
MAUI/Kanban-Board/Sorting.md
Outdated
| } | ||
|
|
||
| /// <summary> | ||
| /// Applies sorting without changing the position of the cards. |
There was a problem hiding this comment.
Implement index-based sorting logic
Explain steps one by one and add code changes. need to explain and add method like that
MAUI/Kanban-Board/Sorting.md
Outdated
| {% endhighlight %} | ||
| {% endtabs %} | ||
|
|
||
| ### ItemsSource Order |
There was a problem hiding this comment.
Remove this and add in note:
Note: To disable sorting logic, avoid assigning a value to the SortingMappingPath property. This ensures that card positions remain static and reflect the order of the ItemsSource collection, making it suitable for scenarios where sorting is not required or is managed externally.
|
Build Status: INPROGRESS 🔃 |
|
CI Status: FAILURE ❌ |
|
Build Status: INPROGRESS 🔃 |
|
CI Status: SUCCESS ✅ |
|
Build Status: INPROGRESS 🔃 |
|
CI Status: SUCCESS ✅ |
4 participants
Description
In this PR I have added the ImageEditor team control Vol3, SP1 release feature details. Here I have added the control and feature details:
-> Maui Kanban - Sorting Feature