Forms9Patch 1.2.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Forms9Patch --version 1.2.0
NuGet\Install-Package Forms9Patch -Version 1.2.0
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="Forms9Patch" Version="1.2.0">
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Forms9Patch --version 1.2.0
#r "nuget: Forms9Patch, 1.2.0"
#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.
// Install Forms9Patch as a Cake Addin
#addin nuget:?package=Forms9Patch&version=1.2.0

// Install Forms9Patch as a Cake Tool
#tool nuget:?package=Forms9Patch&version=1.2.0


You will need to add

<string name="forms9patch_copy_paste_authority">your_Android_app_package_name_here.f9pcopypaste</string>

to your Android project’s Resources/values/strings.xml file.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard1.0 is compatible.  netstandard1.1 was computed.  netstandard1.2 was computed.  netstandard1.3 was computed.  netstandard1.4 was computed.  netstandard1.5 was computed.  netstandard1.6 was computed.  netstandard2.0 was computed.  netstandard2.1 was computed. 
.NET Framework net45 was computed.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed.  monoandroid10 is compatible. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Universal Windows Platform uap was computed.  uap10.0 is compatible. 
Windows Phone wp8 was computed.  wp81 was computed.  wpa81 was computed. 
Windows Store netcore was computed.  netcore45 was computed.  netcore451 was computed. 
Xamarin.iOS xamarinios was computed.  xamarinios10 is compatible. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Forms9Patch:

Package Downloads

Eltra - CANOpen based IoT Framework - SDK - Xamarin UI


Set of several tools and dependency services for xamarin


Package Description

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Forms9Patch:

Repository Stars
Simplify image management and text formatting in your Xamarin.Forms apps
Version Downloads Last updated
2.4.9 142,139 12/16/2020
2.4.9-beta2 1,239 12/16/2020
2.4.9-beta1 1,389 12/15/2020
2.4.8 11,202 11/28/2020
2.4.7 5,075 11/19/2020
2.4.6 8,951 9/18/2020
2.4.5 1,592 9/17/2020
2.4.4 1,593 9/17/2020
2.4.2 8,842 7/25/2020
2.4.1 2,100 7/25/2020
2.4.0 1,931 7/24/2020
2.4.0-beta2 1,116 7/24/2020
2.4.0-beta1 1,120 7/24/2020
2.3.0 13,424 6/29/2020
2.2.6 19,955 3/15/2020
2.2.5 2,366 3/14/2020
2.2.5-beta1 1,130 3/14/2020
2.2.4 8,556 1/28/2020
2.2.4-beta1 1,239 1/23/2020
2.2.3 3,678 1/4/2020
2.2.3-pre1 2,202 1/4/2020
2.2.2 2,186 12/31/2019
2.2.1 1,866 12/30/2019
2.2.0 1,738 12/26/2019
2.1.3 2,932 12/10/2019
2.1.2 4,106 11/27/2019
2.1.1 1,473 11/26/2019
2.1.0 1,520 11/26/2019
2.1.0-beta1 1,159 11/22/2019
2.0.2 2,313 11/13/2019
2.0.1 1,616 11/12/2019
2.0.0 8,790 11/11/2019
2.0.0-rc1 1,148 11/11/2019
1.8.1 4,086 9/17/2019 2,973 8/15/2019 2,536 7/26/2019 2,825 7/9/2019 2,187 7/5/2019
1.8.0 2,844 6/26/2019
1.7.0 13,392 4/22/2019 5,049 4/12/2019 2,246 4/11/2019
1.6.7 2,044 4/11/2019 2,613 4/7/2019 2,869 3/22/2019
1.6.6 8,169 3/2/2019 2,463 2/6/2019 1,903 2/1/2019 1,850 1/30/2019
1.6.5 2,535 1/28/2019
1.6.4 19,713 12/5/2018
1.6.3 10,802 11/25/2018 4,147 11/16/2018
1.6.2 2,485 11/15/2018
1.6.1 2,503 11/2/2018 2,208 10/30/2018
1.6.0-rc5 2,052 10/30/2018
1.6.0-rc4 1,945 10/30/2018
1.6.0-rc3 1,891 10/29/2018
1.6.0-rc2 2,000 10/27/2018
1.6.0-rc1 1,968 10/27/2018 10,903 10/23/2018 2,141 10/22/2018 2,274 10/22/2018 2,033 10/20/2018 2,431 10/12/2018 2,422 10/12/2018
1.5.0-rc1 2,004 10/9/2018 3,061 9/7/2018 2,513 9/7/2018 2,317 9/7/2018
1.4.0 2,382 9/5/2018
1.3.3 6,120 6/28/2018
1.3.2 4,608 6/19/2018
1.3.1 2,902 5/15/2018
1.3.0 2,818 5/11/2018 2,850 4/19/2018
1.2.0 2,449 4/17/2018
1.1.1 2,867 2/19/2018
1.1.0 2,828 1/6/2018 2,430 1/5/2018 2,724 1/4/2018 2,975 1/2/2018
1.0.0 2,553 12/28/2017 11,099 10/26/2017 3,853 10/7/2017 6,362 8/14/2017 2,534 8/2/2017 2,562 7/10/2017
0.10.3 2,480 6/27/2017 2,431 6/21/2017 2,615 5/30/2017 2,441 5/23/2017 2,635 5/10/2017 2,494 5/3/2017 2,401 5/3/2017 2,429 5/3/2017 2,517 5/1/2017 2,777 4/16/2017 2,383 4/16/2017 2,502 4/10/2017 2,507 3/28/2017 3,168 3/2/2017 2,943 2/22/2017
0.10.1 2,648 2/16/2017 2,629 2/13/2017
0.10.0 2,525 2/11/2017 4,686 10/13/2016 2,888 9/26/2016 2,741 9/21/2016 2,540 9/15/2016 2,475 9/1/2016
0.9.13 2,562 8/22/2016 2,448 8/17/2016 2,674 8/6/2016 2,639 7/19/2016 2,794 7/16/2016 2,555 7/13/2016
0.9.12 2,631 7/11/2016 2,555 6/27/2016 2,677 5/10/2016
0.9.11 2,697 5/5/2016 2,634 4/29/2016 2,446 4/12/2016 2,511 4/5/2016 2,368 3/31/2016 2,456 3/23/2016 2,587 3/21/2016 2,501 3/21/2016
0.9.10 2,684 3/11/2016 2,760 3/1/2016 2,416 3/1/2016 2,714 2/28/2016
0.9.9 2,572 2/25/2016 2,454 2/19/2016 2,381 2/5/2016
0.9.8 2,397 2/4/2016 2,421 1/29/2016
0.9.7 2,325 1/28/2016
0.9.6 2,380 1/24/2016 2,417 1/21/2016 2,357 1/20/2016
0.9.5 2,517 1/20/2016 3,054 1/14/2016
0.9.3 2,448 1/13/2016 2,444 1/9/2016
0.9.1 2,407 1/4/2016 Fixed: Android crash if using custom font and app cache is cleared.  New: Clipboard and HardwareKey classes (documentation is coming!).  NOTE: You must add `<string name="forms9patch_copy_paste_authority">*your_Android_app_package_name_here*.f9pcopypaste</string>` to your Android project's `Resources/values/strings.xml` file.  See the GitHub Forms9PatchDemo app for an example. Fixed: iOS Label renders at MinFontSize when Lines=0 and AutoFit=None; Android Label truncates last character when Lines=0 and AutoFit=Width; SinglePicker View working on UWP desktop.  Faster SegmentedControl rendering.  Improved Android reliability. New: SVGs are now valid image sources!  Fixed: Shape outlines are not always full thickness; Button.Clicked event requires double click to fire on Andriod. Fix: Android renderers use Android SDK calls not supported by Gingerbread; PCL.Utils.ApplicationStorageExtensions not using correct directory; Fix: Instantiation of popup, before App.MainPage set to Forms9Patch.RootPage, causes crash; iOS button text not always appearing; Fixed: Default padding not zero for Forms9Patch layouts (other than Frame); Changed: Forms9Patch.Frame is not longer obsolete; IPopup is public; Fix: Crash on older versions of Windows; Change: IPopup is public; Full UWP Support; UWP Release; Fixed: Android implementation of FormsGestures failing in Xamarin.Forms 2.4; Android implementation of popups not re-rendering correctly upon 3rd or 4th display;  Added: pre-alpha of the UWP implmentation of the following Forms9Patch elements: Image, ImageSource, AbsoluteLayout, ContentView, Frame, Grid, ManualLayout, RelativeLayout, StackLayout, ImageButton, MaterialButton, MaterialSegmentedControl, Segment, RootPage, ActivityIndicatorPopup, ModalPopup, PermissionPopup, Toast; Fixed: Size of last segment of MaterialSegmentedController does not always match other segments; iOS intermittantcrash when Image is disposed; Fixed: IconImage dissappears after pressing Android rendering of ImageButton; Some MultiResourceImages are not fitted properly on Android; Fixed: ImageButton does not return to default state after selected; ImageButton triggers Tapped event twice; Fixed: ImageButton crashes when ImageButtonState properties (DefaultState, PressedState, etc) are not set. ImageButton, MaterialButton and MaterialSegmentedControl has been enhanced with HorizontalTextAlignment and VerticalTextAlignment properties.  MaterialSegmentedControl also has IntraSegmentSpacing and IntraSegmentOrientation properties; Obsolete: ImageButton, MaterialButton and MaterialSegmentedControl Alignment property; Fix: Potential crash when deconstructing Image elements. Fixed: iOS rendering of images and fonts in XAML Previewers; Presentation of popups with modal pages. Fixed multiple edge case rendering issues with Label. Changed: PCL Profile from 259 to 111.  Fixed: ImageSource does not open Embedded Resource image when used in a library. Fixed: (Android) Back button causes app to exit. Fixed: Android Label not rendering in Xamarin.Studio's XAML Previewer; Fixed: Fit=LabelFit.Lines not working when truncating on iOS; Modified: Buttons now default to Fit=LabelFit.Width and Padding=4; Added the SelectedBackgroundColor and SelectedFontColor properties to MaterialButton and MaterialSegmentedControl Fixed: Failure to dynamically resize Label when text changes. Fixed: ImageButton not returned to full opacity when IsEnabled is programically set to true; Fixed: bound values of ImageButtonState properties are not used on initialization. Added: TintImage property to MaterialButton and MaterialSegmentedController to control if ImageSource image is tinted with FontColor; Fixed: Unable to select portion of Xamarin.Forms.ListView cell that is covered by Forms9Patch.Label; Android Forms9Patch.Label not always updating correctly when BindingContext has changed; Added: ApplicationInfoService to get application's Name, Bundle/Package Identifier, Build number, and Version name; Fix: ability to listen to gestures on Forms9Patch elements; Fix: RootPage responds correctly to changes in iOS status bar; Added: ColorGradientBox element; Fix: Intermittant crash on Android when releasing layouts. Now fully supports Shared Library apps.  Apparently, it did all along *except* for Embedded Resource fonts.  Now that has been fixed. Added support for <a> tag to HtmlText property of Label; Added HapticsMode and HapticsEffect properties to buttons; Fix: failure to use some Forms9Patch properties in XAML ResourceDictionary Optimized for rendering speed; fix: Bubble popup not appearing with MasterDetailPage; fix: BubblePopup not responding to Margin property; Added Toast, BubbleToast; Fix: Crash from Label object being instantiated and held a period without being rendered. Fix: iOS FormsGestures library Panning event proides erratic results. Fix: Android Label's Lines property does not truncate when LineBreakMode is not Start, Mid, or Center; Added: ActualFontSize readonly property to Label to give access to fit adjusted font size. New: Added IsElliptical property to MaterialButton and the layout elements; Enabled the Opacity property of Image element. New: Added CancelOnBackgroundTouch Property (default: true) to ModalPopup and BubblePopup New: CustomFontEffect platform effect can be applied to Xamarin.Forms Label, Button, Entry, and Editor elements to allow the EmbeddedResourceID of PCL Embedded Resource fonts as value for FontFamily property. Fixed: ImageButton in ContentView fails to correctly render state changes in BackgroundImage (Android). Fixed: resizing of button labels when text is changed.
Enhanced: Forms9Patch.ImageSource.FromMultiResource uses first portion of path of Embedded Resource to determine which assembly to search.
Changed: Lines property of Label sets the max number of lines when Fit=LabelFit.None. Fixed: (1) crash when render Label in Horizontal Orientation in StackLayout; (2) Failure to render Label in some layouts; (3) Failure to autofit some one-character labels correctly; (4) Failure to resize label when bounds changes; Enhanced: Can refer to iOS system fonts by using their name as value for FontFamily property. Fixed: (1) crash when instantiating buttons on iOS release builds; (2) iOS HtmlText <tt> tag combined with <b>, <u>, or <i> fails to render font correctly; (3) Image button touch intermittantly fails.
Enhanced: Width and Height values of LabelFit are now supported for labels with unimposed Height. Fixed: (1) failure to get bold and/or italic version of some iOS system fonts; (2) Multi-line labels not appearing so on iOS; (3) 9Patch images market to edge failing to render on iOS; New: Width and Lines Autofit for Labels.  TrailingImage property for ImageButton, MaterialButton and MaterialSegmentedController. Forms9Patch.FontExtensions.LoadedFontFamilies() lists all currently loaded fonts.
Fixed: iOS HtmlMarkup underlines don't match font color, Default Android image button label missing for some states.  Unable to bind to Segment.  Able to unselect Segment when in Radio mode. Fixed: in iOS, Images will have height or width of 1 (instead defaulting to source image height or width) when HeightRequest or WidthRequest is not set. Fixed: Issue where Forms9Patch.iOS.Settings.LicenseKey throws System.NullRefernceException. Added HTML markup to Label, MaterialButton, Segment, and ImageButtonState elements. Built for Xamain Forms 2.2 Fixed crash when no Target is given for BubblePopup.  Fixed failure to present popups when used w/ PushModalAsync(). Added Cancel method to Popups; Auto-cancel Popups when Android [back] button is pressed. Improved reliabilty of rendering of 9patch backgrounds when used in ListView in Android. Fixed AOT issue that caused BubblePopup not to work on iOS devices. Fixed layout of NinePatch backgrounds when used in a ListView on Android. Added ModalPopup and BubblePopup elements.  See demo app for example. 25x Improved tap response on all buttons; Fixed ImageButton.Background rendering issue. 3x Improved iOS image loading time.  Known issue: ImageButton Fails to present anything but DefaultState.BackgroundImage - will be fixed very soon. Fixed issue with comping for iOS devices. Added:
(1) PressingState to ImageButton to enable customization of the button for when it is in the pressed state.
(2) LongPressing and LongPressed events have been added to the ImageButton, MaterialButton, and Segment element.
(3) SegmentLongPressing and SegmentLongPressed events have been added to the MaterialSegmentedControl element.
(4) Renamed ImageButton's Clicked event to Tapped. Fixed not all XAML attributes working for ImageButtonState. Fixed:  XAML Segments Attribute for MaterialSegmentButton; Added FontColor and FontAttributes properties to Segment Added MaterialSegmentControl, Added Orientation property to MaterialButton Fixed: MaterialButton render when image but no text present. Added ImageButton and MaterialButton elements, Added HasShadow property to Android and iOS AbsoluteLayout, Frame, Grid, RelativeLayout, and StackLayout layouts. Fixed intermittant iOS UIImage.ImageWithData double free, Added RelativeLayout, Grid, and AbsoluteLayout Elements Fixed ContentView background scalable image rendered as non-scalable image if CapsInset has a one or two -1 values Fixed scaling of ContentView BackgroundImage
0.9.5 1) Added Fill (AspectFill, AspectFit, Fill and Tile) property to Image; 2) Added ContentView and Frame elements with BackgroundView and (for Frame) OutlineWidth and OutlineRadius properties
0.9.4 Bug fix Correct resizing when iOS screen orientation changes
0.9.3 fix race condition during debug where iOS Renderer releases Element before releasing renderer.
0.9.2 Bug fix for not properly scaling when parent space is smaller than base image but larger than base image less complaint portion.
0.9.1 beta release
0.9.1 fix: scaling of scalable images larger than parent space