Forms9Patch 1.3.3

.NET Standard 1.0
There is a newer version of this package available.
See the version list below for details.
dotnet add package Forms9Patch --version 1.3.3
NuGet\Install-Package Forms9Patch -Version 1.3.3
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.3.3">
  <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.3.3
#r "nuget: Forms9Patch, 1.3.3"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. 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.3.3

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


Because of Forms9Patch's more comprehensive Forms9Patch.Clipboard functionality, you will have to add the following code to your Android platform project's Resources/Values/string.xml file, before you can build it:

<string name="forms9patch_copy_paste_authority">your_Android_app_package_name_here.f9pcopypaste</string>
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp1.0 netcoreapp1.1 netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard1.0 netstandard1.1 netstandard1.2 netstandard1.3 netstandard1.4 netstandard1.5 netstandard1.6 netstandard2.0 netstandard2.1
.NET Framework net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid monoandroid10
MonoMac monomac
MonoTouch monotouch
Tizen tizen30 tizen40 tizen60
Universal Windows Platform uap uap10.0
Windows Phone wp8 wp81 wpa81
Windows Store netcore netcore45 netcore451
Xamarin.iOS xamarinios xamarinios10
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
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 80,471 12/16/2020
2.4.9-beta2 648 12/16/2020
2.4.9-beta1 762 12/15/2020
2.4.8 7,457 11/28/2020
2.4.7 3,744 11/19/2020
2.4.6 7,524 9/18/2020
2.4.5 887 9/17/2020
2.4.4 882 9/17/2020
2.4.2 7,856 7/25/2020
2.4.1 1,406 7/25/2020
2.4.0 1,267 7/24/2020
2.4.0-beta2 522 7/24/2020
2.4.0-beta1 511 7/24/2020
2.3.0 11,885 6/29/2020
2.2.6 17,661 3/15/2020
2.2.5 1,677 3/14/2020
2.2.5-beta1 554 3/14/2020
2.2.4 6,694 1/28/2020
2.2.4-beta1 643 1/23/2020
2.2.3 2,965 1/4/2020
2.2.3-pre1 1,605 1/4/2020
2.2.2 1,466 12/31/2019
2.2.1 1,155 12/30/2019
2.2.0 1,017 12/26/2019
2.1.3 2,229 12/10/2019
2.1.2 3,419 11/27/2019
2.1.1 767 11/26/2019
2.1.0 876 11/26/2019
2.1.0-beta1 564 11/22/2019
2.0.2 1,627 11/13/2019
2.0.1 905 11/12/2019
2.0.0 7,601 11/11/2019
2.0.0-rc1 521 11/11/2019
1.8.1 3,373 9/17/2019 2,289 8/15/2019 1,839 7/26/2019 2,105 7/9/2019 1,511 7/5/2019
1.8.0 2,142 6/26/2019
1.7.0 12,625 4/22/2019 4,300 4/12/2019 1,621 4/11/2019
1.6.7 1,403 4/11/2019 1,856 4/7/2019 2,184 3/22/2019
1.6.6 7,434 3/2/2019 1,805 2/6/2019 1,300 2/1/2019 1,292 1/30/2019
1.6.5 1,843 1/28/2019
1.6.4 17,692 12/5/2018
1.6.3 10,045 11/25/2018 3,482 11/16/2018
1.6.2 1,810 11/15/2018
1.6.1 1,841 11/2/2018 1,513 10/30/2018
1.6.0-rc5 1,474 10/30/2018
1.6.0-rc4 1,343 10/30/2018
1.6.0-rc3 1,298 10/29/2018
1.6.0-rc2 1,428 10/27/2018
1.6.0-rc1 1,405 10/27/2018 10,003 10/23/2018 1,540 10/22/2018 1,615 10/22/2018 1,428 10/20/2018 1,743 10/12/2018 1,709 10/12/2018
1.5.0-rc1 1,377 10/9/2018 2,366 9/7/2018 1,813 9/7/2018 1,604 9/7/2018
1.4.0 1,716 9/5/2018
1.3.3 5,437 6/28/2018
1.3.2 3,900 6/19/2018
1.3.1 2,209 5/15/2018
1.3.0 2,079 5/11/2018 1,979 4/19/2018
1.2.0 1,747 4/17/2018
1.1.1 2,169 2/19/2018
1.1.0 2,148 1/6/2018 1,752 1/5/2018 2,003 1/4/2018 2,274 1/2/2018
1.0.0 1,801 12/28/2017 10,350 10/26/2017 3,152 10/7/2017 5,670 8/14/2017 1,856 8/2/2017 1,839 7/10/2017
0.10.3 1,745 6/27/2017 1,779 6/21/2017 1,899 5/30/2017 1,744 5/23/2017 1,947 5/10/2017 1,772 5/3/2017 1,690 5/3/2017 1,697 5/3/2017 1,806 5/1/2017 2,062 4/16/2017 1,681 4/16/2017 1,769 4/10/2017 1,780 3/28/2017 2,483 3/2/2017 2,271 2/22/2017
0.10.1 1,912 2/16/2017 1,909 2/13/2017
0.10.0 1,849 2/11/2017 3,971 10/13/2016 2,211 9/26/2016 2,055 9/21/2016 1,812 9/15/2016 1,773 9/1/2016
0.9.13 1,843 8/22/2016 1,729 8/17/2016 2,006 8/6/2016 1,919 7/19/2016 2,064 7/16/2016 1,867 7/13/2016
0.9.12 1,923 7/11/2016 1,910 6/27/2016 1,975 5/10/2016
0.9.11 1,973 5/5/2016 1,976 4/29/2016 1,760 4/12/2016 1,825 4/5/2016 1,686 3/31/2016 1,733 3/23/2016 1,881 3/21/2016 1,819 3/21/2016
0.9.10 1,978 3/11/2016 2,004 3/1/2016 1,741 3/1/2016 2,018 2/28/2016
0.9.9 1,902 2/25/2016 1,766 2/19/2016 1,725 2/5/2016
0.9.8 1,736 2/4/2016 1,734 1/29/2016
0.9.7 1,685 1/28/2016
0.9.6 1,698 1/24/2016 1,767 1/21/2016 1,734 1/20/2016
0.9.5 1,822 1/20/2016 2,399 1/14/2016
0.9.3 1,803 1/13/2016 1,829 1/9/2016
0.9.1 1,750 1/4/2016

1.3.3: Fixed: targeted popups (Bubble, TargetedToast, TargetedMenu) will, after the device orientation has changed, render in wrong location when pointing at an element inside of a ScrollView.
1.3.2: New: KeyboardService.Height and KeyboardService.HeightChanged allow you to resize your layout views in response to changes in the software keyboard.
1.3.1: Fixed: Xamarin.Forms 3.0 UWP: Popups, Buttons, and Layouts are rendering blank. New: Forms9Patch is open source!  Get it at!AkPAsLOJX3DChFJLwyOMwJgpVXfQ  Fixed: failure to build because of orphaned references to SkiaSharp.Extended.Svg; Fixed: Clipboard entry reading fails on iOS; Work around for SkiaSharp 1.60 Lattice bug; 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