π First Stable Release π
This release marks the first stable release of the win32_clipboard
package,
offering a refined and feature-rich API for interacting with the Windows
Clipboard in Dart.
π Breaking Changes
Clipboard
:getData
: Now returnsClipboardData?
instead ofString?
.setData
: Now takes aClipboardData
instance as the only argument.registerFormat
: Now returnsClipboardFormat
instead ofint
.
ClipboardFormat
:formatId
field renamed toid
.name
: The optional named parametername
is now a required positional
parameter and is no longer nullable.text
: Constant renamed tounicodeText
.
β¨ New Features
- Clipboard File List Support:
- Added
Clipboard.getFileList()
to retrieve a list of files from the
clipboard. - Added
Clipboard.setFileList()
to set a list of files on the clipboard. - Added
Clipboard.hasFileList
getter to check if the clipboard contains file
list data. - Added
ClipboardFormat.fileList
constant for identifying the file list
format.
- Added
- Data Change Listeners:
- Added
Clipboard.onDataChanged(ClipboardFormat format)
to listen for
changes in specific clipboard formats. - Added
Clipboard.onFileListChanged
getter to listen for file list changes. - Added
Clipboard.onTextChanged
getter to listen for text changes.
- Added
- New Data Types:
- Introduced
ClipboardData
as a base class for clipboard data. - Added subclasses:
FileListData
for handling file lists.PointerData
for handling pointer-based data.UnicodeTextData
for handling Unicode text data.
- Introduced
π Improvements
- Refined API to be more intuitive and consistent across all clipboard
operations. - Optimized internal structure for better performance and reliability.
π¨ Dart SDK Requirement
- Bumped the minimum required Dart SDK version to
3.5.0
.