Action Toast Quick Start Guide

For iOS development with Xamarin and Visual Studio
Sample App

Action Toast Component

Getting Started with Action Toast

Action Toast is available exclusively as part of the Action Component Suite by Appracatappra, LLC. To use an Action Toast in your mobile app include the ActionComponents.dll and reference the following using statement in your C# code:

using ActionComponents;

Creating a Action Toast Message

The quickest way to create an display an Action Toast message is to use the static MakeText method of the ACToast class to quickly assemble your popup, then display it:

using ActionComponents;
...

// Display message to user
ACToast.MakeText("My message", ACToastLength.Long).Show ();

Multiple constructors exist for the MakeText method that allow for customization of the popup such as display time, location, appearance, etc.

Additionally, Action Toast include a shortcut ShowText method that combines the functionality of ACToast.MakeText(...).Show(); into a single method call:

ACToast.ShowText("My message");

Setting the Display Location

Action Toast can be set to display in multiple locations by setting the gravity property:

  • Top
  • Center
  • Bottom
  • Custom – A user defined location by setting the position property.

All locations take the device’s screen rotation into account so they always display correctly. The additional offset property can be used to nudge the display location as well.

Setting the Display Lengths

Action Toast can be set to display for a given amount of time by either setting the duration property to the number of seconds or setting the length property to to one of the following ACToastLengths as:

  • Forever – the message will display until the user taps it or it is closed programmatically.
  • Short – display for one second.
  • Medium – display for two seconds.
  • Long – display for five seconds.

Changing the Appearance

Action Toast can be further customized by setting it’s appearance property and defining the look and feel of the notification.

iOS Example

Here is an example of quickly displaying an Action Toast message:

using ActionComponents;
...

// Display message to user
ACToast.MakeText("My message", ACToastLength.Long).Show ();

Additionally, you can use one of the ShowText shortcut methods:

using ActionComponents;
...

// Display message to user
ACToast.ShowText("Message at Center.", ACToastGravity.Center);

Trial Version

The Trial version of Action Toast is fully functional however the background is watermarked. The fully licensed version removes this watermark.