From 7d2c56c4bb885144e4387d8cc4c9eff9cfc8a1cf Mon Sep 17 00:00:00 2001 From: IvanDanchev Date: Thu, 28 Aug 2025 12:50:31 +0300 Subject: [PATCH 1/2] docs: update fileselect events article --- components/fileselect/events.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/components/fileselect/events.md b/components/fileselect/events.md index b0659c79e4..42fd1be583 100644 --- a/components/fileselect/events.md +++ b/components/fileselect/events.md @@ -41,7 +41,7 @@ Property | Type | Description The `OnSelect` fires when one or more files have been selected. The selection of files is achieved either through the **Select Files** button or by dropping the files anywhere in the component. -The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo), which contains a list of `FileInfo` objects that allow the processing of the files. +The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo). The FileSelectEventArgs event argument contains the properties `Files` (a collection of `FileSelectFileInfo` members) and `IsCancelled`. When `IsCancelled` is set to `true`, it cancels the event and the respective user action. See the [example below](#example). @@ -49,7 +49,7 @@ See the [example below](#example). The `OnRemove` fires when a file has been removed from the list of selected files either by clicking the **x** icon or by pressing the `Del` key. -The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo). As the FileSelect component allows deleting one item at a time, the collection contains only one `FileSelectFileInfo` object (the deleted one). +The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo) that has the `Files` and `IsCancelled` properties. Unlike the `OnSelect` event, in which the `Files` collection may contain multiple `FileSelectFileInfo` objects, in the `OnRemove` event, it contains only one `FileSelectFileInfo` object (the deleted one). ## Example From 322b1e9c5792b9bedccc04f7873a6b2d452ce508 Mon Sep 17 00:00:00 2001 From: IvanDanchev Date: Thu, 28 Aug 2025 13:19:54 +0300 Subject: [PATCH 2/2] docs: add pr review suggestions --- components/fileselect/events.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/components/fileselect/events.md b/components/fileselect/events.md index 42fd1be583..0d096e583c 100644 --- a/components/fileselect/events.md +++ b/components/fileselect/events.md @@ -41,7 +41,7 @@ Property | Type | Description The `OnSelect` fires when one or more files have been selected. The selection of files is achieved either through the **Select Files** button or by dropping the files anywhere in the component. -The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo). The FileSelectEventArgs event argument contains the properties `Files` (a collection of `FileSelectFileInfo` members) and `IsCancelled`. When `IsCancelled` is set to `true`, it cancels the event and the respective user action. +The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo). If you set its `IsCancelled` property to `true`, the component will ignore the user action and the selected files will not appear in the component file list. See the [example below](#example). @@ -49,7 +49,7 @@ See the [example below](#example). The `OnRemove` fires when a file has been removed from the list of selected files either by clicking the **x** icon or by pressing the `Del` key. -The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo) that has the `Files` and `IsCancelled` properties. Unlike the `OnSelect` event, in which the `Files` collection may contain multiple `FileSelectFileInfo` objects, in the `OnRemove` event, it contains only one `FileSelectFileInfo` object (the deleted one). +The event handler receives a [`FileSelectEventArgs` object](#fileselectfileinfo). The `Files` collection in the event argument always contains a single `FileSelectFileInfo` object. This is unlike the `OnSelect` event where `Files` may include one or more files. ## Example