Des widgets

Le label ou TextView

Le tout premier est le plus simple est le label (TextView).

Il servira généralement à afficher du texte devant d'autres widgets (par exemple devant un champ de saisie comme par exemple Tel:).

Les attributs dans le layout xml

Les attributs les plus courants sont :

- android:layout_width et android:layout_height pour indiquer la place qu'occupera le label (voir chapitre Positionnement et occupation des surfaces des widgets)

- android:typeface Pour indiquer le type de la police qui sera utilisé pour afficher le texte du label
- android:textStyle Pour indiquer si le texte doit être en gras (bold), en italique (italic) ou les deux (bold_italic) ;
- android:textColor Pour indiquer la couleur du texte du label (format RGB hexadécimal #RRVVBB).

- android:text Pour indiquer le texte du label

Vous trouverez ici une liste des attibuts pour le textView:

http://developer.android.com/reference/android/widget/TextView.html#attr_android:inputType

Les méthodes pour le code JAVA

- Les méthodes getText() et setText() nous permettrons de lire ou de positionner un texte.

(Exemple code HelloWorld).

Le bouton ou Button

Il s'agit d'une sous-classe de TextView. Il reprendra donc les mêmes attributs que ci-dessus.

Par contre, cela se complique au niveau du code JAVA.

Il faut en effet que celui-ci détecte que l'utilisateur a appuyé sur le ou un des boutons présents à l'écran, et surtout reconnaître le bouton pressé. Sinon, les boutons ne seraient pas bien intéressant !

Pour cela, nous devrons passer par un listener, qui va écouter ce qui se passe sur les boutons et déclencher du code lorsque l'un deux est pressé. C'est par ici !

Champ de saisie ou EditText

Il s'agit là aussi d'une sous-classe de TextView.

android:hint pour faire apparaître un texte d'exemple dans la champ de saisie de l'objet ("Tapez votre texte..." par exemple) ou pour expliquer à l'utilisateur ce que l'on attend comme saisie dans ce champ.

android:phoneNumber="true" pour indiquer que le champ est dans un format correspondant à un n° téléphone. L'utilisateur ne pourra donc pas saisir autre chose.

android:password="true" pour indiquer que l'on va saisir un password, il ne faut donc pas laisser en clair ce qui sera saisi.

Dans le même acabit: android:digits, android:numeric, android:textAllCaps, ...

et puis toujours android:text qui servira à préremplir le champ.

Pour récupérer ou modifier le texte saisi dans votre code, rien de plus simple:

Les méthodes getText() et setText() permettront de lire ou de positionner un texte.

AutoCompleteTextView

Il s'agit d'une sous classe de TextView, elle proposera en plus de TextView une série de mots ayant un rapport avec ce que vous tapez.

Les explications étant un peu longues, voyez ce lien !

Image ou ImageView

Il s'agit de l'équivalent du label, mais avec une image ! Le widget se nomme ImageView

Les attributs les plus courants sont :

• android:layout_width et android:layout_height pour indiquer la place qu'occupera le label (voir chapitre Positionnement et occupation des surfaces des widgets)
• android:adjustViewBounds Positionner à true ou false
• android:src Pour indiquer l'image source
• Il sera possible de positionner un listener onclick pour faire par exemple évoluer un drawable via pourquoi pas un LevelListDrawable().

Bouton image ou WidgetButton

Il s'agit de l'équivalent de bouton, mais avec une image à la place d'un texte. C'est donc une sous-classe de ImageView et le widget se nommera WidgetButton.

RadioButton

Ou bouton radio en français. Il s'agit d'un objet qui peut prendre deux états.

Les attributs les plus courants sont:

android:text pour indiquer le texte qui sera associé au bouton radio
android:checked qui permet de positionner le radio-bouton dans un état: "true" pour valide ou "false" pour non valide.

Comme souvent un radio-bouton est accompagné d'autres radio-boutons, et que seul un seul de ses radio-boutons ne doit pouvoir est actif à la fois, il sera possible de regrouper plusieurs radio-bouton ensemble via la balise RadioGroup.

Dans le cas de l'utilisation d'un RadioGroup, restez cohérent et ne positionnez android:checked que sur un seul des radio-boutons de ce groupe !

RadioGroup

Un radio group ou un groupement de radio-boutons permet d'associer/unifier la gestion de plusieurs radio-boutons. C'est en effet dans ce cas au radiogroup que va incomber la tâche de conserver l'unicité d'un radio-bouton valide durant les phases de saisies de l'utilisateur.

Les attributs les plus courants seront:

android:layout_width et android:layout_height pour indiquer la place qu'occupera les radio-boutons (voir chapitre Positionnement et occupation des surfaces des widgets)

android:orientation avec là encore vertical ou horizontal comme valeurs...

Voici un exemple de codification:

[...]

<RadioGroup
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:orientation="vertical">

<RadioButton
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="CHOIX 1"
/>
<RadioButton
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="CHOIX 2"
/>

</RadioGroup>

[...]

Il serait bien de connaitre les choix de l'utilisateur. Là encore, un listener s'impose !