FrameTimerX 1.0.0

FrameTimerX

Author: Marcos Lapa dos Santos

A cross-platform Timer that runs inside a Xamarin.Forms.Frame

Features:

• AutoStart Timer
• CountDown/CountUp
• TimerTypes: "hh:mm:ss" | "mm:ss" | IntergerCounter
• Visual Warning (Frame BackgroundColor Changing)
• Negative Numbers (Auto Stop on zero by default)

Configuration:

1. Add the component to your xaml page:

    <ContentPage xmlns="http://xamarin.com/schemas/2014/forms"             
             ...             
             xmlns:frt="clr-namespace:FrameTimerX;assembly=FrameTimerX"             
             ...             
             x:Class="YourProject.MainPage">

2. Creating a simple FrameTimerX (Default Type = "hh:mm:ss"; AutoStart = true)

    <frt:FrameTimer IsAutoStarted="True" />

Examples

1. Configuring the FrameTimerX for a Integer CountDown, TickVelocity = 500 miliseconds

    <frt:FrameTimer BackgroundColor="LightBlue" 
          StartingCounter="50" TickVelocity="500"            
          IsCountDown="True" IsAutoStarted="True"
          TimerType="IntegerCounter" />

2. Starting manually a FrameTimerX in a button click

• On Xaml file:

        <frt:FrameTimer x:Name="frtManual" BackgroundColor="LightGreen" 
                        StartingMinute="1" StartingSecond="0" IsCountDown="True" TimerType="MinuteSecond" 
                        HorizontalOptions="Center" VerticalOptions="Center" />
        <Button Text="Start" Clicked="Button_Clicked"/>

• On .cs file:

  private void Button_Clicked(object sender, EventArgs e){
    frtManual.Start();
  }
  

3. Creating a FrameTimerX with alternate background color on Warning

        <frt:FrameTimer AllowNegativeValues="True" BackgroundColor="LightCoral" WarningColor="Orange"                       
                        StartingCounter="30" TickVelocity="500" EnableWarning="True" ClockFontNegaviteTextColor="DarkBlue"
                        IsCountDown="True" IsAutoStarted="True" TimerType="IntegerCounter" 
                        StartWarningCount="10" HorizontalOptions="Center" VerticalOptions="Center" />

Known Issues

• Don't try to start a FrameTimerX on your page's constructor or OnAppearing event, use the AutoStart property instead.
• We can't put any componente inside the FrameTimer, because it'll became a simple Frame. For example, if we do something like this:

        <frt:FrameTimer IsAutoStarted="True" BorderColor="Black">
           <StackLayout>
               <Label Text="Test"></Label>
           </StackLayout>
       </frt:FrameTimer>

We'll get a simple Frame with a Label "Test" inside a StackLayout...