android times square

Immessquare pour Android

Widget Android autonome pour choisir une seule date à partir d'une vue de calendrier.

Usage

Incluez CalendarPickerView dans votre mise en page XML.

< com .squareup.timessquare.CalendarPickerView
    android : id = " @+id/calendar_view "
    android : layout_width = " match_parent "
    android : layout_height = " match_parent "
    />

Il s'agit d'un contrôle assez important, il est donc sage de lui donner suffisamment d'espace dans votre disposition. Sur les petits appareils, il est recommandé d'utiliser une boîte de dialogue, un fragment plein écran ou une activité dédiée. Sur les appareils plus grands comme les tablettes, l'affichage de l'écran complet n'est pas recommandé. Un fragment occupant une partie de la mise en page ou une boîte de dialogue est un meilleur choix.

Dans l' onCreate de votre activité / boîte de dialogue ou sur onCreateView de votre fragment, initialisez la vue avec une gamme de dates valides ainsi que la date actuellement sélectionnée.

 Calendar nextYear = Calendar . getInstance ();
nextYear . add ( Calendar . YEAR , 1 );

CalendarPickerView calendar = ( CalendarPickerView ) findViewById ( R . id . calendar_view );
Date today = new Date ();
calendar . init ( today , nextYear . getTime ())
    . withSelectedDate ( today );

Le mode par défaut de la vue est d'avoir une date sélectionnable. Si vous souhaitez que l'utilisateur puisse sélectionner plusieurs dates ou une plage de dates, utilisez la méthode InMode ():

 calendar . init ( today , nextYear . getTime ())
    . inMode ( RANGE );

Télécharger

La dernière version peut être téléchargée dans ZIP et référencée par votre application en tant que projet de bibliothèque.

Vous pouvez également dépendre de la bibliothèque via Maven:

< dependency >
  < groupId >com.squareup</ groupId >
  < artifactId >android-times-square</ artifactId >
  < version >1.6.5</ version >
  < type >apklib</ type >
</ dependency >

ou Gradle:

compile ' com.squareup:android-times-square:1.6.5@aar '

Les instantanés de la version de développement sont disponibles dans le référentiel snapshots de Sonatype.

Licence

 Copyright 2012 Square, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.