SIL.Windows.Forms 15.0.0-beta0133

Prefix Reserved
This is a prerelease version of SIL.Windows.Forms.
There is a newer version of this package available.
See the version list below for details.
dotnet add package SIL.Windows.Forms --version 15.0.0-beta0133
                    
NuGet\Install-Package SIL.Windows.Forms -Version 15.0.0-beta0133
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SIL.Windows.Forms" Version="15.0.0-beta0133" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SIL.Windows.Forms" Version="15.0.0-beta0133" />
                    
Directory.Packages.props
<PackageReference Include="SIL.Windows.Forms" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SIL.Windows.Forms --version 15.0.0-beta0133
                    
#r "nuget: SIL.Windows.Forms, 15.0.0-beta0133"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SIL.Windows.Forms@15.0.0-beta0133
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SIL.Windows.Forms&version=15.0.0-beta0133&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SIL.Windows.Forms&version=15.0.0-beta0133&prerelease
                    
Install as a Cake Tool

SIL.Windows.Forms contains Windows Forms classes for UI elements (controls and dialogs) that are commonly used across various SIL applications. SIL.Windows.Forms is similar to SIL.Core in that it does not contain classes that are specific to any domain.

Product Compatible and additional computed target framework versions.
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (9)

Showing the top 5 NuGet packages that depend on SIL.Windows.Forms:

Package Downloads
SIL.Windows.Forms.GeckoBrowserAdapter

SIL.Windows.Forms.GeckoBrowserAdapter provides the GeckoFx implementation of the SIL.Windows.Forms.HtmlBrowser.IWebBrowser interface (defined in SIL.Windows.Forms). This allows the use of the Gecko engine as a browser control in Windows Forms applications through the SIL.Windows.Forms.HtmlBrowser.XWebBrowser class.

SIL.Windows.Forms.WritingSystems

SIL.Windows.Forms.WritingSystems contains Windows Forms UI elements for displaying and editing writing systems as defined by the SIL.WritingSystems assembly.

SIL.Windows.Forms.DblBundle

Package Description

SIL.Windows.Forms.Scripture

SIL.Windows.Forms.Scripture contains Windows Forms UI elements for displaying Scripture.

SIL.Chorus.App

End-user collaboration library via 3-way xml merging and hg dvcs under the hood.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
16.1.0 19 7/18/2025
16.1.0-beta0022 20 7/18/2025
16.1.0-beta0009 51 7/11/2025
16.1.0-beta0006 54 7/11/2025
16.1.0-beta0005 121 7/10/2025
16.1.0-beta0004 273 6/12/2025
16.0.1-beta0002 132 5/20/2025
16.0.1-beta0001 119 5/26/2025
16.0.0 193 5/20/2025
16.0.0-beta0162 122 5/20/2025
16.0.0-beta0159 128 5/20/2025
16.0.0-beta0158 106 5/17/2025
16.0.0-beta0146 221 5/13/2025
16.0.0-beta0145 201 5/12/2025
16.0.0-beta0144 79 4/25/2025
16.0.0-beta0143 69 4/25/2025
16.0.0-beta0141 170 4/16/2025
16.0.0-beta0140 135 4/7/2025
16.0.0-beta0127 78 4/4/2025
16.0.0-beta0126 106 3/28/2025
16.0.0-beta0125 115 3/27/2025
16.0.0-beta0124 108 3/27/2025
16.0.0-beta0109 118 3/26/2025
16.0.0-beta0104 438 3/24/2025
16.0.0-beta0103 131 3/18/2025
16.0.0-beta0102 126 3/18/2025
16.0.0-beta0090 120 3/18/2025
16.0.0-beta0088 58 3/14/2025
16.0.0-beta0083 148 3/12/2025
16.0.0-beta0079 140 3/8/2025
16.0.0-beta0068 186 3/5/2025
16.0.0-beta0067 170 3/5/2025
16.0.0-beta0066 179 3/5/2025
16.0.0-beta0063 177 3/5/2025
16.0.0-beta0061 182 3/4/2025
16.0.0-beta0052 76 2/24/2025
16.0.0-beta0051 62 2/21/2025
16.0.0-beta0050 65 2/21/2025
16.0.0-beta0049 75 2/20/2025
16.0.0-beta0048 69 2/20/2025
16.0.0-beta0047 98 2/18/2025
16.0.0-beta0046 98 2/18/2025
16.0.0-beta0045 86 2/17/2025
16.0.0-beta0034 93 2/17/2025
16.0.0-beta0033 82 2/17/2025
16.0.0-beta0032 95 2/13/2025
16.0.0-beta0031 103 2/13/2025
16.0.0-beta0021 96 2/12/2025
16.0.0-beta0020 83 2/12/2025
16.0.0-beta0019 77 2/11/2025
16.0.0-beta0017 74 2/7/2025
16.0.0-beta0016 65 2/7/2025
16.0.0-beta0012 62 2/6/2025
16.0.0-beta0011 79 2/6/2025
16.0.0-beta0010 84 2/5/2025
16.0.0-beta0009 78 2/5/2025
15.0.1-beta0007 67 1/27/2025
15.0.1-beta0004 74 1/24/2025
15.0.1-beta0003 71 1/23/2025
15.0.1-beta0002 73 1/13/2025
15.0.0 293 1/7/2025
15.0.0-beta0170 69 1/7/2025
15.0.0-beta0165 72 1/2/2025
15.0.0-beta0163 68 12/20/2024
15.0.0-beta0135 60 12/20/2024
15.0.0-beta0133 62 12/3/2024
15.0.0-beta0128 209 11/19/2024
15.0.0-beta0122 59 11/19/2024
15.0.0-beta0117 850 11/14/2024
15.0.0-beta0115 72 11/12/2024
15.0.0-beta0114 73 11/7/2024
15.0.0-beta0112 64 10/30/2024
15.0.0-beta0111 66 10/28/2024
15.0.0-beta0102 63 10/25/2024
15.0.0-beta0101 60 10/24/2024
15.0.0-beta0099 66 10/24/2024
15.0.0-beta0098 65 10/24/2024
15.0.0-beta0097 69 10/17/2024
15.0.0-beta0096 69 10/11/2024
15.0.0-beta0093 69 10/10/2024
15.0.0-beta0091 69 10/8/2024
15.0.0-beta0083 77 9/6/2024
15.0.0-beta0082 84 8/28/2024
15.0.0-beta0081 214 8/28/2024
15.0.0-beta0079 61 8/27/2024
15.0.0-beta0067 88 8/23/2024
15.0.0-beta0051 104 8/19/2024
14.2.0-beta0022 96 8/15/2024
14.2.0-beta0021 84 8/15/2024
14.2.0-beta0020 74 8/12/2024
14.2.0-beta0019 107 8/1/2024
14.2.0-beta0014 67 8/1/2024
14.2.0-beta0012 72 8/1/2024
14.2.0-beta0010 80 8/1/2024
14.2.0-beta0009 83 6/10/2024
14.1.2-beta0002 83 6/7/2024
14.1.1 272 5/23/2024
14.1.1-beta0004 75 5/23/2024
14.1.1-beta0002 74 5/14/2024
14.1.0 102 5/13/2024
14.1.0-beta0007 72 5/13/2024
14.1.0-beta0005 80 5/9/2024
14.0.1-beta0003 67 5/1/2024
14.0.1-beta0001 87 4/15/2024
14.0.0 151 4/9/2024
13.0.1 238 1/9/2024
13.0.0 195 12/8/2023
12.0.1 333 5/26/2023
12.0.0 1,422 2/15/2023
11.0.1 196 1/27/2023
11.0.0 436 1/21/2023
10.1.0 264 8/26/2022
10.0.0 753 8/4/2022
9.0.0 724 6/3/2022
8.0.0 1,479 3/4/2021
7.0.0 483 8/29/2019

Changes since version 14.1.1

Added:
- [SIL.Core] Added optional parameter, preserveNamespaces, to XmlUtils.WriteNode
- [SIL.Core] Added optional parameter, includeSystemLibraries, to AcknowledgementsProvider.CollectAcknowledgements
- [SIL.Windows.Forms] Added ability to select which SIL logo(s) to use in SILAboutBox.
- [SIL.Windows.Forms] Added public enum Widgets.SilLogoVariant
- [SIL.Windows.Forms] Added to Widgets.SilResources: AllLogoVariants, GetLogo, and SilLogoRandom (to replace SilLogo101x113)
- [SIL.Core] Added macOS support for `GlobalMutex`
- [SIL.Archiving] Added ArchivingDlgViewModel.Standard and ArchivingDlgViewModel.StringId emumerations.
- [SIL.Archiving] Added public delegate ArchivingDlgViewModel.ExceptionHandler and event ArchivingDlgViewModel.OnExceptionDuringLaunch.
- [SIL.Archiving] Added IArchivingProgressDisplay interface.
- [SIL.Archiving] Added overload of ArchivingDlgViewModel.DisplayMessage to take format parameters.
- [SIL.Archiving] Added public overload of ArchivingDlgViewModel.LaunchArchivingProgram.
- [SIL.Archiving] Added protected methods to ArchivingDlgViewModel: ReportMajorProgressPoint, ReportProgress, CleanUp
- [SIL.Windows.Forms.Archiving] Added protected virtual properties ArchiveTypeForTitleBar and InformativeText to ArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added public virtual method GetMessage to ArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added public virtual property ArchiveTypeName to ArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added protected methods DisplayMessage and Initialize (async) to ArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added protected virtual method PackageCreationComplete to ArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added (public) override of property ArchiveTypeName to IMDIArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added (protected) override of property InformativeText to IMDIArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added (protected) override of method PackageCreationComplete to IMDIArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added (public) override of method GetMessage to IMDIArchivingDlg.
- [SIL.Windows.Forms.Archiving] Added public extensions class LinkLabelExtensions with some methods that were formerly in Extensions class (now in SIL.Archiving).
- [SIL.Archiving] Added public property isValid to IMDIPackage.
- [SIL.Archiving] Added public event InitializationFailed to IMDIArchivingDlgViewModel.
- [SIL.Archiving] Added the following properties to ArchivingDlgViewModel as an alternative way to customize the initial summary displayed: GetOverriddenPreArchivingMessages, InitialFileGroupDisplayMessageType, OverrideGetFileGroupDisplayMessage

Changed:
- BREAKING CHANGE: Replaced dependency on DotNetZip with System.IO.Compression.ZipFile (Client installers will need to be changed.)
- BREAKING CHANGE: Changed to target .Net Framework 4.6.2 instead of 4.6.1
- [SIL.Windows.Forms] Look for PNG data on clipboard before checking for plain image in WindowsClipboard.GetImageFromClipboard() in order to preserve transparency in copied images.
- [SIL.Windows.Forms] Changed layout of SILAboutBox to accommodate wider SIL logo.
- [SIL.Windows.Forms.Archiving] Split SIL.Archiving, moving Winforms portions (including dependency on L10nSharp) to SIL.Windows.Forms.Archiving.
- [SIL.Archiving] Changed IMDIArchivingDlgViewModel.ArchivingPackage to return an IMDIPackage (instead of an IArchivingPackage).
- [SIL.Archiving] Required ArchivingDlgViewModel implementations to implement IDisposable.
- [SIL.Archiving] Made protected members in ArchivingDlgViewModel private, adding protected accessors as needed.
- [SIL.Archiving] In ArchivingDlgViewModel, renamed DisplayMessageEventHandler to MessageEventHandler, OnDisplayMessage to OnReportMessage, DisplayErrorEventHandler to ErrorEventHandler, and OnDisplayError to OnError.
- [SIL.Archiving] Changed signature of ArchivingDlgViewModel.OverrideDisplayInitialSummary to include a CancellationToken.
- [SIL.Archiving] Made ArchivingDlgViewModel.ArchiveType property public and changed it from a string to Standard (new enum).
- [SIL.Archiving] Changed signature of setFilesToArchive delegate in ArchivingDlgViewModel's protected constructor.
- [SIL.Archiving] Changed return type of ArchivingDlgViewModel.Initialize (to make it async) and added two parameters.
- [SIL.Archiving] Changed the signature of protected methods in ArchivingDlgViewModel: LaunchArchivingProgram, GetFileExcludedMsg.
- [SIL.Archiving] Changed the signature of the public method ArchivingDlgViewModel.CreatePackage.
- [SIL.Archiving] Changed underlying type of public enums VernacularMaterialsType and SilDomain from ulong to long.
- [SIL.Archiving] Replaced protected _keys field (now private) in abstract class ArchivingPackage with protected accessor property Keys.
- [SIL.Archiving] IMDIArchivingDlgViewModel (subclass of ArchivingDlgViewModel) affected by many of the changes to the base class.
- [SIL.Archiving] IMDIArchivingDlgViewModel and RampArchivingDlgViewModel (subclasses of ArchivingDlgViewModel) affected by many of the changes to the base class.
- [SIL.Archiving] IMDIArchivingDlgViewModel constructor signature changed.
- [SIL.Archiving] RampArchivingDlgViewModel constructor signature changed.
- [SIL.Windows.Forms.Archiving] Made ArchivingDlg implement IArchivingProgressDisplay.
- [SIL.Windows.Forms.Archiving] ArchivingDlg constructor signature changed: removed localizationManagerId; added optional archiveInfoHyperlinkText; made some other parameters optional.
- [SIL.Windows.Forms.Archiving] IMDIArchivingDlg constructor signature changed: added appSpecificArchivalProcessInfo.
- [SIL.Windows.Forms] Split ClearShare code, moving non-Winforms portions to SIL.Core (SIL.Core.ClearShare namespace)
- [SIL.Core] Added optional parameter to OlacSystem.GetRoles to allow caller to provide its own XML with role definitions.
- [SIL.Windows.Forms] Split License into a base class called License and a derived LicenseWithLogo, so that License could be in SIL.Core.
- [SIL.Archiving] Changed IArchivingSession.Files (and Session.Files) into an IReadonlyList.
- [SIL.Archiving] Made IMDIPackage.CreateIMDIPackage asynchronous, changing its signature to take a CancellationToken parameter and return Task<bool>.
- [SIL.Archiving] Made MetaTranscript.WriteCorpusImdiFile asynchronous, changing its signature to return Task<bool>.
- [SIL.Archiving] Changed the name of the third parameter in ArchivingDlgViewModel.AddFileGroup from progressMessage to addingToArchiveProgressMessage.
- [SIL.Windows.Forms.Archiving] Changed Cancel Button to say Close instead in IMDIArchivingDlg.
- [SIL.Core.Desktop] Renamed GetFromRegistryProgramThatOpensFileType to GetDefaultProgramForFileType.

Fixed:
- [SIL.Archiving] Fixed typo in RampArchivingDlgViewModel for Ethnomusicology performance collection.
- [SIL.Archiving] Changed URLs that used http: to https: in resource EmptyMets.xml.
- [SIL.Core.Desktop] Implemented GetDefaultProgramForFileType (as trenamed) in a way that works on Windows 11, Mono (probably) and MacOS (untested).

Removed:
- Support for .Net Framework 4.6.1
- [SIL.Windows.Forms] Removed SilLogo101x113 from Widgets.SilResources. Use SilLogoRandom or specify desired variant instead.
- [SIL.Windows.Forms] Removed previously deprecated CreativeCommonsLicense.IntergovernmentalOriganizationQualifier
- [SIL.Archiving] Removed abstract properties from ArchivingDlgViewModel: InformativeText and ArchiveInfoHyperlinkText.
- [SIL.Archiving] Removed public method ArchivingDlgViewModel.Cancel. (Now handled via cancellation tokens.)
- [SIL.Archiving] Removed protected methods from ArchivingDlgViewModel: PreparingFilesMsg, GetSavingFilesMsg
- [SIL.Archiving] Removed protected fields (renamed and made private) from ArchivingLanguage: _iso3Code, _englishName
- [SIL.Archiving] Removed protected fields (made private) from ArchivingFile: _fullName, _fileName, _fileSize, _mimeType, _descriptions, _accessProtocol
- [SIL.Archiving] Removed public methods CreateMetsFile and CreateRampPackage from RampArchivingDlgViewModel (made internal).
- [SIL.Archiving] Removed ArchivingPackage and AddSession from ArchivingDlgViewModel and RampArchivingDlgViewModel (where they threw NotImplementedExceptions)

Fixed:
- [SIL.Window.Forms] When choosing a file in the ImageToolbox.AcquireImageControl, a FileOk handler is simulated that verifies the selected file passes the given filter.  Users can defeat the filter mechanism by pasting or typing the file name.  While the returned filename does not pass the filter, the dialog is reopened until the user either chooses a proper filename or cancels the dialog.  The native FileOk handler can prevent the dialog from closing: we can't achieve that.  (See BL-13552.)

See full changelog at https://github.com/sillsdev/libpalaso/blob/master/CHANGELOG.md