Home

Tutorial AppleScript Studio

Chapitre 2 - Gestion des tableaux -

Etape 1 - Création d'un tableau à N colonnes

Sous Léopard - xCode 3.0

Création du tableau

Dans Interface Builder ouvrir la fenêtre "Library", via le menu "Tools".

Ouvrez les sous-menus "Cocoa" > "Views & Cells" > "Data Views".

Sélectionnez l'icône "Table View".


image
Menu Léopard - Photo 10



Prenez et faites glisser "Table View" sur votre fenêtre vide. Son nom générique est "NSTableView". Voir la description en bas de la fenêtre Library.


image
Menu Léopard - Photo 12



Hop, notre tableau est installé dans la fenêtre de nom "Window".


image
Menu Léopard - Photo 14

Tirez sur les points bleus d'accroche pour que le tableau tienne en entier dans la fenêtre.

Notez les traits en pointillés bleus qui apparaissent pour le positionnement, et les valeurs recommandées pour être conformes aux normes Apple. (Voir le document Apple OSXHIGuidelines page 231 control & layout).


Touche "alt" pour voir les dimensions de la fenêtre.



Les menus Inspecteur

Dans Interface Builder ouvrir la fenêtre "Inspecteur", via le menu "Tools".


image
Menu Léopard - Photo 21

Mémorisez le raccourci, vous aurez besoin en permanence de l'inspecteur.



Cliquez sur votre tableau pour le rendre actif. Cela rend visibles l'inspecteur et ces menus donnant accès à "Attributes" et "AppleScript".

Globalement, le titre sera affiché à l'écran. Le nom est utilisé pour la programmation.

Il est impératif de ne pas confondre. C'est l'un des plus gros pièges, dans lequel vous tomberez. (Nous allons y revenir).

La programmation donne :

Attention, certains objets n'ont pas de titre. Pa exemple un tableau n'a pas de titre, par contre les colonnes du tableau en ont. Je pense qu'il faut toujours affecter un nom dans le menu AppleScript, et utiliser uniquement le "nom" pour programmer. (Quand bien même, si dans certains cas, il est possible d'utiliser le titre en programmation.).


Note de rédaction : Je mets en vert les noms utilisateurs, et en rouge ceux de xCode.



Les différentes "View" d'un tableau

Un tableau possède plusieurs composants : Le tableau lui-même "Table View", la "Scroll view", et enfin les colonnes, avec les sous composants comme leur titre, etc.

La "Table view" c'est la définition physique du tableau. Le cadre qui sera affiché à l'écran.

La "Scroll View" est la définition des mécanismes qui gèrent le tableau, et affiche le contenu.


Suivant où vous cliquez, et quand vous cliquez vous obtiendrez une vue différente.


Cliquez dans la bordure. Vous êtes dans la "Window View".


image
Menu Léopard - Photo 60 - Window View


Cliquez une fois dans le tableau. Vous êtes dans la "Scroll View".


image
Menu Léopard - Photo 62 - Scroll View


Cliquez encore une fois dans le tableau. Vous êtes dans la "Table View".


image
Menu Léopard - Photo 64 - Table View


Pour être sûr où vous êtes, vérifiez dans le titre de l'inspecteur.


image
Menu Léopard - Photo 66 - Table View




Les attributs du tableau "Table view" - Menu Inspecteur

La "Table view" c'est la définition physique du tableau. Le cadre qui sera affiché à l'écran.

Choisissez le sous-menu "Attributes"image. C'est l'icône là plus à gauche en haut.

Tapez 6 dans "Columns", pour avoir six colonnes dans votre tableau.

Cliquez sur "Multiple" pour autoriser la sélection de plusieurs lignes du tableau à la fois.


image
Menu Léopard - Photo 22


Faites "Save" pour valider, et admirez le résultat.


image
Menu Léopard - Photo 24

Pour pouvoir redimensionner les colonnes, il faut d'abord sélectionner la barre de titre des colonnes, puis sélectionner une séparation.

Notez l'icône de déplacement image permettant de changer la taille des colonnes, et de les voir toutes.





sous-menu "AppleScript"


Maintenant, cliquez dans le tableau pour revenir au niveau tableau. Passez au sous-menu "AppleScript" image de l'inspecteur :

  1. Vérifiez que vous êtes bien au niveau "Table View AppleScript" dans l'inspecteur, et pas en "Scroll View".
  2. Sélectionnez le nom du script "MonLogiciel".
  3. Donnez un nom pour référencer le tableau dans les scripts. J'ai choisi "notesTableView".
  4. Cochez "Action" > "clicked".
  5. Cochez "Nib" > "awake from nib". (Pour l'initialisation).
image
Menu Léopard - Photo 26

Faites "Save".


Les points 2 et 3 sont le deuxième grand piège de AppleScript Studio. Vous passerez du temps à chercher pourquoi un script ne marche pas. Souvent, il sera bon, mais il n'est pas appelé (3) et/ou l'événement (2) n'est pas validé pour l'objet que vous traitez.

Les "Events" (carrés bleus avec le signe moins), sont des événements utilisés par d'autres objets, et pas par celui-ci.

L'événement "Nib", "awake from nib" est coché, donc appelé pour notre tableau.

"awake from nib" c'est l'événement au démarrage de l'application. C'est là que vous mettrez la lecture des données initiales.

AppleScript Studio générera l'enveloppe du script des événements définis.


image
Menu Léopard - Photo 27


Et bien, voilà, notre tableau est prêt. Ce n’était pas difficile. Il ne reste plus, maintenant, qu'à y insérer des données.

Hop, et les colonnes, me direz-vous? Et bien, à part leurs donner un nom dans "Attributes" pour l'affichage, il n'y a rien à faire! Car, pour mon application, les données à insérer seront des rangées en entier, et non pas un morceau de colonne.





Les noms de colonnes


Sélectionnez la première colonne.


image
Menu Léopard - Photo 29


Sélectionnez l'onglet "Attributes" image de l'inspecteur. Donnez un nom à votre colonne, alignement centré.


image
Menu Léopard - Photo 30


Faites, "Save", et admirez le résultat.


image
Menu Léopard - Photo 32


Faites la même chose pour les autres colonnes "Desciption", "Date", "Price".


image
Menu Léopard - Photo 33




La "Scroll View" du tableau

La "Scroll View" est la définition des mécanismes qui gèrent le tableau, et affiche le contenu.

AppleScript Studio gère automatiquement la "Scroll View" pour le scrolling vertical et horizontal, le tri. Il n'y a rien à faire.

Ce qu'il faut bien comprendre : les données sont stockées pour le tableau à la queue leu leu. C'est la "Scroll View" qui fait la bonne présentation lorsque vous demandez, par exemple, un tri sur une colonne.

Vous avez uniquement besoin d'affecter un nom à la "Scroll View" dans l'onglet "AppleScript".

Pour cela allez au niveau "Scroll View" de votre tableau en cliquant dans la bordure du tableau. Vérifiez que vous êtes bien dans l'inspecteur au niveau "Scroll View". Cliquez sur l'onglet "AppleScript" image . Sélectionnez le script et donnez un nom.


image
Menu Léopard - Photo 36


En plus, si vous voulez que votre tableau suive l'agrandissement de votre fenêtre. Allez dans l'inspecteur onglet "Scroll View Size" et définissez l'Autosizing, comme indiqué dans la photo 39.


image
Menu Léopard - Photo 39


NDLR : La photo 39 n'a pas les mêmes valeurs X, Y, W, H que ce que vous avez si vous faites l'exemple en parallèle de la lecture du texte. Je n'ai pas refait tout l'exemple pour ce détail.


ET faites, "Save".


L'autorizing image est suffisant, puisque le haut gauche ne bouge pas, une fenêtre s'agrandissant en tirant le coin bas droit.


Voila nous sommes prêts à stocker des données dans notre tableau. Ce sera pour la prochaine leçon.


Si vous êtes débutant complet, je vous suggére de faire plusieurs fois l'exercice, en partant de rien, en créant un nouveau projet, etc.

Faites bien attention de faire "Save" à chaque étape, et surtout avant de lancer "Build & Go", sinon les paramètres introduit ne seront pas pris en compte à la compilation.

Revenez souvent dans l'inspecteur pour vérifier ce que vous avez fait est bien enregistré, et au bon endroit. Surveillez la confusion entre titre et nom AppleScript, entre onglet Attibutes et AppleScript.



Bonne programmation



La suite - Formattage de la colonne "Date"


Page précédente

Page suivante


Merci de votre visite


UP