Home

Terminologie d`AppleScript Studio

1. 2 2 Le panel Font dans Interface Builder 2 3 Un Number Formatter dans Interface Builder 2 4 La fen tre Info d un Number Formatter dans Interface Builder 2 5 L image de l icone de l application dans l onglet Images de la fen tre MainMenu nib dans Interface Builder 2 6 Les fichiers son dans l onglet Sounds d une fen tre Nib dans Interface Builder ZT AUD delle sore uus de ait en d 34 4 2h ee we e a 2 8 La liste des fichiers du panneau Groups amp Files dans un projet AppleScript Application 2 9 La fen tre Info d Interface Builder montrant les informa tions AppleScript de l instance File s Owner d une ap PUES sk he a e e o Pak Taa 3 1 Des boxes utilis s comme s parateur horizontal et vertical 3 2 Une fen tre avec un tiroir ouvert extrait de l application UME ati b ee bas a a RS ee 3 3 Le panneau Cocoa Windows d Interface Builder avec a 6 5 eck ee Ae we a ER R 3 4 La fen tre MainMenu nib apr s ajout d une fen tre tiroir 3 5 Le content view d un objet drawer tiroir 28 U 31 U 3 8 Le compteur permettant de switcher d un onglet l autre DIL A mie he Die Dh a SO ce U U n split view contenant un outline view et un table view n tab view avec trois onglets 4 2 4 3 4 4 Un objet combo box avec
2. 572 hsb mode constante 180 I icon image Propri t 31 id Propri t 61 identifier propri t 39 399 idle VEIT sr 132 ignores multiple clicks propri t 282 image l ment 34 classe 58 propri t 256 268 287 317 478 500 image above constante 178 image alignment num ration 183 propri t 284 287 image below constante 178 image cell classe 284 image cell type constante 179 image dims when disabled propri t 262 image frame style num ration 184 propri t 285 287 image left constante 178 image location propri t 478 image only constante 178 image overlaps constante 178 image position propri t 256 268 image right constante 178 image scaling num ration 184 propri t 285 287 image view l ment 86 210 233 A 285 imports graphics propri t 268 327 572 increment commande 336 increment value propri t 321 indentation per level propri t 394 indeterminate propri t
3. 177 on state constante 178 only tick mark values propri t 317 opaque propri t 83 231 269 open drawer commande 240 open panel propri t 32 open untitled event 143 open panel classe 522 opened event 143 option key down propri t 52 other mouse down type constante 182 other mouse dragged type constante 182 other mouse up type constante 182 other return constante 174 outline table column propri t 395 outline view l ment 210 234 CLASSE uri 392 P page scroll propri t 216 pane splitter propri t 219 panel classe 526 panel ended VEND sesnescevnvevacerene 553 parent data item propri t 380 parent window propri t 208 pasteboard l ment 34 Classe sil iaa 64 propri t 478 path propri t 39 366 461 path for commande 112 path name propri t 531 path names Propri t 523 path separator Propri t 367 pause commande 337 perform action commande 337 periodic type cons
4. 266 281 drag event 483 drag entered event 483 drag exited event 484 drag info l ment 34 classe 477 drag updated event 485 dragged column propri t 402 dragged distance propri t 402 drawer l ment 85 CLASSE inner 204 drawer closed constante 181 drawer closing constante 181 drawer opened constante 181 Index 595 drawer opening constante 181 drawer state num ration 181 draws background propri t 203 214 223 291 326 331 571 draws cell background propri t 292 draws grid propri t 407 drop VENU Ne es rene 486 dynamically scrolls propri t 215 E echos bullets propri t 315 edge propri t 208 editable propri t 267 286 297 327 399 571 edited column propri t 407 edited data column propri t 407 edited data item propri t 394 edited data row propri t 408 edited row propri t 408 enabled propri t 267 281 500 521 enclosing scroll view propri t 230 end editing VENL i
5. 175 released when closed propri t 83 repeated propri t 53 required file type propri t 531 resigned active event 145 resigned key GYEN sad gang audi quads a 145 resigned main EVENT ra cee CARA RACA 146 Index 603 resizable propri t 400 resized event 147 resized column propri t 402 resized sub views resource path propri t 40 responder AL 68 resume commande 339 reuses columns propri t 367 rgb mode constante 180 rich text propri t 572 right alignment constante 184 right edge constante 186 right mouse down VEN ss ann es 147 right mouse down type constante 182 right mouse dragged event 149 right mouse dragged type constante 182 right mouse up EVEIG eel 150 right mouse up type constante 182 right tabs bezel border constante 189 right text alignment constante 190 roll over propri t 257 263 rounded bezel constante 175 row height propri t 409 ruler visible propri t 573 rulers visible propri t 216 S save
6. Traduction trad applescript 23 2 2004 Partie IV Control View Suite button cell 261 button cell Pluriel button cells H rite de cell page 264 Classe Cocoa NSButtonCell Sous classe de cell page 264 qui impl mente certains objets d interface comme les boutons poussoirs les boutons case cocher et les boutons ra dios Vous n aurez g n ralement pas besoin d acc der aux propri t s d un objet button cell puisque vous pouvez acc der aux m mes propri t s par l interm diaire de la classe button page 254 Dans Cocoa un objet button cell peut tre utilis par n importe quel zone d une view qui est d sign e pour envoyer un message une cible lorsque cette zone est cliqu e bien qu encore ce ne soit pas une utilisation typique pour la plupart des applications AppleScript Studio Pour des informations de m me nature voir les descriptions des classes action cell page 254 cell page 264 et button page 254 Vous pouvez cr er et acc der dans Interface Builder un objet button cell en suivant ces tapes 1 Glissez un bouton du panneau Cocoa Controls sur la fen tre cible 2 S lectionnez le bouton 3 Maintenez enfonc e la touche Option et avec le curseur de la sou ris tirez une des poign es de redimensionnement En m me temps que vous faites glisser la souris Interface Builder cr e un objet matrix page 289 contenant plusieurs objet button cell Suivant si vous g
7. 141 moved event 142 movie l ment 34 CLASS Re ss 63 propri t 298 movie controller propri t 298 movie file propri t 298 movie rect propri t 298 movie view l ment 86 210 234 Class servante 296 muted propri t 298 N name propri t 32 61 65 373 377 461 natural text alignment constante 190 needs display propri t 83 231 next state propri t 269 next text propri t 292 327 no border constante 176 no frame constante 184 no image constante 178 no scalling constante 185 no tabs bezel border constante 189 no tabs line border constante 189 no tabs no border constante 189 no title constante 191 normal playback constante 186 null cell type constante 179 number of browser rows event 436 number of items event 437 Index 601 number of rows number of tick marks propri t 317 numerical constante 188 O off state constante 178 old style type constante 176 on off button constante
8. num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Data View contient les classes suivantes DEORE 6 ain Aube A bre me OG de Re Mie 363 browser cell gt 4 6 5 baa au dou s sus e eS 370 dali ell eros ck DE I DR eR OP N 372 CALMA o i be qe oh b R a Boe Sow Gs 376 data en a on O A bin 379 ALA TOW eors LA RU NS HR Ow Sh MN MR ee a 384 ACA ROUTER cine t we BR nb ue a 386 QUEME VIEW x ee D pa no me pe ou Amp A 392 table COMUNE cs ee 4e Se A aude ie deu me 398 table header cell 401 table header view 402 table VIER lt o lt us done o monte dun ae 403 browser Pluriel browsers H rite de control page 280 Classe Cocoa NSBrowser Fournit une interface utilisateur pour l affichage et la s lection d l ments depuis une liste de donn es ou depuis des listes de donn es organis es hi rarchiquement comme un r pertoire de chemins 364 Chapitre 1 Classes Lorsque vous travaillez avec une hi rarchie de donn es les niveaux sont affich s dans des colonnes lesquelles sont num rot es de gauche droite Les num ros des colonnes sont bas s sur 0 Vous trouverez l objet browser dans le panneau Cocoa Data d Inter face Builder Vous pouvez r gler la plupart de ses attributs dans la fen tre Info d Interface
9. 155 should Z09m o 4 c 4 a Las bu dia de E B R a a aE ew ee 156 BOW os ee eb SUR UE C ARE ae a 157 IMAGE Rens ang Hoe Qu Nan oe ee Gk ee ee qi e ES eo ES 158 was Didden IEEE 159 was mniabhmized oo eos ascu bare 4 atune R TA Nha di an 159 will become active sse 44 cocs 4 aa 8 B R ee ae ha e 160 E rn l denis E E ee Be ee 161 will finish launching ooo soe 6 02545 4428444 608 Bee bes 161 GU TE oe ee eR A oe BR wo de 163 Weill al A 164 Wl TORS op ae sok g hee Pa ee Ey ke a A or ba ee 164 TI DPR La Ae en Da AU e E a le BS 165 wilt sis be eA SE EOE SR HE Bae ee eS 166 will FEED o oe 4 osa R LT ee MES dE RU ee de 167 Wil WORSE 6 a eon ede MA ae Se dE ee a 167 E FAUNE OR NE 169 WA BOO a LT Nas Be de Bae Bete a a a tee had 169 ZONE bee hada a dd Re ae Ree ee eet 171 Enum rations 173 alert Petit FASE lt m rar ee da da BOR h A ew Le 174 alert type 4 4422546 Pe bbe ee beau a d N LE st ne 174 a ES v J 6 eo ae Re oe E a ME AN ie 175 order typG se ece a 44 0648 a BR ak aw Se eS 175 DOR YPE e ocra ee die ee A ee ee AS 176 OR TRO v ca du AE a ee ee ae ee Nha due ee 177 cell image POSING sosa re 4040 p a LA RAR ew RS 177 Table des Mati res VII cell state value c orco ee concordar hu e aiie a e aa a Aa aTa a a See ee oul r panel mode s 44 44 LA UE LE SE a we e COND BIZE 4 a ue ge ge pes su deg A 6 control its oox s L usage s db mini das Cae ee a E Haner SR D
10. 208 maximum size propri t 82 572 maximum value propri t 308 317 321 maximum visible columns Propri t 366 maximum width Propri t 399 menu l ment 303 497 classe Sins 495 propri t 69 268 501 menu item l ment 303 497 CLASS mn Ae ET 499 miniaturized event 136 propri t 82 minimized image propri t 82 minimized title propri t 82 minimum column width propri t 366 minimum content size propri t 208 minimum size propri t 82 572 minimum value propri t 308 317 322 minimum width propri t 399 mixed state constante 178 modified Propri t 461 momentary change button constante 177 600 Index momentary light button constante 177 momentary push in button constante ivf mouse down mouse down state propri t 268 mouse dragged A1 S a A due sid a ciei didi 138 mouse entered EVENT ici e cen didi 139 mouse entered type constante 182 mouse exited mouse exited type constante 182 mouse moved mouse moved type constante 182 mouse up event
11. Appel pour d terminer si la s lection est autoris e lorsque l utilisateur clique sur une ligne dans un objet table view page 403 ou outline view page 392 Ce gestionnaire devra retourner true pour autoriser la s lection ou false pour la refuser Vous n aurez pas besoin de connecter ce gestionnaire moins que vous souhaitiez autoriser la s lection d une ligne dans certains cas mais l interdire dans d autres Traduction trad applescript 23 2 2004 Partie V Data View Suite should selection change 445 Syntaxe should select row reference obligatoire row integer obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 contenant la ligne pouvant tre s lectionn e row integer L index de la ligne devant tre s lectionn e R sultats boolean Retourne true pour autoriser la ligne tre s lectionn false pour Vemp cher Si vous impl mentez ce gestionnaire vous devrez obliga toirement retourner une valeur bool enne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Select Row un objet table view page 403 ou outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestion naire vierge identique celui qui suit Votre gestionnaire devra d terminer s il autorise la ligne sp cifi e tre s lectionn e puis retournera la valeur appropri e on should select row t
12. Partie IX Panel Suite Traduction trad applescript 23 2 2004 538 Chapitre 2 Commandes le point marquant l extension in directory Unicode text Le r pertoire de d part pour les panels d enregistrement ou d ouver ture with file name Unicode text Le nom de ficher par d faut pour les panels d enregistrement ou d ou verture R sultats integer Une valeur indiquant quel bouton a t utilis pour renvoyer le panel Pour les panels d ouverture et d enregistrement d AppleScript Studio 0 repr sente le bouton Annuler et 1 le bouton Enregistrer ou Ou vrir Si vous utilisez la commande Display avec votre propre panel vous appellerez la commande close panel page 535 en transmettant une valeur enti re qui est son tour transmise votre gestionnaire panel ended page 553 et indique comment votre panel a t ren voy Dans ce cas l le retour de valeurs est arbitraire et c est votre application de les assigner et de les interpr ter Exemples Vous suivrez g n ralement ces tapes bas es sur l application Save Pa nel distribu e avec AppleScript Studio pour afficher et r pondre un panel d ouverture ou d enregistrement ici un panel d enregistrement e Cr er votre application dans Interface Builder Vous pourriez vouloir afficher le panel lorsque l utilisateur cliquera sur un bouton dans une fen tre Pour faire cela utilisez un gestion naire c
13. Window became key page 127 became main page 128 exposed page 131 miniaturized page 136 moved page 142 opened page 143 resigned key page 145 resigned main page 146 resized page 147 Partie IX Panel Suite Traduction trad applescript 23 2 2004 528 Chapitre 1 Classes should close page 151 should zoom page 156 was miniaturized page 159 will close page 161 will miniaturize page 164 will move page 164 will open page 165 will resize page 167 will zoom page 169 Exemples Le gestionnaire clicked page 348 suivant est extrait partiellement du gestionnaire Clicked de l application Display Panel distribu e avec Apple Script Studio Ce gestionnaire se trouve dans le fichier Window applescript Cette application montre comment afficher un panel et obtenir des infor mations lorsqu il est renvoy Comme ce gestionnaire utilise le param tre attached to pour sp cifier que le gestionnaire devra tre affich attach la fen tre main l application fournit un gestionnaire panel ended page 553 qui est appel lorsque le panel est renvoy Aucun gestionnaire Panel Ended n est utile si le panel n est pas attach car alors il est affich comme un do cument modal et le contr le continue dans l instruction apr s que le panel soit affich on clicked theObject Some statements not shown Make sure panel has been loaded from nib into global property if not
14. comme un r pertoire ou une feuille comme un fichier une cellule branche a une image sur son c t droit indiquant qu elle contient quelquechose des informations imbriqu es sont disponibles une cellule feuille n a pas d image indiquant que l utilisateur a at teint une pi ce d information terminale loaded Acc s lecture criture Classe boolean La cellule est elle charg e true si l tat de la cellule a t r gl et qu elle est pr te pour l affichage un objet browser view appellera pour chaque cellule le gestionnaire will display browser cell page 446 lors qu il aura besoin d afficher les donn es dans une colonne Events support s par les objets de la classe Browser Cell Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire will display browser cell page 446 suivant est extrait de l application Browser distribu e avec AppleScript Studio L application Browser sert naviguer dans le syst me de fichiers affichant les fichiers et les dossiers dans une fen tre similaire la fen tre en mode colonne de l application Finder Ce gestionnaire utilise le Finder pour obtenir les infor Partie V Data View Suite Traduction trad applescript 23 2 2004 372 Chapitre 1 Classes mations sur les cellules de l objet browser page 363 devant tre affich es puis r
15. criture Classe boolean La cellule peut elle tre scroll e selectable Acc s lecture criture Classe boolean La cellule est elle s lectionnable sends action when done editing Acc s lecture criture Classe boolean La cellule doit elle envoyer ses actions lorsqu elle a fini Les ap plications Cocoa connectent g n ralement les objets d interface aux m thodes de l objet cible mais les applications AppleScript Studio les connectent aux gestionnaires d Events du script toutefois vous ne pouvez pas connecter de gestionnaires d Events un objet cell state Acc s lecture criture Classe une des constantes de cell state value page 178 L tat de la cellule string value Acc s lecture criture Classe Unicode text La valeur du contenu de la cellule au format texte tag Acc s lecture criture Classe integer Partie IV Control View Suite Traduction trad applescript 23 2 2004 270 Chapitre 1 Classes L tiquette de la cellule target Acc s lecture criture Classe item page 60 La cible des actions de la cellule les applications Cocoa connectent g n ralement les objets d interface aux m thodes de l objet cible mais les applications AppleScript Studio les connectent aux gestionnaires d Events du script toutefois vous ne pouvez pas connecter de ges tionnaires d Events un objet cell title Acc s
16. 12 Chap 2 Les bases de la terminologie Les suites Le framework Cocoa propose ses informations de scripting sous forme de suites lesquelles sont accessibles toute application l utilisant Les ap plications peuvent aussi d finir des suites suppl mentaires Une suite se compose au minimum d une suite definition et d une suite terminology contenues dans des fichiers s par s Une suite definition d crit les ob jets scriptables avec des termes repr sentant leurs attributs leurs relations et les commandes support es Ces informations sont stock es sous forme de paires cl valeur dans une propri t liste Une propri t liste est une repr sentation structur e et textuelle de donn es g n ralement enregistr e au format XML Extensible Markup Language Une suite terminology fournit la terminologie AppleScript les termes ou phrases en langue anglaise utilisables dans les scripts correspon dant aux descriptions de classes ou de commandes d une suite definition Les suites terminology sont aussi stock es sous forme de propri t s listes Les frameworks et les applications placent les fichiers de terminologie dans un r pertoire de ressources localis es nomm English lproj L anglais est Vunique dialecte support par AppleScript Note Les applications Carbon stockent la terminologie de scripting dans un format diff rent dans une ressource aete terminolo
17. 185 trailing offset propri t 209 transparent propri t 257 263 treat packages as directories propri t 531 truncated labels propri t 223 types Propri t 66 U unlock focus commande 241 unmodified characters Propri t 53 update commande 119 update menu item A gt nes nes 506 update views propri t 388 updated VEND lies sean 158 user defaults propri t 33 user defaults CLASSE cidad 72 uses data source Propri t 276 uses font panel Propri t 574 uses ruler Propri t 574 Index uses threaded animation propri t 308 uses title from previous co lumn propri t 368 V value wraps propri t 322 version propri t 33 vertical propri t 219 318 vertical line scroll propri t 216 vertical page scroll propri t 216 vertical ruler view propri t 216 vertical scroller propri t 216 vertically resizable propri t 574 view l ment 87 211 235 389 Class ais 229 propri t 228 visible constante 187 propri t
18. Application DUO saaa soaa sars a Koa a aara a Ween aaraa Wie alle araar ere lee 27 Container View Suite 195 Control View Suite 0 26 cs eee ee dae aa aii 251 Data View SUE cocina nina ddd eee 361 Document A 2400202026 455 Drag and Drop SUMt 4u u40o40cu0 0404000404 Ah 04 b ha ana ai 475 Den DN case dee ia ai da a da Jade 493 Panel Rs a douceur 511 Traduction trad applescript 23 2 2004 Partie I Introduction Les formes cl s standards 15 Plugin Suites cce ceeevee seers 606006000 sure yn Tee 557 Text View MA oo Lo a da sante done etant etant Lies 567 Le chapitre num rations page 173 de Application Suite page 27 liste les diff rentes constantes mises la disposition de toutes les suites Les formes cl s standards Pour acc der la propri t ou l l ment d un objet un script peut les sp cifier par n importe quelle forme cl key form support e Les formes cl s indiquent simplement comment les donn es doivent tre interpr t es Par exemple si une propri t supporte les formes cl s sp cifiant une position relative un script peut utiliser une instruction telle que celle ci set myWindow to the third window Les objets des applications AppleScript Studio sont bas s sur les d finitions des classes Cocoa et le support du scripting d AppleScript Stu dio permet beaucoup de classes de convenablement supporter une
19. Chapitre 1 Classes 70 sound Pluriel sounds H rite de item page 60 Classe Cocoa NSSound Repr sente un son pouvant tre charg et jou Vous ne scripterez pas g n ralement un son directement mais vous pou vez utiliser la commande load sound page 107 pour charger un objet sound et la commande play page 338 pour le jouer Vous pouvez jouer n importe quels fichiers son support s par la classe NSSound y compris des fichiers AIFF et WAV Pour des informations de m me nature voir Sound dans la documentation Cocoa L objet application page 29 poss de des l ments sound tandis que les objets button page 254 et button cell page 261 ont des propri t s sound L illustration 2 6 montre des fichiers son dans la fen tre Nib d Interface Builder Vous pouvez glisser d poser un son depuis l onglet Sounds sur un objet qui supporte les sons comme un objet button page 254 6068 8 MainMenu nib Instances Classes Images Nib La 97 ar Basso low ottle y y y mn mn ous F Funk 1 v Ae la FIG 2 6 Les fichiers son dans l onglet Sounds d une fen tre Nib dans Interface Builder Vous pouvez ajouter des sons votre application en les glissant d posant dans la liste Files du panneau Users amp Groups dans le projet Xcode de l application Actuellement pour jouer un son vous devrez le charger avec Traduction trad applescript 23 2 2004 Partie II
20. Cocoa Controls d Interface Builder Vous pouvez r gler beaucoup d attributs des objets matrix dans la fen tre Info d Interface Builder Pour des informations sur la cr ation d objets matrix contenant d autres sortes d objets voir la classe scroll view page 213 ainsi que les classes button cell Partie IV Control View Suite Traduction trad applescript 23 2 2004 290 Chapitre 1 Classes page 261 image cell page 284 secure text field cell page 314 et text field cell page 330 Pour plus d informations voir aussi Matrices dans la documentation Co coa Propri t s des objets de la classe Matrix En plus des propri t s qu il h rite de control page 280 un objet matrix poss de ces propri t s allows empty selection Acc s lecture criture Classe boolean L objet matrix autorise t il une s lection vide Par d faut cette pro pri t vaut false par exemple pour une matrice de boutons radios vous pouvez r gler cette propri t dans la fen tre Info d Interface Buil der auto scroll Acc s lecture criture Classe boolean Faut il que l objet matrix d file automatiquement auto sizes cells Acc s lecture criture Classe boolean Faut il que l objet matrix dimensionne automatiquement ses cellules Par d faut cette propri t vaut false pour une matrice de boutons radios vous pouvez r gler cette propri t dans la fen tre Info d Inter face Bu
21. Les formes cl s standards page 15 Les objets stepper de la view tab view page 221 Sp cifier par Les formes cl s standards page 15 Les objets tab view de la view Traduction trad applescript 23 2 2004 Partie III Container View Suite view 235 table header view page 402 Sp cifier par Les formes cl s standards page 15 Les objets table header view de la view table view page 403 Sp cifier par Les formes cl s standards page 15 Les objets table view de la view text field page 325 Sp cifier par Les formes cl s standards page 15 Les objets text field de la view text view page 569 Sp cifier par Les formes cl s standards page 15 Les objets text view de la view view page 229 Sp cifier par Les formes cl s standards page 15 Les objets view de la view Commandes support es par les objets de la classe View Votre script peut envoyer les commandes suivantes un objet view lock focus page 240 non support e dans la version 1 3 d Apple Script Studio register page 116 unlock focus page 241 non support e dans la version 1 3 d AppleScript Studio Events support s par les objets de la classe View Un objet view supporte les gestionnaires r pondant aux Events suivants Pour connecter dans Interface Builder un gestionnaire d Events un objet view mettez la fen tre Nib de l objet window page 76 contenant la view
22. Propri t 307 append commande 417 590 Index appkit defined type constante 181 application Classe ei 29 application defined type constante 181 ascending constante 187 associated file name propri t 78 associated object propri t 265 384 500 at bottom constante 190 at top constante 190 auto completes propri t 275 auto display propri t 78 auto enables items propri t 302 496 auto repeat propri t 321 auto resizes propri t 229 auto resizes all columns to fit propri t 405 auto resizes outline column propri t 393 auto save expanded items propri t 393 auto save name propri t 405 auto save table columns propri t 406 auto scroll propri t 290 auto sizes cells propri t 290 awake from nib event 123 B background constante 188 background color propri t 78 202 214 290 326 330 406 571 became key event 127 became main event 128 begin editing EVET isa anos 346 beginning frame constante 183 below bottom
23. colonne du tableau set allows multiple selection of theTableView to true set allows column selection of theTableView to true set selected columns of theTableView to 2 3 Pour obtenir des informations sur une cellule d une ligne d un tableau avec une data source vous pouvez utiliser les instructions suivantes du ges tionnaire clicked page 348 connect au tableau on clicked theObject set rowIndex to clicked row of theUbject if rowIndex is greater than O then set dataSource to data source of theUbject set theRow to data row rowIndex of dataSource set theName to contents of data cell name of theRow end if end clicked Travailler avec les objets table view est une tache complexe ne pouvant pas tre couverte en d tails ici Pour un exemple complet voir l application Partie V Data View Suite Traduction trad applescript 23 2 2004 414 Chapitre 1 Classes Table Cette application montre deux m canismes pour travailler avec les objets table view Le m canisme recommand lequel fait usage d un objet data source page 386 pour g rer les donn es du tableau est montr dans le fichier script WithDataSource applescript L autre m canisme moins efficace mais pouvant tout de m me convenir pour des tableaux simples est montr dans le fichier script WithoutDataSource applescript Pour un exemple plus d taill voir les chapitres du guide Building Ap plications With AppleScript Studio qu
24. de la classe default entry page 45 Version La commande Localized String est apparue avec la version 1 1 d Apple Script Studio log Retourne l objet sp cifi La commande Log renvoie la valeur dans le panneau Console de l on glet Run si votre application tourne dans Xcode ou dans l application Console situ e dans Applications Utilities si elle tourne dans le Finder La commande Log peut tre extr mement utile lors du d boggage des scripts ou peut juste servir tudier le bon fonctionnement de votre appli cation AppleScript Studio Syntaxe log reference obligatoire Param tres reference La r f rence de l objet logger vous pouvez aussi fournir une cha ne de caract res la place de la r f rence Partie II Application Suite Traduction trad applescript 23 2 2004 112 Chapitre 2 Commandes Exemples Les instructions suivantes montrent comment logger une cha ne de ca ract res et un objet Le texte indiqu apr s les tirets montre le r sultat des instructions cependant logger une cha ne de caract res produira le m me r sultat quelle que soit l application on clicked theUbject log just testing result just testing log theObject result 2002 07 23 11 42 09 274 Drawer 488 button id 2 of window id 1 Rest of handler not shown Vous pouvez aussi logger des variables ou des propri t s comme dans Vexemple suivant
25. diteur prototype cell Acc s lecture criture Classe cell page 264 Le prototype de cellule de l objet matrix scrollable Acc s lecture criture Classe boolean L objet matrix est il d filable Non support e dans la version 1 3 d AppleScript Studio toutefois vous pouvez utiliser la commande call method page 94 pour r gler cette propri t mais pas pour l obte nir notez que vous devrez transmettre une valeur bool enne la commande call method sous forme d une liste un seul l ment call method setScrollable of matrix 1 of window 1 with parameters true selection by rect Acc s lecture criture Classe boolean Les cellules peuvent elles tre s lectionn es par le rectangle Vous pou vez r gler cette propri t dans la fen tre Info d Interface Builder tab key traverses cells Acc s lecture criture Classe boolean La touche tabulation peut elle servir passer d une cellule l autre Partie IV Control View Suite Traduction trad applescript 23 2 2004 294 Chapitre 1 Classes l ments des objets de la classe Matrix En plus des l ments qu il h rite de la classe control page 280 un objet matrix peut contenir les l ments list s ci dessous Votre script peut sp cifier la plupart des l ments avec les formes cl s d crites dans Les formes cl s standards page 15 cell page 264 sp cifier par Les for
26. main contenant un objet box avec plusieurs champs texte vous pourriez r gler le texte d un des champs avec l instruction sui vante set contents of text field company of box info of window main to Acme Nuts and Bolts Ltd Pour acc der aux diff rentes propri t s du m me objet box vous pourriez crire tell window main tell box info set boxTitle to title set boxType to box type etc end tell end tell Version Le support des Events de glisser d poser est apparu avec la version 1 2 d AppleScript Studio La propri t title font de cette classe n est pas support e dans la ver sion 1 3 d AppleScript Studio Partie III Container View Suite Traduction trad applescript 23 2 2004 202 Chapitre 1 Classes clip view Pluriel clip views H rite de view page 229 Classe Cocoa NSClipView Une view contenant et faisant d filer la view affich e par un objet scroll view page 213 Vous n avez normalement pas besoin de scripter l objet clip view car la classe Scroll View g re la plupart des d tails de d filement lorsque la taille du document view change ou si la position le requiert La classe Scroll View fournit aussi l acc s la plupart des m mes propri t s list es par la classe Clip View Propri t s des objets de la classe Clip View En plus des propri t s qu il h rite de view page 229 un objet clip view poss de ces propri t s background
27. on will resize theObject Perform operations here before the object resizes Return a point to specify a different size For example return 200 560 end will resize Version Le param tre proposed size est apparu avec la version 1 2 d Apple Script Studio Traduction trad applescript 23 2 2004 Partie II Application Suite will zoom 169 will show Appel lorsqu un objet est sur le point d tre montr Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer F Syntaxe will show reference obligatoire Param tres reference La r f rence de l objet qui va tre montr Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Show un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer l exposition on will show theObject Perform operations here before the object is shown end will show will zoom Appel lorsqu un objet window page 76 est sur le point d tre agrandi Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer 9 Syntaxe will zoom reference obligatoire screen bounds bounding rectangle facultatif Param tres reference La r f rence de l objet window page 76 qui va tre agrandi screen bounds bounding rectangle Une liste de quatre nombres gauche bas
28. set itemValue to if the identifier of theColumn is name then tell application Finder set itemValue to displayed name of get item theltem as string end tell else if the identifier of theColumn is date then tell application Finder set itemValue to modification date of get item theItem as string end tell else if the identifier of theColumn is kind then tell application Finder set itemValue to kind of get item theltem as string end tell end if return itemValue end item value Partie V Data View Suite Traduction trad applescript 23 2 2004 436 Chapitre 3 Events number of browser rows Appel pour obtenir le nombre de lignes d un objet browser page 363 pour une colonne donn e Contrairement aux autres data views comme outline view page 392 et table view page 403 vous ne pourrez pas alimenter en donn es un objet browser avec un objet data source page 386 En cons quence de quoi les performances pourront tre insuffisantes pour des objets browser affichant plus qu un petit nombre d l ments aussi vous devrez pr f rer l utilisation d une des deux autres data views bien s r si cela est compatible avec vos imp ratifs Syntaxe number of browser rows reference obligatoire in column integer obligatoire Param tres reference La r f rence de l objet browser page 363 duquel doit tre obtenu le nombre de lignes in column integer L index de la colonne R
29. un objet combo box page 274 AppleScript Studio ajoute automati quement au script d sign un gestionnaire vierge identique celui qui suit Le param tre theObject r f rence l objet combo box page 274 ou popup button page 301 qui est sur le point de surgir Vous pouvez utiliser ce Traduction trad applescript 23 2 2004 Partie IV Control View Suite will pop up 357 gestionnaire pour pr parer le surgissement comme v rifier les l ments du combo box ou du popup button on will pop up theUbject Perform any operations to prepare for popping up end will pop up Partie IV Control View Suite Traduction trad applescript 23 2 2004 Cinqui me partie Data View Suite Cette partie d crit la terminologie de la suite Data View d AppleScript Studio La suite Data View d finit les classes dont la principale caract ristique est d afficher des rang es et des colonnes de donn es La plupart des classes de la suite Data View h rite de la classe view page 229 ou de la classe cell page 264 La suite Data View d finit aussi plusieurs Events pour le travail avec les l ments cellules rang es et colonnes trouvables dans les objets table view page 403 et outline view page 392 Les classes commandes et Events de la suite Data View sont d crits dans les chapitres suivants E ad 363 CAMAS NORA E stewie toto sains n e shares aostenste eoanece us 417 AS A A A A ce eee Za 423 Le chapitre
30. Container View Suite view 231 view dans un scroll view flipped Acc s lecture uniquement Classe boolean Est ce que le syst me des coordonn es de la view est tourn Par d faut l origine du syst me de coordonn es de la view est situ dans le coin inf rieur gauche toutefois pour certaines views la valeur par d faut de cette propri t vaut true signifiant que l origine est dans le coin sup rieur gauche cette propri t est en lecture uniquement et il est peu probable que votre application soit concern e par cela voir la propri t bounds de la classe window page 76 pour plus d infor mations sur le syst me des coordonn es lequel diff re de celui qui est utilis par l application Finder de Mac OS needs display Acc s lecture criture Classe boolean La view a t elle besoin d tre affich e R gler cette propri t sur true provoquera le redessinement de la view jusqu une prochaine opportu nit pour provoquer un redessinement imm diat utiliser la commande update page 119 noter que dans la version 1 3 d AppleScript Stu dio la propri t needs display n est pas support e par la classe window page 76 mais l est par la classe view opaque Acc s lecture uniquement Classe boolean La view est elle opaque Voir la description de la propri t opaque de la classe window page 76 position Acc s lecture criture Classe point La positi
31. Inside Mac OS X La terminologie d Applescript Studio pour AppleScript Studio 1 3 trad applescript free fr 23 f vrier 2004 Pr ambule Ce guide n est absolument pas une traduction officielle de la Soci t Apple Ce guide est bas sur le guide AppleScript Studio Terminology Reference for AppleScript Studio 1 3 Ce guide a t enti rement compos et produit avec un logiciel libre et gratuit une distribution de ATEX 2e Pour ceux qui ne connaissent pas essayez le malgr son aspect aust re et d routant au premier abord les documents obtenus d passent largement les traitements de texte conven tionnels la preuve ici Ce guide n est pas exempt d erreurs de frappe ou d interpr tation et je vous prie de m en excuser Si vous constatez des erreurs ou des oublis je vous remercie de bien vouloir me faire remonter l information cette adresse trad applescript free fr afin de les corriger dans une prochaine version Dans l espoir que cette version fran aise comblera l attente de tous les utilisateurs francophones je vous souhaite une bonne d couverte de la ter minologie d AppleScript Studio Nicolas Marques d pos es Apple le logo Apple AppleScript Finder Mac Macintosh et PowerBook sont des marques d pos es de Apple Computer Inc Toutes les autres marques sont la propri t de leurs d tenteurs respectifs Table des mati res Pr ambule I Introduction 1
32. Les informations propos de l op ration de glisser Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Drag Up dated un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge Le param tre theObject r f rence l objet dans les limites duquel un glisser avec un type r pertori a boug Le pa ram tre dragInfo fournit l acc s l objet drag info page 477 contenant toutes les informations pertinentes sur l op ration de glisser Notez toutefois que dans la version 1 3 d AppleScript Studio vous ne pouvez pas acc der la propri t location d un objet drag info page 477 aussi la capacit d terminer un point d insertion est limit e on drag updated theObject drag info dragInfo Statements to deal with the drag updating end drag updated Version Le gestionnaire Drag Updated fut ajout dans la version 1 2 d Apple Script Studio drop Appel lorsqu un utilisateur a d pos des donn es avec le type r pertori sur l objet Vous retournerez false depuis ce gestionnaire pour annuler l op ration sinon vous devrez retourner true pour signaler le succ s de l op ration Vous pouvez examiner la propri t pasteboard du param tre drag info pour obtenir les donn es du d poser dans le format requis Si vous utilisez le gestionnaire prepare drop page 488 pour v rifier que les donn es dont vous avez besoin sont pr se
33. Notez toutefois que bien que vous puissiez travailler avec les donn es d un table view sans un objet data source page 386 comme dans cet exemple l approche conseill e et plus efficace est d utiliser une data source L application Table montre cette approche laquelle ne requiert pas de gestionnaire Number Of Rows dans le fichier script withDataSource applescript Le gestionnaire suivant retourne juste le nombre total de contacts on number of rows theUbject Partie V Data View Suite Traduction trad applescript 23 2 2004 440 Chapitre 3 Events return count of contacts end number of rows should collapse item Appel par un objet outline view page 392 pour d terminer si un l ment devra tre r duit Le gestionnaire retournera true pour autoriser la r duction de l l ment false pour l interdire Syntaxe should collapse item reference obligatoire outline item item facultatif Param tres reference La r f rence de l objet outline view page 392 contenant les l ments pouvant tre r duits outline item item page 60 L l ment pouvant tre r duit R sultats boolean Retourne true pour autoriser l l ment tre r duit false pour l emp cher Si vous impl mentez ce gestionnaire vous devrez obliga toirement retourner une valeur bool enne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Collapse Item un objet outline view pa
34. Perform operations here after becoming key end became key became main Appel lorsqu un objet window page 76 vient juste de devenir la fen tre principale c est dire la fen tre l avant plan et principal lieu des actions de l utilisateur La fen tre principale n est pas n cessairement la fen tre cl Voir aussi became key page 127 et resigned main page 146 ainsi que les propri t s key et main de la classe window page 76 Pour plus d informations voir Basic Event Handling dans la documentation Cocoa Syntaxe became main reference obligatoire Param tres reference La r f rence de l objet window page 76 devenu l objet principal Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Became Main un objet window page 76 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Vous Traduction trad applescript 23 2 2004 Partie II Application Suite closed 129 pouvez utiliser ce gestionnaire pour ex cuter sur la fen tre toute op ration n cessaire une fois le changement d tat ici principal accompli on became main theUbject Perform operations here after becoming main end became main closed Appel apr s qu un objet drawer page 204 tiroir en fran ais soit ferm partir de cet instant le gestionnaire peut ex cuter toute op ration n cessaire une
35. Pour un bref exemple de commandes utilis es avec un objet progress indicator voir les commandes animate page 333 increment page 336 Partie IV Control View Suite Traduction trad applescript 23 2 2004 310 Chapitre 1 Classes start page 340 et stop page 343 Le gestionnaire openPanel suivant est extrait de l application Mail Search distribu e avec AppleScript Studio avant la version 1 1 d Apple Script Studio cette application s appelait Watson Ce gestionnaire fait partie des multiples gestionnaires du script objet d fini dans l application Mail Search pour contr ler la fen tre status panel Ce gestionnaire a un seul param tre statusMessage lequel fournit le message affich dans le status panel Il est aussi reli certaines propri t s du script comme initialized et statusPanelNibLoaded Si la fen tre status panel n a pas d ja t charg e le gestionnaire la charge r gle l tat de l objet progress indicator de la fen tre indique a celui ci de d marrer et r gle le message du status panel Il utilise alors la commande display page 537 pour afficher le status panel et son progress indicator attach une autre fen tre on openPanel statusMessage if initialized is false then if not statusPanelNibLoaded then load nib StatusPanel set statusPanelNibLoaded to true end if tell window status set indeterminate of progress indicator progress
36. Traduction trad applescript 23 2 2004 Partie II Application Suite item 61 page 229 ou de responder page 68 Si le gestionnaire a uniquement besoin d acc der aux propri t s name ou ID de l objet transmis il peut traiter ces objets comme des objets item Toutefois si vous transmettez le gestionnaire un objet n h ritant pas de la classe Item vous obtiendrez une erreur De m me vous pouvez utiliser l l ment item d AppleScript pour se r f rer n importe quel l ment d une liste bien que la liste puisse contenir diff rents types d objets Propri t s des objets de la classe Item Un objet item poss de ces propri t s id Acc s lecture uniquement Classe integer L ID unique de l objet name Acc s lecture criture Classe unicode text Le nom de l objet vous fournirez un nom AppleScript un objet dans Interface Builder comme il est d crit dans la section Exemples script Acc s lecture criture Classe script Le script associ avec l objet disponible dans la version 1 3 d Apple Script Studio voir la section Exemples de cette classe ainsi que celle de la classe menu page 495 Commandes support es par les objets de la classe Item Votre script peut envoyer la commande suivante un objet item log page 111 Events support s par les objets de la classe Item Cette classe n est pas accessible dans Interface Builder par cons quent
37. classe 325 text field cell classe 330 text returned Propri t 519 text view l ment 87 211 235 ALC 569 thick square bezel constante 175 thicker square bezel constante 175 tick mark above constante 190 tick mark below constante 190 Index 607 tick mark left constante 190 tick mark position num ration 190 propri t 318 tick mark right constante 190 time stamp propri t 53 title propri t 84 199 257 270 318 497 501 531 title cell propri t 199 318 title color propri t 318 title font propri t 199 318 title height propri t 367 title position num ration 190 propri t 199 title rect propri t 200 titled propri t 368 toggle button constante 177 tool tip propri t 232 top constante 187 top alignment constante 184 top edge constante 186 top left alignment constante 184 top right alignment constante 184 top tabs bezel border constante 189 track mode constante
38. dans le pan neau AppleScript de la fen tre Info dans Interface Builder votre gestion naire Launched devrait ressembler au gestionnaire qui suit extrait de l ap plication Drawer distribu e avec AppleScript Studio Partie III Container View Suite Traduction trad applescript 23 2 2004 206 Chapitre 1 Classes on launched theObject show window main end launched Pour autoriser l utilisateur ouvrir ou fermer le tiroir vous devrez ajou ter un bouton titr par exemple Ouvrir le tiroir Vous pourrez alors connec ter un gestionnaire clicked page 348 ce bouton pour e ouvrir ou fermer le tiroir en accord avec l tat courant du tiroir e r gler le titre du bouton afin qu il refl te l tat du tiroir comme Ou vrir le tiroir lorsque le tiroir est ferm et Fermer le tiroir lorsque celui ci est ouvert Vous pouvez utiliser la commande open drawer page 240 pour ouvrir ou fermer le tiroir Par exemple l instruction suivante ouvre le tiroir nomm drawer tell drawer drawer to open drawer Il est aussi possible d instancier un tiroir par lui m me sans une fen tre parent ou un content view en glissant d posant l objet tiquet Drawer du panneau Cocoa Windows sur la fen tre Nib dans Interface Builder Dans ce cas vous obtiendrez juste l instance NSDrawer et vous devrez le connecter vous m me une fen tre et un content vi
39. dio vous n aurez pas besoin d appr hender la conservation ou la lib ration de l objet Toutefois si vous faites de multiples appels la commande Load Image ou load movie page 104 ou load sound page 107 et que vous ne lib rez pas l image ou le movie page 63 ou le sound page 70 l usage de la m moire de votre application augmentera Pour r soudre ce probl me vous pouvez explicitement supprimer l image ou le movie ou le sound si ce n est pas un son syst me lorsque vous avez fini avec elle Supprimer une image ou un movie ou un sound la supprime de la liste d images et plus gard e par l application et la lib re le compteur atteignant 0 l objet est lib r Notez que si vous supprimez une image actuellement affich e dans une image view elle ne sera pas lib r e tant que l image view l utilisera Le script suivant montre comment une application pourrait trouver toutes les images d un certain type stock es dans cette application puis utilise un gestionnaire idle pour faire d filer les images dans l image view toutes les 2 secondes Chaque fois qu une image est charg e l image pr c dente est supprim e afin de lib rer la m moire utilis e Le gestionnaire launched utilise la commande call method page 94 pour appeler une m thode du bundle page 38 principal de l application et obtenir la liste stock e sous forme de propri t de toutes les images JPEG de ce bundle Le premier
40. don de son tat actif Voir aussi will resign active page 167 Syntaxe resigned active reference obligatoire Param tres reference La r f rence de l objet application page 29 ayant abandonn son tat actif Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Resigned Active un objet application page 29 AppleScript Studio ajoute automa tiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois que l objet application page 29 a abandonn son tat actif on resigned active theUbject Perform operations here after resigning active state end resigned active resigned key Appel apr s qu une fen tre ait abandonn son tat cl par exemple comme premier r ceptacle des touches du clavier Voir aussi became key page 127 et will resign active page 167 Syntaxe resigned key reference obligatoire Partie II Application Suite Traduction trad applescript 23 2 2004 146 Chapitre 3 Events Param tres reference La r f rence de l objet window page 76 ayant abandonn son tat d objet cl Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Resigned Key un objet window page 76 AppleScript Studio ajoute automati quement au script d sign un gestionnaire vierge identique celui qui suit Vous pouve
41. drawer vous pouvez ouvrir ce tiroir sur le c t gauche de la fen tre avec une instruction tell comme celle qui suit tell window main tell drawer drawer to open drawer on left edge end tell unlock focus Non support e par la version 1 3 d AppleScript Studio Syntaxe unlock focus reference obligatoire Param tres reference La r f rence de l objet view page 229 pour lequel la mise au point va tre d verrouill e Partie III Container View Suite Traduction trad applescript 23 2 2004 Chapitre 3 Events Les objets bas s sur les classes de la suite Container View supportent les gestionnaires r pondant aux Events suivants un Event est une ac tion g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestionnaire appropri devant tre ex cut Pour d terminer les Events support s par une classe se r f rer sa description bounds CAB coca Da eh eee we HE we oe ae 243 resized sub views 244 selected tab view item 245 should select tab view item 246 will resize sub views 247 will select tab view item 248 bounds changed Appel apr s que les limites d un objet view page 229 aient t mo difi es Syntaxe bounds changed reference obligatoire 244 Chapitre 3 Events Param tres reference La r f re
42. end right mouse dragged Vous pouvez utiliser le param tre theEvent pour obtenir des informations sur l Event right mouse dragged comme l emplacement de la souris et si les touches Commande Option Majuscule ou Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples right mouse up Appel lorsqu un Event right mouse up rel chement du bouton droit de la souris survient Syntaxe right mouse up reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Right Mouse Up est appel event event page 50 Les informations d Events de l Event right mouse up Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Right Mouse Up un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on right mouse up theUbject event theEvent Add script statements here to handle the right mouse up event end right mouse up Vous pouvez utiliser le param tre theEvent pour obtenir des informations sur l Event right mouse up comme l emplacement de la souris et si les touches Commande Option Majuscule ou Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples Traduction trad applescript 23 2 2004 Partie II Application Suite should close 151 scroll wheel
43. if openOnEdge is left edge then set current row of matrix open on to 1 else if openOnEdge is top edge then set current row of matrix open on to 2 else if openOnEdge is right edge then set current row of matrix open on to 3 else if openOnEdge is bottom edge then set current row of matrix open on to 4 end if end tell end awake from nib Les instructions suivantes extraites du gestionnaire clicked page 348 de l application Drawer montre comment extraire des informations sur Partie IV Control View Suite Traduction trad applescript 23 2 2004 296 Chapitre 1 Classes les rang es de l objet matrix de fa on ce que lorsque le bouton drawer est cliqu l application sache sur quel c t ouvrir le tiroir on clicked theUbject tell window main if theUbject is equal to button drawer then set openOnSide to current row of matrix open on Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio Les propri t s cell size intercell spacing next text previous text et scrol lable de cette classe ne sont pas support es dans la version 1 3 d AppleScript Studio movie view Pluriel movie views H rite de view page 229 Classe Cocoa NSMovieView Affiche un film dans un cadre et fournit des propri t s associ es la lecture et l dition du film Vous utiliserez la commande load movie page 104 pour charger un objet
44. la premi re instruction ci dessous obtient les pace la seconde le r gle set spacing to call method intercellSpacing of matrix 1 of window 1 call method setIntercellSpacing of matrix 1 of window 1 with parameter 2 0 2 0 key cell Acc s lecture criture Classe cell page 264 La cellule cl de l objet matrix matrix mode Acc s lecture criture Classe une des constantes de matrix mode page 185 Le mode de l objet matrix par exemple radio mode next text Acc s lecture criture Classe n importe Non support e dans la version 1 3 d AppleScript Studio se servir de la m thode de la classe NSMatrix sur laquelle cette propri t est bas e n est pas encourag e aussi cette propri t risque de ne jamais tre Traduction trad applescript 23 2 2004 Partie IV Control View Suite matrix 293 support e le prochain diteur de l objet matrix voir la propri t field editor de la classe text page 569 pour une description d un diteur previous text Acc s lecture criture Classe n importe Non support e dans la version 1 3 d AppleScript Studio se servir de la m thode de la classe NSMatrix sur laquelle cette propri t est bas e n est pas encourag e aussi cette propri t risque de ne jamais tre support e le pr c dent diteur de l objet matrix voir la propri t field editor de la classe text page 569 pour une description d un
45. lecture criture Classe Unicode text Le titre de la cellule wraps Acc s lecture criture Classe boolean La cellule ins re t elle des retours automatiques en fin de ligne Commandes support es par les objets de la classe Cell Votre script peut envoyer la commande suivante un objet cell perform action page 337 Events support s par les objets de la classe Cell Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Vous scripterez g n ralement une sous classe de control page 280 ou view page 229 contenant un objet cell ou une sous classe de cell pas l objet cell lui m me L unique situation o vous devrez acc der l objet cell lui m me est lorsque vous travaillerez avec un objet matrix page 289 Un objet matrix est utilis pour cr er un groupe d objets cell comme des boutons radio L application Assistant distribu e avec AppleScript Studio depuis la version 1 2 utilise un objet matrix avec des boutons radio pour sp cifier la Traduction trad applescript 23 2 2004 Partie IV Control View Suite color well 271 gravit d un probl me Elle utilise l instruction suivante dans son gestion naire updateValue pour obtenir la propri t title du bouton radio actuel lement s lectionn Cette instruction r gle la propri t severity cr e pour l occasion sur le titre de l
46. log someCountProperty result 2002 09 17 17 04 45 596 AppName 488 7 if the value of someCountProperty is 7 Pour utiliser la commande Log dans une instruction tell visant une application vous pouvez utiliser cette syntaxe tell application Finder tell me to log Entered Finder tell block end Version La commande Log est apparue avec la version 1 1 d AppleScript Studio path for Retourne le chemin complet de la ressource sp cifi e dans le bundle vis ou si aucun bundle n est vis dans le bundle principal de l application Pour plus d informations sur les bundles y compris des exemples visant des bundles externes voir bundle page 38 Traduction trad applescript 23 2 2004 Partie II Application Suite path for 113 Syntaxe path for reference obligatoire column integer facultatif directory Unicode text facultatif extension Unicode text facultatif localization Unicode text facultatif resource Unicode text facultatif script Unicode text facultatif Param tres reference La r f rence du bundle page 38 depuis lequel doit tre obtenu le chemin si aucun bundle n est sp cifi le bundle principal de l objet application page 29 est utilis column integer L index de la colonne bas sur 0 du browser view lorsqu est utilis un objet browser page 363 pour afficher un syst me de fichiers vous pou vez utiliser la commande Path For pour obtenir le c
47. on changed theObject Perform operations here after object changed due to editing end changed clicked Appel lorsque l utilisateur clique sur l objet Presque toutes les sous classes de la classe control page 280 supportent le gestionnaire Clicked Syntaxe clicked reference obligatoire Traduction trad applescript 23 2 2004 Partie IV Control View Suite double clicked 349 Param tres reference La r f rence de l objet ayant t cliqu Exemples Le gestionnaire Clicked suivant est pour le bouton Convert de l ap plication Currency Converter distribu e avec AppleScript Studio Cette application fournit des champs texte pour la saisie de la somme et du taux de conversion et un champ pour l affichage du r sultat ainsi que le bouton Convert pour lancer la conversion on clicked theObject tell window of theUbject try set theRate to contents of text field rate set theAmount to contents of text field amount as number set contents of text field total to theRate theAmount on error set contents of text field total to 0 end try end tell end clicked Seul un objet le bouton Convert de l application Currency Conver ter supporte le gestionnaire Clicked aussi dans ce gestionnaire l applica tion sait que le param tre theObject r f rence le bouton Le gestionnaire obtient la fen tre de cet objet ainsi il peut acc der aux champs texte de ce
48. on should open theUbject set allowOpen to false Check variable perform test or call handler to see if OK to open If so set allowOpen to true return allowOpen end should open should open untitled Appel avant qu un objet supportant ce gestionnaire g n ralement l ob jet application page 29 n ouvre une fen tre ou un document sans titre Le gestionnaire peut retourner false pour annuler l op ration Syntaxe should open untitled reference obligatoire Param tres reference La r f rence de l objet g n ralement l objet application page 29 ayant l option d ouvrir une fen tre ou un document sans titre Partie II Application Suite Traduction trad applescript 23 2 2004 154 Chapitre 3 Events R sultats boolean Retournera true pour autoriser l ouverture d une fen tre ou d un do cument sans titre false pour l interdire Exemples L exemple suivant de gestionnaire Should Open Untitled v rifie la pro pri t allowUntitled laquelle est d finie ailleurs dans le script pour d terminer si l ouverture de l objet sans titre doit tre autoris e Vous pourriez galement a la place v rifier une propri t ou ex cuter une vali dation dans le gestionnaire lui m me on should open untitled theObject if allowUntitled is equal to true then return true else return false end if end should open untitled should quit Appel pour d te
49. propos de ce guide Ce que ce guide contient Ce que ce guide ne contient pas Autres documentations s s ges dt ae a a lu de a dl 2 Les bases de la terminologie Information sur les versions Construire des applications AppleScript Studio Les sources de la terminologie d AppleScript Studio Lee SUITES ic erm Sais ba AE Be ee sm ae Comment sont organis es les suites La terminologie fournie par le framework Cocoa Application La terminologie fournie par AppleScript Studio Les formes cl s standards Les conventions d appellation des m thodes et des gestionnaires Acc der aux propri t s et aux l ments Les param tres des gestionnaires d Events Connecter les gestionnaires d Events g rant le clavier et la souris Les messages d erreur de scripting Utiliser les exemples de scripts Panels contre Dialogs et Windows 11 12 12 13 14 15 16 17 19 20 IV Table des Mati res II Un mot sur Unicode Text gt 2 4 4 4455524 6 iaae sua 22 Application Suite 25 Classes 29 application v 422442 bises be eee ee RE do die 29 DAMES soon ee HAN Ne AR Sn Re ek ie 38 o A ae Seve Ge he E ee he te et DT Soie 45 default entry sesaat ga aa Re 4 Red ee 45 OVEN as dde t
50. trad applescript 23 2 2004 56 Chapitre 1 Classes formatter Pluriel formatters H rite de personne Classe Cocoa NSFormatter Contr le le format des nombres ou des dates Un number formatter contr le le format des nombres et un date for matter fait la m me chose mais pour les dates Pour plus d informations sur ces classes voir NSNumberFormatter et NSDateFormatter dans la do cumentation Cocoa L illustration 2 3 pr sente un number formatter que vous pouvez faire glisser depuis le panneau Cocoa Text d Interface Builder Ces number formatter ou date formatter peuvent par exemple tre d pos s sur un champ texte dans une application AppleScript Studio pour formater le texte 1 95 FIG 2 3 Un Number Formatter dans Interface Builder L illustration 2 4 montre le panneau Formatter de la fen tre Info d In terface Builder dans lequel vous pourrez ajuster le format Lorsque vous glissez un objet formatter sur un champ texte Interface Builder affiche au tomatiquement le panneau Formatter dans la fen tre Info La fen tre Info s ouvre en appuyant sur Cmd Maj I Events support s par les objets de la classe Formatter Un objet formatter supporte les gestionnaires r pondant aux Events sui vants Vous pouvez suivre ces tapes pour connecter un gestionnaire un objet formatter dans Interface Builder 1 Mettez la fen tre Nib de l objet
51. 332 Chapitre 1 Classes set draws background of textFieldCell to true Traduction trad applescript 23 2 2004 Partie IV Control View Suite Chapitre 2 Commandes Les objets bas s sur les classes de la suite Control View supportent les commandes suivantes Une commande est un mot ou une phrase qu un script peut utiliser pour demander une action Pour d terminer les com mandes support es par chaque classe voir les descriptions propres cha cune RD os a eR Hoe Ra 4 333 Se fo ee lh ee DUR E eee ee 334 SLI 554 La Boe BO ee ee ed 335 MOOD 3 30 eg hc we eR gs Eire we es 336 PAM oh ee Peo eB Se eee eo ee ee 337 DAT APM 47204 Du 6 Denk ewe Jae e nus et ee re 337 BASE Roi Nes ee RS er IR uen 338 TESIS E nn Pe Pe a es Bw 339 BODO 5 auga Re ee DE Tr s ee ee sh Ded cis Beya D Dune 339 e ae A eS A 340 step back 4 4 csoc 6 4 4 ara eH 4 8 26 8 4 341 step forward x a a ae eu ue ba ft non 342 a A LUS NO NS 343 a 4 s va ba Lu sm sans 343 animate Fait progresser l animation d un objet progress indicator ind termin par tapes 334 Chapitre 2 Commandes Syntaxe animate reference obligatoire Param tres reference La r f rence de l objet progress indicator page 306 animer Exemples tant donn un objet window page 76 nomm main comportant un objet progress indicator page 306 nomm barber pole l instruction suivante provoq
52. 96 Chapitre 2 Commandes call method setScrollable of matrix 1 of window 1 with parameters true R sultat n importe La valeur retourn e d pend de la m thode appel e La commande Call Method peut retourner les types Cocoa NSRect NSPoint NSSize et NSRange en plus des types primitifs comme int double char ainsi que les pointeurs des objets Cocoa etc Le tableau 2 2 liste les types Cocoa g n ralement retourn s par la commande Call Method et leur quivalent AppleScript Il est recommand d utiliser un bloc try on error si vous voulez par la suite exploiter le r sultat de cette commande comme dans la section Exemples de la commande path for page 112 Type Cocoa quivalent AppleScript NSArray list NSDate date NSDictionary record NSPoint liste de deux nombres x y NSRange liste de deux nombres d but offset fin offset NSRect liste de quatre nombres gauche bas droite haut NSSize liste de deux nombres largeur hauteur NSString string TAB 2 2 Les types Cocoa et leur quivalent AppleScript Exemples Ce qui suit est une d claration de m thode de la classe NSDocument de Cocoa BOOL readFromFile NSString fileName ofType NSString docType Cette m thode a deux param tres aussi pour l appeler avec la commande Call Method vous utiliserez l option with parameters Dans l exemple suivant la liste se compose de deux variables
53. Acc s lecture criture Classe boolean L objet browser utilise t il des titres Vous pouvez r gler cette pro pri t dans la fen tre Info d Interface Builder non support e dans la version 1 3 d AppleScript Studio toutefois l instruction suivante pallie cette incompatibilit en utilisant la commande call method page 94 set isTitled to call method isTitled of browser 1 uses title from previous column Acc s lecture criture Classe boolean L objet browser devra t il utiliser la valeur de la colonne pr c dente comme titre de la prochaine colonne Par d faut cette propri t vaut true l ments des objets de la classe Browser En plus des l ments qu il h rite de la classe control page 280 un objet browser peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 cell page 264 sp cifier par Les formes cl s standards page 15 Les cellules de l objet browser peuvent g n ralement tre de la classe browser cell page 370 Commandes support es par les objets de la classe Browser Votre script peut envoyer les commandes suivantes un objet browser path for page 112 update page 119 Traduction trad applescript 23 2 2004 Partie V Data View Suite browser 369 Events support s par les objets de la classe Browser Un o
54. Appel lorsque le scroll wheel se d place Syntaxe scroll wheel reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Scroll Wheel est appel event event page 50 Les informations d Events de l Event scroll wheel Exemples Le gestionnaire Scroll Wheel suivant r pond un scroll wheel en incr mentant ou d cr mentant une valeur dans un text field page 325 bas e sur le param tre event page 50 transmis Le gestionnaire awake from nib page 123 initialise le text field avec une valeur d marrant 100 on scroll wheel theObject event theEvent set theValue to content of theObject as number set theValue to theValue delta y of theEvent set content of theObject to theValue end scroll wheel on awake from nib theUbject set content of theObject to 100 end awake from nib should close Appel lorsqu un objet supportant ce gestionnaire est sur le point de se fermer Ce gestionnaire est support par les classes comme window page 76 panel page 526 et drawer page 204 Le gestionnaire peut retourner false pour annuler l op ration de fermeture Partie II Application Suite Traduction trad applescript 23 2 2004 152 Chapitre 3 Events Syntaxe should close reference obligatoire Param tres reference La r f rence de l objet qui pourrait se fermer R sultats boolean Retourne true pou
55. AppleScript Studio Voir la suite Drag and Drop Suite page 475 pour plus de d tails En particulier la description du gestionnaire conclude drop page 481 donne des informations le support du Glisser D poser des objets text view page 569 et text field page 325 La propri t content est apparue avec la version 1 2 d AppleScript Stu dio Vous pouvez utiliser au choix content et contents sauf l int rieur d un gestionnaire d Events contents of theUbject retournant une r f rence l objet plut t que son contenu courant Pour obtenir dans un gestion naire d Events le contenu d un objet comme le texte contenu dans un text field page 325 vous pouvez utiliser soit contents of contents of theUbject soit content of theUbject Pour un exemple de script montrant la diff rence entre content et contents voir la section Version de la classe control page 280 Voir la section Exemples de la commande scroll page 339 pour plus d informations sur la mani re de faire d filer le texte dans un text view page 569 Traduction trad applescript 23 2 2004 Partie XI Text View Suite Douzi me partie Annexes Annexe A Les applications distribu es avec AppleScript Studio A Vappui d AppleScript Studio version 1 3 Apple fournit un certain nombre d exemples d applications AppleScript Studio Ces exemples sont situ s dans le r pertoire Developer Examples AppleScript Studio et so
56. Classe window page 76 La fen tre principale de l application la fen tre principale est le centre d action de l activit de l utilisateur consulter les propri t s key et main de la classe window page 76 pour plus d informations name Acc s lecture uniquement Classe Unicode text Le nom de l application open panel Acc s lecture criture Classe open panel page 522 Le panel d ouverture de l application cr automatiquement pour chaque application AppleScript Studio save panel Acc s lecture criture Traduction trad applescript 23 2 2004 Partie II Application Suite application 33 Classe save panel page 529 Le panel d enregistrement de l application cr automatiquement pour chaque application AppleScript Studio services menu Acc s lecture criture Classe menu page 495 Le menu Services de l application les services permettent une application de tirer avantages des caract ristiques fournies par d autres applications comme la v rification orthographique ou l envoi par mail de la s lection en cours user defaults Acc s lecture criture Classe user defaults page 72 Les couples de valeurs utilisateurs par d faut de l application voir aussi default entry page 45 version Acc s lecture uniquement Classe Unicode text La version de l application issue de la cha ne de caract res de la version courte par d f
57. Expand Item un objet outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Le param tre theObject r f rence l objet outline view Votre ges tionnaire devra d terminer s il autorise l l ment sp cifi tre d velopp Partie V Data View Suite Traduction trad applescript 23 2 2004 442 Chapitre 3 Events puis retournera la valeur appropri e on should expand item theObject outline item outlineltem set allowExpand to false Check variable perform test or call handler to see if OK to expand If so set allowExpand to true return allowExpand end should expand item should select column Appel pour d terminer si la s lection est autoris e lorsque l utilisateur clique sur une colonne dans un objet table view page 403 ou outline view page 392 comme lorsque l utilisateur essaie de faire glisser une colonne pour modifier sa position Ce gestionnaire devra retourner true pour autoriser la s lection ou false pour la refuser Par d faut la s lection d une colonne est activ e pour les objets table view page 403 mais pas pour les objets outline view page 392 mais vous pouvez modifier ce r glage dans Interface Builder Vous n aurez pas besoin de connecter ce gestionnaire moins que vous souhaitiez autoriser la s lection d une colonne dans certains cas mais l interdire dans d autres Sy
58. Finalement il r gle la valeur affich e dans le champ texte associ notez qu il n a pas besoin de convertir la valeur en cha ne de caract res pour r gler le contenu du champ texte on clicked theObject tell window main Partie IV Control View Suite Traduction trad applescript 23 2 2004 324 Chapitre 1 Classes if theUbject is equal to button drawer then else if theUbject is equal to stepper leading offset then set theValue to contents of stepper leading offset as integer set leading offset of drawer drawer to theValue set contents of text field leading offset to theValue Les instructions suivantes extraites du gestionnaire action page 345 de Vapplication Drawer montre comment r gler la valeur de l objet stepper a partir de la valeur saisie dans le champ texte associ on action theObject set textValue to contents of theObject if theObject is equal to text field leading offset then set leading offset of drawer drawer to textValue set contents of stepper leading offset to textValue Pour r gler la valeur d un objet stepper et afficher la m me valeur dans un champ texte vous pouvez utiliser les instructions suivantes tell window main set contents of stepper stepperName to myNumber set contents of text field textFieldName to myNumber end tell Pour obtenir la valeur utilisez cette instruction laquelle retourne un nombre r el tell window main set c
59. Inter face Builder distribu e avec Mac OS X version 10 2 vous pouvez galement r gler l attribut Textured Window pour sp cifier la fen tre le look m tal bross Dans certains cas comme avec un progress panel vous ne pourrez instancier qu une seule fois la fen tre puis l afficher et la cacher comme voulu en utilisant soit les commandes show page 118 et hide page 99 soit en r glant directement la propri t visible de la fen tre Dans d autres cas vous pourriez vouloir instancier de fa on r p titive une nouvelle fen tre et la lib rer lorsque l utilisateur a fini avec ce que vous Partie II Application Suite Traduction trad applescript 23 2 2004 78 Chapitre 1 Classes pouvez faire en r glant la propri t released when closed de la fen tre dans Interface Builder L application Mail Search distribu e avec AppleScript Studio fournit des fichiers nib et du code pour la cr ation d un one time status panel ainsi qu une fen tre message qui est instanci e plusieurs fois Avant la version 1 1 d AppleScript Studio Mail Search s appelait Wat son Pour plus d informations voir Windows and Panels dans la documenta tion Cocoa Propri t s des objets de la classe Window En plus des propri t s qu il h rite de la classe responder page 68 un objet window poss de ces propri t s alpha value Acc s lecture criture Classe r
60. LIST 1 1 Un gestionnaire Clicked vierge La d finition de la syntaxe de chaque gestionnaire d Events montre la syntaxe compl te utilis e pour construire le gestionnaire vierge Une fois qu un gestionnaire vierge a t ins r dans le script de l application vous tes libre de modifier les noms de ces param tres ou de supprimer ou d ignorer tout param tre d clar comme facultatif dans la d finition de la syntaxe Une des mani res de faciliter la documentation des scripts est lorsque c est possible de modifier le nom du param tre theObject afin qu il soit repr sentatif de l objet auquel il se r f re Par exemple si un gestionnaire clicked page 348 est uniquement appel en r ponse au clic sur un bouton Search vous pouvez modifier la d claration du gestionnaire d Events en on clicked searchButton Modifier le nom d un param tre n a aucun effet Partie I Introduction Traduction trad applescript 23 2 2004 20 Chap 2 Les bases de la terminologie sur le fonctionnement du gestionnaire Si le gestionnaire peut tre appel par un ou plusieurs objets comme une s rie de boutons pr sents sur un objet tab view page 221 vous pouvez la fois modifier le nom du param tre et rajouter un commentaire pour clarifier son utilisation on clicked importButton This handler handles buttons on the Import pane your script statements here end clicked Connecter les gestionnaires d Events g
61. La valeur de l objet progress indicator synonyme de contents contents Acc s lecture criture Classe real La valeur de l objet progress indicator synonyme de content control size Acc s lecture criture Classe une des constantes de control size page 180 La taille de l objet progress indicator par d faut cette propri t vaut regular size vous pouvez la r gler dans la fen tre Info d Interface Builder control tint Acc s lecture criture Partie IV Control View Suite Traduction trad applescript 23 2 2004 308 Chapitre 1 Classes Classe une des constantes de control tint page 180 La teinte de l objet progress indicator par d faut cette propri t vaut default tint indeterminate Acc s lecture criture Classe boolean La valeur de l objet progress indicator est elle ind termin e Un objet progress indicator ind termin tourne sans interruption jusqu ce que le but soit atteint un progress indicator d termin montre le pourcen tage de la t che effectu e vous pouvez la r gler dans la fen tre Info d Interface Builder maximum value Acc s lecture criture Classe real La valeur maximale de l objet progress indicator par d faut cette propri t vaut 100 0 vous pouvez la r gler dans la fen tre Info d In terface Builder minimum value Acc s lecture criture Classe real La valeur minimale de l obj
62. Les informations d Events de l Event key down Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Keyboard Down AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique a celui qui suit on keyboard down theUbject event theEvent Add script statements here to handle the key down event end keyboard down Vous pouvez utiliser le param tre theEvent pour obtenir des informations sur Event keyboard down comme le ou les caract res et si les touches Commande Option Majuscule ou Contr le ont t enfonc es Voir la classe event page 50 pour des exemples keyboard up Appel lorsqu une touche du clavier est relach e Syntaxe keyboard up reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Keyboard Up a t appel event event page 50 Les informations d Events de l Event key up Traduction trad applescript 23 2 2004 Partie II Application Suite launched 135 Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Keyboard Up AppleScript Studio ajoute automatiquement au script d sign un ges tionnaire vierge identique celui qui suit on keyboard up theUbject event theEvent Add script statements here to handle the key up event end keyboard up Vous pouvez utiliser le param tre theEvent pour obtenir des inform
63. Par exemple tous les Events Clavier et Souris sont directement envoy s l objet window page 76 associ e l Event Dans une application AppleScript Studio ces Events peuvent tre dispatch s aux scripts des gestionnaires d Events que vous avez connect s dans Interface Builder Voir la classe responder page 68 pour plus d informations sur la gestion par l application des Events Clavier et Souris Toute application AppleScript Studio et Cocoa n a exactement qu une seule instance de l objet application cr e automatiquement comme par tie int grante du projet d application dans Xcode L illustration 2 1 montre l instance Files Owner du fichier nib principal Dans le fichier nib princi pal File s Owner repr sente toujours NSApp une constante globale qui r f rence l objet NSApplication de l application L objet application sert comme contr leur principal de l application Vous attacherez les gestion naires l objet application dans Interface Builder par l interm diaire de Vinstance File s Owner Pour plus d informations sur les fichiers nib et Fi le s Owner voir la commande awake from nib page 123 0008 Le MainMenu nib Instances Classes Images Sounds Nib ES ina MainMenu Fic 2 1 L instance File s Owner repr sentant l objet application dans Inter face Builder L objet application fournit des instances partag es de color panel page 514 font panel page 520
64. Retournera true pour quitter l application une fois que la derni re fen tre est ferm e false pour l interdire Exemples L exemple suivant de gestionnaire Should Quit After Last Window Clo sed appelle le gestionnaire shouldQuit crit par vous pour d terminer s il Partie II Application Suite Traduction trad applescript 23 2 2004 156 Chapitre 3 Events doit autoriser l application quitter puis retournera la valeur appropri e Vous pourriez galement la place v rifier une propri t ou ex cuter une validation dans le gestionnaire lui m me on should quit after last window closed theUbject Check property perform test or call handler to see if OK to quit after last window closed set allowQuit to shouldQuit the0bject return allowQuit end should quit after last window closed should zoom Appel pour d terminer si une fen tre doit tre agrandie Le gestionnaire peut examiner les limites de zoom et retourner false s il refuse l agrandissement ou true s il l autorise En cas d absence de ges tionnaire ou si vous fournissez un gestionnaire mais qui ne retourne pas de valeur par d faut l agrandissement sera autoris Si vous souhaitez pouvoir contr ler les limites du zoom utilisez le ges tionnaire will zoom page 169 Si vous voulez acc der aux limites dans le gestionnaire Will Zoom vous devrez impl menter Should Zoom et enregis trer la valeur du param tre proposed boun
65. application page 29 Notez que save panel avec un tiret est le nom de la classe tandis que save panel sp cifie un objet de cette classe Pour utiliser un panel d enregistrement dans une application AppleScript Studio vous utiliserez la commande display page 537 pour afficher la pro pri t save panel associ e avec chaque objet application page 29 Si vous affichez le panel comme une feuille attach une fen tre vous aurez aussi besoin de connecter un gestionnaire panel ended page 553 Lorsque l utili sateur ferme le panel vous pouvez obtenir des informations comme le che min qu a choisi l utilisateur pour l enregistrement d un fichier en acc dant aux propri t s de l objet save panel Un objet save panel comprend et travaille uniquement avec des che mins au format POSIX d limit s par des slashs Il ne comprend pas les types files ou alias Vous pouvez toutefois utiliser les commandes POSIX file et POSIX path du compl ment de pilotage d AppleScript pour convertir les types de chemins Ces commandes sont d finies dans le compl ment de pilotage osax Standard Additions d AppleScript fichier StandardAdditions osax dans System Library ScriptingAdditions Partie IX Panel Suite Traduction trad applescript 23 2 2004 530 Chapitre 1 Classes L illustration 9 4 montre un panel d enregistrement Pour plus d infor mations sur les panels voir Windows and Panels dans
66. awake from nib page 123 View bounds changed page 243 Exemples L instruction suivante extraite de l application Open Panel distribu e depuis la version 1 1 d AppleScript Studio montre comment r gler le texte d un objet text view L instruction nettoie le text view en r glant son texte sur une chaine vide set contents of text view path names of scroll view path names of window main to nn Partie XI Text View Suite Traduction trad applescript 23 2 2004 576 Chapitre 1 Classes Vous pouvez utiliser le script suivant dans l application diteur de Scripts pour r gler la couleur du texte d un text view sur la couleur verte Ce script peut tout fait tre repris dans le script d une application Apple Script Studio bien que vous n aurez pas besoin de l ins rer dans un bloc tell application tell application myTextViewApp tell text view text of scroll view scroller of window main set text color to 0 65535 0 end tell end tell La terminologie pour la gestion du texte peut tre un peu confuse La suite Text View d AppleScript Studio d finit la classe text view page 569 laquelle avant la version 1 3 d AppleScript Studio h rite de la classe text page 569 depuis la version 1 3 les propri t s de la classe text page 569 sont fusionn es avec la classe Text View En plus Cocoa d finit la suite Texte laquelle d finit les classes comme character paragrap
67. comme les bou tons les champs textes les ascenseurs etc dessinement des dispositifs d affichage r pondre aux Events de l utilisateur et envoyer les messages ac tions Fonctionne de pr s avec les objets cell page 264 La plupart des appli cations n auront souvent pas besoin de scripter directement un objet control mais plut t de scripter des sous classes comme button page 254 et text field page 325 Pour plus d informations voir Controls and Cells dans la documentation Cocoa Propri t s des objets de la classe Control En plus des propri t s qu il h rite de view page 229 un objet control poss de ces propri t s alignment Acc s lecture criture Classe une des constantes de text alignment page 189 Le type d alignement du texte de l objet control cell Acc s lecture criture Classe cell page 264 La cellule de l objet control content Acc s lecture criture Classe item page 60 La valeur de l objet control synonyme de contents contents Acc s lecture criture Traduction trad applescript 23 2 2004 Partie IV Control View Suite control 281 Classe item page 60 La valeur de l objet control synonyme de content continuous Acc s lecture criture Classe boolean L objet control g n re t il continuellement des actions current cell Acc s lecture uniquement Classe cell page 264 La cellule en cours de l
68. constante 182 left tabs bezel border constante 189 left text alignment constante 189 level propri t 81 line border constante 176 line scroll propri t 216 list mode constante 185 load data representation event 467 load image commande 100 load movie commande 104 load nib commande 106 load panel commande 548 Index 599 load sound commande 107 loaded propri t 366 371 localized sort propri t 388 localized string commande 109 location propri t 52 478 lock focus commande 240 log commande 111 loop mode propri t 297 looping back and forth play back constante 186 looping playback constante 186 M main propri t 81 main bundle propri t 32 main menu Propri t 32 main window Propri t 32 marker follows cell Propri t 394 matrix l ment 86 210 234 classe 289 matrix mode num ration 185 Propri t 292 maximum content size Propri t
69. constante 191 below top constante 191 bezel border constante 176 bezel style num ration 175 propri t 255 262 bezeled propri t 265 307 326 border rect Propri t 198 border type num ration 175 propri t 198 214 bordered propri t 256 265 272 326 bottom constante 187 bottom alignment constante 183 Index 591 bottom edge constante 186 bottom left alignment constante 183 bottom right alignment constante 183 bottom tabs bezel border constante 189 bounds propri t 79 230 bounds changed event 243 bounds rotation propri t 230 box l ment 85 209 233 classe 197 box type num ration 176 propri t 198 browser l ment 85 209 233 CLASSE nee rares eus 363 browser cell CAS et an ee ee 370 bundle classe 38 button l ment 85 209 233 classe 254 button cell classe 261 button frame constante 184 button returned propri t 514 518 button type num ration 177 propri t 256 262
70. de la classe window page 76 dont h rite la classe panel page 526 dont h rite son tour la classe color panel r sultat visible est une pro pri t h rit e pour color panel Ce syst me de poup es russes fait d Apple Script Studio la fois un syst me complexe untel h rite de untel qui h rite lui d untel et relativement complet le syst me d h ritage multipliant les possibilit s Vous pouvez utiliser l instruction suivante pour obtenir la couleur s lectionn e dans le panel Couleurs set myColor to color of color panel returns an RGB color value as a three item list int int int Vous pouvez r gler la couleur d un objet color panel en utilisant cette instruction set color of color panel to 43591 0 2 Le gestionnaire launched page 135 suivant connect l objet application page 29 par l interm diaire de l instance File s Owner dans la fen tre MainMenu nib d Interface Builder r gle la couleur du panel Cou leurs sur le rouge et rend ce panneau visible lorsque l application est lanc e Partie IX Panel Suite Traduction trad applescript 23 2 2004 518 Chapitre 1 Classes on launched theObject set color of color panel to 165535 0 0 set visible of color panel to true end launched Version Depuis la version 1 1 d AppleScript Studio le nom de la classe color panel a t modifi en color panel Ceci afin de mieux diff rencier la class
71. der ses colonnes ou aux cellules individuelles qui fournissent ses donn es Vous cr erez g n ralement un objet data source page 386 pour g rer les donn es d un objet outline view page 392 ou table view page 403 Vous cr erez alors chaque objet data column page 376 et leur fournirez un nom Ce processus est montr dans la section Exemples de la commande append page 417 Puis pour un objet table view vous cr erez des objets data row pour la data source Important Vous devez d abord cr er les objets data column avant de cr er les objets data row Pour chaque ligne cr e l objet data source cr era automatiquement un objet data cell page 372 pour chaque colonne donnant par d faut chaque objet data cell le nom de sa colonne Apr s cr ation d une ligne vous pouvez r gler les donn es de ses objets data cell g n ralement en sp cifiant la ligne et le nom de la cellule Vous pouvez utiliser ces m mes informations pour obtenir le contenu d un objet data cell Pour un objet outline view page 392 vous cr erez des objets data item page 379 la place des objets data row comme le d crit la section Exemples de la classe data item page 379 Propri t s des objets de la classe Data Row Un objet data row poss de ces propri t s associated object Acc s lecture criture Classe item page 60 Un objet pouvant tre associ avec l objet data row Traduction
72. di da 22 we dan OMe oe ee a image alignment oo so 244 4 4 44 4 de 24 Da aa dau a nage Tame BOYT wee a aa ar LR RES Las manteau nage SCANS 4 ke tk he de b Bo vb R Aa Le amp Hide 6 Wali Mode gt Les bee be do dia daube da dd E quicktime movie loop Mode ccs eos soa yee A aude eG t ctanele AA Bel to Ouo Le gon La R Re Leu ma kan da de SOIT e a lt lt 4 3 8 Re hais eR x R 8 RE eS SOUL GET ke de LE AA de far ee du BOW FPE ci Dont a cu A nues a Be we AO ee eg tab SENATE lt b 8 a AA A we an sdr V h CAD VIEW II Lex AENMENT ws eee Ee a dt As A tick mark position c s z a a 4 8 bu 8S be eee ME 8 R ee title POSICION 6 unidas Ada dh SR R T pue A ae we l aa III Container View Suite 1 Classes GUD VIOW coracora a a de ge ea ae Be eG ae d PANEL de e RR ar ne MS Le ee oe ee soroll VIEN a ae 5 be Be oe be Ae RE PAO EG BSG eo ue Spt VIEW o oe coe De a a be dead a a WANE A E Doc a tab VIEW Honi carir a Mur he di Ge RS sata Be 38 178 179 179 180 180 181 181 183 183 184 184 185 185 186 186 187 187 188 188 188 189 190 190 193 VIII Table des Mati res yal cb Bay e anaa adhi a 6 a ERB SS io BG East 229 2 Commandes 239 close LAW oo c cosa 4 8 ban da de bague du pub 239 Lek TOONS o Si LAS LE UE RE RARE FAN Esp 240 OPEN CANET e caca A4 0 a AE Ms ER Bee don a 240 unlock OCUS e e ke Babies be da date
73. disponibles e general e font e ruler e find e drag Les pasteboards font et ruler ne sont pas utilis s ce jour mais pour raient l tre dans une future version Le pasteboard general est le paste board principal Pour obtenir le contenu du pasteboard general vous pou vez utiliser contents of pasteboard general Vous utiliserez ce m me format pour le pasteboard find lequel est utilis pour r gler la valeur des op rations de recherche et de remplacement dans la plupart des ap plications Le pasteboard drag est utilis durant la gestion de l Event glisser d poser Un pasteboard donn peut contenir un certain nombre de types de for mat Les types suivants sont directement support s par AppleScript Studio Traduction trad applescript 23 2 2004 Partie II Application Suite pasteboard 65 color file file names font html image pdf pict image postscript rich text rich text data ruler string tabular text url et vcard Vous pourriez voir des types de pasteboards suppl mentaires d finis par le syst me ou par d autres applications Vous pouvez d terminer les types disponibles tout moment pour un pasteboard en regardant la pro pri t types Par exemple si vous utilisez la phrase types of pasteboard general vous pourriez obtenir une liste comme celle ci
74. droite haut sp cifiant les Partie II Application Suite Traduction trad applescript 23 2 2004 170 Chapitre 3 Events limites de l cran contenant la partie la plus large de la fen tre moins le Dock et la barre de menus s il le faut notez qu il ne s agit pas de limites demand es ou de limites pour lesquelles la fen tre sera agrandie voir la propri t bounds de la classe window page 76 pour des informations sur le syst me des coordonn es R sultats bounding rectangle Vous pouvez retourner un bounding rectangle une liste de quatre nombres gauche bas droite haut pour sp cifier les limites de la fen tre agrandie Si vous ne retournez pas un rectangle la valeur qui tait l origine transmise avec le param tre screen bounds est utilis e Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Zoom un objet window page 76 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Le pa ram tre theObject r f rence l objet qui va tre agrandi Vous pouvez utiliser le param tre screen bounds ainsi que les limites de la fen tre elle m me et peut tre les limites demand es pour l op ration de zoom si vous les avez enregistr es dans le gestionnaire should zoom page 156 pour d terminer s il faut modifier les limites pour lesquelles la fen tre va tre agrandie Le gestionnaire suivant
75. du panneau AppleScript de la fen tre Info d Interface Builder set theRate to contents of text field rate Cette m me application utilise l instruction suivante pour r gler le texte dans un autre text field afin d afficher la conversion mon taire set contents of text field total to theRate theAmount Notez que l objet text field affiche automatiquement le r sultat sous forme de texte Vous pouvez utiliser l instruction suivante pour r gler la couleur du texte d un champ texte sur le rouge set the text color of text field text1 of window 1 to 65535 O O Version Le support des Events de Glisser D poser est apparu dans la version 1 2 d AppleScript Studio Voir Drag and Drop Suite pour plus de d tails En particulier la description du gestionnaire conclude drop page 481 fournit Partie IV Control View Suite Traduction trad applescript 23 2 2004 330 Chapitre 1 Classes des informations sur le support du Glisser D poser des objets text view page 569 et text field page 325 Les propri t s next text et previous text de cette classe ne sont pas support es dans la version 1 3 d AppleScript Studio Le support de ces pro pri t s risque de ne jamais tre ajout text field cell Pluriel text field cells H rite de cell page 264 Classe Cocoa NSTextFieldCell Ajoute au texte affich les capacit s d un objet cell en fournissant la possibilit de r gler en m
76. en mode outline en cliquant sur la petite icone outline au dessus de Vascenseur vertical droit utilisez les triangles pour ouvrir l objet window et les autres objets jusqu ce que l objet view soit visible s lectionnez le puis connectez le gestionnaire d Events dans le panneau AppleScript de la fen tre Info Glisser D poser conclude drop page 481 Partie III Container View Suite Traduction trad applescript 23 2 2004 236 Chapitre 1 Classes drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples La classe View est une classe r sum que vous ne viserez g n ralement pas dans vos scripts mais plut t ses sous classes comme box page 197 scroll view page 213 ou tab view page 221 La classe control page 280 h rite aussi de la classe View aussi toutes les sous classes de control h ritent des propri t s et des l ments de la classe View bien que certains l ments de View comme un movie view page 296 ou un progress indicator
77. et load data representation page 467 Les sections Exemples de ces gestionnaires montrent les ver sions de ces gestionnaires dans l application Task List Vous pouvez utiliser les instructions suivantes dans l application diteur de Scripts pour acc der aux propri t s d un document d une application bas e sur le mod le AppleScript Document based Application Ces m mes instructions fonctionneront dans le script d une application AppleScript Stu dio bien que vous n aurez pas besoin de les encadrer par un bloc tell application tell application Document Application set myName to name of the first document result Untitled 2 end Version La propri t path fut ajout e dans la version 1 3 d AppleScript Studio Avant la version 1 3 d AppleScript Studio la propri t file type tait impl ment e avec un code sur 4 caract res pouvant provoquer des conflits de terminologie avec d autres applications Depuis la version 1 3 cette propri t est impl ment e avec un code diff rent vitant ces conflits possibles La propri t file kind fut ajout e pour une r tro compatibilit avec des scripts existant mais elle ne devra pas tre utilis e dans vos scripts Les changments suivants furent faits dans la version 1 2 d AppleScript Studio e Laclasse Document fut d plac e de la suite Application vers sa propre suite Document e La propri t file type fut ajout e e L
78. gler dans Interface Builder fournit les plus petites versions de ces l ments d in terface convenant aux fen tres ou aux panels plus petits Constantes regular size Taille normale small size Taille r duite control tint Sp cifie le th me des contr les Les classes comme cell page 264 progress indicator page 306 et tab view page 221 poss dent une propri t control tint qui pourra tre r gl e avec l une des valeurs list es ci dessous Par exemple lorsque la propri t control tint est r gl e sur default tint le th me en cours est Aqua Constantes clear tint Th me transparent Traduction trad applescript 23 2 2004 Partie II Application Suite drawer state 181 default tint Th me par d faut Aqua drawer state Sp cifie l tat d un objet drawer page 204 tiroir Pour plus d informations voir la classe drawer page 204 Constantes drawer closed Le tiroir est ferm drawer closing Le tiroir se ferme drawer opened Le tiroir est ouvert drawer opening Le tiroir s ouvre event type Sp cifie le type d Events Pour plus d informations voir la classe event page 50 Constantes appkit defined type Event d fini par AppKit Cocoa se compose de deux frameworks App Kit et Foundation application defined type Event d fini par l objet application page 29 cursor update type Event mise jour du curseur flags changed type Event to
79. image below Image en dessous image left Image gauche image only Uniquement montrer l image image overlaps Chevauchement de l image image right Image droite no image Aucune image cell state value Sp cifie l tat d une cellule La classe cell page 264 fournit la fois une propri t state et une propri t support mixed state Ses sous classes peuvent supporter deux tats activ ou d sactiv ou trois tats activ d sactiv ou mixte Un tat mixte est utile pour une case cocher ou un bouton radio cela permet de refl ter l tat d une caract ristique qui est vraie pour certains l ments Par exemple une case cocher italique sera activ e si tout le texte de la s lection courante est en italique d sactiv e si tous les caract res ne sont pas en italique et mixte si seulement certains caract res sont en italique Constantes mixed state tat mixte off state tat d sactiv on state tat activ Traduction trad applescript 23 2 2004 Partie II nu Application Suite cell type 179 cell type Sp cifie le type de cellule La classe cell page 264 fournit une propri t cell type pour ses sous classes comme image cell page 284 et text field cell page 330 Constantes image cell type Cellule pr vue pour une image null cell type Cellule vide text cell type Cellule pr vue pour du texte color panel
80. page 15 Consulter la section Version de cette classe pour conna tre dans quelle version d AppleScript Studio un l ment a pu tre ajout window page 76 Sp cifier par Les formes cl s standards page 15 Les fen tres du document voir la section Version ci dessous Commandes support es par les objets de la classe Document close de la Core Suite Cocoa print de la Core Suite Cocoa save de la Core Suite Cocoa Events support s par les objets de la classe Document Un objet document supporte les gestionnaires r pondant aux Events suivants Document data representation page 465 load data representation page 467 read from file page 469 write to file page 470 Nib awake from nib page 123 Exemples L application Plain Text Editor distribu e avec AppleScript Studio depuis la version 1 2 montre comment lire et crire des fichiers texte avec les gestionnaires de bas niveau read from file page 469 et write to file page 470 Les sections Exemples de ces gestionnaires montrent les ver sions de ces gestionnaires dans l application Plain Text Editor L applica tion Task List galement distribu e depuis la version 1 2 d AppleScript Traduction trad applescript 23 2 2004 Partie VI Document Suite document 463 Studio montre comment lire et crire des fichiers texte avec les gestionnaires de haut niveau data representation page 465
81. page 306 ne soient pas tr s utiles par exemple un objet control comme un objet button page 254 Traduction trad applescript 23 2 2004 Partie III Container View Suite view 237 Vous pouvez utiliser le script suivant dans l application diteur de Scripts pour faire pivoter de 50 degr s le texte dans un text view page 569 Des instructions similaires fonctionneront l int rieur d une application AppleScript Studio bien que vous n aurez pas besoin de l instruction tell application tell application rotate tell window 1 tell scroll view 1 tell text view 1 set bounds rotation to 50 0 set needs display to true end tell end tell end tell end tell Version La propri t needs display n est pas support e par la classe window page 76 dans la version 1 3 d AppleScript Studio mais elle l est par la classe View Les commandes lock focus page 240 et unlock focus page 241 ne sont pas support es par la version 1 3 d AppleScript Studio Partie III Container View Suite Traduction trad applescript 23 2 2004 Chapitre 2 Commandes Les objets bas s sur les classes de la suite Container View supporte les commandes suivantes Une commande est un mot ou une phrase qu un script peut utiliser pour demander une action Pour d terminer les com mandes support es par chaque classe voir les descriptions propres chaque classe close drawer ac 44 4 nakupu seau se
82. page 76 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Le gestionnaire suivant est extrait de l application Display Alert distribu e avec AppleScript Studio Ce gestionnaire obtient partir du param tre with reply le nom du bouton retourn et l utilise pour r gler le contenu d un champ texte nomm button returned on alert ended theObject with reply theReply set contents of text field button returned of window main to button returned of the reply end alert ended dialog ended Appel apr s qu un dialogue soit fini si ce dialogue a t attach une fen tre Lorsque vous affichez un dialogue en tant qu application modale votre script devra attendre que l utilisateur ait renvoy le dialogue Si vous l affi chez en tant que document modal en sp cifiant le param tre attached to l ex cution du script continue Vous devrez fournir un gestionnaire Dialog Ended afin de pouvoir ex cuter toute action lorsque l utilisateur renverra le dialogue Syntaxe dialog ended reference obligatoire with reply dialog reply facultatif Traduction trad applescript 23 2 2004 Partie IX Panel Suite panel ended 553 Param tres reference La r f rence du panel pour lequel le gestionnaire est appel with reply dialog reply La r ponse retourn e depuis le dialogue Exemples Pour un exemple de gestionnaire Dialog
83. permettant de naviguer dans les volumes si votre application poss de un l ment de menu pour afficher la date de modification d un fi chier s lectionn vous pourriez utiliser un gestionnaire Update Menu Item pour d sactiver l l ment de menu lorsqu aucun fichier n est s lectionn on update menu item theUbject x if the menu item should be enabled Traduction trad applescript 23 2 2004 Partie VIII Menu Suite update menu item 507 return true other statements if the menu item should be disabled return false end update menu item Partie VIII Menu Suite Traduction trad applescript 23 2 2004 Neuvi me partie Panel Suite Cette partie d crit la terminologie de la suite Panel d AppleScript Studio La suite Panel d finit des classes des commandes et des Events pour n gocier avec les dialogues les alertes et les panels La plupart des classes de cette suite h ritent de la classe window page 76 soit directement soit par l interm diaire d une des classes des panels Un panel est un type sp cial d objet window pouvant tre facultativement affich comme un dialogue ou une fen tre utilitaire Pour plus d informations sur les termes utilis s dans la suite Panel voir Panels contre Dialogs et Windows page 21 Les classes commandes et Events de la suite Panel sont d crits dans les chapitres suivants RR RR LES 513 CAMAS NORA E E 5
84. poser de donn es dans AppleScript Studio Toutefois voir 476 le gestionnaire conclude drop page 481 pour plus d informations sur la fourniture du glisser d poser aux objets text view page 569 et text field page 325 Les classes et Events de la suite Drag and Drop sont d crits dans les chapitres suivants Classes o ATT Pel 1 2 nine aus re a ee ee 481 Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Traduction trad applescript 23 2 2004 Partie VIT Drag and Drop Suite Chapitre 1 Classes La suite Drag and Drop contient la classe suivante MERS LB 6 ee eS E ARE Re M m 477 drag info Pluriel drag infos H rite de item page 60 Classe Cocoa ASKDragInfo Repr sente les informations et les donn es de l op ration de glisser cou rante Un objet drag info est transmis chaque gestionnaire de glisser d poser d crit dans la section Events La propri t la plus utile de la classe Drag Info est la propri t paste board Elle contient les donn es pour le gliss desquelles votre application peut extraire des infos et les utiliser avec un gestionnaire drop page 486 ou autre Propri t s des objets de la classe Drag info En plus des propri t s qu il h rite de la classe item page 60 un objet drag info poss de ces propri t s destination window Acc s l
85. pour d couvrir si l l ment sp cifi est d velopp Le gestionnaire retournera true si l l ment est d velopp false dans le cas contraire Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet outline view dans ce cas ce gestionnaire n est pas utile ou appel Syntaxe item expandable reference obligatoire outline item item facultatif Param tres reference La r f rence de l objet outline view page 392 contenant l l ment Traduction trad applescript 23 2 2004 Partie V Data View Suite item expandable 433 outline item item page 60 L l ment pouvant tre d velopp R sultats boolean Retourne false si l l ment n est pas d velopp ou true s il l est Si vous impl mentez ce gestionnaire vous devrez obligatoirement retour ner une valeur bool enne Exemples Le gestionnaire Item Expandable suivant est extrait de l application Outline distribu e avec AppleScript Studio Cette application utilise un objet outline view page 392 pour afficher les l ments d un syst me de fichiers Ce gestionnaire e r gle la variable isExpandable sur false e si l l ment transmis est l l ment O repr sentant les noms des disques au plus haut niveau de l outline et s il y a plusieurs noms de disque dont l application garde la trace part dans la propri t diskNames il r gle isExpandable sur true e
86. pouvez utiliser ces instructions dans le script d une application AppleScript Studio bien que vous n aurez pas besoin de les ins rer dans un bloc tell application tell application TestApp set menultem to second menu item of main menu title of menultem result File set itemi to first menu item of sub menu of menultem title of itemi result New key equivalent of itemi result n end tell Pour un exemple montrant comment ajouter un script un objet menu item voir la section Exemples de la classe menu page 495 Traduction trad applescript 23 2 2004 Partie VIII Menu Suite menu item 503 Version La propri t key equivalent modifier de cette classe n est pas support e dans la version 1 3 d AppleScript Studio Partie VIII Menu Suite Traduction trad applescript 23 2 2004 Chapitre 2 Events Les objets bas s sur les classes de la suite Menu supportent les gestion naires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestionnaire appropri devant tre ex cut Pour d terminer les Events support s par une classe se r f rer sa description choose menu item s mapeada npa cri 505 update menu item 506 choose menu item Appel lorsqu un l ment de menu est choisi Syntaxe choose menu item reference obligatoire Param tre
87. rence de l objet table view page 403 ou outline view page 392 contenant la cellule row integer La ligne de la cellule modifier table column table column page 398 La colonne de la cellule modifier value item page 60 La nouvelle valeur Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Change Cell Value un objet table view page 403 ou outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestion naire vierge identique celui qui suit Votre gestionnaire devra r gler la cellule d sign e avec la valeur sp cifi e on change cell value theUbject value theValue row theRow table column tableColumn Traduction trad applescript 23 2 2004 Partie V Data View Suite change item value 427 Set the specified cell to the passed value end change cell value change item value Appel par un objet outline view page 392 pour modifier la valeur de l l ment de la ligne sp cifi e La mani re recommand e pour manipuler les donn es d un objet outline view est d utiliser un objet data source page 386 dans ce cas ce gestionnaire n est pas utile ou appel Syntaxe change item value reference obligatoire outline item item obligatoire table column table column obligatoire value item obligatoire Param tres reference La r f rence de l objet outline view page 392 contenant l l ment outline item item page 60
88. set contents of data cell city of theRow to contents of text field city set contents of data cell state of theRow to contents of text field state set contents of data cell zip of theRow to contents of text field zip end tell end getContactInfo L illustration 5 2 montre l application Table lanc e avec un contact Un autre gestionnaire de cette application est visible dans la section Exemples de la classe data column page 376 Pour obtenir des informations sur les data cell tant connu la data row contenant la cellule vous utiliserez une instruction comme celle ci dessous extraite du gestionnaire setContactInfo de la m me application Table Comme dans l exemple pr c dent cette instruction appara t l int rieur d un bloc tell sp cifiant la fen tre set contents of text field name Traduction trad applescript 23 2 2004 Partie V Data View Suite data cell 375 to contents of data cell name of theRow L application Task List disponible depuis la version 1 2 d Apple Script Studio contient un gestionnaire data representation page 465 mon trant comment acc der tous les objets data cell d un objet data source page 386 on data representation theObject of type ofType Set some local variables to various objects in the UI set theWindow to window 1 of theUbject set theDataSource to data source of table view tasks of scroll view tasks of theWindow set
89. set hasVertScroller to has vertical scroller of scroll view contacts of window of theUbject Version Le support des Events de glisser d poser est apparu avec la version 1 2 d AppleScript Studio split view Pluriel split views H rite de view page 229 Classe Cocoa NSSplitView Empile plusieurs sous views dans une seule view pour coordonner les modifications de leurs tailles relatives Les barres de partage entre les views peuvent tre horizontales ou ver ticales suivant si elles sont arrang es verticalement ou c te c te Dans l illustration 3 6 un objet outline view page 392 appara t au dessus d un objet table view page 403 Traduction trad applescript 23 2 2004 Partie III Container View Suite split view 219 Voir la classe scroll view page 213 pour plus d informations sur la mani re de mettre dans Interface Builder des objets dans les sous views d un split view ou d une autre view 600 Window V Color 0 R Red 1 G Green 0 Cupertino 1 San Jose 2 Santa Clara FIG 3 6 Un split view contenant un outline view et un table view Propri t s des objets de la classe Split View En plus des propri t s qu il h rite de view page 229 un objet split view poss de ces propri t s pane splitter Acc s lecture criture Classe boolean Y a t il un pane splitter voir la barre horizontale au milieu de l illustration 3 6 vertical Acc s lect
90. step forward page 342 stop page 343 Partie IV Control View Suite Traduction trad applescript 23 2 2004 300 Chapitre 1 Classes Events support s par les objets de la classe Movie View Un objet movie view supporte les gestionnaires r pondant aux Events suivants Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples Le gestionnaire will open page 165 suivant est extrait de l application Talking Head distribu e avec AppleScript Studio Le gestionnaire utilise Traduction trad applescript 23 2 2004 Partie IV Control View Suite popup button 301 simplement la commande load movie page 104 pour charger un film du pro jet lorsque la fen tre contenant l objet movie view est ouverte L image est stock e dans le groupe Resources du projet et elle est nomm e jumps mov on will open theObject set movie of movie view movie of window main to load movie jumps end will open Si vous chargez
91. suivant ces tapes e Glissez une instance de CustomView du panneau Cocoa Containers sur la fen tre vis e Cette view est par d faut un objet view de la classe NSView Pour modifier la classe en classe view personnalis e d finie par vous ou en un autre type de classe suivez ces tapes 1 S lectionnez la view personnalis e 2 Dans le panneau Custom Class de la fen tre Info s lectionnez le nouveau type de classe Propri t s des objets de la classe View En plus des propri t s qu il h rite de responder page 68 un objet view poss de ces propri t s auto resizes Acc s lecture criture Classe boolean Faut il que l objet view s auto redimensionne Partie III Container View Suite Traduction trad applescript 23 2 2004 230 Chapitre 1 Classes bounds Acc s lecture criture Classe bounding rectangle La position et la taille de la view l int rieur de sa super view les limites sont exprim es sous forme d une liste de quatre nombres gauche bas droite haut le rectangle limite est r gl partir de 0 0 dans le super view voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es bounds rotation Acc s lecture criture Classe real La rotation des limites en degr s par d faut elle vaut 0 0 des valeurs positives indiquent une rotation dans le sens des a
92. trad applescript 23 2 2004 Partie V Data View Suite data row data source Acc s lecture uniquement Classe data source page 386 L objet data source avec lequel est associ l objet data row l ments des objets de la classe Data Row Un objet data row peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 data cell page 372 sp cifier par Les formes cl s standards page 15 Les objets data cell de l objet data row chaque cellule stocke son nom son contenu et d autres informations data column page 376 sp cifier par Les formes cl s standards page 15 Les objets data column de l objet data row chaque colonne stocke son nom la data source et d autres informations Events support s par les objets de la classe Data Row Cette classe n est pas accessible dans AppleScript Studio par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples L instruction suivante montre comment cr er un objet data row Cette instruction est extraite du gestionnaire clicked page 348 de l application Table distribu e avec AppleScript Studio set theRow to make new data row at the end of the data rows of contactsDataSource Pour un exemple qui extrait le nom partir d un objet data cell dans une ligne cliqu e voir la section E
93. tre Info d Interface Builder table view Acc s lecture criture Classe table view page 403 L objet table view ou outline view cet objet h rite de table view contenant l objet table column width Acc s lecture criture Classe real La largeur de la colonne l ments des objets de la classe Table Column Un objet table column n a aucun l ment Events support s par les objets de la classe Table Column Un objet table column supporte les gestionnaires r pondant aux Events suivants Nib awake from nib page 123 Exemples Pour un exemple montrant comment acc der aux propri t s d un objet table column voir le gestionnaire column clicked page 430 de la section Exemples de la classe data source page 386 La section Exemples de la classe table view page 403 se concentre sur l utilisation des objets table view avec ou sans objet data source Version Depuis la version 1 2 d AppleScript Studio et la version d Interface Buil der livr e avec Mac OS X version 10 2 vous pouvez nommer les objets table Traduction trad applescript 23 2 2004 Partie V Data View Suite table header cell 401 column d un objet table view page 403 ou outline view page 392 en utilisant le champ Name du panneau AppleScript de la fen tre Info d Interface Builder Il n est plus n cessaire de saisir la valeur dans le champ Identifier du panneau Attributes
94. 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 Vous pouvez remplacer id par name dans le script ci dessus pour obte nir le nom AppleScript de chaque view qui a un nom d fini des fen tres ouvertes Pour un exemple utilisant item afin d acc der aux l ments d une liste voir l exemple de script de la section Discussion de la commande load image page 100 Les instructions suivantes montrent comment r cup rer un script modi fier une de ses propri t s et le mettre jour Traduction trad applescript 23 2 2004 Partie II Application Suite movie 63 obtention d une copie du script set buttonScript to script of button 1 of window 1 modification de la valeur de la propri t foo set foo of buttonScript to new value of foo mise jour du script avec le script modifi set script of button 1 of window 1 to buttonScript Note Pour obtenir une propri t script vous devrez explicitement utiliser get script Version La propri t script fut ajout e dans la version 1 3 d AppleScript Studio movie Pluriel movies H rite de item page 60 Classe Cocoa NSMovie Fournit une interface simple pour le chargement en m moire des films QuickTime Vous ne scripterez g n ralement pas un objet movie lui m me Au lieu de cela vous travaillerez avec la classe movie view page 296 Les objets comme application page 29 et movie view page 29
95. 2 6 les sons disponibles peuvent diff rer suivant les syst mes vous pouvez ajouter des sons un projet dans Xcode ou Interface Builder mais ils ne seront pas ajout s aux l ments de l application tant que vous ne les aurez pas charg s avec la com mande load sound page 107 window page 76 Sp cifier par Les formes cl s standards page 15 Les fen tres de l application Commandes support es par les objets de la classe Application Votre script peut envoyer les commandes suivantes un objet applica tion display dialog page 543 path for page 112 quit de la Core Suite Cocoa Events support s par les objets de la classe Application Un objet application supporte les gestionnaires r pondant aux Events suivants Notez toutefois que les Events Clavier et Souris peuvent tre g r s par d autres objets et cette multi gestion peut provoquer des probl mes de communication entre ces gestionnaires et l objet application certains appels restant parfois sans r ponse Application activated page 123 idle page 132 launched page 135 open de la Core Suite Cocoa open untitled page 143 resigned active page 145 should open untitled page 153 should quit page 154 should quit after last window closed page 155 Partie II Application Suite Traduction trad applescript 23 2 2004 36 Chapitre 1 Classes shown page 157 was hidden page 159 will become active pa
96. 29 est sur le point de finir son lancement Le gestionnaire ne peut pas annuler le lancement mais peut le pr parer L application lors de sa phase de lancement appelle certains gestion naires s ils sont pr sents en respectant un ordre de priorit Le gestionnaire Partie II Application Suite Traduction trad applescript 23 2 2004 162 Chapitre 3 Events Will Finish Launching fait partie de ces gestionnaires la liste est disponible dans la description du gestionnaire awake from nib page 123 Syntaxe will finish launching reference obligatoire Param tres reference La r f rence de l objet application page 29 qui va finir son lancement Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Fi nish Launching un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration une fois que le fichier nib principal ait t charg mais avant la fin du d marrage de l application Par exemple le script suivant rend visible la fen tre du fichier nib principal on will finish launching theUbject Perform operations here before completion of launching set visible of window of theObject to true end will finish launching Vous pourriez aussi utiliser le gestionnaire Will Finish Launching pour v rifier la pr sence de la version minimale du r
97. 308 informational constante 175 integer value propri t 268 282 intercell spacing propri t 276 292 409 item l ment 34 classe 60 item expandable event 432 598 Index item for commande 420 item height propri t 276 item value EVEN rs ss samir 434 J justified text alignment constante 189 K key propri t 81 key cell propri t 292 key code propri t 52 key down type constante 182 key equivalent propri t 256 268 500 key equivalent modifier propri t 256 262 500 key up type CONSTANTE ereenn ardt 182 key window propri t 32 keyboard down EVENT same dead 133 keyboard up event 134 knob thickness propri t 317 L label propri t 227 last column Propri t 366 last visible column Propri t 366 launched A1 S ci 135 leading offset Propri t 208 leaf Propri t 371 left alignment constante 183 left edge constante 186 left mouse down type constante 182 left mouse dragged type constante 182 left mouse up type
98. 84 232 visible document rect propri t 203 216 visible rect propri t 232 volume propri t 299 W warning constante 173 was hidden propri t will become active will display browser cell LS LT will display cell event will display item cell event will display outline cell event will finish launching event will hide will open event will pop up EVERT ae esse eus este will quit event will resign active event will resize Index 609 will select tab view item event 248 will show event 169 will zoom OVEMG ariba 169 window l ment 35 462 classe 76 propri t 53 233 windows menu Propri t 33 wraps Propri t 270 write to file EVENT OR E ee bo ee 470 Z zoomed event 171
99. Acc s lecture criture Classe integer Le niveau de la fen tre Par d faut cette propri t vaut 0 pour plus d informations voir la section Discussion de cette classe main Acc s lecture criture Classe boolean La fen tre est elle la fen tre principale La fen tre principale est le lieu d action de l activit de l utilisateur une fen tre est souvent la fois cl et principale mais n a pas forc ment besoin de l tre par exemple une fen tre d un document dans un traitement de texte peut tre la fen tre principale et la fen tre cl mais lorsque l utilisateur ouvrira le dialogue de recherche Cmd F ce dialogue deviendra la fen tre cl apr s que l utilisateur ait saisi le texte et r ussi la recherche la fen tre Partie II Application Suite Traduction trad applescript 23 2 2004 82 Chapitre 1 Classes du document sera de nouveau la fen tre cl et la fen tre principale comparez avec la propri t key maximum size Acc s lecture criture Classe point La taille maximale de la fen tre est repr sent e par une liste de deux nombres largeur maximale hauteur maximale avant la version 1 2 1 d AppleScript Studio vous ne pouviez pas utiliser cette propri t dans un script miniaturized Acc s lecture criture Classe boolean Non support e dans la version 1 3 d AppleScript Studio la fen tre est elle miniaturis e syn
100. B Ubu Mu du Nha de hn 520 Operepa el ooo sa aee a a a paire 522 panels i sus y dae Ok A SG ee ae A au ae 526 SANB DANEL av 2 4 4 a de OR de dus RE HAS ER es a de 529 2 Commandes 535 Close panel 2 24225 uca 44 SR PERE SR ES m hide 535 Us a ater fee a a Re ten dr Be ee ae hw a 537 display alertes s ee Liu A A ER H 6 340 8 Se 540 display AMG 4 he M lar e Re Ree Qa er ERE OG te 543 display Panel ca aus La due Cade we aa aa 547 load panel anc a ac mu as a Rumba san s but 548 3 Events 551 alert ended kok ee na Geb Us DE Aa ie a Me NE pt ie 551 dialog ended 2 244 484 kee ee 4 ee TE Hire 552 Table des Mati res XIII panel ended 2 4 482 54585 20S d R D A E B Yi we ua X Plugin Suite 1 Classes 2 Events plugin loaded cocos 65 84554 be RPS ARE a ee XI Text View Suite 1 Classes TEXT co a eA ewe bE we OR D OE ew ae text VIEW oo mo Re ee eR we XII Annexes A Les applications distribu es avec AppleScript Studio Archive Maker a a aw ao sa aa pet PA Raa a Uiit Converter s cee LUE LA A R e 186 Table SOC 4 ecr ca Du gens Bonn gra nee ge Gt at 4 ee Save Panel 2 a de sap moi wee dle Lau num a Index 555 559 559 561 561 565 569 569 569 579 581 582 583 584 586 589 Liste des illustrations 2 1 L instance File s Owner repr sentant l objet application dans Interface Builder
101. Builder L illustration 5 1 montre un objet browser affichant les fichiers du disque dur Pour plus d informations voir browser cell page 370 et update page 119 ainsi que Browsers dans la documentation Cocoa Note Contrairement aux autres data views comme outline view page 392 et table view page 403 vous ne pourrez pas alimenter un objet browser avec un objet data source page 386 En cons quence de quoi les performances pourront tre insuffisantes pour des objets browser affichant plus qu un petit nombre d l ments aussi vous devrez pr f rer l utilisation d une des deux autres data views bien sur si cela est compatible avec vos imp ratifs 000 Browser Macintosh HD gt Applications Library Network Developer Library Documents iDisk Library System Folder Temporary Items Users FIG 5 1 Un browser view affichant une partie du syst me de fichiers Propri t s des objets de la classe Browser En plus des propri t s qu il h rite de la classe control page 280 un objet browser poss de ces propri t s accepts arrow keys Acc s lecture criture Classe boolean L objet browser accepte t il la saisie avec les fl ches de direction Par d faut cette propri t vaut false vous pouvez la r gler dans Traduction trad applescript 23 2 2004 Partie V Data View Suite browser 365 la fen tre Info d Interface Builder allows branch selection Acc s lecture c
102. C call method commande 94 can choose directories propri t 523 can choose files propri t 523 can draw propri t 230 can hide propri t 79 case insensitive constante 187 case sensitive constante 187 cell l ment 294 368 classe 264 propri t 280 cell background color propri t 291 cell image position num ration 177 cell prototype propri t 365 cell size propri t 265 291 cell state value num ration 178 cell type num ration 179 propri t 266 cell value event 424 center commande 98 center alignment constante 183 592 Index center text alignment constante 189 change cell value EVENT See cree 426 change item value VE dida 427 changed EVENT nica lia sad 348 characters propri t 50 child of item EVENT eu cree 428 choose menu item event 505 circular bezel constante 175 clear tint constante 180 click count Propri t 51 clicked event 348 clicked column propri t 406 clic
103. Ended voir la section Exemples de la commande dialog reply page 518 panel ended Appel apr s qu un panel ait fini si ce panel a t affich comme tant attach une fen tre Lorsque vous affichez un panel en tant qu application modale votre script devra attendre que l utilisateur ait renvoy le panel Si vous l affi chez en tant que document modal en sp cifiant le param tre attached to l ex cution du script continue Vous devrez fournir un gestionnaire Panel Ended afin de pouvoir ex cuter toute action lorsque l utilisateur renverra le panel Le gestionnaire Panel Ended est appel dans le script qui est connect la fen tre laquelle est connect l objet open panel page 522 ou save panel page 529 Par exemple si vos gestionnaires d Events g rant les fen tres sont connect s dans un script nomm Window applescript et que votre script affiche un panel avec une instruction comme celle qui suit display open panel attached to window main alors le gestionnaire Panel Ended de vra aussi tre connect Window applescript Ce gestionnaire sera appel lorsque le panel sera renvoy Syntaxe panel ended reference obligatoire with result n importe facultatif Param tres reference La r f rence du panel pour lequel le gestionnaire est appel Partie IX Panel Suite Traduction trad applescript 23 2 2004 554 Chapitre 3 Events with result n importe Le r sultat r
104. PAUSE LE KW we ee A ANS al c R HR A oe Tu Periorm SCHON sora sa be Se eee a Hop ee PIAY co che wee eee Beh Reba Rae he RGAE RES a ie 4 4 did NE tits ee eR ce a M ee RI e D Mae ae at ci ee a Ts ae h eae Step DAC cos di oe eA ee SG A we Se a a Step TOU WAT eb eke sata A ee ee AY ee ae eed A Se Be te Se ads Ge ee SE dn se ee ae ad synchronize o o suis Bae Se a eR eG ee ee de 3 Events Beri editing osas ae PR N s RS ae 2 Changed o 403 ka doe Pe aus sons RRR ee eS ee and A ch bot EN Ge Re ASS REG DAES Behe ow Ge et double clear PB eee ht ah Bah ae ee a de Ca oh OHO COM e aa LE ge Bee eRe LAURE Bae EPA a selection changed oeoc e 4 4 bea de bbe dana tek te due ot selection Change 2 2 ee 0 26 due dl HE amp Rd ia he should begin editing e crsa amasi ia REY A ken da should end editing 0 0 0 0 0 0 0 0 0 0 0 0 LI S 540 lt ua dr eee A ee BA ee a ee E 314 315 320 325 330 333 333 334 339 336 337 337 338 339 339 340 341 342 343 343 Table des Mati res Will POP Up so 4 6k eke HA ne D B N A eS bug 356 Data View Suite 359 Classes 363 DIOWSED ce con Gok Behe da sk ae Se eee bE AS 363 Browser pell 25 wk ai ee EL a ae a 370 data cell v osos Ba a Sa mie SG EOE we Pe oe ae bal 372 dala Colums ewe Be eh a ae he ee Pe R S 376 a UG a kh NL Ee E a a a a 379 CAVA TON ce eoi Ba a oe BG EO RE DE 4e ee ee 384 daba SOTO o os ewe De eh BU ek ae Les ee D
105. Par d faut ce sera un objet view page 229 de la classe NSView 4 Dans le panneau Custom Class de la fen tre Info s lectionnez le type de classe d sir Pour des informations de m me nature voir Drawing and Views dans la documentation Cocoa Propri t s des objets de la classe Scroll View En plus des propri t s qu il h rite de view page 229 un objet scroll view poss de ces propri t s Partie III Container View Suite Traduction trad applescript 23 2 2004 214 Chapitre 1 Classes background color Acc s lecture criture Classe RGB color La couleur du fond une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur bleue peut tre repr sent e par 0 0 65535 par d faut la couleur est r gl e sur la couleur blanche 65535 65535 65535 border type Acc s lecture criture Classe une des constantes de border type page 175 Le type de contour du scroll view content size Acc s lecture uniquement Classe point La taille de la view du scroll view la taille est exprim e sous forme d une liste de deux nombres entiers horizontal vertical par exemple 200 100 indiquerait une largeur de 200 et une hauteur de 100 voir la propri t bounds de la classe window page 76 pour plus d infor mations sur le syst me des coordonn es content view Acc s lecture criture Classe view page
106. Syntaxe load data representation reference obligatoire of type Unicode text obligatoire with data item obligatoire Partie VI Document Suite Traduction trad applescript 23 2 2004 468 Chapitre 2 Events Param tres reference La r f rence de l objet dont le gestionnaire Load Data Representation est appel of type Unicode text Le type extension du fichier document with data item page 60 Les donn es charger depuis le document Exemples L application Task List distribu e depuis la version 1 2 d AppleScript Studio fournit le gestionnaire suivant pour montrer le m canisme de haut niveau permettant la lecture des donn es des fichiers Le param tre theData r f rence l objet de m me type que celui qui fut enregistr par le gestionnaire data representation page 465 c est dire un enregistrement contenant la liste des t ches le nom de la colonne courante et l ordre de tri de cette colonne Ce gestionnaire extrait ces informations et les ins re dans l objet data source page 386 de l objet table view page 403 affichant la liste des t ches on load data representation theUbject of type ofType with data theData Set up local variables set theWindow to window 1 of theObject set theDataSource to data source of table view tasks of scroll view tasks of theWindow Restore the sort column and sort order of the data source based on the information saved set sort column
107. acc der par l interm diaire de la commande Call Method En fait votre application peut acc der aux langages C C Objective C Objective C et Java soit directement soit par l interm diaire du Java Bridge de Mac OS X comme le montre Vapplication Multi Language distribu e avec AppleScript Studio dans certains cas les caract ristiques pourront tre disponibles dans une future version d AppleScript Studio Traduction trad applescript 23 2 2004 Partie I Introduction Les sources de la terminologie d AppleScript Studio 11 Les sources de la terminologie d AppleScript Studio AppleScript Studio permet d crire des scripts qui contr lent plusieurs applications y compris des composants de Mac OS lui m me Plusieurs outils existent pour l criture des scripts comme l application Editeur de Scripts distribu e avec Mac OS ou d autres produits de tierce partie comme Smile La puissance des scripts vient d abord de la terminologie de scripting fournie par les applications et le systeme Mac OS pas du petit nombre de termes qui sont propres au langage AppleScript Pour tirer le meilleur parti des capacit s disponibles vous devez savoir quelle terminolo gie employ e dans vos scripts Les scripts des applications AppleScript Studio ont acc s la termino logie de base accessible par tous les scripts comprenant e la terminologie fournie par le langage AppleScript e la terminologie des c
108. allows multiple selection Acc s lecture criture Classe boolean Faut il que l objet table view autorise la s lection multiple Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder auto resizes all columns to fit Acc s lecture criture Classe boolean Faut il que les colonnes soient automatiquement redimensionn es au mieux Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder auto save name Acc s lecture criture Classe Unicode text Le nom utilis pour l enregistrement automatique des informations sur les colonnes du tableau voir la propri t auto save table columns par d faut il n y a pas de nom vous pouvez r gler cette propri t Partie V Data View Suite Traduction trad applescript 23 2 2004 406 Chapitre 1 Classes dans la fen tre Info d Interface Builder auto save table columns Acc s lecture criture Classe boolean Non support e dans la version 1 3 d AppleScript Studio l ordre et la largeur des objets table column doivent ils tre automatiquement enre gistr s Par d faut cette propri t vaut false lorsque vous fournissez un nom a la propri t auto save name dans la fen tre Info d Interface Builder cette propri t est automatiquement r gl e sur true background color Acc s lecture criture Classe RGB
109. au format string dont les valeurs ont t r gl es avant l appel encadr es par des accolades myFilenameString myDocTypeString Traduction trad applescript 23 2 2004 Partie II Application Suite call method 97 call method readFromFile ofType of document 1 of window 1 with parameters myFilenameString myDocTypeString L exemple suivant appelle la m thode performClick d un objet button page 254 transmettant comme param tre un autre objet button encadr entre parenth ses car il s agit d une r f rence multi termes call method performClick of button 1 of window 1 with parameter button 2 of window 2 Si votre application doit tourner avec des versions d AppleScript Stu dio ant rieures la 1 2 vous devrez utiliser le param tre of object Voici comment vous feriez avec l exemple pr c dent call method performClick of object button 1 of window 1 with parameter button 2 of window 2 L exemple suivant appelle une des m thodes de la classe NSNumber pour obtenir en retour un objet number initialis avec une valeur integer Il trans met une valeur simple le nombre 10 comme unique param tre Dans cet exemple le param tre est pr cis et ne requiert pas par cons quent de pa renth ses set theResult to call method numberWithInt of class NSNumber with parameter 10 Pour appeler la m thode de la classe NSView void setFrame NSRect frameRect vous utilisere
110. aussi ex cuter cette op ration avec une seule instruction set movie of movie view movies of window homeMovies to load movie bdayparty4 Si le film ne fait pas partie de votre projet vous pouvez le charger en sp cifiant son chemin POSIX Par exemple si bdayparty4 mov est stock sur le disque dans User Me Movies vous pouvez charger ce film avec l ins truction suivante set movie of movie view movies of window homeMovies to load movie User Me Movies bdayparty4 mov Version Dans la version 1 0 d AppleScript Studio la commande Load Movie ne chargeait pas les films externes au projet Xcode Maintenant depuis la ver sion 1 1 d AppleScript Studio cette limitation est d pass e et la commande Load Movie chargera n importe quel film pourvu que l on fournisse son che min POSIX Partie II Application Suite Traduction trad applescript 23 2 2004 106 Chapitre 2 Commandes load nib Charge le fichier nib sp cifi ou le fichier ressource d interface Depuis la version 1 1 d AppleScript Studio vous devez utiliser la com mande Load Nib la place de la commande load panel page 548 pour charger un panel comme dans la section Exemples ci dessous Vous cr erez des fichiers nib dans Interface Builder Pour plus d infor mations sur les fichiers nib voir awake from nib page 123 Syntaxe load nib string obligatoire Param tres string Sp cifie le fichier nib de
111. avec le format Unicode Voir la section Exemples de localized string page 109 pour savoir comment sp cifier le format UTF 8 dans votre projet d application Traduction trad applescript 23 2 2004 Partie I Introduction Un mot sur Unicode Text 23 Constante N Description NSNoScriptError 0 Aucune erreur NSReceiverEvaluationScriptError 1 L objet ou les objets sp cifi s une commande par le param tre direct pourraient ne pas tre trouv s NSKeySpecifierEvaluationScriptError 2 L objet ou les objets sp cifi s par une r f rence pourraient ne pas tre trouv s NSArgumentEvaluationScriptError 3 L objet sp cifi une commande par un argument pourrait ne pas tre trouv NSReceiversCantHandleCommandScriptError 4 L objet ne supporte pas la commande qui lui a t envoy e NSRequiredArgumentsMissingScriptError 5 Un ou plusieurs arguments requis sont manquants NSArgumentsWrongScriptError 6 Un argument ou plusieurs est du mau vais type ou sinon invalide NSUnknownKeyScriptError 7 Une erreur non identifi e est survenue indique une erreur dans le support du scripting d une application scriptable ou d AppleScript Studio ou Cocoa lui m me NSInternalScriptError 8 Une erreur non identifi e est survenue indique une erreur dans le support du scripting d une application scriptable ou d AppleSc
112. chaque l ment de menu d un menu comme Nouveau ou Ouvrir il y a un objet menu item page 499 Les illustrations 8 1 et 8 2 montrent galement les menus par d faut d une application AppleScript Studio lorsque vous cr ez le projet en choisissant soit le mod le AppleScript soit le mod le AppleScript Document based Application dans Xcode Les menus sont montr s dans une fen tre Nib d Interface Builder avec le menu File ouvert Vous pouvez ajouter un menu dans Interface Builder en glissant un l ment Submenu du panneau Cocoa Menus sur le menu principal Vous pouvez r gler les divers attributs des menus dans la fen tre Info d Interface Builder 496 Chapitre 1 Classes O MainMenu nib MainMenu y Application Edit Window Help New SEN p Open 0 Open Recent gt Close Ww Save eS Save As 43S Revert popup button page 301 Exemples de cette classe auto enables items Acc s lecture criture Classe boolean Page Setup 238P Print 38 P up Lists dans la documentation Cocoa Propri t s des objets de la classe Menu Un objet menu poss de ces propri t s Fic 8 1 Le menu File de la fen tre Nib d Interface Builder Il est possible de modifier dynamiquement un menu en ajoutant ou en supprimant des l ments Vous pouvez aussi dynamiquement peupler le menu d un menu d roulant comme dans la section Exemple
113. code du gestionnaire launched on launched theObject Create the data source this places it in the application object s data source elements Assign it to outline view below set dataSource to make new data source at end of data sources with properties name tasks Create the data columns tell dataSource make new data column at with properties name make new data column at with properties name end tell end of data columns task end of data columns completed Create the top level parent data item Things to do set parentltem to make new data item at end of data items of dataSource set contents of data cell set contents of data cell task of parentItem to Things to do completed of parentItem to Create the first child data item Work on outline example which will have its own children set childItem to make new data item at end of data items of parentItem set contents of data cell task of childltem to Work on outline example set contents of data cell completed of childltem to Yes Create first child data item of Work on outline example Traduction trad applescript 23 2 2004 Partie V Data View Suite data item 383 set childChildItem to make new data item at end of data items of childItem set contents of data cell task of childChildItem to Make it plain and simple set contents of data cell completed of childChild
114. color Acc s lecture criture Classe RGB color La couleur du fond du clip view une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur bleue peut tre repr sent e par 0 0 65535 par d faut la liste est gale 65535 65535 65535 ou la couleur blanche content view Acc s lecture criture Classe view page 229 Le contenu visuel du clip view lequel contient toutes ses sous views pour des informations de m me nature voir la propri t content view de la classe window page 76 copies on scroll Acc s lecture criture Classe boolean Faut il que le contenu de la view soit copi lorsqu il est d roul Traduction trad applescript 23 2 2004 Partie III Container View Suite clip view 203 document rect Acc s lecture uniquement Classe bounding rectangle Les limites du document view dans le clip view une liste de quatre nombres gauche bas droite haut r gl es dans le syst me des co ordonn es du clip view voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es document view Acc s lecture criture Classe view page 229 Le subview principal du clip view par exemple un objet table view page 403 ou text view page 569 draws background Acc s lecture criture Classe boolean Faut il que l objet clip view dess
115. comme un nombre entier Vous pouvez aussi transmettre une liste simple laquelle peut contenir plusieurs l ments mais uni quement si la m thode appel e accepte un param tre unique contenant plusieurs valeurs comme un tableau array ou un dictionnaire dic tionary Array et Dictionary sont des types Cocoa bas s sur les classes NSArray et NSDictionary with parameters list Sp cifie une liste de param tres devant tre transmise la m thode ap pel e Indiqu pour les m thodes ayant plus qu un param tre bien que vous puissiez aussi l utiliser pour une m thode avec param tre unique Vous sp cifierez une liste avec un l ment pour chaque param tre de la m thode sp cifi e Un l ment de la liste peut tre galement une liste si la m thode appel e accepte un param tre unique contenant plusieurs valeurs dans cette position Vous wutiliserez jamais ensemble with parameter et with parameters Si vous ne sp cifiez aucun des deux il est suppos que la m thode n a pas de param tre Vous devez utiliser le param tre with parameters pour transmettre une valeur bool enne m me si c est un param tre unique Vous trans mettrez la valeur bool enne sous forme d une liste l ment unique Par exemple pour r gler la propri t scrollable d un objet matrix page 289 vous pourriez utiliser cette instruction Partie II Application Suite Traduction trad applescript 23 2 2004
116. continuellement des films et que vous ne les lib rez pas la m moire utilis e par votre application va augmenter Pour des informations sur la mani re de lib rer des objets image page 58 movie page 63 ou sound page 70 voir la section Discussion de la commande load image page 100 Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio popup button Pluriel popup buttons H rite de button page 254 Classe Cocoa NSPopUpButton Fournit l acc s un menu d roulant dans lequel un utilisateur peut choi sir un l ment L illustration 4 8 montre un bouton popup affichant le premier l ment de ce menu Vous trouverez l objet popup button dans le panneau Cocoa Controls d Interface Builder Vous pouvez r gler les attributs des boutons popups dans la fen tre Info d Interface Builder Pour des informations de m me nature voir Application Menus and Pop up Lists dans la documentation Cocoa Propri t s des objets de la classe Popup Button En plus des propri t s qu il h rite de la classe button page 254 un objet popup button poss de ces propri t s Partie IV Control View Suite Traduction trad applescript 23 2 2004 302 Chapitre 1 Classes A O A Window Item HH LZ FIG 4 8 Un bouton popup auto enables items Acc s lecture criture Classe boolean Faut il que les l ments du menu soit automatiquem
117. cution du gestionnaire clicked du bouton Drawer de l application Drawer distribu e avec AppleScript Studio ce Partie IV Control View Suite Traduction trad applescript 23 2 2004 338 Chapitre 2 Commandes gestionnaire soit ouvrira le tiroir soit le fermera en fonction de son tat courant Ces m mes instructions fonctionneront dans le script d une appli cation AppleScript Studio bien que vous n aurez pas besoin de les encadrer par un bloc Tell tell application Drawer set theButton to button Drawer of window main tell theButton to perform action end tell Discussion La commande Perform Action g n ralement ne fait rien tant que l ob jet sp cifi n a pas de gestionnaire Action un gestionnaire comme clicked page 348 ou double clicked page 349 dans le groupe Action de la fen tre Info de l objet dans Interface Builder Vous pouvez toutefois utiliser la com mande Perform Action avec les l ments de menu en utilisant une syntaxe telle que celle ci tell menu item 1 of menu 1 of main menu to perform action play Joue l objet La commande Play est support e par la classe movie view page 296 Syntaxe play reference obligatoire Param tres reference La r f rence du film jouer Exemples Vous pouvez indiquer un objet movie view page 296 de jouer avec les instructions suivantes tell window main Traduction trad applescript 2
118. d un script d une application Apple Script Studio bien que vous n aurez pas besoin du bloc tell application tell application Drag Race title of menu items of main menu r sultat File Edit Window Help end tell Ce script peut galement tre plus pr cis pour obtenir des informations sur les l ments de menu du menu principal Par exemple la ligne suivante si elle tait ins r e dans le bloc Tell pr c dent obtiendrait le titre d un l ment de menu du menu Fichier title of menu item 10 of sub menu of menu item 2 of main menu r sultat Mise en page Il peut tre plus facile d utiliser l application diteur de Scripts ou une application de tierce partie pour d terminer la syntaxe correcte identi fiant les objets d une application AppleScript Studio comme montr ici sp cialement lorsque vous n avez pas donn de noms AppleScript ces ob jets dans Interface Builder Maintenant supposons que les l ments de menu ont bien t nomm s alors vous pourrez utiliser une instruction telle que celle ci title of menu item page setup of sub menu item file of main menu Version Les propri t s suivantes furent ajout es l objet application dans la version 1 1 d AppleScript Studio color panel font panel open panel save panel user defaults Les l ments suivants furent ajout s l objet application dans la ver sion 1 1 d AppleScript Studio data
119. d terminer les colonnes s lectionn es selected data column Acc s lecture criture Classe data column page 376 L objet data column qui est s lectionn il n y aura aucun objet data column s lectionn tant que la propri t allows multiple selection vau dra true retourne rien si aucun objet data column n est s lectionn aussi vous devrez acc der cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 selected data columns Acc s lecture criture Classe list Les objets data column qui sont s lectionn s retourne une liste vide si aucun objet data column n est s lectionn si la propri t allows mul Partie V Data View Suite Traduction trad applescript 23 2 2004 410 Chapitre 1 Classes tiple selection vaut false la liste retourn e contiendra au maximum un seul objet data column selected data row Acc s lecture criture Classe data row page 384 L objet data row qui est s lectionn si la propri t allows multiple selection vaut false vous pouvez utiliser cette propri t pour obtenir l objet data row s lectionn autrement utilisez la propri t selected data rows retourne rien si aucun objet data row n est s lectionn aussi vous devrez acc der cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir l
120. data cell page 372 sp cifier par Les formes cl s standards page 15 Les objets data cell de la colonne un par ligne par d faut il n y a qu un seul objet data cell pour chaque objet data column dans un objet data row Partie V Data View Suite Traduction trad applescript 23 2 2004 378 Chapitre 1 Classes data row page 384 sp cifier par Les formes cl s standards page 15 Les objets data row de la colonne Events support s par les objets de la classe Data Column Cette classe n est pas accessible dans AppleScript Studio par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire will open page 165 suivant extrait de l application Table distribu e avec AppleScript Studio montre comment cr er et nom mer les objets data column d un objet data source page 386 Ce gestion naire fait ce qui suit e Obtient la r f rence de la data source partir du param tre theObject transmis au gestionnaire La data source est une propri t de l objet table view page 403 r sidant sur l objet scroll view page 213 de la fen tre e Il indique l objet data source de cr er 5 nouvelles colonnes cha cune avec le nom diff rent d un champ de donn es d un contact nom adresse ville etc on will open theObject Set up reference variable to simplify later statements set contactsDataSource to data s
121. de contour Les objets comme box page 197 et scroll view page 213 poss dent des propri t s de contour Border Type peut interagir avec box type page 176 Partie II Application Suite Traduction trad applescript 23 2 2004 176 Chapitre 4 num rations Constantes bezel border Contour collerette groove border Contour rainur lorsqu elle est combin e avec la valeur separator type de box type page 176 on obtient une ligne de s paration line border Contour ligne d pendante de box type page 176 produit des contours facettes no border Sans contour box type Sp cifie le mod le de bo te La propri t box type d un objet box page 197 sera r gl e avec l une des valeurs list es ci dessous Le mod le de bo te choisi peut interagir avec border type page 175 Vous pourrez trouver des illustrations des diff rents mod les de bo tes y compris des groups boxes dans le guide Aqua Hu man Interface Guidelines disponible dans l aide de Xcode Constantes old style type Vieux mod le de bo te si la propri t border type est r gl e sur bezel border ombr e avec une bordure en haut et gauche si la propri t border type est r gl e sur line border claire avec une bordure de chaque c t primary type Mod le primaire terminologie d un mod le de group box d crit dans une ancienne guideline la guideline de l interface Aqua d sapp
122. de d finir des fichiers nibs suppl mentaires et de les utiliser pour cr er une ou plusieurs instances win dow Vous trouverez plusieurs objets window pr d finis pour des fen tres des panneaux et des tiroirs dans le panneau Cocoa Windows d Interface Traduction trad applescript 23 2 2004 Partie II Application Suite window 77 Groups amp Files Hello World v Scripts Hello World apple y Resources gt ia MainMenu nib gt E InfoPlist strings AppleScriptKit asc vi J Other Sources M main m V Frameworks J Linked Framework gt 3 Other Framework b 3 Products gt Targets b lt Executables gt Errors and Warnings a Implementation Files a NIB Files gt Q Find Results Project Symbols FIG 2 8 La liste des fichiers du panneau Groups amp Files dans un projet AppleScript Application Builder comme dans l illustration 3 3 Dans la fen tre Info d Interface Builder vous pouvez r gler la plupart des attributs des fen tres comme les mod les de boutons qu il contient Mi niaturize Close et Resize ses propri t s de taille et de redimensionnement et si elle doit tre visible au lancement Par exemple pour faire une fen tre flottante ou fen tre utilitaire vous utiliserez instance window nomm e Panel dans l illustration 3 3 puis ouvrirez le panneau Attributes de la fen tre Info et cocherez la case Utility window Dans la version d
123. des constantes de bezel style page 175 L apparence du contour d un bouton bordered Acc s lecture criture Classe boolean Le bouton a t il une bordure button type Acc s lecture criture Classe une des constantes de button type page 177 Le type de bouton image Acc s lecture criture Classe image page 58 L image du bouton voir la section Discussion image position Acc s lecture criture Classe une des constantes de cell image position page 177 La position de l image dans le bouton sous forme d une liste de deux nombres gauche bas chaque objet window page 76 ou view page 229 a son propre syst me de coordonn es avec l origine dans le coin inf rieur gauche voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es key equivalent Acc s lecture criture Classe Unicode text Le raccourci clavier quivalent au clic sur le bouton par exemple le raccourci clavier pourrait tre la lettre U ou la combinaison Cmd U vous pouvez r gler cette propri t dans le panneau Attributes de la fen tre Info d Interface Builder o par exemple vous pouvez r gler un bouton pour tre le bouton par d faut en choisissant Return pour le champ Equiv dans le menu d roulant lt no key gt le bouton par d faut pulse automatiquement et prend la couleur par d faut key equiva
124. des constantes de control size page 180 La taille des onglets par d faut cette propri t vaut regular size vous pouvez la r gler dans Interface Builder avec la case cocher Small Tabs du panneau Attributes de la fen tre Info control tint Acc s lecture criture Classe une des constantes de control tint page 180 La teinte des onglets par d faut elle vaut default tint current tab view item Acc s lecture criture Classe tab view item page 227 Le tab view item courant draws background Acc s lecture criture Classe boolean Faut il que l objet tab view dessine son fond Par d faut cette pro pri t vaut true voir la description plus haut pour plus d informations pour savoir quel moment vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder tab type Acc s lecture criture Classe une des constantes de tab view type page 188 Le type d onglet comme un onglet en haut d un tab view page 221 vous pouvez r gler la direction des onglets haut bas gauche ou droite dans Interface Builder bien que les directions bas gauche et droite ne fonctionnent que depuis la version de Cocoa livr e avec Mac OS X version 10 2 truncated labels Acc s lecture criture Classe boolean Faut il si n cessaire tronquer les tiquettes Vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder Partie
125. e GR 673411 o ee a oO BAR EN RE Lin open drawer UNLOCK focus c 4 qu du dues close drawer Ferme le drawer sp cifi Syntaxe close drawer reference obligatoire Param tres reference La r f rence de l objet drawer page 204 fermer 240 Chapitre 2 Commandes Exemples Avec une fen tre portant le nom AppleScript main contenant un tiroir nomm drawer vous pouvez fermer ce tiroir avec une instruction tell comme celle qui suit tell window main tell drawer drawer to close end tell lock focus Non support e par la version 1 3 d AppleScript Studio Verrouille la mise au point d une view pour la pr parer son redessinement Syntaxe lock focus reference obligatoire Param tres reference La r f rence de l objet view page 229 pour lequel la mise au point va tre verrouill e open drawer Ouvre le tiroir sp cifi Syntaxe open drawer reference obligatoire on une constante facultatif Param tres reference La r f rence de l objet drawer page 204 ouvrir on une des constantes de rectangle edge page 186 Le c t de la fen tre au niveau duquel devra s ouvrir le tiroir Traduction trad applescript 23 2 2004 Partie III Container View Suite unlock focus 241 Exemples Avec une fen tre portant le nom AppleScript main contenant un objet drawer page 204 nomm
126. e dans la version 1 3 d AppleScript Studio la data source de l objet combo box vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder bien que la meilleure fa on soit de la r gler dans un script comme le montrent les sections Exemples de la com mande append page 417 et de la classe data item page 379 Partie IV Control View Suite Traduction trad applescript 23 2 2004 276 Chapitre 1 Classes has vertical scroller Acc s lecture criture Classe boolean Le combo box a t il un ascenseur vertical Par d faut cette propri t vaut true se r gle avec Scrollable dans la fen tre Info d Interface Builder intercell spacing Acc s lecture criture Classe list L espace horizontal et vertical entre les cellules de la liste du combo box exprim e sous forme d une liste de deux nombres par d faut cette propri t vaut 3 2 item height Acc s lecture criture Classe real La hauteur d un l ment uses data source Acc s lecture criture Classe boolean Non support e dans la version 1 3 d AppleScript Studio le combo box utilise t il une data source pour ces l ments Vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder l ments des objets de la classe Combo Box En plus des l ments qu il h rite de la classe text field page 325 un objet combo box peut contenir les l ments
127. et la taille de la fen tre les coordonn es sont repr sent es par une liste de quatre nombres gauche bas droite haut par exemple 0 0 500 250 indiquerait que la fen tre a son origine dans le coin inf rieur gauche de l affichage avec son coin sup rieur droit a 500 250 Vous pouvez r gler un emplacement ou des coordonn es avec des nombres r els par exemple 0 5 0 5 501 75 250 1 mais les va leurs retourn es par AppleScript Studio seront toujours arrondies a leur valeur enti re Dans ce syst me de coordonn es l origine est gauche et en bas et les valeurs x y s augmentent pour repr senter respectivement la droite et le haut notez que c est diff rent du Finder lequel retourne les co ordonn es comme ceci gauche haut droite bas avec l origine dans le coin sup rieur gauche et les valeurs augment es pour repr senter le coin inf rieur droit can hide Acc s lecture criture Classe boolean La fen tre peut elle tre cach e par d faut true supplante la pro pri t visible c est dire que si can hide vaut false r gler la propri t visible sur false ne cachera pas la fen tre content view Acc s lecture criture Classe n importe Le contenu de la view de la fen tre la super view de toutes les autres views de la fen tre le contenu de la view est ins r automatiquement g n ralement vous ne communiquerez pas directement avec lui dans Pa
128. faut cette propri t vaut 0 0 vous pouvez la r gler dans la fen tre Info d Interface Builder number of tick marks Acc s lecture criture Classe integer Le nombre de marques de l objet slider vous pouvez r gler cette pro pri t dans la fen tre Info d Interface Builder certains sliders n ont pas de graduation pour les autres le nombre par d faut est 11 only tick mark values Acc s lecture criture Classe boolean Faut il que seules les valeurs autoris es correspondent aux marques Vous pouvez r gler cette propri t dans la fen tre Info d Interface Buil der pour les sliders ne comportant pas de graduation la valeur par Partie IV Control View Suite Traduction trad applescript 23 2 2004 318 Chapitre 1 Classes d faut est false pour les sliders avec la valeur par d faut est true tick mark position Acc s lecture criture Classe une des constantes de tick mark position page 190 La position des marques au dessus ou au dessous de l objet slider horizontal ou gauche ou droite d un slider vertical vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder title Acc s lecture criture Classe Unicode text Le titre de l objet slider le r glage du titre d un objet slider dans Cocoa est d pr ci e par cons quent vous ne devrez pas r gler le titre dans un script title cell Acc s lecture cr
129. fichier System Library ScriptingAdditions StandardAdditions osax avec Xcode ou Editeur de Scripts ou toute autre application capable de lire des dictionnaires de scripting load movie Charge le film QuickTime sp cifi Vous chargerez g n ralement un film en tant qu objet movie page 63 et l afficherez dans un movie view page 296 L objet application page 29 peut contenir des l ments movie Consultez la classe movie view page 296 pour connaitre la liste des commandes utilisables pour contr ler un film Pour plus d informations sur la mani re de lib rer un movie page 63 voir la section Discussion de la commande load image page 100 Syntaxe load movie string obligatoire Traduction trad applescript 23 2 2004 Partie II Application Suite load movie 105 Param tres string Sp cifie le film devant tre charg Exemples Si un film fait partie de votre projet vous pouvez le charger en le d signant par son nom sans avoir besoin de pr ciser son extension Par exemple si le fichier bdayparty4 mov est stock dans votre projet que celui ci contient une fen tre nomm e homeMovies elle m me contenant un objet movie view page 296 nomm movies vous pouvez charger ce film et l afficher dans le movie view avec les instructions suivantes set currentMovie to load movie bdayparty4 set movie of movie view movies of window homeMovies to currentMovie Vous pouvez
130. film fini normal playback Lecture normale la lecture s arr te une fois le film fini rectangle edge Sp cifie le c t sur lequel un tiroir pourrait s ouvrir ou un menu pop up se d rouler si l espace est limit Par exemple vous utiliserez ces valeurs pour obtenir ou r gler la propri t edge d un objet drawer page 204 ou preferred edge pour un objet popup button page 301 Constantes bottom edge Bord inf rieur left edge C t gauche right edge C t droit top edge Bord sup rieur scroll to location Sp cifie la partie de la fen tre atteindre en cas de d filement utiliser avec la commande scroll page 339 Toutefois cette commande n est pas support e dans la version 1 3 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie II Application Suite sort case sensitivity 187 Constantes bottom Inf rieure top Sup rieure visible Visible sort case sensitivity Sp cifie si un tri doit tenir compte ou non de la casse comme lors du tri des colonnes d une Data Source Constantes case insensitive Tri des donn es sans tenir compte de la casse case sensitive Tri des donn es compte tenu de la casse Version sort case sensitivity est apparu avec la version 1 2 d AppleScript Studio sort order Sp cifie l ordre dans lequel se fait le tri comme lors du tri des colonnes d une Data Source Constantes ascending Tri croi
131. gle les propri t s de la cellule Voir l application Browser pour un exemple plus complexe de travail avec un objet browser view y compris le code complet de ce gestionnaire on will display browser cell theObject row theRow browser cell theCell in column theColumn Code to set the values of the cellContents and isLeaf variables is not shown set string value of theCell to cellContents set leaf of theCell to isLeaf end will display browser cell Notez que contrairement aux autres data views comme outline view page 392 et table view page 403 vous ne pourrez pas alimenter en donn es un objet browser avec un objet data source page 386 En cons quence de quoi les performances pourront tre insuffisantes pour des objets browser affichant plus qu un petit nombre d l ments aussi vous de vrez pr f rer l utilisation d une des deux autres data views bien s r si cela est compatible avec vos imp ratifs data cell Pluriel data cells H rite de personne Classe Cocoa ASKDataCell Repr sente une cellule d une ligne d un objet data source page 386 Les objets data cell stockent le contenu des cellules ainsi que d autres informations pour acc der leur donn es Vous cr erez g n ralement un objet data source page 386 pour g rer les donn es d un objet outline view page 392 ou table view page 403 Vous cr erez alors chaque objet data column page 376 et leur fournirez un n
132. grise vous pouvez la r gler dans la fen tre Info d Interface Builder header view Acc s lecture criture Classe table header view page 402 L objet table header view utilis pour dessiner les en t tes au dessus des colonnes retourne rien si le tableau n a pas d objet table header view aussi vous devrez acc der a cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 Traduction trad applescript 23 2 2004 Partie V Data View Suite table view 409 intercell spacing Acc s lecture criture Classe list L espace entre les cellules exprim par une liste de deux nombres row height Acc s lecture criture Classe real La hauteur de la ligne selected column Acc s lecture criture Classe integer L index de la colonne s lectionn vaut O si aucune colonne n est s lectionn si la propri t allows column selection vaut true et al lows multiple selection vaut false vous pouvez valuer cette propri t pour obtenir l index de la colonne s lectionn e s il y en a une selected columns Acc s lecture criture Classe list L index de chaque colonne s lectionn e une liste vide si aucune co lonne n est s lectionn e si les propri t s allows column selection et allows multiple selection valent true vous pouvez utiliser cette pro pri t pour
133. has horizontal scroller Acc s lecture criture Classe boolean L objet browser a t il un ascenseur horizontal Par d faut cette pro pri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder last column Acc s lecture criture Classe integer L index de la derni re colonne de l objet browser last visible column Acc s lecture criture Classe integer L index de la derni re colonne courante visible dans l objet browser voir aussi la propri t maximum visible columns loaded Acc s lecture uniquement Classe boolean Les donn es de l objet browser sont elles charg es Si true toutes les informations des colonnes courantes affich es ont t acquises un objet browser view appellera pour chaque cellule le gestionnaire will display browser cell page 446 lorsqu il aura besoin d afficher les donn es dans une colonne maximum visible columns Acc s lecture criture Classe integer Le nombre total de colonnes visibles vous pouvez r gler ce nombre dans la fen tre Info d Interface Builder minimum column width Acc s lecture criture Classe real La largeur maximale de la colonne path Acc s lecture criture Classe Unicode text Traduction trad applescript 23 2 2004 Partie V Data View Suite browser 367 Le chemin repr sentant l l ment s lectionn par exemple lorsque l objet browser affiche des fi
134. item l ment 373 381 389 classe 379 data representation EVENE cia haa 465 data row l ment 373 378 381 389 Classe ias 384 594 Index data source l ment 34 411 classe 386 propri t 275 377 385 default entry l ment 73 classe 45 default return constante 174 default tint constante 181 delta x propri t 51 delta y propri t 51 delta z propri t 51 deminiaturized event 130 descending constante 187 destination window propri t 477 dialog ended EVENT ice ee dione at 552 dialog reply classe 518 directory propri t 530 display commande 537 display alert commande 540 display dialog commande 543 display panel commande 547 displayed cell propri t 365 document l ment 34 85 classe 457 document edited propri t 80 document nib name event 130 document rect propri t 203 document view propri t 203 214 double clicked event 349 double value propri t
135. jusqu ce que le panel soit renvoy Dans ce cas l un gestionnaire Panel Ended ne sera pas utile Pour un r sum sur la mani re d utiliser le panel d enregistrement voir la section Exemples de la commande display page 537 et l application Save Panel distribu e avec AppleScript Studio Pour un exemple qui montre comment utiliser un panel d enregistrement voir la section Exemples de la classe open panel page 522 Voir galement Document Suite page 455 pour des informations sur la mani re de lire et d crire des fichiers Traduction trad applescript 23 2 2004 Partie IX Panel Suite save panel 533 Version Depuis la version 1 1 d AppleScript Studio le nom de la classe save panel a t modifi en save panel Ceci afin de mieux diff rencier la classe save panel de la propri t save panel de l objet application page 29 Avant la version 1 1 d AppleScript Studio cette classe avait des fonctions limit es Avant la version 1 1 d AppleScript Studio le nom de la propri t path name tait file name L application Save Panel a t distribu e pour la premi re fois avec la version 1 1 d AppleScript Studio Partie IX Panel Suite Traduction trad applescript 23 2 2004 Chapitre 2 Commandes Les objets bas s sur les classes de la suite Panel supportent les com mandes suivantes Une commande est un mot ou une phrase qu un script peut utiliser pour dema
136. l activation on will become active theUbject Perform operations here before becoming active end will become active Traduction trad applescript 23 2 2004 Partie II Application Suite will finish launching 161 will close Appel lorsque l objet est sur le point de se fermer Le gestionnaire ne peut pas annuler l op ration de fermeture mais peut la pr parer Les classes comme window page 76 panel page 526 et drawer page 204 supportent le gestionnaire Will Close Syntaxe will close reference obligatoire Param tres reference La r f rence de la fen tre du tiroir ou d un autre objet sur le point de se fermer Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Close un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer la fermeture Par exemple vous pourriez vouloir mettre jour un objet contr leur avec les informations des objets text field page 325 d une fen tre Notez qu avant vous devrez valider le contenu des objets text field dans un gestionnaire should close page 151 au cas o la fen tre refuserait de se fermer si un des champs contient des donn es non valides on will close theObject Perform operations here before closing end will close will finish launching Appel lorsque l objet application page
137. l objet dont le gestionnaire Drag Exited est appel drag info drag info page 477 Les informations propos de l op ration de glisser Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Drag Exited un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge Le param tre theObject r f rence lob jet pour lequel un glisser potentiel est sorti de ses limites Le param tre dragInfo fournit l acc s l objet drag info page 477 contenant toutes les informations pertinentes sur l op ration de glisser on drag exited theObject drag info dragInfo Statements to deal with the drag exiting end drag exited Version Le gestionnaire Drag Exited fut ajout dans la version 1 2 d AppleScript Studio drag updated Appel lorsqu un utilisateur a gliss un type r pertori de donn es a l int rieur des limites de l objet Votre application pourra ne pas avoir besoin du gestionnaire Drag Upda ted tant donn que le gestionnaire drop page 486 est le seul gestionnaire requis par le support du d poser de donn es dans AppleScript Studio Syntaxe drag updated reference obligatoire drag info drag info obligatoire Partie VII Drag and Drop Suite Traduction trad applescript 23 2 2004 486 Chapitre 2 Events Param tres reference La r f rence de l objet dont le gestionnaire Drag Updated est appel drag info drag info page 477
138. l objet drag info correspond aux types autoris s ici la v rification porte sur le type string Si ce type est pr sent le gestion naire l utilise pour r gler le contenu de l objet text field transmis par le param tre the0bject on drop theUbject drag info draglnfo We are only interested in the string data type If that type is present set the contents of the text field to the contents of the pasteboard if string is in types of pasteboard of dragInfo then set string value of theUbject to contents of pasteboard of dragInfo end if Partie VIT Drag and Drop Suite Traduction trad applescript 23 2 2004 488 Chapitre 2 Events return true end drop Par d faut la propri t preferred type d un pasteboard est string voila pourquoi le gestionnaire ci dessus ne r gle pas le type pr f r Pour explicitement r gler le type pr f r d un pasteboard dans cet exemple le pasteboard general sur string avant d obtenir les donn es du paste board vous pouvez utiliser les instructions suivantes set preferred type of pasteboard general to string if string is in types of pasteboard general then set myString to contents of pasteboard general Version Le gestionnaire Drop fut ajout dans la version 1 2 d AppleScript Studio prepare drop Appel lorsqu un utilisateur a d pos les donn es gliss es sur l objet Vous retournerez false depuis ce gestio
139. la documentation Cocoa oee 2 Untitled 4 pict Save As Untitled 4 Ca on Profiles Application Support Audio Caches P CFMSupport L ColorSync gt p p p p p p p Context nu Items Desktop Pictures Documentation Filesystems Fonts Frameworks Image Capture CS ColorM P Sf 2 Displays ka Profiles 2 Recommended t WebSafe FIG 9 4 Le panel d enregistrement Propri t s des objets de la classe Save Panel En plus des propri t s qu il h rite de la classe panel page 526 un objet save panel poss de ces propri t s Cette classe n est pas accessible dans Interface Builder aussi vous ne pourrez pas y r gler ses propri t s L application Save Panel distribu e avec AppleScript Studio depuis la version 1 1 montre comment r gler la plupart des propri t s d un objet save panel dans un script directory Acc s lecture criture Classe Unicode text Le r pertoire utiliser dans le panel devra tre un chemin POSIX d limit par des slashs expanded Acc s lecture uniquement Classe boolean Le panel est il d velopp Si oui la colonne du navigateur est visible Traduction trad applescript 23 2 2004 Partie IX Panel Suite save panel 531 comme dans l illustration 9 4 path name Acc s lecture uniquement Classe Unicode text Le chemin retourn depuis le panel un chemin POSIX
140. le gestionnaire Awake From Nib a une fen tre et l utiliser pour la rendre visible on awake from nib theUbject set visible of theUbject to true end awake from nib Consulter la section Exemples de la classe default entry page 45 pour voir un gestionnaire Awake From Nib cr ant une inscription dans les valeurs utilisateur par d faut Discussion Interface Builder est l outil de cr ation d interface graphique d Apple pour Mac OS X Vous utiliserez Interface Builder pour concevoir des objets d interface comme des fen tres des contr les des menus etc pour les redimensionner r gler leurs attributs et les connecter d autres objets Les informations qui en r sultent sont stock es ou archiv es dans les ressources de l interface utilisateur appel es nib lesquelles leur tour sont stock es dans des fichiers nib qui deviennent partie int grante de votre application Un fichier nib est un fichier Interface Builder le ib de nib sous entend Interface Builder Lorsque l application est ouverte elle cr e une interface contenant les fen tres les boutons et les autres objets d interface sp cifi s dans son ou ses fichiers nib Une application contient aussi un fichier nib principal qui est ouvert lorsque l application est lanc e Elle peut aussi contenir des fichiers nib suppl mentaires et les charger au besoin comme cr er des instances de fen tres Pour plus d informations sur le
141. lecture aux propri t s de sa classe parent 560 Chapitre 1 Classes Exemples La raison principale de la cr ation d un plug in AppleScript Xcode est d ajouter de nouvelles fonctionnalit s Xcode en tirant avantage de sa scrip tabilit Cela peut tre utile car Xcode supporte une terminologie de scrip ting robuste et il est ainsi possible de fournir par l interm diaire de l inter face graphique de Xcode des caract ristiques g n ralement non disponibles Pour un exemple montrant comment cr er un menu et un l ment de menu Xcode voir la section Exemples de la commande plugin loaded page 561 Version La classe Plugin fut ajout e dans la version 1 3 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie X Plugin Suite Chapitre 2 Events Les objets bas s sur les classes de la suite Plugin supportent les gestion naires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestionnaire appropri devant tre ex cut Pour d terminer les Events support s par une classe se r f rer sa description purin I d d so Lu 4 3 4 Lama 4 ag at 561 plugin loaded Appel lorsque le plug in pour lequel le gestionnaire est attach est charg Vous utiliserez g n ralement ce gestionnaire pour cr er n importe quel l ment d interface que vous ajoutez Xcode com
142. les objets de la classe Data Item Cette classe n est pas accessible dans AppleScript Studio par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire launched page 135 suivant montre les tapes courantes pour travailler avec les objets data item et data column dans une data source comprenant e cr ation de l objet data source page 386 et stockage de cet objet comme un l ment de l objet application cr ation et bapt me des objets data column page 376 pour la data source cr ation des objets data item parents et r glage du contenu de leurs objets data cell page 372 cr ation de nouveaux objets data item en tant que fils de l objet data item parent et r glage de leurs contenus cr ation d objets data item fils suppl mentaires assignation de la data source une propri t de l objet outline view page 392 Partie V Data View Suite Traduction trad applescript 23 2 2004 382 Chapitre 1 Classes Le gestionnaire launched est appel la fin de la s quence de d marrage d une application aussi c est une bonne place pour cr er une data source pour un objet outline view et la peupler avec des objets data item Ce gestionnaire ajoute les informations suivantes l objet outline view Things to do Work on outline example Make it plain and simple Put it all in a launched event handler Put it in my iDisk when done Voici le
143. lieu should open Vous pouvez annuler l op ration en retour should close nant false will Une op ration est sur le point d avoir lieu will resize Vous pouvez la pr parer mais vous ne pou will hide vez pas l emp cher will quit did Une op ration s est achev e Vous pouvez activated ex cuter des actions en r ponse Apple launched Script Studio utilise le temps pass plut t miniaturized que le terme did zoomed TAB 1 2 Conventions d appellation de Cocoa et d AppleScript Studio Aussi par exemple vous pouvez ajouter un gestionnaire should close page 151 un objet window page 76 Lorsque le gestionnaire est appel il peut d terminer si l utilisateur a ex cut certaines t ches essentielles dans le cas contraire il peut retourner false et refuser d autoriser la fermeture de la fen tre Un gestionnaire will close page 161 ne peut pas annuler l op ration de fermeture mais il peut ex cuter n importe quelles t ches pour pr parer cette op ration Finalement un gestionnaire closed page 129 peut ex cuter n importe quelles t ches requises apr s la fermeture Au d marrage de l application les gestionnaires connect s l objet application page 29 sont appel s dans cet ordre 1 will finish launching page 161 2 awake from nib page 123 Traduction trad applescript 23 2 2004 Partie I Introduction Acc der aux propri t s et aux l ments 17 Im
144. m me sujet voir la description de la commande load nib page 106 ainsi que la classe document page 457 Traduction trad applescript 23 2 2004 Partie II Application Suite became key 127 Lorsqu un fichier nib est d sarchiv il peut r tablir les connections entre les objets archiv s dans ce fichier mais pas avec les objets externes l ar chive C est pour cette raison qu une application doit fournir dans Interface Builder un objet File s Owner chaque fichier nib Pour le fichier nib principal montr dans l illustration 2 1 le Files Owner est cr auto matiquement et r f rence l objet application page 29 Dans une appli cation document based AppleScript Studio le Files Owner du fichier Document nib est aussi cr automatiquement et r f rence l objet document page 457 Dans Interface Builder vous pouvez examiner la classe d un objet File s Owner en s lectionnant son instance dans le panneau Instances de la fen tre Nib en ouvrant la fen tre Info et en utilisant le menu d roulant pour afficher le panneau Custom Class Par exemple vous verrez que la classe de File s Owner est NSApplication pour un objet application page 29 mais NSDocument pour un objet document page 457 Vous pouvez modifier la classe de File s Owner et la r gler sur une autre classe de Cocoa ou une classe personnalis e cr e par vos soins mais la pl
145. missing value bezel style rounded bezel alternate title needs display false current cell item id 3 of application TestingControls auto resizes false key equivalent modifier 0 position 47 45 formatter missing value continuous false size 84 32 cell item id 3 of application TestingControls state 0 button type momentary push in button font item id 4 of application TestingControls sound missing value integer value 0 tool tip missing value super view content view of window id 1 of application TestingControls key equivalent current editor missing value transparent false visible rect 0 0 84 32 contents false Si votre application risque d acc der une propri t pouvant ne pas avoir de valeur vous devrez mettre les instructions utilisant cette propri t dans un gestionnaire d erreurs try on error end try Pour un exemple voir la section Exemples de la commande path for page 112 De m me suivant le contexte un objet pourrait avoir pour sa classe au cun ou plusieurs l ments list s Si vous essayez d acc der un l ment pour lequel il n y a pas d instances vous obtiendrez une liste vide Vous n aurez pas besoin d un gestionnaire d erreurs puisqu un r sultat est retourn mais suivant la logique de votre script vous pourriez avoir besoin de v rifier que la liste n est pas vide Traduction trad applescript 23 2 2004 Partie I Introduction Les param
146. mode Sp cifie comment un utilisateur peut s lectionner une couleur dans un objet color panel page 514 Ce masque est r gl avant que vous initializiez une nouvelle instance de color panel page 514 Vous pouvez r gler la propri t color mode d un objet color panel page 514 avec n importe laquelle des valeurs list es ci dessous Bien que les nuanciers peuvent supporter plusieurs modes lorsque vous obtenez ou que vous r glez dans un objet AppleScript Studio une propri t de couleur celle ci sera au format RVB Une couleur RVB est repr sent e par une liste trois l ments chaque l ment repr sentant un des composants de la couleur Par exemple la couleur bleue sera repr sent e par la valeur 0 0 65535 Constantes cmyk mode Mode CMJN Cyan Magenta Jaune et Noir color list mode Mode liste de couleurs color wheel mode Mode roue de couleurs Partie II Application Suite Traduction trad applescript 23 2 2004 180 Chapitre 4 num rations custom palette mode Mode couleurs personnalis es gray mode Mode niveau de gris hsb mode Mode couleur HSB rgb mode Mode couleur RVB Rouge Vert et Bleu control size Sp cifie la taille des contr les Les classes comme cell page 264 progress indicator page 306 et tab view page 221 poss dent une propri t control size qui pourra tre r gl e avec l une des valeurs list es ci dessous small size que vous pouvez r
147. n a pas explicitement besoin de viser l application c est suppos l int rieur du script Traduction trad applescript 23 2 2004 Partie II Application Suite default entry 47 make new default entry at end of default entries of user defaults with properties name defaultName contents Testing Si vous essayez de faire une nouvelle inscription pour une cl d ja exis tante aucune nouvelle inscription n est cr e et la valeur de la cl n est pas modifi e La supposition est que si la cl existe d ja elle repr sente une valeur enregistr e que vous souhaitez voir pr serv e Toutefois vous pouvez modifier la valeur si n cessaire comme ci dessous Les valeurs par d faut de votre application sont stock es dans son fichier plist Par exemple si l identificateur de votre application lequel fut r gl dans Xcode est com acme application le script pr c dent cr era une nou velle inscription defaultName dans le fichier avec Testing comme valeur o indique le chemin de votre r pertoire utilisateur Library preferences come acme application plist Attention Vous pouvez utiliser l application Property List Editor disponible dans Application Utilitaires pour examiner les listes de propri t s des fi chiers plist Toutefois cause d un bug certaines versions de cette appli cation peuvent afficher incorrectement les informations des propri t s Mais le
148. niveau data representation page 465 et load data representation page 467 Pour des documents plus complexes vous pourrez utiliser la place les gestionnaires de bas niveau write to file page 470 et read from file page 469 e Fournir des informations sur le type de document dans Xcode Vous Partie VI Document Suite Traduction trad applescript 23 2 2004 460 Chapitre 1 Classes pouvez utiliser le Target editor vous y acc derez en choisissant le menu Edit Active Target nomAppli du menu Project ou en appuyant sur les touches Option Cmd E pour sp cifier le nom du type de document les extensions associ es comme txt les types d OS associ s un code sur quatre caract res comme TEXT si l application peut diter le type de fichier ou juste le visualiser l icone associ avec le type de document La version minimale pour la lecture et l criture des fichiers sera de fournir le type de document son extension et sp cifier si l application peut diter ce type Que vous utilisiez les gestionnaires de haut niveau ou de bas niveau pour lire ou crire des donn es le grand avantage du support des docu ments par AppleScript Studio est que vos applications n auront plus besoin de construire des panels d ouverture d enregistrement ou d enregistrement sous ou m me de vous soucier des noms de fichier choisis par l utilisateur L application ne fera que lire o
149. objets de la classe document page 457 Pour d terminer les Events support s par une classe se r f rer sa description data representation 465 load data representation 467 read from Mle s 4 4 8 42 h R R is ee one 469 write CO DLE 4422 due dE a due ee ha dome 470 data representation Appel losqu un document est sur le point d tre enregistr pour incor porer les donn es au document Ce gestionnaire est appel comme le r sultat de l ouverture par l utili sateur des panels d enregistrement Enregistrer et Enregistrer sous ou en utilisant les raccourcis claviers quivalents et du choix d enregistrer le document Il s agit d un gestionnaire de haut niveau que vous pouvez utiliser lorsque vous voulez cr er des documents qui seront sp cifiques votre application Ce gestionnaire retournera alors les donn es du document sous la forme que vous choisirez comme une simple cha ne de caract res une liste un enregistrement ou un autre type de donn es L application ne devra pas 466 Chapitre 2 Events traiter avec l ouverture du fichier et l criture des donn es AppleScript Studio enregistrera automatiquement les donn es dans le document Le contraire de Data Representation est load data representation page 467 Syntaxe data representation reference obligatoire of type Unicode text obligatoire Param tres refer
150. open panel page 522 et save panel page 529 utilisables dans les scripts d une application L objet application fournit aussi des l ments pour m moriser des l ments comme les objets image page 58 movie page 63 et sound page 70 avec l application Traduction trad applescript 23 2 2004 Partie II Application Suite application 31 Propri t s des objets de la classe Application En plus des propri t s h rit es de responder page 68 un objet appli cation poss de ces propri t s consulter la section Version de cette classe pour conna tre dans quelle version d AppleScript Studio fut ajout e une propri t particuli re active Acc s lecture criture Classe boolean L application est elle active color panel Acc s lecture criture Classe color panel page 514 Le panel Couleurs de l application cr automatiquement pour chaque application AppleScript Studio font panel Acc s lecture criture Classe font panel page 520 Le panel Polices de l application cr automatiquement pour chaque application AppleScript Studio hidden Acc s lecture criture Classe boolean L application est elle cach e R gler la propri t hidden sur true r glera la propri t visible de tous les objets window page 76 de l application sur false l inverse restaurera les r glages pr c dents de la propri t visible de toutes les fen tr
151. prendre place Par exemple l application Drawer distribu e avec AppleScript Studio uti lise un gestionnaire Launched pour montrer la fen tre principale on launched theObject show window main end launched L application Drawer a d origine la propri t visible de sa fen tre prin cipale r gl sur false cela t fait lors de sa construction dans Interface Builder dans le panneau Attributes de la fen tre Info Elle r gle alors son interface utilisateur dans le gestionnaire awake from nib page 123 et finalement montre la fen tre dans le gestionnaire Launched Consultez la section Discussion du gestionnaire awake from nib page 123 pour plus d informations sur l ordre dans lequel les gestionnaires sont appel s lors du d marrage Pour d autres exemples de gestionnaires Launched voir la section Exemples de la classe application page 29 miniaturized Appel apr s qu une fen tre ait t r duite Le gestionnaire peut ex cuter sur la fen tre toute op ration n cessaire une fois la r duction accomplie Vous devrez utiliser Miniaturized plut t que was miniaturized page 159 Syntaxe miniaturized reference obligatoire Traduction trad applescript 23 2 2004 Partie II Application Suite mouse down 137 Param tres reference La r f rence de l objet window page 76 ayant t r duit Exemples Lorsque vous connectez dans Interface
152. rant le cla vier et la souris AppleScript Studio fournit un certain nombre de gestionnaires pour g rer le clavier et la souris comme keyboard down page 133 keyboard up page 134 mouse down page 137 mouse up page 141 mouse dragged page 138 etc Pour certains objets particuli rement les objets application page 29 les gestionnaires d Events du clavier et de la souris qui y seront connect s peuvent ne jamais tre appel s car ils sont d abord g r s par d autres objets avant l objet Application Si votre application a r ellement besoin de traiter avec ces gestionnaires tenez compte de leurs connexions avec les objets pr sents dans l interface qui h ritent de la classe control page 280 comme les objets button page 254 slider page 315 stepper page 320 ou text field page 325 Les messages d erreur de scripting Les applications AppleScript Studio sont des applications Cocoa aussi lorsque votre application retourne un message d erreur signifiant une anoma lie de scripting ce message est g n r par le support du scripting de Cocoa Le tableau 1 3 page 23 liste les erreurs de scripting jusqu la version 10 2 de Mac OS X ainsi que les num ros d erreur correspondant Ces messages peuvent ne pas fournir tous les d tails que vous aimeriez pour le d bogage de votre application aussi d autres options sont dispo nibles comme le systeme de d bogage de Xcode Avec ce syst me vous pou
153. rich text string NeXt plain ascii pasteboard type Vous pourriez aussi obtenir d autres types non d finis plus haut la plupart appara tront comme ceci CorePasteboardFlavorType 0x54455854 Pour d autres informations voir la partie Drag and Drop Suite page 475 ainsi que Cutting and Pasting Drag and Drop et System Services dans la documentation Cocoa Propri t s des objets de la classe Pasteboard En plus des propri t s qu il h rite de la classe item page 60 un objet pasteboard poss de ces propri t s content Acc s lecture criture Classe item page 60 Le contenu du pasteboard voir la section Discussion contents Acc s lecture criture Classe item page 60 Le contenu du pasteboard voir la section Discussion name Acc s lecture criture Classe Unicode text Le nom du pasteboard une de ces valeurs general font ruler find et drag preferred type Acc s lecture criture Classe Unicode text Le type de donn es pr f r lors de l obtention ou du r glage du contenu du pasteboard un des types de valeurs list s plus haut dans la des Partie II Application Suite Traduction trad applescript 23 2 2004 66 Chapitre 1 Classes cription de cette classe depuis la version 1 3 d AppleScript Studio vous pouvez utiliser la propri t preferred type pour r gler le contenu d un pa
154. s qu un objet supportant ce gestionnaire comme une fen tre un panel ou un document soit ouvert cet instant le gestionnaire peut ex cuter toute op ration pouvant y prendre place Syntaxe opened reference obligatoire Param tres reference La r f rence de l objet ayant t ouvert Exemples L exemple suivant de gestionnaire Opened est extrait de l application Drawer distribu e avec AppleScript Studio on opened theUbject set contents of text field Date Field of drawer Drawer of window main to opened end opened Comme theObject est la r f rence de l objet ayant t ouvert Drawer ou tiroir en fran ais l instruction suivante est quivalente celle crite plus haut set contents of text field Date Field of theUbject to opened open untitled Appel lorsque l application est sur le point d ouvrir un document sans titre untitled Partie II Application Suite Traduction trad applescript 23 2 2004 144 Chapitre 3 Events Ce gestionnaire est uniquement appel pour une application document based application et seulement pour le premier document lorsque l appli cation est lanc e Ce gestionnaire est appel apr s le gestionnaire should open untitled page 153 et peut pr parer la fen tre sans titre devant tre ouverte Syntaxe open untitled reference obligatoire Param tres reference La r f rence de l application page 29 ouvrant
155. s suivantes fut ajout e dans la version 1 2 1 d AppleScript Studio vous ne pouviez pas les utiliser dans la version 1 2 e auto display e maximum size e minimum size e needs display Le support de la propri t background color est apparu avec la ver sion 1 2 d AppleScript Studio Le support des commandes center page 98 hide page 99 et show page 118 est apparu avec la version 1 2 d AppleScript Studio Le support des gestionnaires will open page 165 et will zoom page 169 est apparu avec la version 1 2 d AppleScript Studio Le support de l attribut Textured Window que vous pouvez utiliser pour sp cifier le look m tal bross est apparu avec la version d Interface Builder distribu e avec Mac OS X version 10 2 Partie II Application Suite Traduction trad applescript 23 2 2004 Chapitre 2 Commandes Les objets bas s sur les classes de la suite Application supportent les com mandes suivantes Une commande est un mot ou une phrase qu un script peut utiliser pour demander une action Pour d terminer les commandes support es par chaque classe voir les descriptions propres chacune call method A LE MI SR A ee 94 GET Lu s mundos Etat be wire 98 He 4 um tale Nana I ana eine 99 Gad Pe ee Lau a GE G Ra pe eue 100 load MOVIS saa sens a ee a 104 RSC TGs tats II Se i ai 106 lead Sound s s 42 3 44 4 dau eee de uk page 107 localized string o s La si ns eR ese 109 AN A E EG A AE 1
156. sa liste d roul e n objet color well dans une fen tre n objet combo box sans sa liste visible 57 XVI Liste des Illustrations 4 5 4 6 4 7 4 8 4 9 4 10 4 11 4 12 4 13 4 14 5 1 5 2 5 3 5 4 5 5 6 1 Bl 8 2 91 9 2 9 3 9 4 9 5 9 6 Lit 12 1 12 2 12 3 12 4 12 5 12 6 12 7 12 8 12 9 Une fen tre affichant une image dans un objet image view extrait de l application Image 286 Un objet matrix avec trois boutons radios 289 Un objet movie view extrait de l application Talking Head 297 Un bouton popup ea pors adidir a da Lake 302 Une barre de progression ind termin e 306 L indicateur de progression circulaire ind termin 307 Un champ s curis affichant des ronds 312 Sliders horizontaux et verticaux sans et avec graduation 316 Unobjet Stepper sc e ca dau na a das 321 Des objets text field utilis s comme tiquette et champ de saisie 326 Un browser view affichant une partie du syst me de fichiers 364 L application Table 379 L application To D list 4 a d ina b a ia 383 Un objet outline view 393 Un objet table view dans Interface Builder 404 Le panneau Groups amp Files d un projet Xcode 459 Le menu File de la fen tre Nib d Interface
157. sultats integer Retourne le nombre de lignes de la colonne sp cifi e de l objet browser Exemples Le gestionnaire Number Of Browser Rows suivant est extrait de l ap plication Browser distribu e avec AppleScript Studio Cette application navigue dans un syst me de fichiers affichant les fichiers et les dossiers dans une fen tre identique au mode colonne de l application Finder Ce gestion naire e r gle la variable rowCount sur 0 e s il n y a aucun nom de disque affich dans la premi re colonne de l objet browser il ne modifie pas la valeur de rowCount Traduction trad applescript 23 2 2004 Partie V Data View Suite number of items 437 e s il y a au moins un nom de disque affich dans la premi re co lonne count of diskNames gt O et si la colonne sp cifi e est la premi re il r gle rowCount sur le nombre total de noms de disque dont l application garde la trace part dans la propri t diskNames e s il y a au moins un nom de disque mais la colonne sp cifi e n est pas la premi re il obtient le chemin de la colonne puis appelle l application Finder pour obtenir le nombre total d l ments de ce chemin Puis il r gle rowCount sur le total retourn par le Finder e retourne rowCount on number of browser rows theUbject in column theColumn set rowCount to 0 if count of diskNames gt O then if theColumn is 1 then set rowCount to count of diskNames else tell brows
158. support e dans la version 1 3 d AppleScript Studio l objet data cell de la colonne editable Acc s lecture criture Classe boolean La colonne est elle ditable Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder header cell Acc s lecture criture Classe table header cell page 401 L objet table header cell utilis pour dessiner l en t te de la colonne identifier Acc s lecture criture Classe Unicode text Le nom utilis par l objet data source pour identifier une colonne vous pouvez r gler cette valeur dans le champ identifier du panneau Attributes de la fen tre Info d Interface Builder voir la section Ver sion de cette classe pour plus d informations maximum width Acc s lecture criture Classe real La largeur maximale de la colonne par d faut cette propri t vaut 1000 vous pouvez la r gler dans la fen tre Info d Interface Builder minimum width Acc s lecture criture Classe real La largeur minimale de la colonne vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder Partie V Data View Suite Traduction trad applescript 23 2 2004 400 Chapitre 1 Classes resizable Acc s lecture criture Classe boolean La colonne est elle redimensionnable Par d faut cette propri t vaut true vous pouvez la r gler dans la fen
159. sur quatre caract res que vous pouviez connaitre dans Mac OS Classique il s agit d une chaine de caract res comme DocumentType que vous r glerez dans Xcode vous pouvez aussi dans Xcode d finir le type sur quatre caract res ainsi que l extension pour les documents voir la section Version pour plus d informations modified Acc s lecture criture Classe boolean Le document a t il t modifi name Acc s lecture uniquement Classe Unicode text Le nom du document par d faut Sans titre pour le premier do cument l unique fa on de modifier le nom est d utiliser Enregistrer sous pour enregistrer le document avec un nouveau nom ou de le modifier s par ment sur le disque path Acc s lecture criture Classe Unicode text Le chemin du document y compris son nom de fichier ajout e dans la version 1 3 d AppleScript Studio non d finie pour un nouveau docu ment jusqu ce qu il soit enregistr au format POSIX une cha ne de caract res d limit es par des slashs par exemple users yourUser Documents fichier text Partie VI Document Suite Traduction trad applescript 23 2 2004 462 Chapitre 1 Classes l ments des objets de la classe Document Un objet document peut contenir les l ments list s ci dessous Votre script peut pour la plupart les sp cifier avec les formes cl s d crites dans Les formes cl s standards
160. trad applescript 23 2 2004 Partie V Data View Suite data source 391 Get the identifier of the clicked table column you can instead use the name of the column set theColumnldentifier to identifier of tableColumn Get the current sort column of the data source set theSortColumn to sort column of theDataSource If the current sort column is not the same as the clicked column then switch the sort column if name of theSortColumn is not equal to theColumnldentifier then set the sort column of theDataSource to data column theColumnldentifier of theDataSource else Otherwise change the sort order if sort order of theSortColumn is ascending then set sort order of theSortColumn to descending else set sort order of theSortColumn to ascending end if end if Update the table view so it will be redrawn update theObject end column clicked Les applications Table Sort et Task List fournissent des exemples complets sur la mani re de trier une data source Travailler avec les objets data source est une t che complexe ne pouvant pas tre couverte en d tails ici Pour un exemple suppl mentaire relative ment simple voir l application Outline laquelle montre comment utiliser un objet outline view page 392 pour afficher les l ments du syst me de fichiers L application Table utilise une data source avec un objet table view page 403 Pour un exemple plus d taill voir les chapitres
161. trad applescript 23 2 2004 Partie XI Text View Suite text view 577 de 7 caract res cause de l instruction character 7 of text of text view 1 qui pourrait g n rer une erreur tell application simple tell window 1 tell scroll view 1 class of text of text view 1 text word 1 of text of text view 1 result This set myTextObject to text of text view 1 result This is the only sentence class of myTextObject result Unicode text In Studio version 1 1 the result is string Next line generates error because Unicode text doesn t have a color property color of myTextObject result Can t get color of This is the only sentence word 1 of myTextObject result This character 7 of myTextObject result s character 1 of word 1 of myTextObject result T set myText to contents of text view 1 result This is the only sentence class of myText result Unicode text word 3 of myText result the character 13 of myText result o editable of text view 1 result true inherited from text background color of text view 1 result 65535 65535 65535 set myTextRef to a reference to text of text view 1 result every text of text view 1 of scroll view 1 of window 1 of application simple class of myTextRef result text color of myTextRef result 0 0 O font of myTextRef NSCannotCreateScriptCommandError contents of myTextRef result This is the o
162. tre Notez que open panel avec un tiret est le nom de la classe tandis que open panel sp cifie un objet de cette classe Pour utiliser le panel Ouvrir dans une application AppleScript Studio vous utiliserez la commande display page 537 pour afficher la propri t open panel associ e avec chaque objet application page 29 Si vous affi chez ce panel comme une feuille attach une fen tre vous aurez aussi besoin de connecter un gestionnaire panel ended page 553 Lorsque l utili sateur ferme le panel vous pouvez obtenir des informations comme la liste des chemins des fichiers que l utilisateur a s lectionn s en acc dant aux propri t s de l objet open panel Un objet open panel comprend et retourne uniquement des chemins au format POSIX d limit s par des slashs Il ne comprend pas les types files ou alias Vous pouvez toutefois utiliser les commandes POSIX file et POSIX path du compl ment de pilotage d AppleScript pour convertir les types de chemins Ces commandes sont d finies dans le compl ment de pilotage osax Standard Additions d AppleScript fichier StandardAdditions osax dans System Library ScriptingAdditions Pour plus d informations voir save panel page 529 ainsi que File Ma nagement and Windows and Panels dans la documentation Cocoa L illustration 9 3 montre le panel Ouvrir Propri t s des objets de la classe Open Panel En plus des propri t s q
163. tre affich e voir cell page 264 image cell page 284 et text field cell page 330 outline item item page 60 L l ment contenant la cellule qui sera affich e table column able column page 398 La colonne de la cellule devant tre affich e Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Dis play Outline Cell un objet outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique Traduction trad applescript 23 2 2004 Partie V Data View Suite will display outline cell 451 celui qui suit Le param tre theObject r f rence l objet outline view page 392 Votre gestionnaire devra faire n importe quelle pr paration re quise par l affichage de l outline cell sp cifi on will display outline cell theObject outline item outlineItem cell theCell table column tableColumn Prepare for cell to be displayed end will display outline cell Partie V Data View Suite Traduction trad applescript 23 2 2004 Sixi me partie Document Suite Cette partie d crit la terminologie de la suite Document d AppleScript Studio La suite Document fournit la terminologie pour le travail avec les docu ments dans les applications AppleScript Studio Cette suite d finit la version AppleScript Studio de la classe document page 457 laquelle remplace celle d finie dans la Standard Suite de Cocoa d crite dans l
164. tres des gestionnaires d Events 19 Important Ce guide indique parfois que certaines propri t s peuvent tre r gl es dans Interface Builder et qu elles ont des valeurs par d faut mais ce guide n essaie pas d tre un guide exhaustif sur Interface Builder pour cela il est pr f rable de consulter l aide propre cette application Les param tres des gestionnaires d Events Dans une application AppleScript Studio vous utiliserez Interface Buil der pour connecter les objets de l application avec les gestionnaires d Events de vos scripts Par exemple si vous connectez un gestionnaire clicked page 348 un bouton lorsque l utilisateur cliquera sur ce bouton le ges tionnaire sera appel dans le script de votre application Lorsque vous connecterez pour la premi re fois un gestionnaire dans In terface Builder celui ci installera automatiquement un gestionnaire vierge dans le script d sign Le listing 1 1 montre le gestionnaire vierge d un gestionnaire clicked page 348 Les gestionnaires vierges sont toujours ajout s avec leur syntaxe compl te le gestionnaire ici n a qu un seul pa ram tre theObject Tous les gestionnaires vierges comportent un param tre theObject lequel sera presque toujours une r f rence l objet pour lequel le gestionnaire est appel mais certains gestionnaires ont aussi des param tres suppl mentaires on clicked theObject Add your script here end clicked
165. un exemple complet mais relativement simple permettant de naviguer dans le syst me de fichiers d afficher les fichiers et les dossiers dans une fen tre identique la vue en colonne de l application Finder Version Le support des Events de Glisser D poser est apparu dans la version 1 2 d AppleScript Studio La propri t titled de cette classe n est pas support e dans la version 1 3 d AppleScript Studio browser cell Pluriel browser cells H rite de cell page 264 Classe Cocoa NSBrowserCell Repr sente la sous classe par d faut d une cellule utilis e pour afficher les donn es dans les colonnes d un objet browser page 363 Chaque colonne d un browser contient un objet matrix page 289 rempli avec les cellules de l objet browser Pour plus d informations voir browser page 363 ainsi que Browsers dans la documentation Cocoa Traduction trad applescript 23 2 2004 Partie V Data View Suite browser cell 371 Propri t s des objets de la classe Browser Cell En plus des propri t s qu il h rite de la classe cell page 264 un objet browser cell poss de ces propri t s alternate image Acc s lecture criture Classe image page 58 L image altern e qui devra tre utilis e par l tat illumin de l objet browser cell leaf Acc s lecture criture Classe boolean Est ce une cellule feuille Chaque cellule peut tre soit une branche
166. un exemple de gestionnaire Alert Ended voir la section Exemples du gestionnaire alert ended page 551 L instruction suivante montre la syntaxe permettant d afficher une alerte qui n est pas attach e une fen tre et sera par cons quent une application modale De m me que plus haut la plupart des param tres sont des va riables r gl es depuis des champs texte dans la fen tre principale de l applica tion en partie visible en arri re plan dans l illustration 9 5 Ici pourtant l ex cution s arr te jusqu ce que l alerte soit renvoy e et Display Alert retourne un objet alert reply page 513 partir duquel vous pouvez obte nir des informations sur la mani re dont l alerte a t renvoy e comme le montre la section Exemples du gestionnaire alert ended page 551 set theReply to display alert dialogText as dialogType message dialogMessage default button defaultButtonTitle alternate button alternateButtonTitle other button otherButtonTitle Traduction trad applescript 23 2 2004 Partie IX Panel Suite display dialog 543 Version Le param tre afterwards calling de cette commande n est pas sup port e dans la version 1 3 d AppleScript Studio display dialog Affiche le dialogue sp cifi AppleScript Studio annule la commande display dialog du compl ment de pilotage d AppleScript fournie dans le fichier System Library ScriptingAdditions StandardAdditions osax pou
167. une taille diff rente pour sp cifier la nouvelle taille Syntaxe will resize reference obligatoire proposed size point facultatif Partie II Application Suite Traduction trad applescript 23 2 2004 168 Chapitre 3 Events Param tres reference La r f rence de l objet window page 76 qui va tre redimensionn proposed size point La taille demand e de la fen tre consistant en une liste de deux nombres entiers horizontal vertical voir la propri t bounds de la classe window page 76 pour des informations sur le syst me des coordonn es R sultats point Vous pouvez retourner un point diff rent pour sp cifier la taille laquelle la fen tre sera redimensionn e Si vous ne retournez pas un point la valeur qui tait transmise dans le param tre proposed size est utilis e Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Re size un objet window page 76 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer le redimensionnement et vous pouvez retourner une valeur de taille pour sp cifier la nouvelle taille Si vous avez besoin de conna tre l ancienne taille dans un gestionnaire resized page 147 lequel est appel apr s le redimensionnement vous pouvez uti liser le gestionnaire Will Resize pour enregistrer la taille courante
168. utilisateur manipule les couleurs dans le panel Par d faut cette propri t vaut true shows alpha Acc s lecture criture Classe boolean Faut il que le panel montre la valeur alpha Par d faut cette propri t vaut false si vous r glez cette valeur sur true le panel affichera le slider Opacity visible dans l illustration 9 1 autrement il ne Vaffichera pas et retournera une valeur alpha gale 1 0 l ments des objets de la classe Color Panel Un objet color panel peut uniquement contenir les l ments qu il h rite de la classe panel page 526 Traduction trad applescript 23 2 2004 Partie IX Panel Suite color panel 517 Events support s par les objets de la classe Color Panel Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Un gestionnaire dans une application AppleScript Studio peut rendre visible le panel Couleurs de cette application ou le cacher lorsqu il est visible en r glant sa propri t visible Comme les scripts AppleScript Studio visent implicitement l application vous n aurez pas besoin d une instruction tell application MonApplication pour acc der la propri t d une application set visible of color panel to true Explication color panel est une des propri t s de la classe application page 29 et elle a pour classe color panel visible est une propri t
169. visible Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder editable Acc s lecture criture Classe boolean Le film est il ditable Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder loop mode Acc s lecture criture Partie IV Control View Suite Traduction trad applescript 23 2 2004 298 Chapitre 1 Classes Classe une des constantes de quicktime movie loop mode page 185 Le type de boucle du lecteur par d faut cette propri t vaut normal vous pouvez la r gler dans la fen tre Info d Interface Builder movie Acc s lecture criture Classe movie page 63 Le film de la view jouer vous chargerez le film dans vos scripts l aide de la commande load movie page 104 movie controller Acc s lecture uniquement Classe item page 60 Le contr leur de film QuickTime movie file Acc s lecture criture Classe Unicode text Le chemin POSIX d limit par des slashs du fichier film du movie view voir la description de la classe ci dessus pour des informations sur l ajout de films votre projet AppleScript Studio movie rect Acc s lecture criture Classe bounding rectangle Les fronti res du film dans la view une liste de quatre nombres gauche bas droite haut voir la propri t bounds de la classe window page 76 pou
170. vous ne sp cifiez aucun des deux l appel va la m thode de l objet d l gu de l application ou si le d l gu ne le supporte pas l objet application page 29 lui m me Plusieurs classes de Cocoa utilisent des d l gu s ou des objets aide lesquels peuvent intervenir et ex cuter des op rations pour la classe utilisant ce d l gu Les d l gu s fournissent une mani re pratique de personnaliser le comportement d une classe sans avoir cr er une Traduction trad applescript 23 2 2004 Partie II Application Suite call method 95 nouvelle sous classe Si vous n crivez pas de code Cocoa vous n aurez probablement pas besoin de conna tre les objets d l gu s mais si vous tes int ress s vous trouverez plus d informations dans Using Window Notifications et Delegate Methods dans la documentation Cocoa of class Unicode text La classe envoyer la m thode Vous n utiliserez jamais ensemble of ou of object et of class of object item page 60 L objet pour appeler la m thode Si votre application a besoin de tour ner avec une version plus ancienne que la 1 2 d AppleScript Studio utilisez of object au lieu de of with parameter item page 60 Sp cifie un param tre devant tre transmis la m thode appel e Uti lisez ce param tre pour une m thode prenant qu un seul param tre Vous pouvez utiliser le param tre pour transmettre un objet ou une valeur simple
171. 0 text field page 325 et text field cell page 330 Par exemple le gestionnaire Action d un objet text field est g n ralement d clench lorsque l utilisateur essaie de tabuler hors du champ ou appuie sur la touche Retour Vous pouvez r gler le bouton radio Send Action d un objet text field dans le panneau Attributes de la fen tre Info d Interface Builder Vous pouvez utiliser la commande perform action page 337 pour pro voquer l appel d un gestionnaire Action Syntaxe action reference obligatoire Param tres reference La r f rence de l objet ayant re u l action Exemples Le gestionnaire Action suivant est extrait du fichier Application applescript de l application Unit Converter distribu e avec AppleScript Studio Ce gestionnaire v rifie juste si l objet pour lequel le gestionnaire a t appel est un objet text field page 325 particulier Si oui il appelle un autre gestionnaire pour ex cuter la conversion comme convertir des yards en m tres on action theUbject if theObject is equal to text field Value of box 1 of window Main then my convert end if end action begin editing Appel avant que l dition ne commence Vous utiliserez g n ralement ce gestionnaire avec les objets text field page 325 text view page 569 ou autres Le gestionnaire ne peut pas annuler l op ration d dition mais peut la pr parer Traduction trad applescript 23 2 2
172. 004 Partie IV Control View Suite begin editing 347 Par exemple lorsque l utilisateur appuiera pour la premi re fois sur une touche du clavier pour saisir un caract re dans un objet text field page 325 AppleScript Studio appellera le gestionnaire should begin editing page 353 s il est install lequel pourra refuser d autoriser l dition Puis si l dition est autoris e le gestionnaire Begin Editing s il est install Le caract re ne sera pas saisi dans le champ tant que l application ne retournera pas le r sultat du gestionnaire Begin Editing Pour continuer avec cet exemple AppleScript Studio appellera le ges tionnaire changed page 348 s il est install apr s que le caract re soit saisi Lorsque l utilisateur appuiera sur la touche Tabulation ou essaiera de compl ter l dition dans ce champ AppleScript Studio appellera le gestion naire should end editing page 354 lequel pourra refuser d autoriser la fin de l dition si par exemple le champ contient une saisie incorrecte Puis si la fin de l dition est autoris e AppleScript Studio appellera le gestionnaire end editing page 350 s il est install o l application pourra ex cuter toute instruction pour que l dition soit compl te Syntaxe begin editing reference obligatoire Param tres reference La r f rence des objets text field page 325 text view page 569 ou d autres objets de m me nature pour les
173. 0bject return allowStopEditing end should end editing will dismiss Appel avant que l objet soit rejet Ce gestionnaire est support par les objets combo box page 274 Le gestionnaire ne peut pas annuler le rejet mais peut le pr parer Syntaxe will dismiss reference obligatoire Partie IV Control View Suite Traduction trad applescript 23 2 2004 356 Chapitre 3 Events Param tres reference La r f rence de l objet combo box page 274 dont le gestionnaire Will Dismiss est appel Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Dis miss un objet combo box page 274 AppleScript Studio ajoute automati quement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer le rejet on will dismiss theUbject Perform any operations to prepare for being dismissed end will dismiss will pop up Appel avant qu un menu d roulant ne surgisse Ce gestionnaire est support par les objets combo box page 274 et po pup button page 301 Le gestionnaire ne peut pas annuler le surgissement mais peut le pr parer Syntaxe will pop up reference obligatoire Param tres reference La r f rence de l objet combo box page 274 ou popup button page 301 dont le gestionnaire Will Pop Up est appel Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Pop Up
174. 1 234 CLASS rise 320 stop commande 343 606 Index string value propri t 269 sub menu propri t super menu propri t super view propri t switch button constante synchronize commande system defined type constante T tab key traverses cells propri t tab state num ration propri t tab type Propri t tab view l ment 86 211 CLASSE anses memes propri t tab view item l ment CLASSE serrures tab view type num ration table column l ment classe table header cell CLASSE ue see eme table header view l ment Bi DIA classe miis table view l ment 87 211 235 A 403 propri t 400 402 tag propri t 232 269 501 target propri t 270 282 text l ment 574 classe 569 text alignment num ration 189 text cell type constante 179 text color propri t 327 331 4573 text container inset Propri t 573 text container origin Propri t 573 text field l ment SY 211 235
175. 11 path Ior osa a AA ea ee db 112 PESTE nck ve AR ds Ne a AAS Be Ql A SU i de 116 Ce c nl n 0 44 a A G e dima d bed he 40 6 8 7a 117 select all o es 24m eee hea de a Ree Ew ee P LE DE ee 117 A 118 BETO fib scr sa a A a 119 94 Chapitre 2 Commandes call method Fournit un m canisme pour appeler les m thodes des objets Objective C depuis un script Avec la commande Call Method vous pouvez facilement acc der votre code Objective C ou utiliser les caract ristiques Cocoa non expos es dans la terminologie de scripting d AppleScript Studio Voir la description de la classe document page 457 pour des d tails sur la mani re d utiliser Xcode et un projet AppleScript Studio pour trouver des informations sur les classes m thodes et constantes Cocoa utilisables avec la commande Call Method Syntaxe call method string obligatoire of item facultatif of class Unicode text facultatif of object item facultatif with parameter item facultatif with parameters list facultatif Param tres string Le nom de la m thode appeler of item page 60 L objet envoyer la m thode Le param tre of fut ajout dans la version 1 2 d AppleScript Studio il peut tre utilis la place du param tre of object si votre application n a pas besoin de tourner avec des versions ant rieures d AppleScript Studio Vous n utiliserez jamais ensemble les param tres of ou of object et of class Si
176. 2 ainsi que Loading Resources dans la documentation Cocoa Propri t s des objets de la classe Bundle En plus des propri t s h rit es de la classe item page 60 un objet bundle poss de ces propri t s executable path Acc s lecture uniquement Classe Unicode text Le chemin des ex cutables de l objet bundle par d faut une applica tion AppleScript Studio n a qu un seul ex cutable frameworks path Acc s lecture uniquement Classe Unicode text Le chemin des frameworks du bundle un framework est lui m me une sorte de bundle qui regroupe le logiciel avec les ressources que celui ci requiert y compris son interface identifier Acc s lecture uniquement Classe Unicode text L identificateur du bundle vous pouvez le sp cifier dans le champ Identifier de l diteur de cibles de Xcode les d tails d pendent de la version de Xcode utilis e les noms des identi ficateurs ressemblent com yourcompany somedirectorylocation YourAppName des exemples sont visibles dans les noms des fichiers plist de votre r pertoire Library Preferences path Acc s lecture uniquement Classe Unicode text Le chemin du bundle avant la version 1 2 1 d AppleScript Studio vous ne pouviez pas utiliser directement cette propri t dans un script Partie II Application Suite Traduction trad applescript 23 2 2004 40 Chapitre 1 Classes vous deviez contourner cette lim
177. 2 2004 402 Chapitre 1 Classes table header view Pluriel table header views H rite de view page 229 Classe Cocoa NSTableHeader View Utilis par un objet table view pour dessiner les en t tes au dessus de ses colonnes et pour g rer les Events Souris de ces en t tes Pour plus d informations voir table view page 403 ainsi que Table Views dans la documentation Cocoa Propri t s des objets de la classe Table Header View En plus des propri t s qu il h rite de la classe view page 229 un objet table header view poss de ces propri t s dragged column Acc s lecture uniquement Classe integer Si l utilisateur fait glisser une colonne le num ro d index de cette colonne autrement 1 dragged distance Acc s lecture uniquement Classe real Si l utilisateur fait glisser une colonne la distance horizontale parcou rue par la colonne depuis sa position initiale autrement la valeur est sans importance resized column Acc s lecture uniquement Classe integer Si l utilisateur redimensionne une colonne le num ro d index de cette colonne autrement 1 table view Acc s lecture criture Classe table view page 403 L objet table view contenant l objet table header view Traduction trad applescript 23 2 2004 Partie V Data View Suite table view 403 l ments support s par les objets de la classe Table Header View Un objet table header view peu
178. 2004 Partie V Data View Suite outline view 395 Exemples de la commande path for page 112 selected data items Acc s lecture criture Classe list Les objets data item s lectionn s disponible depuis la version 1 3 d AppleScript Studio retourne missing value si aucun l ment n a t s lectionn aussi vous devrez acc der cette valeur dans un bloc try on error pour un exemple de bloc try on error voir la sec tion Exemples de la commande path for page 112 outline table column Acc s lecture criture Classe table column page 398 L objet table column contenant le outline l ments des objets de la classe Outline View Un objet outline view peut uniquement contenir les l ments qu il h rite de table view page 403 Commandes support es par les objets de la classe Outline View Votre script peut envoyer les commandes suivantes un objet outline view item for page 420 update page 119 Events support s par les objets de la classe Outline View Un objet outline view supporte les gestionnaires r pondant aux Events suivants Action clicked page 348 double clicked page 349 Data View column clicked page 430 column moved page 430 Partie V Data View Suite Traduction trad applescript 23 2 2004 396 Chapitre 1 Classes column resized page 431 selection changed page 351 selection changing page 352 should select
179. 229 Le content view l objet clip view page 202 qui d coupe l affichage du document pour des informations de m me nature voir la propri t content view de la classe window page 76 document view Acc s lecture criture Classe view page 229 Le document view que l ascenseur fait d filer draws background Acc s lecture criture Classe boolean Faut il que l objet scroll view dessine son fond Par d faut cette pro pri t vaut true Traduction trad applescript 23 2 2004 Partie III Container View Suite scroll view 215 dynamically scrolls Acc s lecture criture Classe boolean Faut il que l objet view d file dynamiquement Par d faut cette pro pri t vaut true has horizontal ruler Acc s lecture criture Classe boolean Le scroll view a t il une r gle horizontale has horizontal scroller Acc s lecture criture Classe boolean Le scroll view a t il un ascenseur horizontal has vertical ruler Acc s lecture criture Classe boolean Le scroll view a t il une r gle verticale has vertical scroller Acc s lecture criture Classe boolean Le scroll view a t il un ascenseur vertical horizontal line scroll Acc s lecture criture Classe real Le nombre total de lignes horizontales faire d filer horizontal page scroll Acc s lecture criture Classe real Le nombre total de pages horizonta
180. 29 deminiatirized 242 s de ba a due da dee we ee 130 document mb DAME o s 44 dun UE LE eb 6 ER e Oe 130 a 1 he eR qe ae E OR ee oa Ae Ee 131 WMG Ba Sew a a Rae ha PhS eh ERE Ee eet 132 keyboard AORN xn sor Goi pee eee Re Ee eg He es 133 keyboard up soraa 4 de a d u da A ee a 134 VOUGNE lt o soa s ece aA 0 Re oe RGA SA AS Ce Re ua 135 a 4 056 24 db AN RIR ME RU au Du 136 TWICE NORTE es de LE eh oh A6 RP ew a l 137 mouse Capes dames dde RUE Le head a 138 MOUSE entered e era De de Eh Ga d du ed 139 MOLES EXCEL de ke a dr nb Gi Aue Ra RE Ru 139 MOUSE moved o sa csa aoa aus a ee s EE eee 140 pa E 6 na e ae RR 141 TOVE a anh a ten E A 142 q ge 6 mi ee ee ME ee A a ee a mia 143 OVE WTO kw eee os de ce dd AG Data de 143 resigned ACV so eso de EA ciias a E B ee 145 S Tai tza RE ke Re Lu dudit Ae ed a 145 resigned TOG caca ee ee 146 e a ee a ee hea her Le Re Oe 147 Might MOUSE CO Lair A A we d VC A 147 right mouse dragged 149 VI Table des Mati res TIEN MOUSE UP c yk ee ne RE SR EE biudae 150 scroll wheel ace Ag ke ans ae Be de E E OR on at 151 should close sou 2 4 e602 245 SG eR eS Ra Ee BE eS 151 should OPE lt e sore s be eh a pie eh e ee eue 152 should open untitled 153 should quit s e oes Le a kee A e a a 154 should quit after last window closed
181. 3 2 2004 Partie IV Control View Suite scroll 339 tell movie view movie to play end tell Pour un exemple plus complexe voir l application Talking Head dis tribu e avec AppleScript Studio resume Non support e dans la version 1 3 d AppleScript Studio Reprend l acti vit pr c dente Syntaxe resume reference obligatoire Param tres reference La r f rence de l objet qui doit reprendre son activit pr c dente scroll Fait d filer l objet sp cifi Non support e dans la version 1 3 d AppleScript Studio Toutefois voir la section Exemples ci dessous pour plus d informations sur la mani re de faire d filer le texte d un objet text view page 569 Syntaxe scroll reference obligatoire item at index integer facultatif to une constante facultatif Param tres reference La r f rence de l objet devant tre d roul item at index integer L index de l l ment jusqu o il faut faire d filer Partie IV Control View Suite Traduction trad applescript 23 2 2004 340 Chapitre 2 Commandes to une des constantes de scroll to location page 186 L emplacement jusqu o doit se faire le d filement Exemples Bien que la commande Scroll ne soit pas support e dans la version 1 3 d AppleScript Studio vous pouvez utiliser la place la commande call method page 94 pour faire d filer Pour un objet text view page 569 par exemple vou
182. 3 d AppleScript Studio Partie VIT Drag and Drop Suite Traduction trad applescript 23 2 2004 Chapitre 2 Events Les objets bas s sur les classes de la suite Drag and Drop supportent les gestionnaires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestionnaire appropri devant tre ex cut Pour d terminer les Events sup port s par une classe se r f rer sa description CONCIUdE MOD side iaa Ae EY Re 481 WS Li a dE AR 483 drag entered 483 Mop erted 2 ss 18 ss dE Leu Oe A a de D at 484 Mee Upa v open o M sa As pre 485 Oa D hoe D ed ce eee 486 prepare A INR c Ca Rd 488 conclude drop Appel pour finir une op ration de d poser r ussi Ce gestionnaire est uniquement appel si les gestionnaires prepare drop page 488 et drop page 486 ont tous les deux r ussi Vous pouvez utiliser ce gestionnaire par exemple pour nettoyer tout tat qui a t r gl ou modifi dans le gestionnaire Prepare Drop Le gestionnaire drop page 486 est le seul gestionnaire requis par le support du d poser de donn es dans AppleScript Studio Les classes text view page 569 et text field page 325 ont toutes les 482 Chapitre 2 Events deux int gr le support du glisser d poser fourni automatiquement par les classes Cocoa sur lesquelles elles sont bas es NSText View et NSTextField Si
183. 39 AS A A A A E ce de 551 Le chapitre Enum rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Panel contient les classes suivantes alert reply Pluriel H rite de Classe Cocoa alert replies personne ASKAlertReply La r ponse de la commande display alert page 540 Un objet alert reply est identique dans le concept la classe dialog reply d finie dans le compl ment de pilotage osax Standard Additions d AppleScript fichier StandardAdditions osax dans System Library ScriptingAdditions Voir aussi display alert page 540 et alert ended page 551 514 Chapitre 1 Classes Propri t s des objets de la classe Alert Reply Un objet alert reply poss de une seule propri t Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y r gler sa propri t vous devrez le faire dans un script button returned Acc s lecture uniquement Classe Unicode text Le bouton qui a t cliqu pour arr ter l alerte par exemple Annu ler si l utilisateur a cliqu sur le bouton Annuler Events support s par les objets de la classe Alert Reply Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Pour un exemple d objet alert reply voir la secti
184. 4 La police courante l ments des ob jets de la classe Font Panel Un objet font panel peut uniquement contenir les l ments qu il h rite de la classe panel page 526 Events support s par les objets de la classe Font Panel Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire d une application AppleScript Studio peut se r f rer la propri t font panel de l objet application page 29 sans avoir sp cifier l application comme dans l instruction suivante laquelle affiche le panel Polices set visible of font panel to true Version Depuis la version 1 1 d AppleScript Studio le nom de la classe font panel a t modifi en font panel Ceci afin de mieux diff rencier la classe font panel de la propri t font panel de l objet application page 29 Avant la version 1 1 d AppleScript Studio cette classe avait des fonctions limit es Partie IX Panel Suite Traduction trad applescript 23 2 2004 522 Chapitre 1 Classes open panel Pluriel open panels H rite de save panel page 529 Classe Cocoa NSOpenPanel Fournit un dialogue standard que les applications peuvent utiliser pour demander l utilisateur le nom du fichier ouvrir Un objet open panel peut tre lanc comme une application modale ou un document modal comme une feuille attach e une fen
185. 4 should select tab view item event 246 should selection change event 445 should zoom event 156 show commande 118 shown event 187 shows alpha propri t 516 shows state by propri t 263 size propri t 84 232 size to fit commande 119 slider l ment 86 211 234 classe 315 small size constante 180 smart insert delete enabled propri t 573 sort case sensitivity num ration 187 propri t 377 sort column propri t 388 sort order num ration 187 Propri t ott sort type num ration 188 propri t ott sorted propri t 388 sound l ment 35 Classe 70 propri t 257 263 source Propri t 478 source mask propri t 479 spell checking enabled propri t 573 split view l ment 86 211 234 classe 218 start commande 340 state propri t 209 257 269 501 step back commande 341 step forward commande 342 stepper l ment 86 21
186. 4 Partie III Container View Suite drawer 209 preferred edge Acc s lecture criture Classe une des constantes de rectangle edge page 186 Le bord ou c t pr f r sur lequel s ouvre le tiroir par d faut cette propri t vaut left edge vous pouvez la r gler dans la fen tre Info d Interface Builder notez que cette propri t peut tre ignor e s il n y a pas la place pour ouvrir le tiroir dans cette direction state Acc s lecture criture Classe une des constantes de drawer state page 181 L tat ouvert ferm du tiroir trailing offset Acc s lecture uniquement Classe real Pour un tiroir qui s ouvre sur le bord gauche ou droit la distance entre le bord inf rieur de la fen tre et le bord inf rieur du tiroir Pour un tiroir qui s ouvre sur le bord sup rieur ou inf rieur la distance entre le bord droit de la fen tre et le bord droit du tiroir Si trailing offset vaut 0 le bord gauche ou inf rieur en fonction du c t choisi pour l ouverture du tiroir est au m me niveau que le bord de la fen tre si vous lancez l application Drawer visible dans l illus tration 3 2 vous pourrez ajuster trailing offset pour voir le tiroir se d placer en relation avec la fen tre l ments des objets de la classe Drawer Un objet drawer peut contenir les l ments list s ci dessous Votre script peut sp cifier la plupart des l ments avec les formes cl s d crite
187. 45 courante Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois que les sous views sont redimensionn es on resized sub views theUbject Perform operations here after sub views resized end resized sub views selected tab view item Appel apr s qu un tab view item page 227 soit s lectionn indiquant que le tab view item courant a t modifi Un tab view item repr sente un onglet dans un tab view page 221 Syntaxe selected tab view item tab view obligatoire tab view item tab view item facultatif Param tres tab view page 221 le tab view dont le tab view item a t s lectionn tab view item tab view item page 227 le tab view item qui a t s lectionn Exemples Le gestionnaire Selected Tab View Item suivant est extrait de l applica tion Assistant distribu e avec AppleScript Studio depuis la version 1 1 Ce gestionnaire est appel lorsque le tab view item page 227 courant a t remplac C est un bon endroit pour ex cuter toute op ration avant l affi chage du contenu de l onglet on selected tab view item theObject tab view item tabViewltem We will give the new info panel a chance to prepare it s data values prepareValues window of theObject of infoPanelWithName name of tabViewItem end selected tab view item Partie III Container View Suite Traduction trad applescript 23 2 2004 246 Chapitre 3 Event
188. 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 dition begin editing page 346 changed page 348 end editing page 350 should begin editing page 353 should end editing page 354 Clavier keyboard up page 134 Souris mouse entered page 139 mouse exited page 139 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Partie IV Control View Suite Traduction trad applescript 23 2 2004 314 Chapitre 1 Classes Exemples Un objet secure text field n a pas de propri t s ou d l ments propres scriptables Toutefois il h rite l ensemble de ses propri t s et de ses l ments de la classe text field page 325 Voir aussi la classe secure text field cell page 314 Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio secure text field cell Pluriel secure text field cells H rite de text field cell page 330 Classe Cocoa NSSecureTextFieldCell Fonctionne avec un objet secure text field page 311 afin de fournir un champ texte dont l affichage de la valeur est masqu e l utilisateur Fournit son propre diteur de champ lequel n affiche pas le texte ou interdit l utilisateur de couper copier et coller sa valeur Toutefois vous pouvez glisser d poser un texte dans un champ s curis Pour plus d informations voir la classe secure
189. 51 Nib awake from nib page 123 View bounds changed page 243 Exemples Le gestionnaire awake from nib page 123 suivant est extrait de l appli cation Image distribu e avec AppleScript Studio Le gestionnaire utilise simplement la commande load image page 100 pour charger une image du projet l image est stock e dans le groupe Resources du projet et elle est nomm e AboutBox tifP Traduction trad applescript 23 2 2004 Partie IV Control View Suite matrix 289 on awake from nib theUbject set image of image view image of window main to load image AboutBox end awake from nib Si vous chargez continuellement des images et que vous ne les lib rez pas la m moire utilis e par votre application va augmenter Pour des informa tions sur la mani re de lib rer des objets image page 58 movie page 63 ou sound page 70 voir la section Discussion de la commande load image page 100 matrix Pluriel matrices H rite de control page 280 Classe Cocoa NSMatrix Utilis e pour cr er des groupes d objets cell page 264 comme des bou tons radios fonctionnant ensemble de diff rentes mani res L illustration 4 6 montre un objet matrix contenant trois boutons radios A O A Window fa Radio _ Television nr J Internet we RE FIG 4 6 Un objet matrix avec trois boutons radios Vous trouverez l objet matrix contenant des boutons radios dans le panneau
190. 56 ee n Th dn ne den ae 4 12 Comment sont organis es les suites 12 La terminologie fournie par le framework Cocoa Appleation i 44 nante de R 6 pas 13 La terminologie fournie par AppleScript Studio 14 Les formes cl s standards 15 Les conventions d appellation des m thodes et des gestionnaires 16 Acc der aux propri t s et aux l ments 17 Les param tres des gestionnaires d Events 19 Connecter les gestionnaires d Events g rant le cla WET Gt IG SOUMIS De poct ee dr h Ae 4 Aus 20 Les messages d erreur de scripting 20 Utiliser les exemples de scripts 21 Panels contre Dialogs et Windows 21 Un mot sur Unicode Text gt o o s 4 conoc mo rra au 22 8 Chap 2 Les bases de la terminologie Information sur les versions Pour construire des applications AppleScript Studio vous devrez avoir install une version des Developer Tools incluant AppleScript Studio adapt e la version de votre syst me Mac OS X Pour pouvoir faire tour ner une application AppleScript Studio votre Mac devra avoir le runtime AppleScript Studio requis par l application Le runtime AppleScript Studio est disponible si AppleScriptKit framework est pr sent dans System Library Frameworks AppleScript Studio essaie de faire en sorte que e une application cr e et construite avec un
191. 6 poss dent des propri t s movie mais les objets movie eux m mes n ont pas de propri t s ou d l ments scriptables Vous pouvez ajouter un film votre application en glissant d posant un fichier movie dans la liste Files du panneau Users amp Groups du projet Xcode de votre application Pour utiliser un film vous le chargerez avec la commande load movie page 104 Pour plus d informations sur la lib ration des objets movie voir la section Discussion de la commande load image page 100 Partie II Application Suite Traduction trad applescript 23 2 2004 64 Chapitre 1 Classes Events support s par les objets de la classe Movie Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Pour un exemple chargeant un objet movie dans un movie view page 296 voir la section Exemples de la classe movie view page 296 pasteboard Pluriel pasteboards H rite de item page 60 Classe Cocoa NSPasteBoard Fournit une interface un pasteboard server supportant le transfert de donn es entre applications comme les op rations copier couper coller ou glisser d poser Les donn es peuvent tre plac es dans le pasteboard sous diff rentes formes Un pasteboard est un l ment de l objet application page 29 et est analogue au presse papiers except qu il y a de multiples pasteboards
192. 65 A ba as ae Ge Sa La dues a 166 will resign active 44 444 ee 167 Will resize donp we oi 4 ea eat gl ME R f 167 MAL BAG ss Ae Li EL RE REA OS Re G 169 Will ZONE 5 4 24 4 COR eG aoe Se GP ork Le 169 DOMO gt cass Boe 40 8 PAS RH ere e oa 171 Traduction trad applescript 23 2 2004 Partie II Application Suite awake from nib 123 activated Appel apr s qu un objet application page 29 ait t activ Le gestionnaire peut ex cuter toute op ration ayant besoin de l activa tion Le d marrage de l application appelle dans un ordre pr cis certains ges tionnaires d Events s ils sont connect s bien s r dont le gestionnaire Acti vated la liste compl te se trouve dans la description du gestionnaire awake from nib page 123 Syntaxe activated reference obligatoire Param tres reference La r f rence de l objet application page 29 ayant t activ Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Activated un objet application page 29 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute action requ rant l activation comme v rifier l tat des l ments affich s dans les fen tres de l application on activated theObject Add script statements here to handle activation end activated awake from nib
193. 7 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Table View cell value page 424 change cell value page 426 number of rows page 439 View bounds changed page 243 Exemples Les instructions suivantes montrent comment identifier un objet table view et lui envoyer la commande update page 119 Les noms des objets Traduction trad applescript 23 2 2004 Partie V nu Data View Suite table view 413 utilis s dans cet exemple correspondent ceux de l application Table dis tribu e avec AppleScript Studio set theTableView to table view contacts of scroll view contacts of window main tell theTableView to update Vous pouvez utiliser des instructions comme celles qui suivent pour r gler les lignes s lectionn es dans l objet table view La premi re instruction r gle une propri t afin d autoriser la s lection multiple dans le tableau la seconde s lectionne la premi re et la quatri me ligne de ce tableau set allows multiple selection of theTableView to true set selected rows of theTableView to 1 4 Vous pouvez utiliser des instructions comme celles qui suivent pour r gler les colonnes s lectionn es dans le tableau Dans l exemple suivant la seconde instruction r gle une propri t afin d autoriser la s lection d une colonne dans le tableau la troisi me s lectionne la seconde et la troisi me
194. 9 Pour plus d informations consulter la section Exemples de la classe default entry page 45 Pour utiliser le syst me des valeurs par d faut pour stocker et r cup rer les pr f rences votre application devra suivre ces directives 1 Essayez de faire de nouvelles inscriptions pour toutes les pr f rences avant d essayer de r cup rer les r glages courants de l utilisateur depuis le syst me des valeurs par d faut Vous ferez une inscription avec une instruction telle que celle ci make new default entry at end of default entries of user defaults with properties name defaultName contents Testing Cette manipulation sera sans effet sur les anciennes valeurs par d faut car si vous essayez de faire une nouvelle inscription avec une cl d j existante aucune inscription n est cr e et la valeur de la cl n est pas modifi e Voir la classe default entry page 45 pour des informations sur la mani re de modifier une inscription lorsque vous en avez besoin L endroit ad quat pour ex cuter cette tape sera dans le gestionnaire will finish launching page 161 connect votre objet application page 29 L objet application est repr sent dans Interface Builder par Vinstance File s Owner dans le panneau Instances de la fen tre Main Menu nib Ce gestionnaire est appel juste avant la fin du d marrage de l application Voir la section Discussion du gestionnaire awake from nib pa
195. Appel apr s qu un objet ait t d sarchiv de son fichier nib cela inclut Vinstanciation de l objet et la restauration de ses valeurs y compris les relations avec les autres objets du fichier nib L archivage est la proc dure de cr ation d un enregistrement d taill d un groupe d objets et de valeurs li s partir desquels vous pouvez recr er le groupe original par d sarchivage Pour plus d informations sur l archivage voir Archiving and Serialization dans la documentation Cocoa Partie II Application Suite Traduction trad applescript 23 2 2004 124 Chapitre 3 Events Un fichier nib est une archive d objets et de connexions cr e dans Inter face Builder Dans un gestionnaire Awake From Nib un objet peut ex cuter n importe quelle initialisation personnalis e une fois que tous les objets du fichier nib aient t d sarchiv s et connect s mais avant que l interface ne soit rendue visible l utilisateur Lorsqu un objet nib est charg Apple Script Studio appelle le gestionnaire Awake From Nib de chaque objet du fichier nib li ce gestionnaire La plupart des classes qui h ritent de responder page 68 c est dire peu pr s toutes les classes AppleScript Studio supportent th oriquement le gestionnaire Awake From Nib Toutefois dans la pratique Awake From Nib est uniquement support par les classes pouvant y acc der dans Interface Builder et pouvant y connecter ce gest
196. Application Suite sound 71 la commande load sound page 107 et le jouer avec la commande play page 338 Pour plus d informations sur la lib ration des objets sound voir la section Discussion de la commande load image page 100 Propri t s des objets de la classe Sound En plus des propri t s h rit es de la classe item page 60 un objet sound poss de ces propri t s playing Acc s lecture uniquement Classe boolean Le son est il actuellement jou Commandes support es par les objets de la classe Sound Votre script peut envoyer les commandes suivantes un objet sound pause page 337 play page 338 resume page 339 start page 340 stop page 343 Events support s par les objets de la classe Sound Bien que vous puissiez glisser d poser un son sur un objet supportant les sons dans Interface Builder vous ne pourrez pas y connecter de gestion naires Exemples La commande load sound page 107 fournit un exemple montrant com ment une application peut charger et jouer un son La classe slider page 315 donne un exemple utilisant un slider laissant l utilisateur la possibilit de r gler le volume du son Version La propri t playing fut ajout e dans la version 1 1 d AppleScript Studio Partie II Application Suite Traduction trad applescript 23 2 2004 72 Chapitre 1 Classes user defaults Pluriel user defaults H rite de item page 60 Clas
197. Builder 496 L l ment de menu New du menu File de la fen tre Nib d Interface Builder os 4 4 2 06 dada sea me deb 499 Le panel Couleurs soci Lui e Le bon A 515 Le panel Polices 4 c 44 464 22 245 mena aude Data 520 Le panel OUY exis das sun Age amp RE He 523 Le panel d enregistrement 530 Un message d alerte affich en tant que feuille par la commande Display Alert 541 Un dialogue feuille affich par la commande Display Dialog 544 Un text view contenant du texte 570 La fen tre de l application Archive Maker 582 La fen tre de l application Unit Converter avec les choix des types de mesure 583 L application Unit Converter avec son tiroir ouvert 584 L application Table Sort avec la liste des individus 585 La colonne Zip retri e suite au clic sur son en t te 585 S lection du contenu de la colonne City avant modification 585 La fen tre de l application Save Panel avec les diff rents choix possibles occiso 4 4 ee 586 Le panel d enregistrement attach la fen tre 586 Le panel d enregistrement affich dans une fen tre part 587 Premi re partie Introduction Chapitre 1 propos de ce guide AppleScript Studio est un environnement de d veloppement permettant de cr er
198. Builder un gestionnaire Minia turized un objet window page 76 AppleScript Studio ajoute automati quement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois la r duction accomplie on miniaturized theUbject Add script statements here to deal with miniaturizing end miniaturized mouse down Appel lorsqu un Event mouse down enfoncement du bouton de la souris survient et qu il peut affecter l objet Syntaxe mouse down reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Mouse Down a t appel event event page 50 Les informations d Events de l Event mouse down Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Mouse Down un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on mouse down theObject event theEvent Partie II Application Suite Traduction trad applescript 23 2 2004 138 Chapitre 3 Events Add script statements here to handle the mouse down event end mouse down Vous pouvez utiliser le param tre theEvent pour obtenir des informations sur l Event mouse down comme l emplacement du curseur de la souris le nombre de clics et si les touches Commande Option Majuscule o
199. Events image page 58 Sp cifier par Les formes cl s standards page 15 Les images de l application par d faut une application n a acc s qu une seule image l image de l icone par d faut d crite dans la section Propri t s plus haut vous pouvez ajouter des images y compris des images suppl mentaires d icones un projet dans Xcode ou In terface Builder mais elles ne seront pas ajout es aux l ments de l ap plication tant que vous ne les aurez pas charg es avec la commande load image page 100 item page 60 Sp cifier par Les formes cl s standards page 15 l usage interne et exclusif d AppleScript Studio movie page 63 Sp cifier par Les formes cl s standards page 15 Les films de l application par d faut une application n a aucun film vous pouvez ajouter des films un projet dans Xcode ou Interface Builder mais ils ne seront pas ajout s aux l ments de l application tant que vous ne les aurez pas charg s avec la commande load movie page 104 pasteboard page 64 Sp cifier par Les formes cl s standards page 15 Les objets pasteboard de l application Traduction trad applescript 23 2 2004 Partie II Application Suite application 35 sound page 70 Sp cifier par Les formes cl s standards page 15 Les sons de l application par d faut une application acc de aux sons pr sent s dans l illustration
200. III Container View Suite Traduction trad applescript 23 2 2004 224 Chapitre 1 Classes l ments des objets de la classe Tab View En plus des l ments qu il h rite de la classe view page 229 un objet tab view peut contenir les l ments list s ci dessous Votre script peut sp cifier la plupart des l ments l aide des r f rences d crites dans Les formes cl s standards page 15 tab view item page 227 Sp cifier par Les formes cl s standards page 15 Les tab view item de la view un par onglet dans la view Events support s par les objets de la classe Tab View Un objet tab view supporte les gestionnaires r pondant aux Events sui vants Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Traduction trad applescript 23 2 2004 Partie III Container View Suite tab view 225 Nib awake from nib page 123 Tab View selected tab view item page 245 should select tab view item page 246 will select tab view item page 248 View bounds changed p
201. Il utilise la commande log page 111 pour afficher le r sultat Une fois que la r f rence du bundle externe est connue vous pouvez l exploiter pour obtenir des in formations sur ce bundle par l interm diaire de ses propri t s ou avec la commande path for page 112 Cet exemple utilise la commande call method page 94 pour obtenir le chemin du bundle car comme il est not pr c demment dans la section Propri t s la propri t path n tait pas support e avant la version 1 2 1 d AppleScript Studio Ce gestionnaire utilise un bloc try on error pour g rer le cas o la commande call method page 94 ne serait pas capable de Partie II Application Suite Traduction trad applescript 23 2 2004 42 Chapitre 1 Classes retourner le bundle par exemple si l application Terminal n est pas pr sente dans le r pertoire Utilitaires on clicked theUbject set theBundle to call method bundleWithPath of class NSBundle with parameter Applications Utilities Terminal app try set thePath to call method bundlePath of object theBundle log thePath on error log Problem getting path to Terminal app end try end clicked Note Avec AppleScript Studio version 1 2 vous pouvez crire of theBundle plut t que of object theBundle L exemple suivant montre comment viser un bundle en dehors de l ap plication on clicked theUbject set LibBundle to call method bundleWithPath of class NSBundle with paramet
202. Item to Yes Create second child data item of Work on outline example set childChildItem to make new data item at end of data items of childItem set contents of data cell task of childChildItem to Put it all in a launched event handler set contents of data cell completed of childChildItem to Yes Create the second child data item of Things to do set childItem to make new data item at end of data items of parentItem set contents of data cell task of childItem to Put it in my iDisk when done set contents of data cell completed of childItem to No Assign the data source to the outline view set data source of outline view tasks of scroll view scroll of window main to dataSource end launched L illustration 5 3 montre l application lanc e avec tous les objets data item d velopp s 0005 Window Task Completed V Things to do Y Work on outline example Yes Make it plain and simple Yes Put it all in an on launched event handler Yes Put it in my Disk when done Yes FIG 5 3 L application To Do list Partie V Data View Suite Traduction trad applescript 23 2 2004 384 Chapitre 1 Classes data row Pluriel data rows H rite de personne Classe Cocoa ASKDataRow Repr sente une ligne dans un objet data source page 386 Cet objet stocke la ligne d une data source et d autres informations Vous pouvez utiliser les l ments d un objet data row pour acc
203. L l ment dont la valeur doit tre modifi e table column table column page 398 La colonne de l l ment modifier value item page 60 La nouvelle valeur Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Change Item Value un objet outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra r gler l l ment d sign avec la valeur sp cifi e on change item value theObject value theValue outline item outlineltem table column tableColumn Partie V Data View Suite Traduction trad applescript 23 2 2004 428 Chapitre 3 Events Set the specified item to the passed value end change item value child of item Appel par un objet outline view page 392 afin d obtenir l l ment fils sp cifi d un l ment Bien qu AppleScript Studio fournisse des gestionnaires pour g rer les donn es qu un objet outline view affiche comme obtenir le fils d un l ment Vapproche recommand e et plus efficace est d utiliser un objet data source page 386 Syntaxe child of item reference obligatoire outline item item obligatoire child integer facultatif Param tres reference La r f rence de l objet outline view page 392 contenant les l ments outline item item page 60 L l ment contenant l l ment fils g n ralement un num ro d index ou une c
204. Le guide Aqua l appellera Fonts window open panel page 522 bas sur la classe NSOpenPanel fournit un m canisme standard permettant l utilisateur de sp cifier le nom du fichier ouvrir Le guide Aqua l appellera Open dialog save panel page 529 bas sur la classe NSSavePanel autorise l uti lisateur sp cifier le r pertoire et le nom sous lequel un fichier est enregistr Le guide Aqua l appellera Save dialog Un dialogue peut tre affich comme une feuille sheet attach une fen tre dans ce cas c est un document modal et l utilisateur pourra travailler avec les autres fen tres de l application sans avoir besoin de la fermer Par exemple vous pouvez utiliser le param tre facultatif attached to de la commande display page 537 pour afficher un dialogue open panel page 522 comme une feuille Un mot sur Unicode Text Lorsque vous obtenez un texte en retour d AppleScript Studio il sera presque toujours au format Unicode Dans certains cas vous pourrez avoir besoin de convertir ce texte en texte brut Pour une discussion et un exemple sur la mani re de convertir de l Unicode en texte brut voir la section Dis cussion de la classe default entry page 45 Dans certains cas lorsque vous fournissez du texte AppleScript Studio comme lors de l utilisation de la commande localized string page 109 vous devrez vous assurer que vous travaillez bien
205. Les dossiers nomm s Resources English lprog Documentation dans les frameworks AppKit et Foundation contiennent la documentation Cocoa Vous pourrez acc der cette m me documentation en choisissant Cocoa Help dans le menu Help de Xcode Traduction trad applescript 23 2 2004 Partie VI Document Suite document 459 vs Scripts Hello World Doc applescript Document applescript y 7 Resources gt E MainMenu nib gt ES Document nib gt gt Credits rtf gt E InfoPlist strings AppleScriptKit asdictionary vi 3 Other Sources M main m va Frameworks y J Linked Frameworks b G Cocoa framework gt K AppleScriptKit framework y 7 Other Frameworks gt K Foundation framework gt K Appkit framework b J Products gt Targets gt 4 Executables gt Errors and Warnings 2 Implementation Files 2 NIB Files gt Q Find Results gt If Bookmarks Project Symbols FIG 6 1 Le panneau Groups amp Files d un projet Xcode Apr s cr ation d un projet Document based Application par d faut vous aurez encore quelques travaux importants faire pour tirer pleine ment avantage du support des documents par AppleScript Studio Ce travail consistera e Ajouter des l ments d interface au fichier Nib du document e Fournir les donn es pour l criture du fichier et les extraire lors de sa lecture Pour des documents simples vous pouvez utiliser les gestion naires de haut
206. Pour un exemple de gestionnaire Will Display Browser Cell voir la sec tion Exemples de la classe browser cell page 370 will display cell Appel avant qu une cellule d un objet table view page 403 ou outline view page 392 ne soit affich e par cons quent afficher la donn e dans la ligne et la colonne sp cifi es Partie V Data View Suite Traduction trad applescript 23 2 2004 448 Chapitre 3 Events Ce gestionnaire ne pourra pas annuler l op ration d affichage mais peut la pr parer Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet table view ou outline view dans ce cas ce gestion naire n est pas utile ou appel Syntaxe will display cell reference obligatoire cell n importe obligatoire row integer obligatoire table column table column obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 contenant la cellule devant tre affich e cell n importe La cellule qui est sur le point d tre affich e voir cell page 264 image cell page 284 et text field cell page 330 row integer L index de la ligne de la cellule devant tre affich e table column table column page 398 La colonne de la cellule devant tre affich e Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Dis play Cell un objet table view page 403 ou outline view page 392 Appl
207. SApplication NSDocument NSButton etc bien qu elles ne reprennent pas toutes les fonctionnalit s possibles de chaque classe Cocoa Ce guide fournit les r f rences la documentation de chaque classe Cocoa correspondante comme une source suppl mentaire d informations sur la ter minologie sous jacente Pour plus d informations sur l organisation de la terminologie dans ce guide voir Comment sont organis es les suites page 12 Traduction trad applescript 23 2 2004 Partie I Introduction Ce que ce guide ne contient pas 5 Ce que ce guide ne contient pas Ce guide ne d crit pas en d tails le langage AppleScript Un autre guide le fait tr s bien il s agit du guide AppleScript Language Guide Si vous ne connaissez pas encore le fonctionnement des scripts et les terminologies de scripting vous trouverez dans le guide Inside Mac OS X Building Applications With AppleScript Studio toute la documentation n cessaire Bien que ce guide fournisse de l aide sur le fonctionnement de Xcode et Interface Builder pour cr er des applications AppleScript Studio il n est pas une r f rence pour ces outils En d crivant les objets d interface disponibles pour vos applications ce guide mentionne certaines propri t s que vous pouvez r gler dans Interface Builder en plus des valeurs par d faut des propri t s des objets d interface que vous instanciez N oubliez pas que la valeur de ces pr
208. Script Studio bas es sur le mod le AppleScript Document based Application Par exemple si vous cr ez un nouveau projet AppleScript Document based Application dans Xcode sans effectuer de modifications l application pourra ouvrir de mul tiples fen tres Sans titre et m me les enregistrer quoique sans donn es application L illustration 6 1 montre le panneau Groups amp Files d un nouveau pro jet Document based nomm DefaultDocumentProject avec plusieurs groupes d velopp s La plupart de ces l ments sont communs tous les mod les de projet AppleScript Studio et sont d crits dans le guide Buil ding Applications With AppleScript Studio voir Autres documentations 458 Chapitre 1 Classes page 5 pour plus d informations sur ce guide Ce qui suit est une des cription des l ments par d faut qui sont propres un projet AppleScript Document based Application e Document applescript est le ficher script par d faut d un document Depuis la version 1 2 d AppleScript Studio ce fichier contient des ges tionnaires data representation page 465 et load data representation page 467 vierges Vous devrez remplir ces gestionnaires pour four nir les donn es pour l enregistrement du document et pour charger les donn es lues depuis Si vous avez d autres instructions vous pouvez les ajouter ce fichier e Document nib est le fichier Nib pour la cr
209. Traduction trad applescript 23 2 2004 Onzi me partie Text View Suite Cette partie d crit la terminologie de la suite Text View d AppleScript Studio La suite Text View d finit deux classes pour l affichage et la manipulation du texte La classe text page 569 h rite de la classe view page 229 et la classe text view page 569 h rite de la classe text page 569 Les classes de la suite Text View sont d crites dans le chapitre suivant ae nie enr due con ed RS hier th 569 Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Text View contient les classes suivantes O A Bek a 569 DRE IG osek ie RUE E Ra amp us 569 text Pluriel text H rite de view page 229 Classe Cocoa NSText Non disponible depuis la version 1 3 d AppleScript Studio Attention Depuis la version 1 3 d AppleScript Studio la classe Text est fusionn e avec la classe text view page 569 Les propri t s pr c demment accessibles dans la classe Text sont dor navant dans la classe Text view Voir la section Ver sion de la classe Text View pour la liste compl te des propri t s fusionn es text view Pluriel text views H rite de text page 569 Classe Cocoa NSTextView 570 Chapitre 1 Classes Fournit plusieurs caract ristiques pour l affichage et la manipulation du texte d
210. Une liste de listes ou une liste d enregistrements devant venir s ajouter a la data source sp cifi e Exemples Le gestionnaire awake from nib page 123 suivant est extrait de l appli cation Table Sort distribu e avec AppleScript Studio disponible depuis la version 1 2 Ce gestionnaire qui est connect a l objet table view page 403 fait ce qui suit e Cr e une data source nomm e names e Cr e et ajoute quatre colonnes la data source une pour name city zip code et age Les colonnes sp cifient des pr f rences de classement y compris le type et l ordre de tri Sp cifie que la data source devra tre tri e et que la colonne courante pour le tri devra tre la colonne name Assigne la data source l objet table view page 403 dont le gestion naire awake from nib tait appel Utilise la commande Append pour peupler la data source avec les donn es de la propri t tableData de l application montr e plus loin on awake from nib theUbject Create the data source this places it in the application object s data source elements Assign it to table view below set theDataSource to make new data source at end of data sources with properties name names Traduction trad applescript 23 2 2004 Partie V Data View Suite append 419 Create each of the data columns including the sort information for each column make new data column at end of data columns of t
211. Vous trouverez ces types d objet dans le panneau Cocoa Controls d Interface Builder aA Window FIG 4 12 Sliders horizontaux et verticaux sans et avec graduation Pour plus d informations voir Sliders dans la documentation Cocoa Propri t s des objets de la classe Slider En plus des propri t s qu il h rite de la classe control page 280 un objet slider poss de ces propri t s alternate increment value Acc s lecture criture Classe real La valeur d incr mentation alternative est la quantit avec laquelle Traduction trad applescript 23 2 2004 Partie IV Control View Suite slider 317 l objet slider modifiera sa valeur lorsque l utilisateur fera glisser la poign e avec la touche Option enfonc e ou touche Alt sur certains claviers image Acc s lecture criture Classe image page 58 L image de l objet slider le r glage de l image d un slider dans Cocoa est d pr ci e par cons quent vous ne devrez pas r gler l image dans un script knob thickness Acc s lecture criture Classe real L paisseur de la poign e maximum value Acc s lecture criture Classe real La valeur maximale de l objet slider par d faut cette propri t vaut 100 0 vous pouvez la r gler dans la fen tre Info d Interface Builder minimum value Acc s lecture criture Classe real La valeur minimale de l objet slider par d
212. Window contenant l objet formatter en mode Listes en cliquant sur l icone visible dans l illustration 2 1 et situ e au dessus de l ascenseur vertical 2 Utilisez le triangle pour d velopper l objet window et autres jusqu ce que l objet formatter soit visible Traduction trad applescript 23 2 2004 Partie II Application Suite formatter 57 ove __NSNumberFormatter Info _ Positive Negative 9 999 99 9 999 99 0 9 999 99 9 999 99 9 999 99 S 9 999 99 x nana aa nana an Appearance Samples Positive Negative Positive 0 00 Zero 0 00 Negative 0 00 Minimum Maximum Options 1 Negative in Red Localize M Add 1000 Separators Cl lt gt Detach Formatter FIG 2 4 La fen tre Info d un Number Formatter dans Interface Builder 3 S lectionnez l objet formatter enfin connectez le gestionnaire dans le panneau AppleScript de la fen tre Info Nib awake from nib page 123 Exemples Dans la version 1 3 d AppleScript Studio les objets formatter n ont pas de propri t s ou d l ments scriptables Toutefois vous pouvez utiliser la commande call method page 94 pour extraire des informations sur un ob jet formatter Vous pouvez aussi utiliser la commande call method pour ob tenir la r f rence d un objet formatter d une classe poss dant une propri t formatter comme control page 280 ou cell page 264 La c
213. a cellule en cours de l objet matrix l objet matrix est aussi nomm severity set my severity to title of current cell of matrix severity Version La propri t content est apparue avec la version 1 2 d AppleScript Stu dio Vous pouvez utiliser au choix content et contents sauf l int rieur d un gestionnaire d Events contents of theUbject retournant une r f rence l objet plut t que son contenu courant Pour obtenir dans un gestion naire d Events le contenu d un objet comme le texte contenu dans un text field page 325 vous pouvez utiliser soit contents of contents of theObject soit content of theUbject La propri t formatter de cette classe n est pas support e dans la ver sion 1 3 d AppleScript Studio Pour un exemple de script montrant la diff rence entre content et contents voir la section Version de la classe control page 280 color well Pluriel color wells H rite de control page 280 Classe Cocoa NSColor Well Supporte la s lection et l affichage d une couleur Un objet color panel page 514 utilise un objet color well pour afficher la couleur courante s lectionn e Vous travaillerez g n ralement avec les couleurs par lin term diaire de la propri t color panel de la classe application page 29 pas directement avec un objet color well L illustration 4 2 montre un objet color well dans une fen tre Cliquez sur cet objet ouvre le pan
214. a fen tre Info d Interface Builder mais pour faire cela vous devrez double cliquer pour s lectionner l objet table view et non s lectionner l objet scroll view le contenant le titre de la fen tre Info d Interface Builder devra mentionner NSTableView L illustration 5 5 montre un objet table view dans Interface Builder Les informations des lignes et des colonnes sont temporairement remplies par Partie V Data View Suite Traduction trad applescript 23 2 2004 404 Chapitre 1 Classes Interface Builder lors de la compilation ces informations disparaitront et seront remplac es par les v tres Pour plus d informations voir Table Views dans la documentation Cocoa 6 0 Window 0 Cupertino Cupertino 1 San Jose San Jose 2 Santa Clara Santa Clara 3 San Francisco San Francisco 4 Palo Alto Palo Alto 5 San Carlos San Carlos 6 Los Gatos Los Gatos 7 Sunnyvale Sunnyvale 8 Mountain View Mountain View FIG 5 5 Un objet table view dans Interface Builder Bien qu Interface Builder fournisse des gestionnaires d Events pour la gestion des donn es affich es par le tableau l approche conseill e et plus ef ficace sera d utiliser un objet data source page 386 pour fournir les donn es La section Exemples de cette classe se concentre sur l utilisation des objets table view avec ou sans objet data source Propri t s des objets de la classe Table View En plus des propri t s
215. a ressembler ceci Volumes Projects tester build tester app Contents Resources Scripts tester scpt Comme les objets bundle page 38 et application page 29 supportent tous les deux la commande Path For vous pouvez simplifier le script pr c dent par celui qui suit Lorsqu aucun bundle n est sp cifi application cherche automatiquement dans le bundle principal tell application tester set scriptPath to path for script tester extension scpt end tell Le gestionnaire clicked page 348 suivant utilise la commande Path For pour obtenir le chemin du script compil Application scpt dans l applica tion AppleScript Studio Comme aucun bundle n est sp cifiquement vis la commande cherche dans le bundle principal de l objet application page 29 Il stocke le chemin dans une propri t et utilise un bloc try on error pour g rer le cas o la commande Path For ne retournerait pas un chemin valide Si la commande Path For aboutit le script utilise la commande log page 111 pour afficher le chemin Il utilise alors le compl ment de pilotage POSIX file pour obtenir le chemin du fichier et le compl ment de pilotage load script pour charger le script puis assigne ce script a une propri t A ce point les scripts de application peuvent appeler les gestionnaires du script charg Traduction trad applescript 23 2 2004 Partie II Application Suite path for 115 Note La classe POSIX file et la command
216. a section Exemples de la commande path for page 112 selected data rows Acc s lecture criture Classe list Les objets data row qui sont s lectionn s retourne une liste vide si aucun objet data row n est s lectionn si la propri t allows multiple selection vaut false la liste retourn e contiendra au maximum un seul objet data row selected row Acc s lecture criture Classe integer L index de la ligne s lectionn e si la propri t allows multiple se lection vaut false vous pouvez v rifier cette propri t pour la ligne s lectionn e selected rows Acc s lecture criture Classe list L index de chaque ligne s lectionn e si la propri t allows multiple selection vaut true vous pouvez v rifier cette propri t pour toutes les lignes s lectionn es l ments des objets de la classe Table View En plus des l ments qu il h rite de la classe control page 280 un objet table view peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Traduction trad applescript 23 2 2004 Partie V Data View Suite table view 411 Les formes cl s standards page 15 data source page 386 sp cifier par Les formes cl s standards page 15 L objet data source fournissant les donn es au tableau un objet table view peut avoir soit aucun objet data source soit
217. a section La termi nologie fournie par le framework Cocoa Application page 13 La suite Document est apparue avec la version 1 2 d AppleScript Studio afin de faciliter la cr ation des applications bas es sur le mod le Apple Script Document based Application Cette suite d finit deux gestionnaires d Events de haut niveau data representation page 465 et load data representation page 467 ainsi que deux gestionnaires de bas niveau read from file page 469 et write to file page 470 De plus la classe window page 76 poss de d sormais un l ment document donnant acc s son ou ses documents depuis l interface utilisateur Xcode fournit le mod le de projet AppleScript Document based Ap plication pour les applications qui cr ent et g rent de multiples docu ment Pour supporter la suite Document les r glages de ce mod le de projet furent r vis s Le fichier script Document applescript du projet int gre dor navant des versions vierges des gestionnaires data representation page 465 et load data representation page 467 L application Task List disponible depuis la version 1 2 d AppleScript Studio montre comment lire et crire des fichiers simples avec ces gestionnaires de haut niveau L appli cation Plain Text Editor disponible aussi depuis la version 1 2 montre comment lire et crire des fichiers texte l g rement plus complexes avec les gestionnaires de bas niveau read f
218. a source Un objet data item peut contenir des objets data item imbriqu s sup porter le stockage des l ments dans une view hi rarchique comme un objet Partie V Data View Suite Traduction trad applescript 23 2 2004 380 Chapitre 1 Classes outline view page 392 o l utilisateur peut ouvrir un l ment pour afficher les l ments contenus Les propri t s d un objet data item sp cifient s il a des objets data item imbriqu s ainsi que s il a un l ment parent et si oui la r f rence de l l ment parent Ses l ments stockent n importe quel objet data item imbriqu Vous cr erez g n ralement un objet data source page 386 pour g rer les donn es d un objet outline view page 392 ou table view page 403 Vous cr erez alors chaque objet data column page 376 et leur fournirez un nom Ce processus est montr dans la section Exemples de la commande append page 417 Puis pour un objet outline view vous cr erez des objets data item pour la data source Pour chaque data item cr l objet data source cr era au tomatiquement un objet data cell page 372 pour chaque colonne donnant par d faut chaque data cell le nom de sa colonne Apr s la cr ation d un objet data item vous pouvez r gler les donn es de ses objets data cell g n ralement en sp cifiant le data item et le nom de la cellule Vous pouvez utiliser ces m mes informations pour obtenir le contenu d un obje
219. a suite Plugin d AppleScript Stu dio Depuis la version 1 3 d AppleScript Studio distribu e pour la premi re fois avec Mac OS X 10 3 Xcode fournit un nouveau gabarit pour la cr ation de plugin AppleScript destination de Xcode C est dire que vous pou vez utiliser AppleScript Studio pour cr er des plugins qui ajoutent des ca ract ristiques Xcode lui m me La suite Plugin fournit la terminologie utiliser avec les plugins de ce type Les classes et Events de la suite Plugin sont d crits dans les sections suivantes BE ad 559 ca e 2 nn nada antenne antennes unes 561 Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Plugin contient la classe suivante PU eck ve el Be EU ee ae wed NRA URL 559 plugin Pluriel plugins H rite de item page 60 Classe Cocoa ASKPlugin Repr sente un plug in Vous construirez des plug ins en utilisant le mod le de projet Xcode AppleScript Xcode Plugin Une fois que vous avez construit un plug in vous le placerez un de ces emplacements ainsi il sera charg au prochain lancement de Xcode e Library Application Support Apple Developer Tools Plug Ins e Library Application Support Apple Developer Tools Plug Ins e Network Library Application Support Apple Developer Tools Plug Ins Un objet plugin a uniquement acc s en
220. a tabu lation entre champs ajout s une fen tre Par d faut l ordre de tabulation va de gauche droite puis en dessous et est ind pendant de l ordre dans lequel vous ins rez les objets text field Voir Enabling Tabbing Between Objects dans l aide d Interface Builder pour une description sur la mani re de r gler l ordre de la tabulation entre des objets text fields ou d autres ob jets vous pouvez sp cifier le premier objet recevant les Events clavier ou le first responder initial et chaque objet successif de la cha ne responder L illustration 4 14 montre un text field tiquette System Font Text et un champ de saisie Pour plus d informations voir Text Fields dans la documentation Cocoa Propri t s des objets de la classe Text Field En plus des propri t s qu il h rite de la classe control page 280 un objet text field poss de ces propri t s allows editing text attributes Acc s lecture criture Classe boolean Partie IV Control View Suite Traduction trad applescript 23 2 2004 326 Chapitre 1 Classes aA Window System Font Text Fic 4 14 Des objets text field utilis s comme tiquette et champ de saisie L utilisateur peut il diter les attributs de polices de l objet text field Par d faut cette propri t vaut false background color Acc s lecture criture Classe RGB color La couleur de fond de l objet text field une lis
221. able Sort et Task List distribu es depuis la version 1 2 d AppleScript Studio Si vous r glez le type de tri d une colonne sur numerical vous aurez besoin de vous assurer que le contenu des objets data cell de cette colonne sont bien en fait des nombres et non des chaines de caract res Ou si vous le r glez sur alphabetical le contenu des objets data cell devra tre des cha nes de caract res les chiffres devront tre au format string 23 Partie V Data View Suite Traduction trad applescript 23 2 2004 388 Chapitre 1 Classes Propri t s des objets de la classe Data Source Un objet data source poss de ces propri t s voir la section Version de cette classe pour savoir dans quelle version d AppleScript Studio sont apparues certaines propri t s localized sort Acc s lecture criture Classe boolean Les donn es doivent elles tre tri es en utilisant des r gles localis es sort column Acc s lecture criture Classe data column page 376 l objet data column dans lequel se fait le tri des donn es les propri t s de la colonne contr le le tri sorted Acc s lecture criture Classe boolean La data source doit elle tre tri e update views Acc s lecture criture Classe boolean Faut il que les views de la data source soient mises jour Par effi cacit vous devrez viter les mises jour non n cessaires en r glant cette p
222. age image scaling Acc s lecture criture Classe une des constantes de image scaling page 184 L chelle de l image Events support s par les objets de la classe Image Cell Un objet image cell supporte les gestionnaires r pondant aux Events suivants Action clicked page 348 Nib awake from nib page 123 Exemples Vous ne scripterez g n ralement pas un objet image cell la place vous pouvez scripter les m mes propri t s d un objet image view page 285 image frame style image alignment et image scaling image view Pluriel image views H rite de control page 280 Classe Cocoa NSImage View Affiche une image dans un cadre et peut occasionnellement autoriser un utilisateur glisser une image dessus L illustration 4 5 montre une image affich e dans un objet image view par l application Image distribu e avec AppleScript Studio Vous pouvez stocker une image dans votre projet AppleScript Studio en glissant un fichier image depuis le Finder dans un des groupes de la liste Partie IV Control View Suite Traduction trad applescript 23 2 2004 286 Chapitre 1 Classes Files du panneau Groups amp Files de Xcode ou en utilisant le menu Add Files du menu Project Vous pouvez aussi glisser les images sur le panneau Images de la fen tre Nib dans Interface Builder Vous pouvez afficher une image dans un objet image view en la chargeant a
223. age 151 Nib awake from nib page 123 View bounds changed page 243 Exemples Vous pouvez acc der aux l ments de la liste du menu d roulant d un objet combo box par l interm diaire de sa propri t combo box item tant donn un objet combo box nomm combo dans la fen tre en avant plan l instruction suivante retournera la liste des l ments texte chaque l ment repr sentant un l ment de la liste du menu d roulant de cet objet combo box every combo box item of combo box combo of window 1 Les lignes suivantes supprimeront tous les l ments du combo box et ajouteront un nouvel l ment delete every combo box item of combo box combo of window 1 make new combo box item at end of combo box items of combo box combo of window 1 with data Test Item Vous pouvez supprimer un objet combo box item avec son index comme avec par exemple l instruction suivante delete combo box item 2 of combo box 1 of window 1 Pour obtenir le contenu d un objet combo box la valeur de la partie texte du combo box vous pouvez utiliser cette instruction set comboContents to contents of combo box combo of window main Voir aussi la section Exemples de la classe combo box item page 279 Traduction trad applescript 23 2 2004 Partie IV Control View Suite combo box item 279 Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio Le
224. age 243 Exemples tant donn les noms appropri s aux objets vous pouvez utiliser la terminologie suivante pour r gler le texte d un text field page 325 dans un tab view set contents of text field textFieldName of view of tab view item tabViewltemName of tab view tabViewName of window windowname Les l ments d un tab view item page 227 sont g n ralement sur une view page 229 qui est elle m me sur un tab view item page 227 le quel repr sente la view dans la phrase of view of tab view item de cet exemple Toutefois partir de la version 1 2 d AppleScript Studio vous n aurez plus besoin de sp cifier la view et vous pourrez utiliser l instruction suivante forme simplifi e de la pr c dente set contents of text field textFieldName of tab view item tabViewltemName of tab view tabViewName of window windowname Vous pouvez utiliser un tab view pour simuler le zapping du contenu d une view Dans Interface Builder glissez d posez un objet tab view du pan neau Cocoa Containers sur la fen tre vis e Avec le tab view s lectionn cochez le bouton Tabless Vous pouvez alors choisir le style entre avoir une plateforme ombr e ou avoir aucun cadre visible Si vous choisissez aucun cadre visible vous pourrez aussi choisir si le tab view pourra dessiner son fond Vous pourrez encore mettre les objets d interface voulus sur chaque tab view item page 227 Comme il n y a a
225. age 477 menu item page 499 et slider page 315 peuvent avoir des images associ es Les types d image support s sont ceux de la classe Cocoa NSBitmapl mageRep Les types support s sont JPEG PNG GIF TIFF BMP PICT EPS et PDF Vous pouvez stocker des images dans votre projet AppleScript Studio avec le menu Add Files du menu Project Vous pouvez aussi glisser des fichiers image depuis le Finder sur un des groupes g n ralement le groupe Resources de la liste de fichiers du panneau Groups and Files de Xcode Vous pouvez aussi glisser des images dans l onglet Images de la fen tre nib dans Interface Builder Pour plus d informations sur le m me sujet voir Drawing and Images et Images Views dans la documentation Cocoa Syntaxe load image string obligatoire Traduction trad applescript 23 2 2004 Partie II Application Suite load image 101 Param tres string Sp cifie l image devant tre charg e voir la section Exemples pour plus d informations Exemples Si une image fait partie de votre projet vous pouvez la charger en la sp cifiant par son nom sans avoir besoin de pr ciser l extension Par exemple supposons que votre application contienne dans le progiciel un fi chier nomm starryNights tiff ainsi qu un objet image view page 285 ayant comme nom AppleScript artImages et une fen tre art Window vous pouvez alors charger cette image et l af
226. aire Right Mouse Down un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on right mouse down theObject event theEvent Add script statements here to handle the right mouse down event end right mouse down Vous pouvez utiliser le param tre theEvent pour obtenir des informa tions sur l Event right mouse down comme l emplacement de la souris le nombre de clics et si les touches Commande Option Majuscule ou Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples right mouse dragged Appel lorsqu un Event right mouse dragged glissement avec le bou ton droit de la souris survient Syntaxe right mouse dragged reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Right Mouse Dragged est appel event event page 50 Les informations d Events de l Event right mouse dragged Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Right Mouse Dragged a un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique a celui qui suit on right mouse dragged theObject event theEvent Partie II Application Suite Traduction trad applescript 23 2 2004 150 Chapitre 3 Events Add script statements here to handle the right mouse dragged event
227. an of Ark city Paris zip 53255 age 36 name King Tut city Egypt zip 00245 age 45 name James Taylor city Atlanta zip 21769 age 42 Vous pouvez aussi obtenir en retour les donn es d une data source sous forme d une liste de listes avec la terminologie suivante o theDataSource sp cifie une data source Partie V Data View Suite Traduction trad applescript 23 2 2004 420 Chapitre 2 Commandes set myList to contents of every data cell of every data row of theDataSource Depuis la version 1 3 d AppleScript Studio la commande Append ac cepte une simple liste d l ments Par exemple vous pouvez crire append the data source of table view 1 of window 1 with One Two Three Version Depuis la version 1 3 d AppleScript Studio la commande Append ac cepte une simple liste d l ments La commande Append est apparue avec la version 1 2 d AppleScript Studio item for Retourne les l ments de la ligne choisie dans la data source Un objet data item page 379 repr sente une seule ligne d un objet data source page 386 Cette commande fonctionne uniquement avec un objet outline view page 392 Syntaxe item for outline view obligatoire row integer obligatoire Param tres outline view page 392 L objet outline view partir duquel doit tre obtenu l l ment de la ligne sp cifi e row integer L index de la ligne de l obje
228. ants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestion naire appropri devant tre ex cut Pour d terminer les Events support s par une classe se r f rer sa description gall Sal 2 45 44 8452 4805644 hoe 24 82 424 change cell value 426 change em value cocos e Rogue sun 427 child OF WOH s 4 2 5 Da 8 Gorte Le en Bi em dur x 428 column clicked 430 EOL MOE ra a 430 column resized 431 item expandable 432 WE PAE co So Ek QUE 4 a DRE ne 434 number of browser rows 436 Ober FUESE oa coa a De dre 4 Ale 437 number OF TOWS o pda a nue G a din m re 439 should collapse HSM ro sna de b k Lu du ue 440 should expand Met 4 a 4 eee cares et 441 should select column 2 5 54 4 ewe a nasa dat 442 should select item 443 should select row 444 should selection change 445 will display browser cell 446 424 Chapitre 3 Events will display cell so ss amp 4 4 4 4 4 447 will display item cell 449 will display outlin tell gt po s s o issue 450 cell value Appel par un objet table view page 403 ou outline view page 392 afin d obtenir la valeur d une cellule Ce gestionnaire
229. apitre 3 Events will select tab view item Appel lorsqu un tab view item page 227 est sur le point d tre s lectionn Un tab view item repr sente un onglet dans un tab view page 221 Ce gestionnaire ne peut pas annuler la s lection mais peut la pr parer Syntaxe will select tab view item tab view obligatoire tab view item tab view item facultatif Param tres tab view page 221 le tab view dont le tab view item est sur le point d tre s lectionn tab view item tab view item page 227 le tab view item qui est sur le point d tre s lectionn Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Se lect Tab View Item un objet view page 229 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer le tab view item tre s lectionn on will select tab view item theUbject Perform operations to prepare for selection of the item end will select tab view item Traduction trad applescript 23 2 2004 Partie III Container View Suite Quatri me partie Control View Suite Cette partie d crit la terminologie de la suite Control View d AppleScript Studio La suite Control View d finit un certain nombre de classes permet tant d impl menter et de travailler avec des objets control page 280 Les controls sont des objets graphiques qui prov
230. aque l ment l objet outline view appellera le gestionnaire Item Value trois fois pour chaque l ment affich une premi re fois pour le nom une seconde fois pour la date de modification et une troisi me fois pour la taille Ce gestionnaire n est pas appel pour les lignes d velopp es non visibles Syntaxe item value reference obligatoire outline item item facultatif table column table column obligatoire Param tres reference La r f rence de l objet outline view page 392 contenant l l ment outline item item page 60 L l ment dont la valeur doit tre obtenue table column table column page 398 La colonne de l l ment Traduction trad applescript 23 2 2004 Partie V Data View Suite item value 435 R sultats n importe La valeur de l l ment sp cifi g n ralement retourn e au format string Exemples Le gestionnaire Item Value suivant est extrait de l application Outline distribu e avec AppleScript Studio Cette application utilise un objet out line view page 392 pour afficher les l ments d un syst me de fichiers Ce gestionnaire utilise l identificateur de la colonne pour d terminer le type de valeur retourner pour l l ment Il appelle alors l application Finder pour obtenir la valeur soit le nom la date de modification ou le type et retourne la valeur au format string on item value theObject outline item theltem table column theColumn
231. as s sur les classes de la suite Control View supportent les gestionnaires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestionnaire appropri devant tre ex cut Pour d terminer les Events sup port s par une classe se r f rer sa description o lt ae Qn A b a de b merde ee Gee Ge 345 DESTA EDS Li is De oise HR MU sk as Ce Qued d Tac sun 346 a A LAN A EE Ba Eom ma at 348 Click d lt 4 4 da A dir bad hd BEA se dde 348 double clicked 349 end editing ica ban 18 6 ds a s L i ma ee 350 selection changed 351 selection changing 22 5 44 x 5244 ee eae 352 should begin editing 353 Should end editing oc ono e ci de ko nb ge a ue 354 PULL CHATS a da ge So 4 sh sua 355 will pop UD 54654254 bide bee be He 356 action Appel lorsqu une action survient pour un objet Ce gestionnaire doit son nom au concept Cocoa de l action une m thode pouvant tre d clench e par les objets de l interface utilisateur Dans AppleScript Studio les gestion naires action sont clicked page 348 double clicked page 349 et Action 346 Chapitre 3 Events Le gestionnaire Action lui m me est support par les classes comme combo box page 274 popup button page 301 secure text field page 311 slider page 315 stepper page 32
232. asse Cocoa NSSound y compris les fichiers AIFF et WAV Pour plus d informations sur la mani re de lib rer un objet sound page 70 voir la section Discussion de la com mande load image page 100 Partie II Application Suite Traduction trad applescript 23 2 2004 108 Chapitre 2 Commandes Syntaxe load sound string obligatoire Param tres string Sp cifie le son devant tre charg la cha ne de caract res peut nom mer le son dans le projet de l application ou fournir son chemin PO SIX d limit par des slashs pour plus de d tails voir la section Exemples Exemples Par d faut un projet AppleScript Studio permet l acc s aux fichiers son syst me Vous pouvez visualiser ces sons dans l onglet Sounds de la fen tre MainMenu nib d Interface Builder comme dans l illustration 2 6 Pour pouvoir charger un son faisant partie de votre projet celui ci devra avoir l extension d un des formats support s comme aif aiff ou wav mais vous n aurez pas besoin de sp cifier explicitement cette extension voir la section Exemples ci dessous Vous pouvez charger un son situ en dehors de votre projet en le sp cifiant avec son chemin POSIX dans ce cas vous devrez sp cifier explicitement son extension Le gestionnaire clicked page 348 suivant utilise le compl ment de pi lotage set volume pour r gler au minimum le volume sonore puis charge et joue le son Sosumi aiff situ
233. ation de fen tres document associ Les fichiers Nib sont d crits avec le gestionnaire awake from nib page 123 e Credits rtf est un fichier au format Rich Text Format qui fournit le texte pour la fen tre par d faut A propos de d une application Cocoa Vous diterez ce fichier pour pouvoir y inscrire vos propres informations Le framework Cocoa framework est list dans le groupe Linked Fra meworks Sa case Target est coch e indiquant qu il fait partie de la cible courante Le groupe Headers de Cocoa contient actuellement un seul fichier en t te Cocoa h non visible Ce fichier importe les fichiers en t te Foundation h et AppKit h deux fichiers qui a leur tour importent tous les fichiers en t tes pour les deux frameworks composant Cocoa AppKit framework et Foundation framework Vous pouvez voir dans l illustration 6 1 que le groupe Other Frame works contient la fois AppKit framework et Foundation framework cela est vrai pour tous les projets AppleScript Studio Ces frameworks sont list s dans le groupe Other Frameworks pour fournir un acc s pratique et ais aux fichiers en t tes contenant toutes les classes Cocoa m thodes et constantes disponibles pour vos applications AppleScript Studio Vos appli cations peuvent faire usage de ces informations dans du code Objective C ou autre que vous crirez ou dans les scripts utilisant la commande call method page 94
234. ations sur l Event keyboard up comme le ou les caract res et si les touches Commande Option Majuscule ou Controle ont t enfonc es Voir la classe event page 50 pour des exemples Discussion A cause de conflits dans la terminologie ce gestionnaire ne pouvait pas tre nomm key up launched Appel apr s que l application ait t lanc e Vous ne pouvez connecter qu un seul gestionnaire Launched l ob jet application page 29 Le gestionnaire peut ex cuter n importe quelle op ration demand e par le lancement L application lors de sa phase de lancement appelle certains gestion naires s ils sont pr sents en respectant un ordre de priorit Le gestionnaire Launched fait partie de ces gestionnaires la liste est disponible dans la des cription du gestionnaire awake from nib page 123 Syntaxe launched reference obligatoire Param tres reference La r f rence de l objet application page 29 ayant t lanc Partie II Application Suite Traduction trad applescript 23 2 2004 136 Chapitre 3 Events Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Launched un objet application page 29 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration rendue n cessaire apr s le lancement de l application ou pouvant y
235. au au besoin avec la commande show page 118 ou en r glant sa propri t visible sur true une fois qu une fen tre Partie II Application Suite Traduction trad applescript 23 2 2004 84 Chapitre 1 Classes est lib r e vous devrez cr er une autre instance partir de son fichier nib pour l utiliser de nouveau sheet Acc s lecture uniquement Classe boolean La fen tre est elle une feuille sheet C est dire attach e une autre fen tre size Acc s lecture criture Classe point La taille de la fen tre la taille est repr sent e par une liste de deux nombres horizontal vertical par exemple 200 100 indiquerait une largeur de 200 et une hauteur de 100 voir la propri t bounds pour plus d informations sur le syst me des coordonn es title Acc s lecture criture Classe Unicode text Le titre de la fen tre visible Acc s lecture criture Classe boolean La fen tre est elle visible Par d faut cette propri t vaut true pour la fen tre principale mais false pour les fen tres suppl mentaires que vous ajouterez dans Interface Builder vous pouvez r gler cette valeur dans Interface Builder voir la propri t released when closed pour des informations de m me nature r gler la propri t hidden d un objet application page 29 sur true r glera la propri t visible de toutes ses fen tres sur false moins que la propri t can hide vau
236. aussi glisser d poser une image sur un bouton e 0e EN MainMenu nib Instances Classes Mimages Sounds Nib FIG 2 5 L image de l icone de l application dans l onglet Images de la fen tre MainMenu nib dans Interface Builder Vous pouvez ajouter des images vos applications en glissant d posant un fichier image sur le panneau Images d une fen tre Nib dans Interface Builder ou en glissant d posant une liste de fichiers image sur le panneau Users amp Groups dans le projet Xcode de l application Vous pouvez alors utiliser la commande load image page 100 pour charger une image et la classe image view page 285 pour l afficher Pour plus d informations sur la facon de lib rer une image page 58 voir la section Discussion de la commande load image page 100 Partie II Application Suite Traduction trad applescript 23 2 2004 60 Chapitre 1 Classes Events support s par les objets de la classe Image Bien que vous puissiez dans Interface Builder glisser d poser une image dans une image view page 285 vous ne pourrez pas connecter de gestion naires d Events une image Exemples Pour des exemples sur le travail avec un objet image voir la classe image view page 285 item Pluriel items H rite de personne Classe Cocoa aucune Fournit une classe parent avec les propri t s name et ID beaucoup d autres classes Depuis la version 1 3 d AppleScript Stud
237. aut cette propri t vaut 0 windows menu Acc s lecture criture Classe menu page 495 Le menu Fen tre de l application par d faut le menu Fen tre mis en place par Interface Builder contient Minimize Masquer la fen tre et Bring All to Front Items Tout ramener au premier plan dans une application active il liste aussi toutes les fen tres ouvertes de l application l ments des objets de la classe Application Un objet application peut contenir les l ments list s ci dessous Votre script peut pour la plupart les sp cifier avec les formes cl s d crites dans Les formes cl s standards page 15 Consulter la section Version de cette classe pour conna tre les modifications et les ajouts survenus depuis la version 1 0 d AppleScript Studio Partie II Application Suite Traduction trad applescript 23 2 2004 34 Chapitre 1 Classes data source page 386 Sp cifier par Les formes cl s standards page 15 Les objets data source de l application document page 457 Sp cifier par Les formes cl s standards page 15 Les documents de l application drag info page 477 Sp cifier par Les formes cl s standards page 15 l usage interne et exclusif d AppleScript Studio event page 50 Sp cifier par Les formes cl s standards page 15 L Event en cours le dernier Event extrait de la file d attente des
238. autrement il appelle l application Finder pour obtenir le nombre to tal d l ments de l l ment Si ce total est sup rieur 1 il r gle isExpandable sur true e retourne isExpandable on item expandable theObject outline item outlineltem set isExpandable to false if outlineltem is O then if count of diskNames is greater than 1 then set isExpandable to true end if else tell application Finder if count of items of get item outlineltem is greater than 1 then set isExpandable to true end if end tell Partie V Data View Suite Traduction trad applescript 23 2 2004 434 Chapitre 3 Events end if return isExpandable end item expandable item value Appel par un objet outline view page 392 pour obtenir la valeur d un l ment Le gestionnaire retournera la valeur g n ralement sous la forme d une cha ne de caract res devant tre affich e de l l ment sp cifi Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet outline view dans ce cas ce gestionnaire n est pas utile ou appel Pour les objets outline view qui n utilisent pas une data source ce ges tionnaire est appel une fois pour chaque ligne affich e dans chaque colonne Par exemple si l objet outline view affiche la hi rarchie d un syst me de fichiers dans trois colonnes une pour le nom une autre pour la date de mo dification et une autre pour la taille de ch
239. autres fen tres avant de r pondre celle ci L illustration 9 5 montre un message d alerte affich en tant que feuille par l application Display Alert distribu e avec AppleScript Studio Syntaxe display alert Unicode text obligatoire afterwards calling n importe facultatif alternate button Unicode text facultatif as une constante facultatif attached to window facultatif default button Unicode text facultatif message Unicode text facultatif other button Unicode text facultatif Traduction trad applescript 23 2 2004 Partie IX Panel Suite display alert 541 OSO Display Alert Close Do you want to save changes to this document AR Corte SD Other Button Don t Save Type Warning A x Informational My sat Critical Button Returned Display Alert M As Sheet FIG 9 5 Un message d alerte affich en tant que feuille par la commande Dis play Alert Param tres Unicode text Le titre du message afficher dans l alerte peut tre une cha ne de caract res vide afterwards calling n importe Non support e dans la version 1 3 d AppleScript Studio la r f rence du script lancer lorsque l alerte est finie alternate button Unicode text Le titre du bouton alternatif as une des constantes de alert type page 174 Le type d alerte attached to window La fen tre laquelle attacher l alerte default button Unicode text Le
240. autres exemples voir la section Exemples de la classe bundle page 38 Partie II Application Suite Traduction trad applescript 23 2 2004 116 Chapitre 2 Commandes register R pertorie l objet sp cifi pour recevoir les op rations de gliss s dans le sens glisser d poser Pour qu un objet puisse r pondre n importe quel gestionnaire de Glisser D poser d crits dans le chapitre Events page 481 s de la par tie Drag and Drop Suite page 475 vous devez r pertorier les types de gliss que l objet pourra accepter Vous ferez cela avec la commande Re gister en utilisant le param tre drag type pour fournir la liste des types de pasteboard drag d sir s Les types de pasteboard possibles sont list s dans la classe pasteboard page 64 Syntaxe register reference obligatoire drag type list facultatif Param tres reference La r f rence de l objet r pertori pour recevoir les gliss s drag type list Les types de pasteboard drag que l objet acceptera doivent tre pr sents pour tre r pertori pour les gliss s enregistrer une liste vide videra le pasteboard et emp chera les gliss s Exemples Le gestionnaire awake from nib page 123 suivant r pertorie deux types de gliss s string et file names pour l objet auquel il est connect Vous pourriez par exemple utiliser ce gestionnaire pour r pertorier les types de gliss s d un objet t
241. ave vse ease eevee eee reverent 475 Menu Darbe A EE 493 Be E A e e ee ee 4 511 Plugin Suite ce a a VA eG ee ha da a Ka a n eG dA e a a aan 557 Bl te nonca NEMNE RENEE 567 Le chapitre num rations page 173 de Application Suite page 27 liste les diff rentes constantes mises la disposition de toutes les suites Ce que ce guide contient Ce guide d crit la terminologie fournie par AppleScript Studio ver sion 1 3 disponible depuis la version 10 3 de Mac OS X Panther Il liste chaque terme de la terminologie d AppleScript Studio et indique ceux qui ne sont pas support s par les versions ant rieures Pour plus d informations sur les versions d AppleScript Studio voir Information sur les versions page 8 Ce guide tente aussi de r pertorier les diff rences de terminologie entre les versions 1 0 1 1 et 1 2 d AppleScript Studio en fournissant une section Version pour la terminologie ajout e ou modifi e depuis la version 1 0 Si une classe une commande un Event ou une numeration n a pas de section Version cela signifie que cette terminologie est disponible et inchang e depuis la version 1 0 d AppleScript Studio Voir aussi Information sur les versions page 8 La plupart des classes utilis es dans les scripts AppleScript Studio comme les classes application page 29 view page 229 button page 254 et autres sont construites respectivement partir des classes Cocoa sui vantes N
242. avec des caract res blancs l ments des ob jets de la classe Secure Text Field Cell Un objet secure text field cell peut uniquement contenir les l ments qu il h rite de la classe text field cell page 330 Exemples L instruction suivante modifie la propri t echos bullets d un objet secure text field cell Par d faut les caract res sont masqu s par des ronds Lorsque les ronds sont d sactiv s les caract res sont masqu s par des caract res blancs set echos bullets of cell of secure text field 1 of window 1 to false slider Pluriel sliders H rite de control page 280 Classe Cocoa NSSlider Affiche une rang e de valeurs et comporte un indicateur ou poign e lequel indique le r glage courant Partie IV Control View Suite Traduction trad applescript 23 2 2004 316 Chapitre 1 Classes Un objet slider peut facultativement comporter une graduation L utili sateur d placera la poign e le long de la barre de l objet slider pour modifier le r glage L objet slider d termine automatiquement s il doit tre horizontal ou vertical gr ce sa taille Si l objet slider est plus large qu il est grand il sera horizontal Dans les autres cas il sera vertical Un slider vertical a sa valeur minimale en bas un slider horizontal l a sa gauche L illustration 4 12 montre des objets slider verticaux et horizontaux avec diff rentes sortes de poign es et avec et sans graduation
243. ay sell x c e so a a an R ges he ee ges aug dur will display item cell 2 44 4 se 4 6b de o d e d teste will display outline cell VI Document Suite 1 Classes document lt lt s d os ns E e We dis mine wa Ae E 2 Events data representation load data representation REA trem PIE v a Le 4 LA UE LE 4h set E p re DELLE to Ble lt a dois bee ee de de R TE eee e due 4 VII Drag and Drop Suite 1 Classes MASIA aa e k Gs Bo Ne Na ee LS Pe we ee RAD 2 Events concluida TBS gs LL de 4 LL Lu au a MARRANT UE WAG a dos gun ed a pe eau qu ae Go Due A A a drag entered e s 6 4 ma ea ba de she De aus We aka MR MES 26 ew hee de Lu AN FRANS Du raz IE 2 Le a EU HS RE we Be Ha we Nu she 16074 453 457 457 465 465 467 469 470 473 477 ATT Table des Mati res MOG G 4 nue dun af A 18 a dit HE eS SE e SH n bd 486 REA GIO A p i a AU A IR au A ah als 488 VIII Menu Suite 491 1 Classes 495 WA ace A dus Du ee de io nee 495 TIED ee ee ke ee we eee Pewee hee Eee eee 499 2 Events 505 Choose menu itemi ee ee eee de 505 update menu Held 2 4 4 2 608 6 rss a oari 506 IX Panel Suite 509 1 Classes 513 alert reply o 44 a er ans LR ON ge es RR ee Oe af ne 513 colorpan l s ce 2 4 da ns ss Ae ee me AUX EA a 4 514 dialog tapeo dianas EM e A i T at ae ESE a aA 518 TOPANEL sois a
244. basique pouvant avoir son propre contour et son propre titre Vous pouvez utiliser un objet box pour visuellement regrouper d autres views ou pour servir comme simples s parateurs L illustration 3 1 montre plusieurs objets box comprenant une bo te vide une bo te contenant deux boutons radio et des bo tes utilis es comme s parateur vertical et horizontal Dans Interface Builder vous trouverez les separator boxes dans le panneau Cocoa Controls parmi divers boutons 198 Chapitre 1 Classes et champs texte tandis que les containers boxes sont dans le panneau Cocoa Containers parmi divers objets views Voir la classe scroll view page 213 pour plus d informations sur la mani re de mettre les objets dans les sous views d un objet box ou d autres views dans Interface Builder 0068 Window Box Box Radio O Radio FIG 3 1 Des boxes utilis s comme s parateur horizontal et vertical Propri t s des objets de la classe Box En plus des propri t s qu il h rite de view page 229 un objet box poss de ces propri t s border rect Acc s lecture uniquement Classe bounding rectangle Les limites du contour une liste de quatre nombres gauche bas droite haut les objets box ont leur propre syst me de coordonn es aussi les valeurs de gauche bas seront toujours gales 0 0 voir la propri t bounds de la classe window page 76 pour plus d infor mation
245. bien que cela soit toujours support pour la compatibilit avec les versions plus anciennes Si vous sp cifiez un nom identificateur plut t qu un nom AppleScript un objet table column il devra correspondre au nom de l objet data column page 376 de votre data source Autrement depuis la version 1 1 d Apple Script Studio aucune donn e ne sera fournie pour que l objet data column soit dessin La propri t data cell de cette classe n est pas support e dans la ver sion 1 3 d AppleScript Studio table header cell Pluriel table header cells H rite de text field cell page 330 Classe Cocoa NSTableHeaderCell Utilis pour un objet table header view pour dessiner les en t tes de ses colonnes Pour plus d informations voir table header view page 402 ainsi que Table Views dans la documentation Cocoa Propri t s des objets de la classe Table Header Cell Un objet table header cell poss de uniquement les propri t s qu il h rite de la classe text field cell page 330 Events support s par les objets de la classe Table Header Cell Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Vous ne scripterez g n ralement pas un objet table header cell lequel n ajoute rien sa super classe text field cell page 330 ni propri t s ni l ments Partie V Data View Suite Traduction trad applescript 23
246. bjet browser supporte les gestionnaires r pondant aux Events sui vants Action clicked page 348 Browser view number of browser rows page 436 will display browser cell page 446 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Partie V Data View Suite Traduction trad applescript 23 2 2004 370 Chapitre 1 Classes View bounds changed page 243 Exemples L instruction suivante montre comment r gler la propri t path separator d un objet browser nomm browser dans une fen tre nomm e main set path separator of browser browser of window main to Cette instruction est extraite du gestionnaire launched page 135 de l application Browser distribu e avec AppleScript Studio Le gestion naire complet est list dans la section Exemples de la commande update page 119 Travailler avec les objets browser view est une t che complexe ne pouvant pas tre couverte en d tails ici L application Browser fournit
247. ble column d termine les limites en hauteur et en largeur la possibilit de redimensionner et d diter ses colonnes dans les objets table view ou outline view Il stocke aussi deux objets cell le header cell lequel est utilis pour dessiner l en t te de la colonne et son objet data cell page 372 utilis pour dessiner les valeurs de chaque ligne Lorsque vous ins rez un objet table view ou outline view dans Inter face Builder la view contient automatiquement un objet table column pour chaque colonne Si les objets table view ou outline view utilisent un objet data source page 386 vous devrez sp cifier soit un nom identificateur soit un nom AppleScript pour chaque colonne Pour plus d informations voir la propri t identifier et la section Version de cette classe Important Assurez vous bien que les noms AppleScript que vous avez assign s aux objets table column dans Interface Builder sont identiques aux propri t s name des objets data column de la data source de l objet table view Pour plus d informations voir les classes table header cell page 401 et table header view page 402 ainsi que Table Views dans la documentation Cocoa Traduction trad applescript 23 2 2004 Partie V Data View Suite table column 399 Propri t s des objets de la classe Table Column Un objet table column poss de ces propri t s data cell Acc s lecture criture Classe data cell page 372 Non
248. c OS X Building Applications With AppleScript Studio disponible dans l aide de Project Builder L l ment view fut ajout dans la version 1 1 d AppleScript Studio outline view Pluriel outline views H rite de table view page 403 Classe Cocoa NSOutlineView Une view qui utilise un format de lignes et de colonnes pour afficher des donn es hi rarchis es pouvant tre d velopp es ou contract es comme des r pertoires et des fichiers dans un syst me de fichiers L utilisateur pourra d velopper et contracter les lignes diter les valeurs et redimensionner et r organiser les colonnes L illustration 5 4 montre un objet outline view affichant une hi rarchie de fichiers et de dossiers Vous trouverez l objet outline view dans le panneau Cocoa Data d In Traduction trad applescript 23 2 2004 Partie V Data View Suite outline view 393 Name Size Date Modified v DIN IIIZ Jaturuady sep D cores 264 Friday Septer Desktop DB 106496 Friday Septer Desktop DF 167250 Wednesday S gt Desktop Folder 264 Wednesday S b dev 512 Wednesday S Y Developer 330 Saturday Sep gt Applications 942 Friday Septer w Documentation 398 Saturday Sep b Carbon 602 Monday Aug wv Cocoa 466 Saturday Sep Cocoa idx 2277376 Monday July cocoa html 6085 Wednesday CocoaTopics html 25119 Tuesday July gt DevEnvGuide 264 Wednesdav A Fic 5 4 Un objet outline view terface Builder Vous pouv
249. cation qu une application Partie IX Panel Suite Traduction trad applescript 23 2 2004 546 Chapitre 2 Commandes AppleScript Studio l int rieur d un bloc tell application comme dans l exemple suivant o le Finder est destinataire du dialogue on clicked theUbject tell application Finder set theReply to display dialog Please click a button buttons Hello Goodbye OK default button Goodbye giving up after 10 with icon stop display dialog button returned of theReply end tell end clicked Voir la section Discussion pour plus d informations sur la mani re d afficher un dialogue comme une feuille attach une fen tre Pour un exemple plus complexe voir l application Display Dialog distribu e avec AppleScript Studio ainsi que la section Exemples de la classe dialog reply page 518 Discussion Lorsque vous affichez un dialogue ind pendant l ex cution du script s arr te jusqu ce que le dialogue soit renvoy l ex cution reprend alors l instruction suivant imm diatement l instruction display dialog Lorsque vous affichez un dialogue en tant que feuille attach a une fen tre l ex cution du script continue et l instruction suivante est ex cut e imm diatement Cela peut conduire une certaine confusion Pour reprendre le contr le lorsque l utilisateur a renvoy le dialogue vous installerez un ges tionnaire dialog ended page 552 comm
250. celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois la mise jour faite on updated theUbject Perform operations here after the object is updated end updated Traduction trad applescript 23 2 2004 Partie II Application Suite was miniaturized 159 was hidden Appel apr s que l objet application page 29 ait t cach soit avec le menu Masquer l Application du menu Application ici Application remplace le v ritable nom de l application ou en appuyant sur les touches Cmd H Vous ne pouvez pas connecter ce gestionnaire un objet window page 76 bien que vous puissiez utiliser la commande hide page 99 pour cacher une fen tre Votre application peut explicitement appeler des com mandes comme Hide mais lorsque vous connecterez des gestionnaires comme Was Hidden aux objets les gestionnaires seront appel s par AppleScript Studio au moment appropri Syntaxe was hidden reference obligatoire Param tres reference La r f rence de l objet application page 29 ayant t cach Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Was Hid den un objet application page 29 AppleScript Studio ajoute automati quement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois l objet applica
251. cette Partie II Application Suite Traduction trad applescript 23 2 2004 54 Chapitre 1 Classes information pour d terminer quelles actions il doit ex cuter on mouse down theObject event theEvent if option key down of theEvent then log the option key was used else log the option key wasn t used end if end mouse down Le gestionnaire mouse down page 137 suivant utilise la propri t time stamp pour d terminer si l utilisateur a double cliqu Bien s r vous pour riez juste connecter un gestionnaire double clicked page 349 l objet si vous n avez pas besoin de ce niveau de contr le Ce gestionnaire utilise une propri t pour garder une trace de l heure laquelle est survenu le premier Event l initialisant avec la constante missing value pour indiquer qu elle n est pas r gl e Il est suppos dans cet exemple que deux clics fait en moins d une seconde constitue un double clic Comme la valeur de la propri t time stamp est au format real vous risquez d obtenir une mesure du temps en fraction de secondes property lastTimeStamp missing value on mouse down theObject event theEvent if lastTimeStamp is missing value then set lastTimeStamp to time stamp of theEvent else if time stamp of theEvent lastTimeStamp lt 1 then display alert You double clicked else set lastTimeStamp to time stamp of theEvent end if end if end mouse down font Pluriel fonts H ri
252. cette propri t s appelait file name avant la version 1 2 d AppleScript Studio prompt Acc s lecture criture Classe Unicode text Le message a afficher dans le bouton par d faut par d faut Save ou Enregistrer pour la version fran aise comme dans l illustration 9 4 required file type Acc s lecture criture Classe Unicode text Sp cifie l extension devant tre ajout e aux fichiers s lectionn s n ayant pas d j cette extension une extension comme rtf ou txt n inclut pas le point commen ant l extension title Acc s lecture criture Classe Unicode text Le titre du panel Save as dans l illustration 9 4 treat packages as directories Acc s lecture criture Classe boolean Faut il que le panel traite les packages comme des r pertoires Dans Mac OS X une application est packag e comme un bundle ou un r pertoire dans le syst me de fichiers qui stocke le code ex cutable et les ressources en relation avec ce code package est quelque fois utilis comme un synonyme de bundle si cette propri t est r gl e sur false le panel d enregistrement montrera le contenu d un bundle plut t que de l afficher comme s il s agissait d un fichier l ments des ob jets de la classe Save Panel Un objet save panel peut uniquement contenir les l ments qu il h rite de la classe panel page 526 Partie IX Panel Suite Traduct
253. cette propri t vaut 65535 65535 65535 ou la couleur blanche vous pouvez la r gler dans la fen tre Info d Interface Builder draws background Acc s lecture criture Classe boolean Faut il que la cellule dessine son fond Vous pouvez r gler cette pro pri t dans la fen tre Info d Interface Builder text color Acc s lecture criture Classe RGB color La couleur du texte une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur rouge pourra tre repr sent e par 65535 0 0 par d faut cette propri t vaut 0 0 0 ou la couleur noire vous pouvez la r gler dans la fen tre Info d Interface Builder Events support s par les objets de la classe Text Field Cell Un objet text field cell supporte les gestionnaires r pondant aux Events suivants Action clicked page 348 Nib awake from nib page 123 Exemples Vous ne scripterez g n ralement pas un objet text field cell Vous pouvez la place scripter les propri t s identiques d un objet text field page 325 background color draws background et text color Toutefois si vous avez besoin d acc der aux propri t s d un objet text field cell vous pouvez le faire avec les instructions suivantes set textFieldCell to cell 1 of matrix 1 set myColor to background color of textFieldCell Partie IV Control View Suite Traduction trad applescript 23 2 2004
254. ch la fen tre c t du bouton Display Save Panel se trouve une case cocher inti tul As Sheet Elle permet de choisir si le panel d enregistrement doit tre attach ou non la fen tre Si la case est coch e le panel d enregistrement sera attach la fen tre et appara tra l cran en sortant de sous la barre de titre de la fen tre comme un store qui descend pour l ouverture et qui remonte pour la fermeture De plus si votre fen tre a une largeur inf rieure celle du panel d enregistrement vous aurez droit l effet g nie comme un Traduction trad applescript 23 2 2004 Save Panel 587 g nie qui sort de sa lampe idem pour la fermeture effet garanti Si la case n est pas coch e le panel ne sera pas attach la fen tre de l application et sera affich dans une fen tre part Vous pourrez d placer la fen tre du panel mais elle sera toujours au dessus de celle de l application et vous ne pourrez pas modifier le contenu de l application tant que vous n aurez pas renvoy le panel en cliquant soit sur le bouton Enregistrer soit sur le bouton Annuler 000 Save Panel Save As A Save As Sample f Required File 3 Where nicolas 5 Dir File Cancel Save a al Path Name Fic 12 9 Le panel d enregistrement affich dans une fen tre 4 part Traduction trad applescript 23 2 2004 Index A ab
255. chacune GOD ia Ee Hoek Soe WO oe do oe ne Da 417 OTE Lan 55 30 bin we D A Ee ma date 420 append Ajoute la liste fournie une liste de listes ou une liste d enregistrements l objet data source page 386 Les donn es de chaque liste ou enregistrement fournissent le contenu pour les cellules d une seule ligne de la data source Cette commande fournit un m canisme simple mais tr s efficace pour l ajout de donn es la data source associ e avec une view comme un objet outline view page 392 ou table view page 403 Si vous fournissez une liste d enregistrements la commande Append es saiera de faire correspondre les tiquettes de chaque enregistrement avec les identificateurs des objets data column page 376 Pour chaque tiquette correspondant un identificateur elle ins rera les donn es de ce champ dans la colonne correspondante Si aucune tiquette de l enregistrement ne correspond avec l identificateur d une colonne cette colonne restera vide Si vous fournissez une liste de listes la commande Append fera cor respondre les l ments de chaque liste avec la colonne correspondante par 418 Chapitre 2 Commandes index C est dire que les donn es du premier l ment vont dans la premi re colonne etc Syntaxe append data source obligatoire with list obligatoire Param tres data source page 386 La data source laquelle doit venir s ajouter les donn es with list
256. changement de s lection on selection changing theObject Perform operations here in response to changing selection end selection changing should begin editing Appel avant que l dition ne commence Le gestionnaire peut retourner false pour annuler l dition Les classes comme text field page 325 et text view page 569 supportent ce gestion naire Voir aussi begin editing page 346 et should end editing page 354 Syntaxe should begin editing reference obligatoire object n importe facultatif Partie IV Control View Suite Traduction trad applescript 23 2 2004 354 Chapitre 3 Events Param tres reference La r f rence de l objet dont le gestionnaire Should Begin Editing est appel object n importe L objet text field page 325 ou text view page 569 qui fera l dition R sultats boolean Retournera true pour autoriser le d marrage de l dition false pour pr venir l dition Exemples L exemple suivant de gestionnaire Should Begin Editing appelle le ges tionnaire isltemEditable crit par vous pour d terminer s il doit autoriser l dition commencer puis retourne la valeur appropri e Vous pourriez la place ex cuter des tests dans le gestionnaire lui m me ou v rifier une propri t on should begin editing theObject Check property perform test or call handler to see if OK to edit set allowEditing to isItemEditable the0bject return allowEditing end s
257. chiers dans le syst me de fichiers path separator Acc s lecture criture Classe Unicode text La cha ne de caract res utiliser comme s parateur pour les chemins par d faut cette propri t est r gl e sur le caract re slash reuses columns Acc s lecture criture Classe boolean Faut il que l objet browser r utilise ses colonnes Par d faut cette propri t vaut true signifiant que l objet browser n est pas libre de sauter la colonne suivante lorsque les colonnes sont d charg es selected cell Acc s lecture criture Classe browser cell page 370 La cellule courante s lectionn e selected column Acc s lecture criture Classe integer L index de la colonne courante s lectionn e send action on arrow key Acc s lecture criture Classe boolean Faut il que l objet browser ex cute des actions lorsqu il re oit une entr e avec les fl ches de direction separates columns Acc s lecture criture Classe boolean Faut il que les colonnes soient s par es par des bordures Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder mais uniquement si vous avez d coch la case Is titled title height Acc s lecture uniquement Partie V Data View Suite Traduction trad applescript 23 2 2004 368 Chapitre 1 Classes Classe real La hauteur du titre titled
258. classes color panel page 514 et font panel page 520 sont bas es sur des classes Cocoa qui descendent de NSPanel Pour plus d informations voir la commande display page 537 ainsi que Windows and Panels dans la documentation Cocoa Propri t s des objets de la classe Panel En plus des propri t s qu il h rite de la classe window page 76 un objet panel poss de cette propri t floating Acc s lecture criture Classe boolean Le panel est il un panel flottant l ments des objets de la classe Panel Un objet panel peut uniquement contenir les l ments qu il h rite de la classe window page 76 Commandes support es par les objets de la classe Panel Votre script peut envoyer les commandes suivantes un objet panel close panel page 535 display page 537 display panel page 547 Traduction trad applescript 23 2 2004 Partie IX Panel Suite panel 527 Events support s par les objets de la classe Panel Un objet panel supporte les gestionnaires r pondant aux Events sui vants Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Panel alert ended page 551 dialog ended page 552 panel ended page 553
259. color La couleur de fond de l objet table view une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur rouge pourra tre repr sent e par 65535 0 0 par d faut 65535 65535 65535 ou la couleur blanche vous pouvez la r gler dans la fen tre Info d Interface Builder clicked column Acc s lecture uniquement Classe integer L index de la colonne ayant t cliqu e pour d clencher un gestion naire d Events cette propri t vaut 0 si aucun Event ne survient la valeur retourn e de cette m thode est significative uniquement dans les gestionnaires clicked page 348 et double clicked page 349 clicked data column Acc s lecture uniquement Classe data column page 376 L objet data column ayant t cliqu vous permet d obtenir directe ment l objet data column cliqu et de prendre en consid ration ses caract ristiques de tri retourne rien si aucune colonne n avait t cliqu e aussi vous devrez acc der cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 clicked data row Acc s lecture uniquement Classe data row page 384 Traduction trad applescript 23 2 2004 Partie V Data View Suite table view 407 L objet data row ayant t cliqu vous permet d obtenir directement l objet data row et de prend
260. column page 442 should select item page 443 should select row page 444 should selection change page 445 will display cell page 447 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Outline View change item value page 427 Traduction trad applescript 23 2 2004 Partie V Data View Suite outline view 397 child of item page 428 item expandable page 432 item value page 434 number of items page 437 should collapse item page 440 should expand item page 441 will display item cell page 449 will display outline cell page 450 Table View cell value page 424 change cell value page 426 number of rows page 439 View bounds changed page 243 Exemples Le script suivant montre comment identifier un objet outline view et lui envoyer une commande update page 119 tell outline view outline of scroll view scroll of window main to update Travailler avec les objets outline view est une t che complexe ne pou vant pas tre cou
261. comprendre Partie IV Control View Suite Traduction trad applescript 23 2 2004 268 Chapitre 1 Classes highlighted Acc s lecture criture Classe boolean La cellule est elle illumin e image Acc s lecture criture Classe image page 58 L image de la cellule image position Acc s lecture criture Classe une des constantes de cell image position page 177 La position de l image dans la cellule imports graphics Acc s lecture criture Classe boolean Faut il que les graphiques soient import s integer value Acc s lecture criture Classe integer La valeur du contenu au format entier 0 si le contenu ne peut pas tre interpr t au format entier key equivalent Acc s lecture uniquement Classe Unicode text Le raccourci clavier de la cellule voir la description de cette propri t dans la classe button page 254 menu Acc s lecture criture Classe menu page 495 Le contexte du menu de la cellule s il y a mouse down state Acc s lecture uniquement Classe integer L tat de la souris lorsqu elle a t cliqu dans la cellule Traduction trad applescript 23 2 2004 Partie IV Control View Suite cell 269 next state Acc s lecture criture Classe integer L tat suivant de la cellule opaque Acc s lecture uniquement Classe boolean La cellule est elle opaque scrollable Acc s lecture
262. cript de l application Unit Converter distribu e avec AppleScript Studio vous trouverez le gestion naire updateUnitTypes Ce gestionnaire montre comment supprimer tous les l ments d un menu popup et les remplacer par de nouveaux lorsque vous avez besoin de mettre a jour ses l ments on updateUnitTypes tell box 1 of window Main Traduction trad applescript 23 2 2004 Partie IV Control View Suite popup button 305 Delete all of the menu items from the pop ups delete every menu item of menu of popup button From delete every menu item of menu of popup button To Add each of the unit types as menu items to both of the pop ups repeat with i in my unitTypes make new menu item at the end of menu items of menu of popup button From with properties title i enabled true make new menu item at the end of menu items of menu of popup button To with properties title i enabled true end repeat end tell end updateUnitTypes Vous pouvez obtenir l l ment de menu courant d un popup button avec cette instruction current menu item of popup button 1 of window 1 Vous pouvez r gler l l ment de menu en cours d un popup button avec cette instruction set current menu item of popup button 1 of window 1 to menu item 2 of menu of popup button 1 of window 1 Vous pouvez obtenir l index de l l ment de menu s lectionn dans un popup button avec cette instruction set currentIndex to cont
263. ct au gestionnaire La plupart des classes qui h ritent des classes control page 280 et view page 229 supportent le gestionnaire Mouse Entered Syntaxe mouse entered reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Mouse Entered est appel event event page 50 Les informations d Events de l Event mouse entered Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Mouse Entered un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique a celui qui suit on mouse entered theUbject event theEvent Add script statements here to handle the mouse entered event end mouse entered Vous pouvez utiliser le param tre theEvent pour obtenir des informa tions sur 1 Event mouse entered comme l emplacement du curseur de la souris et si les touches Commande Option Majuscule ou Controle ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples mouse exited Appel lorsqu un Event mouse exited sortie du curseur de la souris survient et qu il peut affecter l objet Partie II Application Suite Traduction trad applescript 23 2 2004 140 Chapitre 3 Events C est dire que le curseur est sorti des limites de l objet connect au ges tionnaire La plupart des classes qui h ritent des classes control page 280 et v
264. d finit un grand nombre d Events et de com mandes pour travailler avec les Events Application Fen tre Souris Clavier etc Les classes commandes Events et num rations de la suite Application sont d crits dans les chapitre suivants PELS A 2 vs oe orador be Dw ae we ee eu de 29 COMARES nude de da 93 Events 4 44 4444444 eee ei eee tebe been eens 121 Chapitre 1 Classes La suite Application d finit les classes suivantes ABDUCADIO 1 ds pue use d humeur 29 bile re ge Los sua dame ER SS 38 MAGA aaa SSS AEG EK 45 default entry ossos 4 44 44444 ee 45 OVEN cok a ee ao den ee we A ee a aS 50 POU ol a ea ele Bek ech we EO 54 formatter lt a dou du a we ee Ra we SS 56 WARE A 58 RORE a a RS ec ed a a E 4 60 MOVIE co gee a ee a A er V dE 4 63 PASS ss o ke ee d ae aia OR ea a de 64 responder 42 4 4 4 344 ebb 8 4 eee eh a 68 o ue du Dia done idees 70 UBer defatlltS oe 2 47 das nue De ha 72 MAN pue a e RAA Len NE ANR SEE 76 application Pluriel applications H rite de responder page 68 Classe Cocoa NSApplication 30 Chapitre 1 Classes G re la boucle principale d Events d un objet application ainsi que les ressources utilis es par tous les objets de l application La fonction principale d un objet application est de recevoir les Events et de les distribuer aux objets appropri s pouvant y r pondre typiquement les sous classes view
265. d page 325 vous r glerez la propri t first responder de sa fen tre sur cet objet par exemple vous pourriez utiliser l instruction suivante pour d signer comme receveur de la saisie du clavier un champ texte nomm myText set first responder of window 1 to text field myText of window 1 Les instructions suivantes r glent la couleur de fond d une fen tre sur le vert puis rendent cette nouvelle couleur visible Partie II Application Suite Traduction trad applescript 23 2 2004 90 Chapitre 1 Classes set background color of window main to 0 65535 0 tell window main to update Le script suivant montre comment r gler l image minimis e d une fen tre Le script choisit d abord un fichier image puis charge l image et r gle alors l image minimis e de la fen tre tell application StudioTest set imagePath to POSIX path of choose file set minImage to load image imagePath set minimized image of window 1 to minImage end tell Discussion L empilement des fen tres d pend du rang de chacune les fen tres de rang sup rieur sont affich es devant celles de rang inf rieur les fen tres de m me rang peuvent tre affich es l une devant l autre ou inversement mais elles ne peuvent pas tre affich es derri re une fen tre de rang inf rieur Dans la version 1 3 AppleScript Studio ne d finit plus de constantes pour r gler le rang des fen tres mais une alternative ex
266. d if Load the new image set newlmage to load image item imagelndex of imagePaths Get a reference to the old image if there is one set oldImage to image of image view image of window main Set the new image set image of image view image of window main to newlmage Delete the old image use try block in case no image try delete oldImage end try end if end if Return 2 to call idle routine again in 2 seconds return 2 end idle Partie II Application Suite Traduction trad applescript 23 2 2004 104 Chapitre 2 Commandes Version Dans la version 1 0 d AppleScript Studio la commande Load Image ne chargeait pas les images externes au projet de l application Maintenant de puis la version 1 1 cette limitation est d pass e et Load Image charge n im porte quelle image pourvu que l on fournisse son chemin POSIX d limit par des slashs Les chemins obtenus grace la classe bundle page 38 sont ce format Vous pouvez obtenir le chemin POSIX d un fichier ou d un alias en uti lisant la commande path to et la propri t POSIX path fournies dans le compl ment de pilotage d AppleScript StandardAdditions osax Par exemple set thePath to path to desktop result alias MacOSX Users BigCat Desktop set POSIXpath to POSIX path of thePath result Users BigCat Desktop Vous pouvez examiner la terminologie des Compl ments Stan dards d AppleScript Studio en ouvrant le
267. d informations sur la fen tre cl voir les descriptions des propri t s key et main de la classe window page 76 Depuis la version 1 2 d AppleScript Studio vous pouvez utiliser la pro pri t properties pour acc der aux propri t s de la plupart des objets d AppleScript Studio Cette caract ristique est maintenant disponible gr ce la nouvelle version de Cocoa distribu e avec Mac OS X version 10 2 Le script suivant montre comment afficher les propri t s d un bouton dans une application AppleScript Studio tell application simple Partie I Introduction Traduction trad applescript 23 2 2004 18 Chap 2 Les bases de la terminologie properties of button 1 of window 1 end tell Le r sultat de ce script pourra tre quelque chose comme ce qui suit o missing value indique qu une valeur pourrait ne pas tre obtenue pour une certaine propri t visible true content false double value 0 0 ignores multiple clicks false title Button image missing value name missing value bordered true enabled true window window id 1 of application TestingControls allows mixed state false float value 0 0 image position no image string value 0 id 2 flipped true roll over false opaque false alternate image missing value bounds 47 45 131 77 bounds rotation 0 0 tag 0 class button alignment center text alignment enclosing scroll view missing value can draw true menu missing value target
268. dans System Library Sounds Dans cet exemple vous n avez pas besoin de sp cifier le chemin complet du fichier son car Interface Builder fournit un acc s direct aux sons syst me dans l onglet Sounds de la fen tre MainMenu nib on clicked theObject set volume 1 volume level goes from 0 silent to 7 full volume set theSound to load sound Sosumi play theSound end clicked Si vous souhaitez sp cifier le chemin complet du fichier son vous pouvez utiliser l instruction suivante set theSound to load sound System Library Sounds Sosumi aiff Traduction trad applescript 23 2 2004 Partie II Application Suite localized string 109 Ce gestionnaire clicked ne lib re pas le son qu il charge Pour plus d in formations sur la lib ration des objets charg s voir la section Discussion de la commande load image page 100 Notes La commande Load Sound est apparue avec la version 1 1 d AppleScript Studio Avant la version 10 2 de Mac OS X et 1 2 d AppleScript Studio vous pouviez uniquement jouer un son 16 bit et non un son 8 bit et uniquement des fichiers son ayant l extension aiff localized string Charge la cha ne de caract res de la cl sp cifi e depuis un fichier strings un fichier avec l extension strings Syntaxe localized string string obligatoire from table Unicode text facultatif in bundle bundle facultatif Param tres string Le nom de la cl sp cifiant la c
269. devra retourner la valeur de la cellule sp cifi e La mani re recommand e pour manipuler les donn es d un objet table view ou outline view est d utiliser un objet data source page 386 dans ce cas ce gestionnaire n est pas utile ou appel Syntaxe cell value reference obligatoire row integer obligatoire table column table column obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 contenant la cellule row integer La ligne bas e sur 1 de la cellule table column table column page 398 La colonne de la cellule R sultats n importe La valeur de la cellule de la ligne et de la colonne sp cifi es Si vous impl mentez ce gestionnaire vous devrez obligatoirement retourner une valeur Traduction trad applescript 23 2 2004 Partie V Data View Suite cell value 425 Exemples Le gestionnaire Cell Value suivant est extrait de l application Table distribu e avec AppleScript Studio Il se trouve dans le fichier script WithoutDataSource applescript L autre mani re de travailler avec les tableaux recommand e par Apple est pr sent e dans le fichier script WithDataSource applescript Ce gestionnaire e initialise la valeur retourn e avec une cha ne vide e v rifie la validit du num ro de ligne e si le num ro existe r ellement utilise l identificateur de la colonne pour d terminer le champ afin d y obtenir la valeur de la ce
270. divers attributs des l ments de menu dans la fen tre Info d Interface Builder Depuis la version 1 3 d AppleScript Stu dio vous pouvez aussi utiliser make new pour cr er de nouveaux l ments de menu dans un script comme l indique la description de la classe menu page 495 Pour plus d informations sur les menus voir Application Menus et Pop up Lists dans la documentation Cocoa Propri t s des objets de la classe Menu Item Un objet menu item poss de ces propri t s Partie VIII Menu Suite Traduction trad applescript 23 2 2004 500 Chapitre 1 Classes associated object Acc s lecture criture Classe item page 60 L objet associ avec l l ment de menu enabled Acc s lecture criture Classe boolean L l ment de menu est il actif Vous pouvez connecter un gestionnaire update menu item page 506 cet l ment de menu pour obtenir son contr le qu il soit actif ou inactif has sub menu Acc s lecture uniquement Classe boolean L l ment de menu a t il un sous menu image Acc s lecture criture Classe image page 58 L image de l l ment de menu par d faut aucune image n est assign e un menu key equivalent Acc s lecture criture Classe Unicode text Le raccourci clavier pour s lectionner l l ment de menu par d faut aucun raccourci n est sp cifi pour les l ments de menu ajout s dans Interface Builder mais v
271. ds afin de pouvoir l utiliser plus tard avec le gestionnaire will zoom page 169 Syntaxe should zoom reference obligatoire proposed bounds bounding rectangle facultatif Param tres reference La r f rence de l objet window page 76 qui pourrait tre agrandie proposed bounds bounding rectangle Les limites demand es pour l objet devant tre agrandie une liste de quatre nombres gauche bas droite haut voir la propri t bounds de la classe window page 76 pour des informations sur le syst me des coordonn es Traduction trad applescript 23 2 2004 Partie II Application Suite shown 157 R sultats boolean Retournera false pour interdire le zoom ou true pour l autoriser Si vous impl mentez ce gestionnaire vous devrez toujours retourner une valeur bool enne true ou false Exemples L exemple suivant de gestionnaire Should Zoom appelle le gestionnaire isZoomable crit par vous pour d terminer s il doit autoriser l agrandisse ment puis retournera la valeur appropri e Si vous voulez acc der aux limites demand es dans le gestionnaire will zoom page 169 vous devrez utiliser Should Zoom pour enregistrer la valeur du param tre proposed bounds pour un usage ult rieur on should zoom theUbject Check property perform test or call handler to see if OK to edit set allowZooming to isZoomable theUbject return allowZooming end should zoom Version Le param tre proposed bou
272. du guide Inside Mac OS X Building Applications With AppleScript Studio qui d crivent com ment construire l application Mail Search laquelle est aussi distribu e avec AppleScript Studio Partie V Data View Suite Traduction trad applescript 23 2 2004 392 Chapitre 1 Classes Version Le support des Events de glisser d poser est apparu dans la version 1 2 d AppleScript Studio Le tri des objets data source est apparu avec la version 1 2 d AppleScript Studio Les propri t s localized sort sort column et sorted furent ajout es dans la version 1 2 d AppleScript Studio Les applications Table Sort et Task List furent ajout es dans la version 1 2 d AppleScript Studio La m thode conseill e et plus convenable pour utiliser une data source est de la cr er et de l assigner directement dans le script de l application comme le montre la section Exemples de la commande append page 417 ou de la classe data item page 379 Cette option fut ajout e dans la ver sion 1 1 d AppleScript Studio Avant cette version vous deviez utiliser un processus plus encombrant d ajout et de connexion de la data source avec votre application dans Interface Builder Notez que si vous souhaitez connecter un gestionnaire awake from nib page 123 une data source vous devrez ajouter et connecter la data source dans Interface Builder Les tapes pour le faire sont d crites dans Inside Ma
273. e Script Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra faire n importe quelle pr paration requise par l affichage de la cellule sp cifi e on will display cell theObject row theRow cell theCell table column tableColumn Prepare for cell to be displayed end will display cell Traduction trad applescript 23 2 2004 Partie V Data View Suite will display item cell 449 will display item cell Appel avant qu une donn e soit affich e dans un objet outline view page 392 par cons quent afficher la donn e de l l ment et de la colonne sp cifi s Ce gestionnaire ne pourra pas annuler l op ration d affichage mais peut la pr parer Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet outline view dans ce cas ce gestionnaire n est pas utile ou appel Syntaxe will display item cell reference obligatoire cell n importe obligatoire outline item item facultatif table column table column obligatoire Param tres reference La r f rence de l objet outline view page 392 contenant l l ment devant tre affich cell n importe La cellule qui est sur le point d tre affich e voir cell page 264 image cell page 284 et text field cell page 330 outline item item page 60 L l ment contenant la cellule qui sera affich e table column table colu
274. e color panel de la propri t color panel de l objet application page 29 Avant la version 1 1 d AppleScript Studio cette classe avait des fonctions limit es dialog reply Pluriel dialog replies H rite de personne Classe Cocoa ASKDialogReply La r ponse de la commande display dialog page 543 Un objet dialog reply est identique dans le concept la classe dialog reply d finie dans le compl ment de pilotage osax Standard Additions d AppleScript fichier StandardAdditions osax dans System Library ScriptingAdditions Voir aussi display dialog page 543 et dialog ended page 552 Propri t s des objets de la classe Dialog Reply Un objet dialog reply poss de ces propri t s Cette classe n est pas acces sible dans Interface Builder aussi vous ne pourrez pas y r gler ses propri t s vous devrez le faire dans un script button returned Acc s lecture uniquement Classe Unicode text Le nom du bouton choisi vide si le param tre giving up after tait renseign et que le temps imparti pour la r ponse coul Traduction trad applescript 23 2 2004 Partie IX Panel Suite dialog reply 519 gave up Acc s lecture uniquement Classe boolean Le temps imparti pour le dialogue est il coul pr sent uniquement si le param tre giving up after a t utilis dans l appel de la com mande display dialog page 543 text returned Acc s lecture uniqu
275. e 173 de Application Suite page 27 une description de l num ration une description de chaque constante de l num ration version si nouveaut ou modification depuis la version 1 0 La terminologie fournie par le framework Cocoa Application Les applications AppleScript Studio peuvent tirer profit de la termino logie de Cocoa accessible depuis deux suites par d faut e La Standard Suite d finit les classes de base comprenant Application Document et Window bien qu AppleScript Studio d finit ses propres versions pour ces classes dans Application Suite page 27 d finit la terminologie des Events de base comprenant Get Set Count Delete Print Quit et autres Dans les applications Cocoa dont le support du scripting est actif les objets peuvent supporter certaines commandes importantes comme Get et Set avec un peu ou pas du tout de code d veloppeur suppl mentaire e La Text Suite d finit les classes fonctionnant avec le texte comme les classes Character Paragraph Word et Text Pour plus d informations sur le travail avec le texte voir la section Exemples de la classe text view page 569 Partie I Introduction Traduction trad applescript 23 2 2004 14 Chap 2 Les bases de la terminologie Important Le framework Cocoa application fournit des suites par d faut pour supporter le scripting des applications Cocoa Bien que les applications AppleScript Studi
276. e 29 Apr s la cr ation du nouvel objet default entry elle utilise une autre instruction tell pour logger le contenu de l inscription modifier son contenu puis logger ce nouveau contenu on awake from nib theUbject tell user defaults targets property of application make new default entry at end of default entries with properties name test contents testing tell default entry test log contents as string set contents to completed log contents as string end tell end tell end awake from nib Le gestionnaire pr c dent produira en g n ral les logs suivants 2002 08 12 13 46 32 260 Test3 477 testing 2002 08 12 13 46 32 340 Test3 477 completed Pour d autres exemples voir user defaults page 72 Discussion Le contenu d un objet default entry est au format Unicode Text comme la valeur retourn e par la commande localized string page 109 Vous pou vez avoir besoin de convertir le format Unicode en texte brut par exemple si une commande d une autre application demande du texte brut ou pour envoyer une cha ne de caract res comme True ou False une valeur bool enne Le gestionnaire suivant extrait de l application SOAP Talk distribu e avec AppleScript Studio montre comment convertir de l Unicode en texte brut L application SOAP Talk convertit les cha nes de caract res en texte brut car la commande call xmlrpc d AppleScript n accepte 1 Uni code qu
277. e 350 end frame constante 183 entry type propri t 267 error return constante 174 event l ment 34 classe 50 event number propri t 52 event type num ration 181 propri t 52 excluded from windows menu propri t 80 executable path propri t 39 expanded propri t 530 exposed VE A F ts Onde ue bebe 131 F field editor propri t 571 file kind propri t 461 file name propri t 460 file type propri t 461 first responder propri t 80 first visible column propri t 365 flags changed type constante 181 flipped propri t 231 596 Index float value propri t 267 281 floating propri t 526 font classe 54 propri t 267 281 521 572 font panel propri t 31 font panel classe 520 formatter classe 56 propri t 267 282 frameworks path propri t 39 G gave up propri t 519 go commande 334 go to num ration 183 gray bezel
278. e 417 Events support s par les objets de la classe Data Source Un objet data source supporte les gestionnaires r pondant aux Events suivants Nib awake from nib page 123 Vous pouvez connecter un gestionnaire awake from nib un objet data source uniquement si vous cr ez la data source dans Interface Builder pas si vous la cr ez dans le fichier script l approche recommand e Toutefois il est peu probable que vous ayez besoin de connecter ce gestionnaire un objet data source Voir la description de cette classe plus haut pour plus d informations sur la cr ation d un objet data source dans Interface Builder Exemples Pour des exemples montrant comment cr er un objet data source voir les sections Exemples de la commande append page 417 et de la classe data item page 379 Partie V Data View Suite Traduction trad applescript 390 Chapitre 1 Classes Lorsque vous modifiez les donn es d une data source dans une view vi sible les performances risquent probablement de souffrir de la mise jour continue de la view par la data source Vous pouvez assurer des performances optimales en d sactivant la mise jour le temps que vous modifiez la data source puis vous la r activez de nouveau lorsque vous avez fini Les lignes suivantes montrent comment faire cela Turn off updating set update views of theDataSource to false Add statements here that modify the data source Turn upda
279. e AA MR ae Ge Re eS NE 50 LE o US A A oe E Ad RO es 54 DOM TER iaa a e Va Mad a e be EE eS 56 o oko ue en A oe 4e 58 IE hae an ote Phe te a ke Bee ee El ee ee A 60 MAS Shy Boar te Sn ae A gee Ste el AA een A 63 pasteboard av da sua eee Gada oe ak BS EM be wee 4 64 YespOonder Lau na ba 5424 pe ko Ree te eae ee E 68 OMT ok Sk ae Re Ge ee ee ae a ce ia 70 US r defaults soe c a 24 e aca Rb Be a de 8 E eS 72 patet o MA r T 76 Commandes 93 call method os usos ess M REE SR a ee du ho 94 Eu sui ua aoe De LAS INR SENS EME ee BX 98 Fide toraa sg dk ee te REESE A EE site 99 ce La Lean ia Be HR ae er ee 100 load MOVIE os us a sbc danse a R G ge at pese Soe 104 loal DAE o e ay tisane e ss RR IR ee ARMES EME 106 ROME 25 LA A ae de a 107 l calized SmE o 5 3 16 ee Li r G pute a en SAP she 109 RC ne e AE VRATA ne A 111 PALE TON A ee BE him at ait are 112 TORNS Lies E ben ms Ets dark blog Mia abus 116 BEE LS RER NN A ee ae ee we 117 Table des Mati res s lect all ocios h 6 8 6 REPS SEEDERS Ee 117 o ee howe Bho Be He Bae eek Bia LA Aces Be Bale 118 size to DE 245 4G Aw a ae hee oe A E a ue 119 iste Liste ee eee AP REG ELEM SE AOS Gee ES 119 3 Events 121 BONAR gt na m hears PSs gle RR 123 awake ve vu mi ke be ate Lda he Dek he d a 48 123 became HEY ss sin ee Pk a a a a A Rt a aus 127 DECAam main o scos o La eR ee R E 8 ee 128 o oc ack ee Ree eR Oe ee Ada a oe ae dE 1
280. e Button Un objet button supporte les gestionnaires r pondant aux Events sui vants Action clicked page 348 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Traduction trad applescript 23 2 2004 Partie IV Control View Suite button 259 Exemples AppleScript Studio permet d acc der plusieurs types d objets button et les applications distribu es avec AppleScript Studio comportent de nom breux exemples de travail avec ces objets L instruction suivante montre une partie de la terminologie de base utilisable avec les boutons Dans la plupart des cas vous utiliserez un bouton pour d clencher une action dans un gestionnaire clicked page 348 Le gestionnaire clicked sui vant extrait de l application Currency Converter distribu e avec Apple Script Studio ex cute juste la conversion mon taire bas e sur les valeurs saisies par l utilisateur et affiche le r sultat Le param tre theObject du gestionnaire clic
281. e Load Script font partie du compl ment de pilotage fourni avec AppleScript cet osax est normalement situ dans le dossier System Library ScriptingAdditions Si le script choue il affiche le num ro et le message d erreur retourn s AppleScript fournit la constante missing value pour remplacer les infor mations manquantes property mainScriptPath missing value property theScript missing value on clicked theObject set mainScriptPath to path for script Application extension scpt try log mainScriptPath log the result set theScript to load script POSIX file mainScriptPath Other statements here to work with the script on error errMsg number errNum Deal with any error in getting path first log to console log Error loading script amp Error amp errNum amp Msg amp errMsg For user related error can display a dialog display dialog Error amp errNum amp errMsg end try end clicked Ce qui suit est un message possible de log g n r lorsqu une erreur sur vient ici le fichier script n existait pas aussi la variable mainScriptPath n a pas pu tre r gl e 2002 10 30 16 56 44 697 on error test 512 Error loading script Error 2753 Msg The variable mainScriptPath is not defined Si vous n tes pas int ress par le num ro et le message d erreur ou que vous n aviez pas pr vu les valeurs retourn es vous pouvez juste utiliser on error Pour d
282. e a ee 188 tab view type 188 text ASE o o ane a L da du da ma dues 189 tick mark position 44 4 4 54 80555 4a ae axe 190 HE POSTION LL 2 85544 24 be i ORAS ER Eee 190 alert return values Non utilis es dans la version 1 3 d AppleScript Studio Constantes alternate return Le bouton sur deux retourn default return Le bouton retourn par d faut error return L erreur retourn e other return L autre bouton retourn alert type Sp cifie le niveau d alerte Vous transmettrez une de ces valeurs la commande display alert page 540 Traduction trad applescript 23 2 2004 Partie II Application Suite bezel style 175 Constantes critical Alerte critique informational Alerte informative warning Avertissement bezel style Sp cifie l apparence du contour La propri t bezel style d un objet button page 254 sera r gl e avec l une des valeurs list es ci dessous Constantes circular bezel Contour circulaire pour un bouton rond regular square bezel Contour carr r gulier pour un bouton carr rounded bezel Contour arrondi pour un bouton avec un bord arrondi shadowless square bezel Contour carr ombr pour un bouton carr thick square bezel Contour carr pais pour un bouton carr thicker square bezel Contour carr plus pais pour un bouton carr border type Sp cifie le type
283. e ancienne version d Apple Script Studio puisse fonctionner avec une version plus r cente du run time e une application cr e et construite avec une version r cente d Apple Script Studio puisse fonctionner avec une version plus ancienne du runtime toutefois si cette application n utilise pas les nouvelles ca ract ristiques introduites par les versions plus r centes Par exemple une application construite avec AppleScript Studio 1 1 et utilisant des caract ristiques introduites par cette version requiert le run time 1 1 Toutefois la m me application mais n utilisant pas les nouvelles caract ristiques d AppleScript Studio 1 1 pourra fonctionner avec le run time 1 0 Et une application construite avec AppleScript Studio version 1 0 pourra fonctionner avec n importe quel runtime travers la version 1 8 Important Une application cr e avec AppleScript Studio version 1 2 ne fonctionnera pas en g n ral avec les versions plus anciennes du runtime m me si elle n utilise pas les nouvelles caract ristiques de la version 1 2 Cela a t corrig dans la version 1 2 1 d AppleScript Studio Le tableau 1 1 page 9 liste pour chaque version d AppleScript Studio l environnement de d veloppement correspondant et le syst me Mac OS X minimum pour faire fonctionner une application AppleScript Studio Si vous voulez savoir comment une application peut d terminer si la version requise d AppleScript Studio est pr se
284. e depuis AppleScript 1 9 Traduction trad applescript 23 2 2004 Partie II Application Suite default entry 49 on getPlainText fromUnicodeString set styledText to fromUnicodeString as string set styledRecord to styledText as record return class ktxt of styledRecord end getPlainText L extrait suivant montre comment obtenir le contenu d un objet default entry appelle getPlainText pour le convertir en texte brut et envoie le r sultat une valeur bool enne Vous pouvez utiliser une instruction iden tique pour convertir une chaine num rique en nombre Le bloc try on error g re les possibles erreurs lors de l obtention du contenu des ins criptions set tempString to contents of default entry openFile of user defaults try set shouldOpen to getPlainText tempString as boolean if shouldOpen then Do whatever is needed to open else Do what is needed when shouldOpen is false end on error display dialog Error getting should open value end Comme alternative la conversion obligatoire de l Unicode en texte brut vous pouvez comparer directement le texte comme dans cet exemple set shouldOpen to contents of default entry openFile of user defaults try if shouldOpen is equal to true then Do whatever is needed to open else Do what is needed when shouldOpen is false end on error display dialog Error getting should open value end Partie II Application Suite Traduction t
285. e des constantes de rectangle edge page 186 Le bord de la fen tre sur lequel le tiroir est attach leading offset Acc s lecture criture Classe real Pour un tiroir qui s ouvre sur le bord gauche ou droit la distance entre le bord sup rieur de la fen tre et le bord sup rieur du tiroir Pour un tiroir qui s ouvre sur le bord sup rieur ou inf rieur la distance entre le bord gauche de la fen tre et le bord gauche du tiroir Si leading offset vaut 0 le bord droit ou sup rieur en fonction du c t choisi pour l ouverture du tiroir est au m me niveau que le bord de la fen tre si vous lancez l application Drawer visible dans l illus tration 3 2 vous pourrez ajuster leading offset pour voir le tiroir se d placer en relation avec la fen tre maximum content size Acc s lecture criture Classe point La taille maximale du content view du tiroir la taille est exprim e sous forme d une liste de deux nombres horizontal vertical identique la propri t content size plus haut minimum content size Acc s lecture criture Classe point La taille minimale du content view du tiroir la taille est exprim e sous forme d une liste de deux nombres horizontal vertical identique la propri t maximum content size plus haut parent window Acc s lecture criture Classe window page 76 La fen tre associ e au tiroir Traduction trad applescript 23 2 200
286. e des fichiers s lectionn s devant tre ouverts chaque nom est un chemin POSIX d limit par des slashs l ments des ob jets de la classe Open Panel Un objet open panel peut uniquement contenir les l ments qu il h rite de la classe panel page 526 Partie IX Panel Suite Traduction trad applescript 23 2 2004 524 Chapitre 1 Classes Commandes support es par les objets de la classe Open Panel Votre script peut envoyer les commandes suivantes un objet open panel display page 537 display panel page 547 Events support s par les objets de la classe Open Panel Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire d une application AppleScript Studio peut se r f rer la propri t open panel de l objet application page 29 sans avoir sp cifier l application comme dans l instruction suivante laquelle obtient la liste des chemins POSIX des fichiers choisis dans le panel Ouvrir set fileList to path names of open panel Une application pourra utiliser le gestionnaire clicked page 348 sui vant pour indiquer l utilisateur de choisir un dossier Ce gestionnaire r gle d abord les propri t s du panel Ouvrir de l objet application page 29 afin de ne sp cifier qu un dossier ou r pertoire Notez que vous n avez pas besoin de sp cifier implicitem
287. e entered 139 mouse exited 139 Monse movel p oos ee eu eg Ke eu 4 140 MOUSE UP cso 02 an de ap R bee et me og ee ue es 141 122 Chapitre 3 Events MOVEL 2 os a dou de ant T e AT a 8 3 142 a L Hu Se Lans E b 8 de si ete 143 pen Untitled cocineros sms des 143 T signed ACLIV lt c sso 8 4 6 da 4 8 co 8 pesa wi 145 resigned key ccoo au du due eh a a posd na 145 DESILHEA MAA i srs dau nee DE ae 146 DA a ne da dou ve de ne G ne E d l 147 right mouse down 2 42450 8 be eae A E ua 147 right mouse dragged 149 Tight MOUSE UD 24 a Se we A 150 gorol ee sae Bak Ah Sle DE AN Soe Pk ae ees 151 shoul Glope oo ek Au hr PR re ee 151 SOUL open o e a Lis D Le ae TAD D AM EE date 152 should open untitled 153 should QU gt s 2256448544264 8554 6 sad 154 should quit after last window closed 155 should ZOM caia a Ee 156 CHOW ic eee E E Re Re Re 157 updated L ee Re ame oa ae ee eee 158 WAS MGM be croatas 159 was miniaturized 159 will become active 160 Will eloge e sec ho ua es Oe G din dant a 161 will finish launching 161 GUS SE ee LULU a a ER RENTE 163 FU TMU ACTA E 22 Lu Jur LU Au Lu Dar 0 30 8 164 TL THON Le a dr Bok eH a d di e T l HA a 164 MUGEN oy no se ee a a Ba 1
288. e le montre l application Display Dialog distribu e avec AppleScript Studio Lorsque vous affichez un dialogue ind pendant si l utilisateur appuie sur le bouton Annuler la commande Display Dialog g n rera une erreur Annul par l utilisateur aussi votre script devra utiliser un bloc try on error galement montr dans l application Display Dialog pour g rer cette erreur Lorsque vous affichez un dialogue attach une fen tre votre gestion naire Dialog Ended peut traiter l annulation comme un autre bouton Traduction trad applescript 23 2 2004 Partie IX Panel Suite display panel 547 Version Depuis la version 1 1 d AppleScript Studio vous pouvez transmettre un nombre la commande display dialog page 543 sans avoir le mettre au format string comme dans l instruction suivante o amount et rate ont t pr c demment d finis comme tant des valeurs num riques display dialog amount rate Pour un autre exemple l instruction suivante affiche un dialogue minimal avec seulement les boutons Annuler et Ok contenant le chiffre 10 et se fermant tout seul au bout de 3 secondes si l utilisateur ne r pond pas display dialog 10 giving up after 3 display panel Affiche le panel sp cifi Non recommand e depuis la version 1 2 d AppleScript Studio Il est pr f rable d utiliser la commande display page 537 la place Les pa ram tres o
289. e pouvez pas connecter ce gestionnaire un objet window page 76 bien que vous puissiez utiliser la commande hide page 99 pour cacher une fen tre Votre application peut explicitement appeler des com mandes comme Hide mais lorsque vous connecterez des gestionnaires comme Will Hide aux objets les gestionnaires seront appel s par AppleScript Studio au moment appropri Syntaxe will hide reference obligatoire Param tres reference La r f rence de l objet application page 29 qui va tre cach Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Hide un objet application page 29 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer le masquage de l application on will hide theObject Perform operations here before the application hides end will hide Partie II Application Suite Traduction trad applescript 23 2 2004 164 Chapitre 3 Events will miniaturize Appel lorsqu un objet supportant ce gestionnaire comme une fen tre ou un panel est sur le point d tre r duit Le gestionnaire ne peut pas annuler l op ration de r duction mais peut la pr parer Syntaxe will miniaturize reference obligatoire Param tres reference La r f rence de l objet qui va tre r duit Exemples Lorsque vous connectez dans Interface Builder u
290. e secure text field cell page 314 L illustration 4 11 montre un champ s curis avec plusieurs ronds vi sibles Vous pouvez cr er un objet secure text field dans Interface Builder en suivant ces tapes 1 Glissez un objet text field page 325 du panneau Cocoa Text sur la fen tre vis e 2 S lectionnez ce text field 3 Dans le panneau Custom Class de la fen tre Info s lectionnez NS Secure TextField comme type de classe eee _ Window Enter Password seesesees Encrypt File FIG 4 11 Un champ s curis affichant des ronds Pour plus d informations voir la description des classes text field cell page 330 et secure text field cell page 314 ainsi que Text fields dans la documentation Cocoa Propri t s des objets de la classe Secure Text Field Un objet secure text field poss de uniquement les propri t s qu il h rite de la classe text field page 325 l ments des objets de la classe Secure Text Field Un objet secure text field peut uniquement contenir les l ments qu il h rite de la classe text field page 325 Traduction trad applescript 23 2 2004 Partie IV Control View Suite secure text field 313 Events support s par les objets de la classe Secure Text Field Un objet secure text field supporte les gestionnaires r pondant aux Events suivants Action action page 345 Glisser D poser conclude drop page 481 drag page 483 drag entered page
291. e support des Events suivants fut ajout data representation page 465 load data representation page 467 read from file page 469 et write to file page 470 e Vous ne pourrez pas connecter un gestionnaire will open page 165 a un document Toutefois vous pourrez connecter ce gestionnaire a la fen tre du document voir le prochain l ment e L l ment window page 76 fut ajout la classe Document afin de fournir l acc s aux l ments d interface associ s avec le document Partie VI Document Suite Traduction trad applescript 23 2 2004 464 Chapitre 1 Classes Notez que comme window est un l ment adressable par le nom le num ro d index ID etc et non une propri t l instruction window of document 1 retournera une liste telle que window id 1 De plus window est synonyme de windows pour un l ment e Notez aussi que l l ment document fut ajout la classe window page 76 pour que les l ments d interface des fen tres ayant un do cument associ puissent y acc der Traduction trad applescript 23 2 2004 Partie VI Document Suite Chapitre 2 Events Les objets bas s sur les classes de la suite Document supportent les ges tionnaires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestion naire appropri devant tre ex cut Vous utiliserez ces gestionnaires avec les
292. eScript Studio l application Mail Search s appelait Watson end editing Appel avant que l dition ne se finisse Vous utiliserez g n ralement ce gestionnaire avec les objets text field page 325 text view page 569 ou autres Le gestionnaire ne peut pas annuler la fin de l dition mais peut la pr parer Pour plus d informations voir begin editing page 346 Syntaxe Traduction trad applescript 23 2 2004 Partie IV Control View Suite selection changed 351 end editing reference obligatoire Param tres reference La r f rence de l objet text field page 325 text view page 569 ou autres pour lequel l dition se finira Exemples Lorsque vous connectez dans Interface Builder un gestionnaire End Edi ting un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer la fin de l dition on end editing theUbject Perform operations here before editing stops end end editing selection changed Appel apr s que la s lection d un objet change Le gestionnaire peut ex cuter des actions en r ponse au changement de s lection G n ralement utilis avec les data views comme browser page 363 outline view page 392 ou table view page 403 Par exemple lorsque l utilisateur clique pour s lectionner une nouvelle rang e dans un objet outl
293. eScript Studio mais vous n aurez pas besoin du bloc tel1 tell application myApp Traduction trad applescript 23 2 2004 Partie II Application Suite pasteboard 67 pasteboards end tell Ce qui suit obtiendra les types d un pasteboard tell application myApp types of pasteboard general end tell Le gestionnaire awake from nib page 123 suivant extrait de l applica tion Drag and Drop livr e avec AppleScript Studio utilise la commande register page 116 pour d clarer les drag types auxquels un objet peut r pondre on awake from nib theUbject Enable support by registering the appropriate types tell theObject to register drag types string rich text file names end awake from nib Depuis la version 1 3 d AppleScript Studio vous pouvez utiliser la pro pri t preferred type pour r gler le contenu d un pasteboard comme avec les instructions suivantes In case the default wasn t already string set preferred type of pasteboard general to string Now put a string on the pasteboard set contents of pasteboard general to Testing Pour des exemples suppl mentaires voir l application Drag and Drop Discussion Vous pouvez utiliser au choix les propri t s content ou contents sauf l int rieur d un gestionnaire d Events contents of theUbject retour nant la r f rence de l objet plut t que son contenu Pour obtenir le contenu d un ob
294. eUbject Traduction trad applescript 23 2 2004 Partie III Container View Suite will resize sub views 247 return allowSelection end should select tab view item L application Assistant disponible depuis la version 1 1 d AppleScript Studio inclut un gestionnaire Should Select Tab View Item qui examine chaque panel avant de d cider s il doit autoriser une modification dans l on glet s lectionn will resize sub views Appel lorsque les sous views d un objet view page 229 sont sur le point d tre redimensionn es Le gestionnaire ne peut pas annuler le redimensionnement mais peut le pr parer Syntaxe will resize sub views reference obligatoire Param tres reference La r f rence de l objet view page 229 dont les sous views sont sur le point d tre redimensionn es Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Re size Sub Views un objet view page 229 AppleScript Studio ajoute auto matiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer les sous views tre redimensionn es Par exemple vous pourriez enregistrer la taille courante des sous views on will resize sub views theUbject Perform any operations to prepare for resizing of subviews end will resize sub views Partie III Container View Suite Traduction trad applescript 23 2 2004 248 Ch
295. ead 386 OU IME VIEW a he eek Me Ca E ce au Hie a ee Be 392 table COMIDA l c a 64 e624 E ge ee dee ede See 398 table header cell o ce x 4 4 soep e 4 406 ee ken ha ae R 401 table header VIER io ek a B RD Bee ou ue pur ee Be 402 HOBIE VIO eka ah a ee eee eR ee ba hy we Bad 403 Commandes 417 ee gs eae res Bee he ae te a A 417 WH TOF i pk ha bad Be ed vas de Dee we eB A RB Se et 420 Events 423 cell VANE i used 54h da Ne GENE eS Ge Has 424 change cell value ce 444 406 R 4 8 uses up 426 change Mema Value acs oi oe mi da note bee by at dia 427 child OF item r sd bis due EA M R a Re m e bis pie 428 columa elle ova a oe OP Re EU RE 430 COMMIT moved o 4 aus La dau 8 4 ses due RE HS 430 column resized o 4 4 4 4 da die 6 de 4 bu de 431 item expandable o oe s 45h 4 40 ra 4 6 BR pu pe 432 VOL VALUE xo l 4 ha moe Dame dia s ame a 4 434 number of browser rows 436 TUM DEE D WenS oco su a a a OR diras 437 Table des Mati res XI number OF TOWS c ce aosa boaa hE D Ha A us au Should collapse TOM avs ue bin koe a Ah gibis Du La Should expand Meni sasos La La A pes abuse da should select column v 4 ea Le Las PARA Rw te ss should Select TENN _ sc pue dut eek Glace NN ua ab aos should select TOW oa n a a 6 LA Li eR da dau sa Re da should selection change will display browser cell succre s Liu eee Rab oe will displ
296. eal La valeur alpha de la fen tre une valeur de 1 0 par d faut indique que la fen tre est compl tement opaque tandis que 0 0 indique que la fen tre est compl tement transparente l instruction suivante r gle la valeur au milieu set alpha value of window main to 0 5 associated file name Acc s lecture criture Classe unicode text Le nom du fichier associ la fen tre pour une nouvelle fen tre non enregistr e cette propri t retournera une cha ne vide pour une fen tre avec un fichier associ cette propri t retournera le chemin POSIX complet d limit par des slashs auto display Acc s lecture criture Classe boolean Affichage automatique de la fen tre Avant la version 1 2 1 d Apple Script Studio vous ne pouviez pas utiliser cette propri t dans un script background color Acc s lecture criture Traduction trad applescript 23 2 2004 Partie II Application Suite window 79 Classe RGB color La couleur de fond de la fen tre par d faut 65535 65535 65535 ou la couleur blanche non support e avant la version 1 2 d AppleScript Studio apr s le r glage de la propri t background color la nouvelle couleur ne deviendra visible qu une fois la fen tre mise jour par script ou par interaction de l utilisateur voir la section Exemples pour un exemple bounds Acc s lecture criture Classe bounding rectangle La position
297. eau de donn es Et pour faire un usage encore plus efficace de l objet data source vous pouvez r gler sa propri t update views sur false avant sa mise jour puis la r gler sur true apr s pour que la mise jour de la view associ e se fasse d un seul coup Chaque view affichant des lignes et des colonnes de donn es utilisera au maximum une seule data source Toutefois vous pouvez utiliser plusieurs views avec la m me data source si par exemple vous souhaitez insister sur diff rents aspects des donn es Puis si vous modifiez les donn es de la data source chaque view sera mise automatiquement jour afin de refl ter les nouvelles valeurs Pour des exemples montrant comment cr er un objet data source dans les scripts de votre application voir les sections Exemples de la commande append page 417 et de la classe data item page 379 Vous pouvez aussi cr er dans Interface Builder un objet data source en le glissant depuis le panneau Cocoa AppleScript Ce m canisme n est pas recommand et n est pas d crit ici mais vous pouvez le voir dans le tutoriel de l application Mail Traduction trad applescript 23 2 2004 Partie V Data View Suite data source 387 Search Building Applications With AppleScript Studio Depuis la version 1 2 d AppleScript Studio les objets data source peuvent tre tri s L objet data source retiendra encore l ordre dans lequel les lignes furent a
298. ecture uniquement 478 Chapitre 1 Classes Classe window page 76 La fen tre destinataire de l op ration de glisser image Acc s lecture uniquement Classe n importe L image gliss e image location Acc s lecture uniquement Classe point Non support e dans la version 1 3 d AppleScript Studio l emplace ment de l image gliss e l emplacement est exprim sous forme d une liste de deux nombres gauche bas voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es location Acc s lecture uniquement Classe point Non support e dans la version 1 3 d AppleScript Studio l emplace ment courant dans la fen tre destinataire de l op ration de glisser ex prim sous forme d une liste de deux nombres gauche bas chaque fen tre a son propre syst me de coordonn es avec l origine dans le coin inf rieur gauche voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es pasteboard Acc s lecture uniquement Classe pasteboard page 64 Le pasteboard contenant les donn es gliss es sequence number Acc s lecture uniquement Classe integer Non support e dans la version 1 3 d AppleScript Studio l identifica teur unique de l op ration de glisser source Acc s lecture uniquement Classe item page 60 Traduction trad applescript 23 2 2004 Par
299. eference obligatoire drag info drag info obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Drag Entered est appel drag info drag info page 477 Les informations propos de l op ration de glisser Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Drag En tered un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge Le param tre theObject r f rence l objet pour lequel un glisser potentiel est entr dans ses limites Le param tre dragInfo fournit l acc s l objet drag info page 477 contenant toutes les informations pertinentes sur l op ration de glisser on drag entered theObject drag info dragInfo Statements to deal with the drag entering end drag entered Version Le gestionnaire Drag Entered fut ajout dans la version 1 2 d AppleScript Studio drag exited Appel lorsqu un utilisateur glisse le type r pertori de donn es hors des limites de l objet Votre application pourra ne pas avoir besoin du gestionnaire Drag Exi ted tant donn que le gestionnaire drop page 486 est le seul gestionnaire requis par le support du d poser de donn es dans AppleScript Studio Syntaxe Traduction trad applescript 23 2 2004 Partie VIT Drag and Drop Suite drag updated 485 drag exited reference obligatoire drag info drag info obligatoire Param tres reference La r f rence de
300. el autorisera l utilisateur sp cifier le type de document enregistrer sous Traduction trad applescript 23 2 2004 Partie VI Document Suite write to file 471 La valeur choisie dans ce menu est la valeur transmise par le param tre of type Le contraire de Write To File est read from file page 469 Syntaxe write to file reference obligatoire of type Unicode text obligatoire path name Unicode text obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Write To File est appel of type Unicode text Le type extension du fichier path name Unicode text Le chemin au format POSIX d limit par des slashs du fichier lire Exemples L application Plain Text distribu e depuis la version 1 2 d AppleScript Studio montre comment lire et crire des fichiers texte avec les gestionnaires de bas niveau read from file page 469 et write to file page 470 Version Le gestionnaire Write To File fut ajout dans la version 1 2 d AppleScript Studio Partie VI Document Suite Traduction trad applescript 23 2 2004 Septi me partie Drag and Drop Suite Cette partie d crit la terminologie de la suite Drag and Drop d Apple Script Studio laquelle est disponible depuis la version 1 2 La suite Drag and Drop d finit les termes pour travailler avec le glisser d poser comprenant la classe drag info page 477 pour fournir les informa tions sur le glisser e
301. el couleurs choisir une couleur dans le panel couleurs r gle la couleur de l objet color well Vous trouverez l objet color well dans le panneau Cocoa Controls d In terface Builder Vous pouvez r gler les attributs d un objet color well dans la fen tre Info d Interface Builder Partie IV Control View Suite Traduction trad applescript 23 2 2004 272 Chapitre 1 Classes ODO Window Choose color FIG 4 2 Un objet color well dans une fen tre Pour des informations de m me nature voir Using Color dans la docu mentation Cocoa Propri t s des objets de la classe Color Well En plus des propri t s qu il h rite de control page 280 un objet color well poss de ces propri t s active Acc s lecture criture Classe boolean L objet color well est il actif bordered Acc s lecture criture Classe boolean L objet color well a t il une bordure color Acc s lecture criture Classe RGB color La couleur de l chantillon une liste de trois nombres entiers repr sentant chacun un composant de la couleur par exemple la cou leur rouge pourra tre repr sent e par 165535 0 0 Events support s par les objets de la classe Color Well Un objet color well supporte les gestionnaires r pondant aux Events suivants Traduction trad applescript 23 2 2004 Partie IV Control View Suite color well 273 Action clicked page 348 Clique
302. ement Classe Unicode text Le texte saisi pr sent uniquement si le param tre default answer tait renseign Events support s par les objets de la classe Dialog Reply Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire dialog ended page 552 suivant est extrait de l applica tion Display Dialog distribu e avec AppleScript Studio Cette application montre comment afficher un dialogue et obtenir des informations lorsqu il est renvoy Ce gestionnaire se fait appeler lorsque le dialogue est renvoy apr s qu il fut appel avec le param tre optionnel attached to pour qu il soit montr comme une feuille Ce gestionnaire extrait les informations partir de l objet dialog reply fourni par le param tre dialog reply et les affiche dans la fen tre de l application on dialog ended theUbject with reply theReply Set the values returned in theReply set contents of text field text returned of window main to text returned of theReply set contents of text field button returned of window main button returned of theReply set state of button gave up of window main to gave up of theReply end dialog ended to Partie IX Panel Suite Traduction trad applescript 23 2 2004 520 Chapitre 1 Classes font panel Pluriel font panels H rite de panel page 526 Classe Cocoa NSF
303. ence La r f rence de l objet dont le gestionnaire Data Representation est appel of type Unicode text Le type extension du fichier document Exemples L application Task List distribu e depuis la version 1 2 d AppleScript Studio fournit le gestionnaire suivant pour montrer le m canisme de haut niveau permettant l criture des donn es dans les fichiers Dans ce cas pr cis le gestionnaire obtient des informations de l objet data source page 386 de l objet table view page 403 affichant la liste des t ches Les informations incluent la liste des t ches le nom de la colonne courante et l ordre de tri de cette colonne Le gestionnaire retournera ces informations dans un enre gistrement lesquelles sont tout ce dont l application a besoin pour recr er l tat de la fen tre courante on data representation theObject of type ofType Set up local variables set theWindow to window 1 of theObject set theDataSource to data source of table view tasks of scroll view tasks of theWindow set theTasks to contents of every data cell of every data row of theDataSource set theSortColumn to sort column of theDataSource Create a record containing the list of tasks just a list of lists the name of the sort column and the sort order set theDataRecord to tasks theTasks Traduction trad applescript 23 2 2004 Partie VI Document Suite load data representation 467 sortColumnName name of t
304. ence obligatoire table column table column obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 table column table column page 398 La colonne qui a t cliqu e Exemples Pour un exemple de gestionnaire Column Clicked voir la section Exemples de la classe data source page 386 column moved Appel par un objet table view page 403 ou outline view page 392 apr s qu une colonne ait t d plac e comme lorsque l utilisateur m lange les colonnes Syntaxe column moved reference obligatoire new column integer obligatoire old column integer obligatoire Traduction trad applescript 23 2 2004 Partie V Data View Suite column resized 431 Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 new column integer L index de la nouvelle position de la colonne old column integer L index de l ancienne position de la colonne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Column Moved un objet table view page 403 ou outline view page 392 Apple Script Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Les param tres fournissent les index de l ancienne position et de la nouvelle position de la colonne on column moved theObject new column newColumn old column oldColumn Respond to changed column
305. ent activ Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder current menu item Acc s lecture criture Classe menu item page 499 L l ment de menu actuellement choisi preferred edge Acc s lecture criture Classe une des constantes de rectangle edge page 186 Le c t favori pour pr senter le menu sous r serve de sa position dans l cran notez que le c t pr f r sera ignor s il n y a pas assez de place pour d rouler le menu dans cette direction pulls down Acc s lecture criture Classe boolean La liste se d roule t elle sous le menu Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder Traduction trad applescript 23 2 2004 Partie IV Control View Suite popup button 303 l ments des objets de la classe Popup Button En plus des l ments qu il h rite de la classe button page 254 un objet de la classe popup button peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 menu page 495 sp cifier par Les formes cl s standards page 15 les sous menus de l objet popup button menu item page 499 sp cifier par Les formes cl s standards page 15 les l ments de menu de l objet popup button Comma
306. ent le panel Ouvrir comme appartenant l objet application on clicked theUbject set can choose directories of open panel to true set can choose files of open panel to false display open panel attached to window main end clicked Comme le gestionnaire affiche le panel comme une feuille le panel est un document modal ce qui signifie que l ex cution de l application continue apr s que le panel soit affich Aussi pour obtenir le choix de l utilisateur du panel l application a besoin d utiliser Interface Builder pour connecter un gestionnaire panel ended page 553 l objet window page 76 afin que le panel soit attach Le gestionnaire Panel Ended est appel lorsque le panel Traduction trad applescript 23 2 2004 Partie IX Panel Suite open panel 525 est renvoy Dans l exemple montr ici le gestionnaire v rifie le r sultat et s il vaut 1 un dossier a t choisi 0 indique que le panel a t annul extrait le dossier de la liste retourn e Comme mentionn au dessus le chemin du dossier est un chemin POSIX on panel ended theObject with result withResult if withResult is 1 then set theFolder to item 1 of path names of open panel as list do something with the supplied folder path end if end panel ended Si un script n attache pas le panel une fen tre le panel est affich comme une application modale et l ex cution s arr te jusqu ce que le panel soi
307. ents of popup button 1 of window 1 Vous pouvez obtenir la valeur de l l ment de menu s lectionn dans un popup button avec cette instruction set currentValue to title of popup button 1 of window 1 Vous pouvez supprimer un l ment de menu d un popup button avec cette instruction delete menu item Shrink It of menu of popup button Do Laundry of window Laundromat Partie IV Control View Suite Traduction trad applescript 23 2 2004 306 Chapitre 1 Classes Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio Depuis la version 1 2 d AppleScript Studio lorsque vous faites r f rence un objet menu d un objet popup button vous pouvez utiliser menu item 1 of popup button 1 plut t que l ancienne version plus longue menu item 1 of menu of popup button 1 bien que cette version longue fonctionne toujours progress indicator Pluriel progress indicators H rite de view page 229 Classe Cocoa NSProgressIndicator La classe progress indicator ou barre de progression fournit un m canisme standard pour les feedbacks utilisateur Combin e avec un ob jet text field page 325 elle peut fournir la fois une barre de progression d termin e le temps total est connu et la barre se d place de gauche droite proportionnellement au pourcentage de la t che accompli et ind termin e le temps total est inconnu un cylindre ray
308. er l ments des objets de la classe Text Field Un objet text field peut uniquement contenir les l ments qu il h rite de la classe control page 280 Events support s par les objets de la classe Text Field Un objet text field supporte les gestionnaires r pondant aux Events sui vants Action action page 345 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Edition begin editing page 346 changed page 348 end editing page 350 should begin editing page 353 should end editing page 354 Clavier keyboard up page 134 Souris mouse entered page 139 Traduction trad applescript 23 2 2004 Partie IV Control View Suite text field 329 mouse exited page 139 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples La plupart des applications distribu es avec AppleScript Studio montrent comment travailler avec les objets text field Par exemple l appli cation Currency Converter disponible depuis la version 1 1 d AppleScript Studio utilise l instruction suivante pour obtenir le texte de l objet text field Dans cette instruction le texte est stock dans la variable theRate o rate sp cifie le nom AppleScript de l objet text field Vous indiquerez le nom AppleScript dans le champ Name
309. er Users MyUser MyStudioLib build MyStudioLib app try tell LibBundle set scriptPath to path for script MyStudioLib extension scpt end tell log scriptPath on error log Problem getting path to MyStudio app end try end clicked Entre les exemples montr s ici et l exemple de la section Exemples de la commande path for page 112 il est possible de charger un bundle externe pour y trouver et y charger des scripts Cela signifie que vous pouvez regrouper les scripts les plus fr quemment utilis s sous une forme facilement accessible par n importe quelle application AppleScript Studio Traduction trad applescript 23 2 2004 Partie II Application Suite bundle 43 Important Lorsque vous chargez un script vous obtenez une copie de ce script y com pris une nouvelle copie de toutes ses propri t s et variables globales Apple Script Studio ne fournit pas par d faut de moyen satisfaisant pour partager les donn es entre scripts Vous pouvez la rigueur utiliser des fichiers an nexes pour lire et crire les donn es transmettre mais cette solution n est pas pratique Le script suivant fournit un exemple simple sur la mani re de faire D abord cr ez un projet AppleScript Studio dans Xcode en uti lisant un mod le AppleScript Studio Nommez l application MyStu dioLib et pour cet exemple enregistrez la dans votre dossier Uti lisateur Users yourname Dans le fichier script principal du pr
310. er browser of window main set thePath to path for column theColumn 1 end tell tell application Finder set rowCount to count of items of item thePath end tell end if end if return rowCount end number of browser rows number of items Appel par un objet outline view page 392 pour obtenir le nombre d l ments fils de l l ment sp cifi Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet outline view dans ce cas ce gestionnaire n est pas utile ou appel Partie V Data View Suite Traduction trad applescript 23 2 2004 438 Chapitre 3 Events Syntaxe number of items reference obligatoire outline item item facultatif Param tres reference La r f rence de l objet outline view page 392 contenant les l ments outline item item page 60 L l ment duquel doit tre obtenu le nombre d l ments contenus R sultats integer Retourne le nombre d l ments contenus dans l l ment sp cifi de l objet outline view Exemples Le gestionnaire Number Of Items suivant est extrait de l application Outline distribu e avec AppleScript Studio Cette application utilise un objet outline view page 392 pour afficher les l ments d un syst me de fichiers Ce gestionnaire utilise l application Finder pour compter le nombre d l ments de l l ment sp cifi Ce processus est d crit plus en d tails dans les sections Exemp
311. er si vous au torisez l utilisateur r organiser les colonnes dans la fen tre Info d Interface Builder Pour des informations de m me nature voir la classe data cell page 372 Traduction trad applescript 23 2 2004 Partie V Data View Suite data column 377 Propri t s des objets de la classe Data Column Un objet data column poss de ces propri t s voir la section Version de cette classe pour savoir dans quelle version d AppleScript Studio sont apparues certaines propri t s data source Acc s lecture uniquement Classe data source page 386 L objet data source avec laquelle est associ l objet data column name Acc s lecture criture Classe Unicode text Le nom de la colonne sort case sensitivity Acc s lecture criture Classe une des constantes de sort case sensitivity page 187 La sensibilit du tri sensible la casse ou pas sort order Acc s lecture criture Classe une des constantes de sort order page 187 L ordre du tri ascendant ou descendant sort type Acc s lecture criture Classe une des constantes de sort type page 188 Le type de tri alphab tique num rique l ments des objets de la classe Data Column Un objet data column peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15
312. erence obligatoire Param tres reference La r f rence de l objet ayant t redimensionn Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Resized a un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique a celui qui suit Vous pouvez utiliser ce gestion naire pour ex cuter toute op ration n cessaire une fois le redimensionnement accompli Pour mesurer la modification vous devrez stocker l ancienne taille de Vobjet et la comparer avec sa nouvelle taille Pour faire cela vous pouvez sauvegarder la taille dans un gestionnaire will resize page 167 lequel sera appel avant le gestionnaire Resized on resized theObject Perform operations here after resizing the object end resized right mouse down Appel lorsqu un Event right mouse down enfoncement du bouton droit de la souris survient Partie II Application Suite Traduction trad applescript 23 2 2004 148 Chapitre 3 Events Syntaxe right mouse down reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Right Mouse Down est appel event event page 50 Les informations d Events de l Event right mouse down Traduction trad applescript 23 2 2004 Partie II Application Suite right mouse dragged 149 Exemples Lorsque vous connectez dans Interface Builder un gestionn
313. ersion 1 2 d AppleScript Studio cette commande n est plus recommand e utilisez plut t la place la commande display page 537 load panel Non recommand e depuis la version 1 1 d AppleScript Studio Charge le panel sp cifi depuis le fichier nib sp cifi Syntaxe load panel reference obligatoire from nib Unicode text facultatif Traduction trad applescript 23 2 2004 Partie IX Panel Suite load panel 549 Param tres reference La r f rence de la fen tre du panel charger from nib Unicode text Le nom du ficher nib partir duquel doit tre obtenue la fen tre du panel Exemples Pour utiliser cette commande vous ins rerez la fen tre du panel dans votre fichier nib et lui fournirez un titre dans la fen tre Attributes de la fen tre Info ce n est pas son nom AppleScript le nom AppleScript est fourni dans le panneau AppleScript Vous chargerez alors le panel dans le script en sp cifiant le titre de la fen tre Par exemple tant donn une fen tre avec comme titre myWindow dans un fichier nib myNib vous pourrez alors charger une instance de cette fen tre pour l utiliser comme panel avec l instruction suivante load panel myWindow from nib myNib Version Depuis la version 1 2 d AppleScript Studio cette commande n est plus recommand e utilisez plut t la commande load nib page 106 la place Partie IX Panel Suite Traductio
314. ert choisissez UTF 8 dans le menu d roulant File Encoding Supposons que les fichiers Localized strings soient organis s comme ceci English lproj Localized strings Text for the Open button MOPEN _KEY Open Text for the Close button CLOSE _KEY Close French lproj Localized strings Text for the Open button QOPEN _KEY Ouvrir Text for the Close button CLOSE _KEY Fermer Vous pouvez alors utiliser la commande Localized String comme ceci get localized string OPEN _KEY from table Localized set theString to localized string OPEN _KEY from table Localized Traduction trad applescript 23 2 2004 Partie II Application Suite log 111 Cette instruction obtiendra alors la cha ne de caract res appropri e en fonction des pr f rences locales de l application le choix des langues se fait dans la fen tre Info rubrique Langues de l application dans le Finder s lection de l icone de l application puis Cmd I La cha ne de caract res retourn e par l appel de la commande Loca lized Strings est au format Unicode text Vous pourriez vouloir convertir cette cha ne au format texte brut par exemple pour l utiliser dans une commande d une autre application qui demande du texte brut ou pour dis tribuer la cha ne retourn e sous forme d une valeur bool enne comme true ou false Pour un exemple montrant cela voir la section Discussion
315. es icon image Acc s lecture criture Classe image page 58 L icone de l application l icone par d faut est un crayon un pinceau et une r gle plac s de fa on repr senter la lettre A Vous pouvez modifier l icone en sp cifiant un fichier icone dans Xcode commencez par s lectionner la cible courante dans la liste Groups amp Files puis ouvrez la fen tre Info avec Cmd I et choisissez l onglet Properties l vous pouvez saisir un nom de fichier dans le champ Icon Field Partie II Application Suite Traduction trad applescript 23 2 2004 32 Chapitre 1 Classes key window Acc s lecture uniquement Classe window page 76 La fen tre cl courante la cible courante des p riph riques de saisie consulter les propri t s key et main de la classe window page 76 pour plus d informations main bundle Acc s lecture criture Classe bundle page 38 Le bundle principal de l application le bundle principal est l empla cement par d faut de toutes les ressources de l application y compris les scripts compil s il est cr automatiquement par Xcode main menu Acc s lecture criture Classe menu page 495 Le menu principal de l application les l ments de menus du menu principal repr sente g n ralement d autres menus consulter la section Exemples de cette classe pour plus d informations main window Acc s lecture uniquement
316. es donn es de la colonne Zip L illustration suivante montre la s lection du contenu d une cellule du tableau afin d y apporter une modification la s lection a t faite en double cliquant avec la souris sur la cellule eee Table Sort Name City Zip Age Egypt Bart Simpson Springfield 19542 12 James Taylor Atlanta 21769 42 Joan of Ark Paris 53255 36 Ally McBiel Chicago 91544 28 FIG 12 6 S lection du contenu de la colonne City avant modification Traduction trad applescript 23 2 2004 586 Annexe Les applications distribu es avec AppleScript Studio Save Panel 6680 Save Panel Title Save As Prompt Save Required File Type txt Directory File Name Sample Treat Packages as Directories Path Name FIG 12 7 La fen tre de l application Save Panel avec les diff rents choix pos sibles Save Panel sert uniquement montrer l utilisation du panel d enregistre ment dans une application AppleScript Studio Vous pouvez r gler la plupart des propri t s d un objet open panel page 522 dans sa fen tre ainsi vous pouvez tester les diff rents r glages possibles et voir le r sultat en cliquant sur le bouton Display Save Panel 080 Save Panel Save As Sample fr Where a nicolas B Ri File Name Sample Treat Packages as Directories Path Name Display Save Panel Y As Sheet FIG 12 8 Le panel d enregistrement atta
317. est r gl e sur la couleur blanche 65535 65535 65535 label Acc s lecture criture Classe Unicode text L tiquette du tab view item vous pouvez r gler l tiquette dans In terface Builder tab state Acc s lecture uniquement Classe une des constantes de tab state page 188 L tat du tab view item tab view Acc s lecture uniquement Partie III Container View Suite Traduction trad applescript 23 2 2004 228 Chapitre 1 Classes Classe tab view page 221 Le tab view qui contient ce tab view item view Acc s lecture criture Classe view page 229 La view du tab view item sur lequel vous placez les objets d interface du tab view item Events support s par les objets de la classe Tab View Item Un objet tab view item supporte les gestionnaires r pondant aux Events suivants Nib awake from nib page 123 Exemples Le gestionnaire suivant est extrait de l application Assistant distribu e avec AppleScript Studio depuis la version 1 1 Ce gestionnaire est appel lorsque les propri t s du script ont besoin d tre mises jour depuis le contenu des objets d interface associ s au tab view item Comme le montre la premi re ligne de l instruction tell la terminologie pour acc der un tab view page 221 peut devenir tr s complexe L erreur courante avant la version 1 2 tait d omettre view of au d but de l instruction Depuis la version 1 2
318. et du script impl mentent un gestionnaire will finish launching qui appelle loadLibraryScripts lorsque l application est lanc e impl mentent un gestionnaire clicked pour montrer comment appeler un script charg votre application peut faire des appels identiques depuis son fichier script property libraryScript missing value property libScripti missing value on loadLibraryScripts set scriptPath to missing value set myLibBundle to call method bundleWithPath of class NSBundle with parameter Users yourname MyStudioLib build MyStudioLib app Log what we got for the bundle log myLibBundle Use try on error block to handle possible errors try tell myLibBundle set scriptPath to path for script MyStudioLib extension scpt end tell set libraryScript to load script POSIX file scriptPath set libScripti to makeLibScript1 of libraryScript on error log Problem getting library script end try end loadLibraryScripts on will finish launching theUbject loadLibraryScripts end will finish launching on clicked theObject tell libScript1 to acknowledgeReceipt end clicked Traduction trad applescript 23 2 2004 Partie II Application Suite data 45 Version Avant la version 1 2 1 d AppleScript Studio vous ne pouviez pas utiliser directement la propri t path dans un script pour contourner cette limita tion vous deviez utiliser la commande call method page 94 comme dans la descripti
319. et progress indicator par d faut cette propri t vaut 0 0 vous pouvez la r gler dans la fen tre Info d Interface Builder uses threaded animation Acc s lecture criture Classe boolean Faut il que l animation de l objet progress indicator soit ex cut e dans une t che s par Si l application devient multi t che suite votre volont ses performances pourraient devenir notablement plus lentes par d faut cette propri t vaut false Commandes support es par les objets de la classe Progress Indi cator Votre script peut envoyer les commandes suivantes un objet progress indicator animate page 333 Traduction trad applescript 23 2 2004 Partie IV Control View Suite progress indicator 309 increment page 336 start page 340 stop page 343 Events support s par les objets de la classe Progress Indicator Un objet progress indicator supporte les gestionnaires r pondant aux Events suivants Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples
320. etourn par le panel Exemples Le gestionnaire Panel Ended suivant est extrait de l application Save Panel distribu e depuis la version 1 1 d AppleScript Studio Vous connec terez ce gestionnaire une fen tre dans Interface Builder Alors votre ap plication appellera la commande display panel page 547 en utilisant le param tre attached to window pour attacher le panel la fen tre avec le gestionnaire Panel Ended Ce gestionnaire sera appel lorsque le panel sera renvoy on panel ended theObject with result withResult if withResult is 1 then set contents of text field path name of window main to path name of save panel else set contents of text field path name of window main to end if end panel ended L application Save Panel utilise l instruction suivante pour afficher le panel attach a la fen tre qui utilise le gestionnaire Panel Ended montr ci dessus Les parametres in directory et with file name sont facultatifs display save panel in directory theDirectory with file name theFileName attached to window of theObject Pour plus d informations voir la section Exemples de la commande display page 537 Version L application Save Panel a t distribu e pour la premi re fois avec la version 1 1 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie IX Panel Suite Dixi me partie Plugin Suite Cette partie d crit la terminologie de l
321. ets du fichier nib principal aient t cr s et initia lis s C est le bon moment pour rendre visible la fen tre principale de l ap plication ce que le gestionnaire fait en appelant la commande Show Dans cette application la fen tre principale a comme nom AppleScript main on launched theObject show window main end launched Pour sp cifier l ordre des fen tres vous utiliserez une instruction comme celle qui suit show window main in front of window settings size to fit Non support e dans la version 1 3 d AppleScript Studio Ajuste la taille de l objet sp cifi pour l adapter aux dimensions de son container Syntaxe size to fit reference obligatoire Param tres reference La r f rence de l objet redimensionner update Met jour l affichage de l objet window page 76 ou view page 229 provoquant imm diatement le redessinement de l objet Syntaxe update reference obligatoire Partie II Application Suite Traduction trad applescript 23 2 2004 120 Chapitre 2 Commandes Param tres reference La r f rence de l objet window page 76 ou view page 229 mettre jour Exemples Le gestionnaire launched page 135 suivant extrait de l application Browser distribu e avec AppleScript Studio utilise le Finder pour obtenir la liste des noms des volumes pour un objet browser page 363 r gle le d limiteur de chemin de cet objet b
322. ew 00e MainMenu nib instances Classes Images Sounds Nib ew E 7 q o E F vr F ond MainMenu eee a Window Parent Window DrawContent _ 1e NSDrawer FIG 3 4 La fen tre MainMenu nib apr s ajout d une fen tre tiroir Pour plus d informations voir Drawers dans la documentation Cocoa Traduction trad applescript 23 2 2004 Partie III Container View Suite drawer 207 ODO DrawContentView FIG 3 5 Le content view d un objet drawer tiroir Propri t s des objets de la classe Drawer En plus des propri t s qu il h rite de responder page 68 un objet drawer poss de ces propri t s content size Acc s lecture criture Classe point La taille du content view du tiroir la taille est exprim e sous forme d une liste de deux nombres horizontal vertical par exemple 200 100 indiquerait une largeur de 200 et une hauteur de 100 voir la pro pri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es content view Acc s lecture criture Classe view page 229 Le content view du tiroir d crit plus haut lequel contient toutes ses Partie III Container View Suite Traduction trad applescript 23 2 2004 208 Chapitre 1 Classes sous views pour des informations de m me nature voir la propri t content view de la classe window page 76 edge Acc s lecture uniquement Classe un
323. exemple si vous optez pour le type Temperature vous pourrez convertir des degr s Fahrenheit Traduction trad applescript 23 2 2004 584 Annexe Les applications distribu es avec AppleScript Studio en degr s Celsius si vous optez pour le type Length vous pourrez conver tir des kilom tres en yards La mise jour de ces deux menus d roulants est effectu e une fois le choix fait dans le type de mesure et elle est instantan e eee Unit Converter Type of Measure area HJ Convert From square meters HJ To square meters H Result Convert T O Clear Save As FIG 12 3 L application Unit Converter avec son tiroir ouvert Dans l illustration ci dessus vous pouvez voir le tiroir qui s ouvre sous la fen tre lorsque vous cliquez sur le bouton rond situ dans le coin inf rieur gauche Ce tiroir r capitule toutes les conversions effectu es depuis le lance ment de l application et vous permet de les sauvegarder Table Sort Table Sort sert pr senter des donn es dans un tableau ici des infor mations sur des personnes Cette application se sert d un objet data source page 386 pour stocker provisoirement les donn es des diff rentes personnes et alimenter le tableau en donn es Pour garder de mani re permanente ses donn es d un lancement un autre vous devrez r cup rer les donn es de la data source et les enregistrer dans un fichier annexe so
324. exists panelWIndow then load nib SettingsPanel set panelWIndow to window settings end if Statements for setting state of panel items not shown Now display the panel display panelWIndow attached to window main Other statements not shown end clicked L application Display Panel utilise l instruction suivante pour afficher un panel en tant qu application modale L appel de display retourne le Traduction trad applescript 23 2 2004 Partie IX Panel Suite save panel 529 nombre du bouton utilis pour renvoyer le panel et le r sultat est utilis ici dans une instruction de test if then Une valeur 0 indique que le panel a t annul 1 indique qu il a t accept if display panelWIndow is 1 then Note L application Display Panel utilise la commande display page 537 mani re recommand e pour afficher un panel plut t qu avec la commande display panel page 547 save panel Pluriel save panels H rite de panel page 526 Classe Cocoa NSSavePanel Autorise les utilisateurs sp cifier le r pertoire et le nom sous lequel un fichier doit tre enregistr La classe save panel supporte la navigation dans un syst me de fichiers et il accepte des visualisations personnalis es Pour utiliser le panel d en registrement dans les scripts de vos applications AppleScript Studio vous pouvez acc der la propri t save panel qui est associ e avec chaque objet
325. ext field page 325 on awake from nib theUbject tell theObject to register drag types string file names end awake from nib Pour plus d exemples voir l application Drag and Drop distribu e avec la version 1 2 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie II Application Suite select all 117 Version La commande Register est apparue avec la version 1 1 d AppleScript Studio mais elle ne produisait rien La commande fut rendue utilisable pour le glisser d poser avec l ajout du param tre drag type dans la version 1 2 d AppleScript Studio L application Drag and Drop fut distribu e partir de la version 1 2 d AppleScript Studio select Non support e dans la version 1 3 d AppleScript Studio S lectionne le ou les objets sp cifi s Syntaxe select reference obligatoire at index integer facultatif item item facultatif Param tres reference La r f rence de l objet ou des objets s lectionner at index integer L index de l objet s lectionner item item page 60 L objet s lectionner select all Non support e dans la version 1 3 d AppleScript Studio S lectionne tous les objets contenus dans l objet sp cifi Syntaxe select all reference obligatoire Partie II Application Suite Traduction trad applescript 23 2 2004 118 Chapitre 2 Commandes Param tres reference La r f rence de
326. ez r gler la plupart de ses attributs dans la fen tre Info d Interface Builder Bien qu AppleScript Studio fournissent des gestionnaires d Events pour g rer les donn es qu un objet outline view affiche l approche conseill e et largement plus efficace est d utiliser un objet data source page 386 Pour plus d informations sur les objets outline view voir Outline Views dans la documentation Cocoa Propri t s des objets de la classe Outline View En plus des propri t s qu il h rite de la classe table view page 403 un objet outline view poss de ces propri t s auto resizes outline column Acc s lecture criture Classe boolean La colonne outline doit elle tre automatiquement redimensionn e Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder auto save expanded items Acc s lecture criture Classe boolean Non support e dans la version 1 3 d AppleScript Studio faut il que Partie V Data View Suite Traduction trad applescript 23 2 2004 394 Chapitre 1 Classes l tat d velopp des l ments outline soit automatiquement enre gistr Par d faut cette propri t vaut false clicked data item Acc s lecture uniquement Classe data item page 379 L objet data item qui a t cliqu disponible depuis la version 1 3 d AppleScript Studio retourne missing value si aucun l ment
327. ficher dans l image view avec les instructions suivantes set artImage to load image starryNights set image of image view artImages of window artWindow to artImage Vous pouvez aussi ex cuter cette op ration avec une seule instruction set image of image view artImages of window artWindow to load image starryNights Notez que pour charger une image depuis le projet sans indiquer pr cis ment son extension celle ci devra tre tiff et non tif Si l image ne fait pas partie de votre projet vous pouvez la charger en sp cifiant le chemin POSIX de son fichier Par exemple si sunFlowers png est stock e sur le disque dans User Me Images vous pouvez la charger avec l instruction suivante set image of image view artImages of window artWindow to load image User Me Images sunFlowers png Pour un exemple de suppression d images voir la section Discussion ci dessous Discussion L objet image retourn par la commande Load Image est conserv Dans Cocoa tous les objets ont un compteur de conservation La conserva tion augmente le compteur la lib ration le diminue Lorsque le compteur Partie II Application Suite Traduction trad applescript 23 2 2004 102 Chapitre 2 Commandes atteint O l objet est jet Un objet retourn par une des commandes de chargement a son compteur mis 1 Pour la plupart des objets utilis s dans une application AppleScript Stu
328. finissent les constantes utilisables dans les applications AppleScript Stu dio Important Ces num rations sont disponibles pour toutes les classes des suites d Apple Script Studio alert return values cooo 4 4 4 crsa 4 we 6 4 174 alert type sos m a R b A de G pe le E eS 174 bezel MTS o 4 ca ee sa E P a 44e A 175 border typ s sa e a a ek eS 175 DORDE ue sa EIN 176 Ditton Hype gt gt de ke ee ee ee Ee kh 177 cell image position 177 Gell state m acy ue de ah nue Rue dating 178 CEL type 22 4 bee ba bah eee eae mia de 179 color panel Made lt sos se ue da de dat pes 179 Control RIZE s e had 9 366 Ga a 89 0 opus 180 CAE VIAL 5 ie ed le A te Be Aa e Bs 180 drawer BATE aan nd mi Me ae a E eS 181 VEEN YDE ee ap a NE ie BO BRT de me hea 181 219 18 54 2 ip cee we eek ee PR ee a Ad eee BOR en 183 image alignment 183 image frame style 184 image SCANNE o e osoa k a a a aae b SNA a A r 184 174 Chapitre 4 num rations MATIN IMOOS c 2 4 eA dd a e E Bad dada 185 quicktime movie loop mode 185 rectangle edge 186 scroll to location gt u x Las ooo ees 186 sort cage sensitivity o sasa du ha das du aa 187 SOPLO lt 4 2 ERA a A4 Le ha du da 187 e x x a b aor a cat dh aR a a Be B dh R n d a n 188 CAD SALE du 4 ee a de Ge ar
329. fois la fermeture de l objet drawer page 204 accomplie Syntaxe closed reference obligatoire Param tres reference La r f rence de l objet drawer page 204 ayant t ferm Exemples L exemple suivant est extrait de l application Drawer distribu e avec AppleScript Studio on closed theObject set contents of text field Date Field of drawer Drawer of window main to closed end closed Comme theObject est une r f rence de l objet ayant t ferm le tiroir l instruction suivante est quivalente celle crite plus haut set contents of text field Date Field of theUbject to closed Partie II Application Suite Traduction trad applescript 23 2 2004 130 Chapitre 3 Events deminiaturized Appel apr s qu un objet window page 76 ait t sorti de son tat miniaturized Le gestionnaire peut ex cuter toute op ration n cessaire une fois la d r duction un synonyme de r duction serait mis dans le Dock de la fen tre accomplie Syntaxe deminiaturized reference obligatoire Param tres reference La r f rence de l objet window page 76 ayant t d r duit Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Demi niaturized un objet window page 76 AppleScript Studio ajoute auto matiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cu
330. frame constante 184 gray mode constante 180 grid color propri t 408 groove border constante 176 groove frame constante 184 H has data items propri t 380 has horizontal ruler propri t 215 has horizontal scroller propri t 215 366 has parent data item propri t 380 has resize indicator propri t 80 has shadow propri t 81 has sub menu propri t 500 has valid object value propri t 267 has vertical ruler propri t 215 has vertical scroller propri t 215 276 header cell propri t 399 header view propri t 408 hidden Propri t 31 hide commande 99 hides when deactivated propri t 81 highlight commande 335 highlight mode constante 185 highlighted propri t 268 highlights by propri t 262 horizontal line scroll propri t 215 horizontal page scroll propri t 215 horizontal ruler view propri t 215 Index 597 horizontal scroller propri t 216 horizontally resizable propri t
331. ge 123 pour plus d informations sur l ordre dans lequel les gestionnaires sont appel s lors du d marrage de l application 2 Une fois que vous avez r gl les valeurs des pr f rences vous devrez essayer de lire n importe quelle pr f rence utilisateur depuis le syst me des valeurs par d faut Vous ferez ceci avec l instruction suivante set myName to contents of default entry defaultName of user defaults Notez que la valeur retourn e est au format Unicode et que vous ne pourrez pas l envoyer telle que un bool en Pour des informations sur comment obtenir une valeur bool enne voir la section Discussion de la classe default entry page 45 3 Votre application peut pr sent faire de nouvelles inscriptions ou mo difier celles d j existantes comme les pr f rences de l utilisateur 4 Les applications Cocoa peuvent appeler la m thode synchronize pour sp cifiquement provoquer des modifications devant tre crites dans Traduction trad applescript 23 2 2004 Partie II Application Suite user defaults 75 le syst me des valeurs par d faut La commande register page 116 d AppleScript Studio fut l origine impl ment e pour servir cette caract ristique mais dans la version 1 3 d AppleScript Studio cette commande n est pas fonctionnelle bien qu elle soit utilis e dans le support du glisser d poser Toutefois le framework Cocoa appelle r guli rement la m thode synchron
332. ge 160 will finish launching page 161 will hide page 163 will quit page 166 will resign active page 167 will show page 169 Document document nib name page 130 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Exemples Le gestionnaire launched page 135 suivant connect l objet applica tion par l interm diaire de l instance File s Owner dans Interface Builder r glera la couleur du panel Couleurs de l application sur le Rouge et affi chera ce panel lors du lancement de l application Les instructions des scripts d AppleScript Studio peuvent se r f rer aux propri t s de l application sans explicitement cibler cet objet application Traduction trad applescript 23 2 2004 Partie II Application Suite application 37 on launched theObject set color of color panel to 65535 0 0 set visible of color panel to true end launched Vous pouvez utiliser le script suivant dans l diteur de Scripts pour obte nir les titres des l ments de menu du menu principal de l application Drag Race application distribu e avec AppleScript Studio Ces m mes instruc tions fonctionneront aussi l int rieur
333. ge 392 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Le param tre theObject r f rence l objet outline view Votre ges tionnaire devra d terminer s il autorise l l ment sp cifi tre r duit puis retournera la valeur appropri e on should collapse item theObject outline item outlineltem Traduction trad applescript 23 2 2004 Partie V Data View Suite should expand item 441 set allowCollapse to false Check variable perform test or call handler to see if OK to collapse If so set allowCollapse to true return allowCollapse end should collapse item should expand item Appel par un objet outline view page 392 pour d terminer si un l ment doit tre d velopp Ce gestionnaire retournera true pour autoriser le d veloppement de l l ment false pour l emp cher Syntaxe should expand item reference obligatoire outline item item facultatif Param tres reference La r f rence de l objet outline view page 392 contenant les l ments pouvant tre d velopp s outline item item page 60 L l ment pouvant tre d velopp R sultats boolean Retourne true pour autoriser l l ment tre d velopp false pour Vemp cher Si vous impl mentez ce gestionnaire vous devrez obliga toirement retourner une valeur bool enne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should
334. ge to false Check variable perform test or call handler to see if OK to select If so set allowSelectionChange to true return allowSelectionChange end should selection change will display browser cell Appel avant qu un objet browser cell page 370 ne soit affich dans l objet browser page 363 Traduction trad applescript 23 2 2004 Partie V Data View Suite will display cell 447 Ce gestionnaire ne pourra pas annuler l op ration d affichage mais peut la pr parer Contrairement aux autres data views comme outline view page 392 et table view page 403 vous ne pourrez pas alimenter en donn es un objet browser avec un objet data source page 386 En cons quence de quoi les performances pourront tre insuffisantes pour des objets browser affichant plus qu un petit nombre d l ments aussi vous devrez pr f rer l utilisation d une des deux autres data views bien s r si cela est compatible avec vos imp ratifs Syntaxe will display browser cell reference obligatoire browser cell browser cell obligatoire in column integer obligatoire row integer obligatoire Param tres reference La r f rence de l objet browser page 363 contenant la cellule devant tre affich e browser cell browser cell page 370 La cellule devant tre affich e in column integer L index de la colonne de la cellule donn e row integer L index de la ligne de la cellule donn e Exemples
335. gie Apple Event Comment sont organis es les suites Lorsque c est possible ce guide fournit les liens renvoyant aux d finitions des classes des commandes des Events des propri t s des l ments ou des constantes Pour chaque suite d AppleScript Studio ce guide fournit les informations suivantes e un bref aper u de la suite e la terminologie de chaque classe forme plurielle classe parente et les classes Cocoa sur lesquelles se base la classe Note Les classes qui commencent par NS comme NSButton sont d finies dans le framework Cocoa et renvoient la documentation Co coa Les classes qui commencent par ASK comme ASKDataCell sont d finies dans le propre framework d AppleScript Studio le framework AppleScriptKit Traduction trad applescript 23 2 2004 Partie I Introduction La terminologie fournie par le framework Cocoa Application 13 propri t s l ments commandes et Events support s version si nouveaut ou modification depuis la version 1 0 e la terminologie de chaque commande et Event s il y en a r sum syntaxe description des param tres et des valeurs re tourn es s il y en a exemples discussion s il y en a version si nouveaut ou modification depuis la version 1 0 e la terminologie de chaque numeration toutes les valeurs de numeration lesquelles sont disponibles pour chaque suite sont d crites dans num rations pag
336. gnment vous pouvez la r gler dans la fen tre Info d Interface Buil der image frame style Acc s lecture criture Classe une des constantes de image frame style page 184 Le type de cadre de l image vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder image scaling Acc s lecture criture Classe une des constantes de image scaling page 184 L chelle de Vimage par d faut cette propri t vaut scale proportionally vous pouvez la r gler dans la fen tre Info d Interface Builder El ments des ob jets de la classe Image View Un objet image view peut uniquement contenir les l ments qu il h rite de la classe control page 280 Events support s par les objets de la classe Image View Un objet image view supporte les gestionnaires r pondant aux Events suivants Action clicked page 348 Partie IV Control View Suite Traduction trad applescript 23 2 2004 288 Chapitre 1 Classes Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 1
337. grande vari t de formes cl s Avec comme r sultat que la plupart des objets des applications AppleScript Studio supportent les formes cl s suivantes e Name tell drawer myDrawer to open drawer on top edge e Absolute Position index num rique text field 1 of window 1 e Relative Position avant apr s window in front of window 3 e Range une s lection d l ments name of window 1 through 3 e Satisfaisant un test the first window whose name is mainWindow e ID unique set windowID to ID of window 1 Voir aussi Acc der aux propri t s et aux l ments page 17 Partie I Introduction Traduction trad applescript 23 2 2004 16 Chap 2 Les bases de la terminologie Les conventions d appellation des m thodes et des gestionnaires Le framework Cocoa application fournit une convention grammaticale bas e sur le langage humain permettant de d terminer quel moment lors de l ex cution du code une m thode sera appel e Cette convention laquelle est reprise dans la terminologie des gestionnaires d Events d Apple Script Studio ins re should will et did dans le nom des m thodes Le tableau 1 2 d crit la signification de ces termes Notez que pour indiquer une op ration d j achev e AppleScript Studio utilise le temps pass plut t que le terme did Expression Explication Exemples Cocoa should Demande si une op ration doit avoir
338. h text et word lesquelles a leur tour ont des l ments comme character paragraph et word et des propri t s comme color font et size La suite Text est une suite par d faut qui est accessible toutes les applications Cocoa qui supportent le scripting Pour davantage compliquer l affaire les classes AppleScript comme string et Unicode text ont des l ments character paragraph text et word En plus si une classe et une propri t comme text ont le m me nom utilisez leur nom l int rieur d une instruction tell prend par d faut la classe Le script suivant montre diverses op rations que vous pouvez ex cuter sur le texte d un text view dans une fen tre Un objet text view est auto matiquement encadr par un objet scroll view page 213 aussi le script acc de l objet text view par l interm diaire de l objet scroll view Ce script fut test avec la version 1 2 d AppleScript Studio dans l application diteur de Scripts mais vous pouvez l utiliser dans le script d une appli cation AppleScript Studio sans avoir besoin du bloc tell application Ce script pourrait inclure des instructions incompatibles avec les versions ant rieures d AppleScript Studio Pour cet exemple le texte du text view fut This is the only sentence Notez que vous obtiendrez une valuation des erreurs pour certaines lignes de ce script s il n y a aucun texte dans le text view ou par exemple moins Traduction
339. ha ne de caract res child integer L index du fils sp cifi R sultats n importe Le gestionnaire devra retourner le fils voulu de l l ment sp cifi Exemples Le gestionnaire Child Of Item suivant est extrait de l application Out line distribu e avec AppleScript Studio Cette application utilise un objet outline view page 392 pour afficher les l ments d un syst me de fichiers Ce gestionnaire e initialise la variable childItem avec une cha ne vide Traduction trad applescript 23 2 2004 Partie V Data View Suite child of item 429 e appelle l application Finder pour l aider faire ce qui suit si l l ment transmis est l l ment 0 repr sentant le nom du disque au plus haut niveau de l outline il r gle childItem sur le nom du disque dont l application garde la trace part dans la propri t diskNames sp cifi par le param tre theChild et le met au format string Dans l application Outline le param tre outline item du gestionnaire child of item aura la valeur num rique O pour les noms de disques pour des l ments imbriqu s il s agira d un chemin d limit par deux points comme Hard Disk Hard Disk App Folder Hard Disk App Folder SomeApp etc autrement il r gle childItem sur l l ment fils de l l ment transmis au format string Notez que l application Outline utilise le Finder pour l ai der a afficher les l
340. ha ne de caract res obtenir en langue locale from table Unicode text Le nom du fichier strings chaque fichier strings est repr sent par un tableau si vous ne sp cifiez pas de fichier strings le fichier par d faut est le fichier localized strings du projet in bundle bundle page 38 Le bundle page 38 contenant le fichier strings si vous ne sp cifiez pas de bundle le bundle par d faut sera le bundle de l application Partie II Application Suite Traduction trad applescript 23 2 2004 110 Chapitre 2 Commandes R sultats Unicode text La cha ne de caract res localis e de la cl sp cifi e Si la commande ne fonctionne pas le r sultat sera non d fini aussi il est fortement conseill d utiliser un bloc try on error si vous souhaitez utiliser par la suite ce r sultat comme dans la section Discussion ci dessous Exemples Supposons que vous ayez deux fichiers strings localis s dans votre projet enregistr s au format UTF 8 l un pour le support de la langue anglaise l autre pour le support de la langue fran aise Vous pouvez r gler le for mat d un fichier strings au format UTF 8 en suivant ces tapes 1 S lectionnez le fichier dans la liste des fichiers du panneau Groups and Files dans Xcode 2 Ouvrez la fen tre Info soit en appuyant sur Cmd I soit en choisis sant Show Info dans le menu Projects 3 Dans le panneau Text Settings ouv
341. heDataSource with properties name name sort order ascending sort type alphabetical sort case sensitivity case sensitive make new data column at end of data columns of theDataSource with properties name city sort order ascending sort type alphabetical sort case sensitivity case sensitive make new data column at end of data columns of theDataSource with properties name zip sort order ascending sort type alphabetical sort case sensitivity case sensitive make new data column at end of data columns of theDataSource with properties name age sort order ascending sort type numerical sort case sensitivity case sensitive Make this a sorted data source set sorted of theDataSource to true Set the name data column as the sort column set sort column of theDataSource to data column name of theDataSource Set the data source of the table view to the new data source set data source of theUbject to theDataSource Add the table data using the new append command append theDataSource with tableData end awake from nib Ci dessous vous trouverez la propri t tableData d finie dans l applica tion Table Sort Le champ name est encadr par des barres verticales A afin de le diff rencier d avec le mot cl name du langage AppleScript property tableData name Bart Simpson city Springfield zip 19542 age 12 name Ally McBeal city Boston zip 91544 age 28 name Jo
342. heSortColumn sortColumnOrder sort order of theSortColumn return theDataRecord end data representation Version Le gestionnaire Data Representation fut ajout dans la version 1 2 d AppleScript Studio L application Task List fut ajout e dans la version 1 2 d AppleScript Studio load data representation Appel pour charger les donn es du document lorsque le document est ouvert Ce gestionnaire est appel comme le r sultat de l ouverture par l utilisa teur du panel d ouverture et de la s lection d un ou de plusieurs fichiers ouvrir ou du glisser d poser d un document sur l icone de l application ou du double cliquement de l icone du document Les donn es fournies par ce gestionnaire sont les m mes que celles que l application a fourni dans le ges tionnaire data representation page 465 lorsque le document fut enregistr Il s agit d un gestionnaire de haut niveau que vous pouvez utiliser pour les documents qui sont sp cifiques votre application Ce gestionnaire chargera alors les donn es fournies sous la forme que vous aurez choisie la m me forme que celle qui a t pr c demment fournie dans le gestionnaire data representation page 465 L application ne devra pas traiter avec l ouver ture du fichier et la lecture des donn es AppleScript Studio fournira automatiquement les donn es au document Le contraire de Load Data Representation est data representation page 465
343. heUbject row theRow set allowSelection to false Check variable perform test or call handler to see if OK to select If so set allowSelection to true return allowSelection end should select row should selection change Appel par un objet table view page 403 ou outline view page 392 pour d terminer si la s lection courante devra tre modifi e Partie V Data View Suite Traduction trad applescript 23 2 2004 446 Chapitre 3 Events Ce gestionnaire retournera true pour autoriser la modification de la s lection false pour la refuser Syntaxe should selection change reference obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 pour lequel la s lection peut tre modifi e R sultats boolean Retourne true pour autoriser la modification de la s lection false pour l emp cher Si vous impl mentez ce gestionnaire vous devrez obli gatoirement retourner une valeur bool enne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Se lection Change un objet table view page 403 ou outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestion naire vierge identique celui qui suit Votre gestionnaire devra d terminer s il autorise la modification de la s lection puis retournera la valeur appro pri e on should selection change theUbject set allowSelectionChan
344. hemin du r pertoire contenant les fichiers de cette colonne directory Unicode text Sp cifie le r pertoire du bundle inspecter extension Unicode text L extension de l objet rechercher localization Unicode text La version locale de la ressource rechercher resource Unicode text Le type de ressources rechercher script n importe Le script rechercher R sultats Unicode text Le chemin de la ressource sp cifi e Si la commande choue le r sultat sera non d fini aussi il est fortement conseill d utiliser un bloc try on error si vous souhaitez par la suite utiliser ce r sultat comme dans l exemple ci dessous Partie II Application Suite Traduction trad applescript 23 2 2004 Chapitre 2 Commandes Exemples Vous pouvez utiliser le script suivant dans l diteur de Scripts pour obtenir le chemin complet du script principal compil d une application AppleScript Studio ici nomm e tester Des instructions identiques fonc tionneront dans le script d une application AppleScript Studio bien que vous n aurez pas besoin du bloc tell application Le script sp cifie la propri t main bundle de l objet application page 29 comme cible de la commande Path For tell application tester tell main bundle set scriptPath to path for script tester extension scpt end tell end tell En fonction de l emplacement du projet le r sultat du script pr c dent pourr
345. hoix content et contents sauf l int rieur d un gestionnaire d Events contents of theUbject retournant une r f rence l objet plut t que son contenu courant Pour obtenir dans un gestion naire d Events le contenu d un objet comme le texte contenu dans un text field page 325 vous pouvez utiliser soit contents of contents of theObject soit content of theObject La propri t formatter de cette classe n est pas support e dans la ver sion 1 3 d AppleScript Studio Les instructions suivantes d un gestionnaire action utilise la commande log pour montrer le r sultat de l utilisation de content et contents sur un champ texte contenant le texte Some text on action theUbject log theObject result text field 1 of window 1 log contents of theObject result text field 1 of window 1 log contents of contents of theUbject as string result Some text log content of theObject as string result Some text end action Partie IV Control View Suite Traduction trad applescript 23 2 2004 284 Chapitre 1 Classes image cell Pluriel image cells H rite de cell page 264 Classe Cocoa NSImageCell Affiche une image dans un cadre Fournit des propri t s pour sp cifier le type de cadre et l alignement et l chelle de l image Un objet image cell est g n ralement associ avec un type d objet de la classe control page 280 comme un objet image view page 285 mat
346. hould begin editing should end editing Appel avant que l dition ne se finisse Le gestionnaire peut retourner false pour annuler l dition Les classes comme text field page 325 ou text view page 569 supportent ce gestion naire Un usage commun est de ne pas autoriser la fin de l dition si le texte courant est non valide Voir aussi end editing page 350 et should begin editing page 353 Syntaxe should end editing reference obligatoire object n importe facultatif Traduction trad applescript 23 2 2004 Partie IV Control View Suite will dismiss 355 Param tres reference La r f rence de l objet dont le gestionnaire Should End Editing est appel object n importe L objet text field page 325 ou text view page 569 qui fait l dition R sultats boolean Retournera true pour autoriser la fin de l dition false pour conti nuer l dition Exemples L exemple suivant de gestionnaire Should End Editing appelle le gestion naire isltemValid crit par vous pour d terminer s il doit autoriser la fin de l dition si l l ment d dition est valide puis retourne la valeur appro pri e Vous pourriez la place ex cuter une validation dans le gestionnaire lui m me ou v rifier une propri t on should end editing theObject Check property perform test or call handler to see if OK to stop editing if edited item is valid set allowStopEditing to isItemValid the
347. i d crivent comment construire l ap plication Mail Search application distribu e avec AppleScript Studio Discussion Il est important que vous vous assuriez que les noms AppleScript as sign s aux objets table column dans Interface Builder soient identiques la propri t name de chaque objet data column de la data source de l objet table view Version Le support des Events de Glisser D poser est apparu dans la version 1 2 d AppleScript Studio Les propri t s edited data column clicked data column selected data column selected data columns clicked data row edited data row selected data row et selected data rows furent ajout es la classe Table View et sont donc aussi disponibles dans les sous classes la classe outline view page 392 dans la version 1 2 d AppleScript Studio Ces propri t s retournent les l ments appropri s compte tenu de leurs caract ristiques de tri et devront tre utilis es la place de leurs quivalents non tri s edited column edited row etc La propri t auto save table columns de cette classe n est pas support e dans la version 1 3 d AppleScript Studio Comme un bug du scripting de Cocoa a t r solu dans Mac OS X 10 2 il est dor navant possible depuis la version 1 2 d AppleScript Studio de r gler une propri t qui est une liste sur une nouvelle liste Par exemple vous pouvez maintenant sp cifier une liste pour s lectionner des lignes dan
348. iew page 229 supportent le gestionnaire Mouse Exited Syntaxe mouse exited reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Mouse Exited est appel event event page 50 Les informations d Events de l Event mouse exited Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Mouse Exited un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on mouse exited theUbject event theEvent Add script statements here to handle the mouse exited event end mouse exited Vous pouvez utiliser le param tre theEvent pour obtenir des informa tions sur Event mouse exited comme l emplacement du curseur et si les touches Commande Option Majuscule ou Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples mouse moved Appel lorsque la souris est d plac e l int rieur des limites de l objet C est dire que le curseur de la souris est d plac e l int rieur des limites de l objet connect au gestionnaire La plupart des classes qui h ritent des classes control page 280 et view page 229 supportent le gestionnaire Mouse Moved Syntaxe Traduction trad applescript 23 2 2004 Partie II Application Suite mouse up 141 mouse moved reference obligatoire event event facultatif Para
349. iew margins Propri t 199 contents propri t 46 65 266 280 307 373 571 context propri t 51 continuous propri t 266 281 516 control l ment 85 210 233 classe 280 control key down propri t 51 control size num ration 180 propri t 223 266 307 control tint num ration 180 propri t 223 266 307 control view Propri t 266 controller visible Propri t 297 copies on scroll Propri t 202 corner view Propri t 407 critical constante 175 current cell propri t 281 291 current column Propri t 291 current editor propri t 281 current item propri t 275 current menu item propri t 302 current row propri t 291 current tab view item propri t 223 current text editor Propri t 80 cursor update type constante 181 custom palette mode constante 180 D data classe 45 data cell l ment 377 381 385 388 CLASS canicas 372 propri t 399 data column l ment 385 389 classe 376 data
350. iguilles d une montre n gatives le sens inverse la rotation est ex cut e avec comme origine l origine du syst me des coordonn es 0 0 0 0 lequel n a pas besoin de co ncider avec celui du cadre ou des limites du rectangle modifier cette valeur ne r affiche pas la view ou la marque pas comme ayant besoin d tre affich e vous pouvez faire cela en r glant la propri t needs display sur true ou en utilisant la commande update page 119 can draw Acc s lecture uniquement Classe boolean La view peut elle tre dessin e true si les commandes de dessin peuvent produire n importe quel r sultat false dans l autre cas cette propri t est utilis e lorsqu est invoqu e directement le dessine ment ainsi que les commandes lock focus page 240 et unlock focus page 241 toutefois ces commandes ne sont pas support es dans la version 1 3 d AppleScript Studio de plus AppleScript Studio ne four nit pas de contr le fin sur le dessinement et la plupart des applications n auront pas besoin de l invoquer directement si votre application est une exception voir NSView ainsi que la documentation Cocoa sur cette classe enclosing scroll view Acc s lecture criture Classe scroll view page 213 La scroll view de la view s il y en a une voir la description de la classe scroll view pour savoir comment incorporer dans Interface Builder une Traduction trad applescript 23 2 2004 Partie III
351. ilder background color Acc s lecture criture Classe RGB color La couleur de fond de l objet matrix exprim e sous forme d une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur rouge peut tre repr sent e par 65535 0 0 par d faut cette propri t vaut 65535 65535 65535 ou la couleur blanche vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder Traduction trad applescript 23 2 2004 Partie IV Control View Suite matrix 291 cell background color Acc s lecture criture Classe RGB color La couleur de fond des cellules de l objet matrix exprim e sous forme d une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par d faut cette propri t vaut 65535 65535 65535 ou la couleur blanche cell size Acc s lecture criture Classe point La taille de chaque cellule de l objet matrix la taille est exprim e sous forme d une liste de deux nombres horizontal vertical voir la propri t bounds de la classe window page 76 pour plus d informa tions sur le syst me des coordonn es non support e dans la version 1 3 d AppleScript Studio toutefois vous pouvez utiliser la commande call method page 94 pour obtenir ou r gler cette propri t la premi re instruction ci dessous obtient la taille la seconde la r gle set cellSi
352. ine son fond visible document rect Acc s lecture uniquement Classe bounding rectangle Les limites visibles du document view une liste de quatre nombres gauche bas droite haut r gl es dans le syst me des coordonn es du clip view voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es l ments des objets de la classe Clip View Un objet clip view peut uniquement contenir les l ments qu il h rite de view page 229 Events support s par les objets de la classe Clip View Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Partie III Container View Suite Traduction trad applescript 23 2 2004 204 Chapitre 1 Classes drawer Pluriel drawers H rite de responder page 68 Classe Cocoa NSDrawer Un l ment d interface contenant et affichant des objets view page 229 Les tiroirs drawers en anglais contiennent g n ralement des objets text field page 325 scroll view page 213 browser page 363 et d autres objets bas s sur les classes h ritant de la classe view page 229 L illustration 3 2 montre un tiroir qui contient plusieurs objets d interface Un objet drawer est associ un objet window page 76 appel son pa rent et peut uniquement appara tre lorsque son parent est visible l cran Un objet drawer ne peut pas tre d plac
353. ine view page 392 le gestionnaire Selection Changed est appel s il y en a un de connecter Syntaxe selection changed reference obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Selection Changed est ap pel Partie IV Control View Suite Traduction trad applescript 23 2 2004 352 Chapitre 3 Events Exemples Le gestionnaire Selection Changed suivant est extrait du fichier Application applescript de l application Task List distribu e avec AppleScript Studio depuis la version 1 2 Ce gestionnaire est appel chaque fois que la s lection dans un objet table view page 403 change S il y a des rang es de s lectionner ce gestionnaire appelle le gestion naire setUIValuesWithTaskValues pour mettre jour l interface utilisa teur fond e sur les rang es s lectionn es Si aucune rang e n est s lectionn e la s lection a chang en aucune s lection le gestionnaire appelle le ges tionnaire setDefaultUIValues pour mettre jour l interface utilisateur ses valeurs par d faut on selection changed theObject if name of theUbject is tasks then If there is a selection then we ll update the UI otherwise we set the UI to default values if count of selected rows of theObject gt O then Get the selected data row of the table view set theTask to selected data row of theUbject Update the UI using the selected task setUIValuesWithTaskValues wind
354. inq minutes surtout en RTC mais ils sont tout de m me mis 582 Annexe Les applications distribu es avec AppleScript Studio gratuitement en ligne tout le monde ne le fait pas Notez que tous ces mod les sont en langue anglaise il n y a pas d autre localisation disponible donc si vous voulez une version fran aise il faudra la faire vous m me vous pourrez ainsi vous faire la main Les mod les pr sent s sont Archive Maker 582 Umit Converter ooe df Li a 6 mins we eS 583 Table BONE o e ds DM Dans De 584 Save Panel 586 Archive Maker eee Archive Maker Files Drag items from the Finder to the a table to add them to the archive _ Hide Settings Make Save Archives at Choose Follow Links M Preserve File and Group IDs Use Verbose Mode v Open Window on Launch M Show Progress M Compress Archive FIG 12 1 La fen tre de l application Archive Maker Archive Maker est une interface graphique pour l utilitaire d archivage GNUtar permettant de cr er des archives tar ou tar gz pour des archives compress es Cette application se sert de la commande AppleScript Do Shell Script permettant d utiliser des commandes UNIX dans un script Traduction trad applescript 23 2 2004 Unit Converter 583 AppleScript Gr ce cette commande vos scripts AppleScript peuvent utili ser les commandes UNIX san
355. interfaces graphiques aux applications AppleScript Studio Interface Builder fournit un support actif de l inter face utilisateur Aqua comprenant un syst me de guides pour la mise en place des objets d interface en accord avec la guideline Aqua Vous trouverez dans le guide Aqua Human Interface Guidelines des illustrations de fen tres menus contr les et autres l ments d in terface ainsi que des recommandations sur leur utilisation et leur posi tionnement S il vous pla t utilisez ce guide pour cr er des applications qui tirent compl tement partie de l interface Aqua La section Autres documentations page 5 explique comment acc der ce guide ainsi qu la documentation sur Xcode et Interface Builder Toutes les applications AppleScript Studio sont des applications Cocoa construites partir du framework Cocoa application En tant que telles elles sont un m lange de codes Cocoa et de scripts AppleScript mais vous pouvez crire de robustes applications ne requ rant pas de codes Cocoa personnels suppl mentaires Certaines possibilit s de Cocoa ne sont g n ralement pas disponibles dans les classes AppleScript Studio Lorsque cela se produit vous avez diff rentes solutions pour y rem dier e vous pouvez utiliser la commande call method page 94 pour appeler directement les m thodes des classes Cocoa e vous pouvez crire votre propre code Cocoa comme faisant partie de votre application et y
356. io fournit aussi une propri t script Comme la plupart des classes h ritent de la classe Item vous pouvez attacher un script a la plupart des types d objets alors grace a la pro pri t script vous pouvez acc der aux propri t s globales et gestionnaires du script Il y a tout de m me certaines limitations par exemple lorsque vous acc dez au script d un objet vous obtenez une copie du script objet et non sa r f rence Avec comme cons quence si vous avez besoin de mo difier la valeur d une propri t dans un script vous aurez besoin d obtenir le script de modifier la propri t puis de r gler le script en retour Pour un exemple voir la section Exemples de cette classe Pour un exemple qui utilise la propri t script pour ajouter un script un objet menu item page 499 voir la section Exemples de la classe menu page 495 La majorit des classes d AppleScript Studio descendent de la classe Item soit directement soit par l interm diaire de responder page 68 view page 229 et autres sous classes La classe Item d AppleScript Studio est diff rente de l l ment item de la classe List d AppleScript Vous pouvez utiliser la classe Item d Apple Script Studio pour se r f rer un objet dont vous savez qu il h rite de cette classe ou d une de ses sous classes Supposons par exemple que vous ayez un gestionnaire qui soit toujours transmis un objet sous classe de view
357. ion trad applescript 23 2 2004 532 Chapitre 1 Classes Commandes support es par les objets de la classe Save Panel Votre script peut envoyer les commandes suivantes un objet save panel display page 537 display panel page 547 Events support s par les objets de la classe Save Panel Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire d une application AppleScript Studio peut se r f rer la propri t open panel de l objet application page 29 sans avoir sp cifier l application comme dans l instruction suivante laquelle affiche le panel d enregistrement attach la fen tre ayant comme nom AppleScript main display save panel attached to window main Comme l instruction affiche le panel comme une feuille le panel sera un document modal ce qui signifie que l ex cution de l application continuera apr s que le panel soit affich Aussi pour obtenir le choix de l utilisateur partir du panel l application aura besoin d utiliser Interface Builder pour connecter un gestionnaire panel ended page 553 l objet window page 76 auquel le panel est attach Le gestionnaire Panel Ended sera appel lorsque le panel sera renvoy Si un script n attache pas le panel la fen tre le panel est affich en tant qu application modale et donc l ex cution s arr te
358. ionnaire Pour examiner ou connec ter dans Interface Builder les gestionnaires disponibles pour une classe s lectionner une instance d un objet de ce type dans le panneau Instances de la fen tre Nib puis ouvrez le panneau AppleScript de la fen tre Info L illustration 2 9 montre le panneau AppleScript de Files Ow ner repr sentant l objet application page 29 voir la section Discus sion ci dessous pour plus d informations sur File s Owner Cette ins tance a un seul gestionnaire connect le gestionnaire should quit af ter last window closed page 155 Ce gestionnaire est dans le fichier Application applescript du projet Au lancement de l application les gestionnaires connect s l objet application page 29 sont appel s dans cet ordre bien s r s ils sont connect s will finish launching page 161 awake from nib page 123 launched page 135 will become active page 160 activated page 123 idle page 132 9 a FP N FR Avant qu un quelconque gestionnaire ne soit appel par l objet application page 29 except le gestionnaire will finish launching page 161 s il est pr sent lequel est toujours appel en premier le fichier nib principal de l application sera charg tous ses objets d sarchiv s et le gestionnaire Awake From Nib appel pour tous ses objets connect s ce gestionnaire Aussi un gestionnaire Awake From Nib connect un
359. ispos dans un espace d fini Attention Depuis la version 1 3 d AppleScript Studio la classe Text est fusionn e avec la classe text view page 569 Les propri t s pr c demment accessibles dans la classe Text sont dor navant dans la classe Text view Voir la section Ver sion de la classe Text View pour la liste compl te des propri t s fusionn es L illustration 11 1 montre une fen tre contenant un objet text view Window The quick brown fox jumped over the lazy dog Why are you letting a fox play with your dog Clear Text FIG 11 1 Un text view contenant du texte Vous trouverez l objet text view dans le panneau Cocoa Text d Inter face Builder Vous pouvez r gler la plupart des attributs des objets text view dans la fen tre Info d Interface Builder Pour un aper u du syst me de gestion du texte de Cocoa voir Text System Architecture dans la documentation Cocoa Propri t s des objets de la classe Text View En plus des propri t s qu il h rite de la classe view page 229 un objet text view poss de ces propri t s alignment Acc s lecture criture Classe une des constantes de text alignment page 189 Traduction trad applescript 23 2 2004 Partie XI Text View Suite text view 571 L alignement du texte allows undo Acc s lecture criture Classe boolean Faut il que le text view autorise l annulation background color Acc s
360. iste le tableau 2 1 liste les valeurs courantes des constantes de rang des fen tres Cocoa Vous pouvez utiliser ces valeurs mais pas les constantes dans vos scripts Mais n oubliez pas que l utilisation et le fonctionnement de ces hard coded values dans vos scripts ne sont pas assur s avec les futures versions d AppleScript Studio Version Depuis la version 1 3 d AppleScript Studio vous pouvez acc der la plupart des propri t s d finies pour la classe Window dans la Standard Suite de Cocoa comme titled Depuis la version 1 3 d AppleScript Studio la propri t first responder retourne un objet tel que current field editor of window 1 Avant elle ne retournait aucun objet utile La propri t miniaturized n est pas support e dans la version 1 3 d AppleScript Studio L l ment clip view n est pas support e dans la version 1 3 d Apple Script Studio Le support de la propri t current field editor est apparu dans la ver sion 1 2 1 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie II Application Suite window 91 Constantes Valeur NSNormalWindowLevel 0 NSFloatingWindowLevel 3 NSSubmenuWindowLevel 3 NSTorn0ffMenuWindowLevel 3 NSModalPanelWindowLevel 8 NSDockWindowLevel 20 NSMainMenuWindowLevel 24 NSPopUpMenuWindowLevel 101 NSScreenSaverWindowLevel 1001 TAB 2 1 Les constantes de rang des fen tres Cocoa Le support des propri t
361. itation avec la commande call method page 94 comme dans l instruction suivante laquelle obtient le che min du bundle principal de l application set thePath to call method bundlePath of object main bundle resource path Acc s lecture uniquement Classe Unicode text Le chemin des ressources du bundle en fonction de l emplacement de l application AppleScript Studio le chemin pourra tre quelque chose comme Users userName TestApp build TestApp app Contents Resources scripts path Acc s lecture uniquement Classe Unicode text Le chemin des scripts du bundle en fonction de l emplacement de l application AppleScript Studio le chemin pourra tre quelque chose comme Users userName TestApp build TestApp app Contents Resources Scripts shared frameworks path Acc s lecture uniquement Classe Unicode text Le chemin des frameworks partag s du bundle en fonction de l em placement de l application AppleScript Studio le chemin pourra tre quelque chose comme Users userName TestApp build TestApp app Contents SharedFrameworks shared support path Acc s lecture uniquement Classe Unicode text Le chemin des supports partag s du bundle en fonction de l empla cement de l application AppleScript Studio le chemin pourra tre quelque chose comme Users userName TestApp build TestApp app Contents SharedSupport Commandes support es par les objets de la classe Bundle Votre script peut envoye
362. iture Classe real La valeur du contenu au format double 0 0 si le contenu ne peut pas tre interpr t au format double Traduction trad applescript 23 2 2004 Partie IV Control View Suite cell 267 editable Acc s lecture criture Classe boolean La cellule est elle ditable enabled Acc s lecture criture Classe boolean La cellule est elle activ e entry type Acc s lecture criture Classe integer Le type d entr e le type d entr e est appr ci dans Cocoa aussi vous ne devrez pas l utiliser dans vos scripts float value Acc s lecture criture Classe real La valeur du contenu au format d cimal 0 0 si le contenu ne peut pas tre interpr t au format d cimal font Acc s lecture criture Classe font page 54 La police de la cellule formatter Acc s lecture criture Classe formatter page 56 Le formatter de la cellule cette propri t n est pas support e dans la version 1 3 d AppleScript Studio toutefois voir la section Exemples de la classe formatter page 56 pour une description sur la mani re d utiliser la commande call method page 94 pour obtenir le format ter et en tirer des informations has valid object value Acc s lecture uniquement Classe boolean La cellule contient elle une valeur valide Un objet valide est un objet que le formatter de la cellule s il est pr sent peut
363. iture Classe text field cell page 330 La cellule du titre comme la propri t title vous ne devrez pas utiliser cette propri t dans vos scripts title color Acc s lecture criture Classe RGB color La couleur du titre comme la propri t title vous ne devrez pas uti liser cette propri t dans vos scripts title font Acc s lecture criture Classe font page 54 La police du titre comme la propri t title vous ne devrez pas utiliser cette propri t dans vos scripts vertical Acc s lecture criture Classe boolean Le slider est il orient verticalement Vous pouvez choisir des sliders horizontaux ou verticaux dans Interface Builder Traduction trad applescript 23 2 2004 Partie IV Control View Suite slider 319 l ments des objets de la classe Slider Un objet slider peut uniquement contenir les l ments qu il h rite de la classe control page 280 Events support s par les objets de la classe Slider Un objet slider supporte les gestionnaires r pondant aux Events sui vants Action action page 345 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse
364. iture Classe une des constantes de title position page 190 Partie III Container View Suite Traduction trad applescript 23 2 2004 200 Chapitre 1 Classes La position du titre title rect Acc s lecture uniquement Classe bounding rectangle Les limites du titre une liste de quatre nombres gauche bas droite haut mis au point l int rieur du syst me de coordonn es de l objet box voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es l ments des objets de la classe Box Un objet box peut uniquement contenir les l ments qu il h rite de view page 229 Events support s par les objets de la classe Box Un objet box supporte les gestionnaires r pondant aux Events suivants Glisser d poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 Traduction trad applescript 23 2 2004 Partie III Container View Suite box 201 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples Pour une fen tre
365. ize aussi les valeurs utilisateur par d faut sont bien enregistr es dans les applications AppleScript Studio Vous pouvez aussi utiliser la commande call method page 94 pour appeler directement la m thode Cocoa synchronize comme 1a call method synchronize of object user defaults 5 L application devra mettre jour son tat pour refl ter les modifica tions des pr f rences faites par l utilisateur L application Archive Maker distribu e avec AppleScript Studio de puis la version 1 1 fournit un exemple d taill sur la mani re d utiliser le syst me des valeurs par d faut pour travailler avec les pr f rences utilisateur Notes La classe User Defaults est apparue avec la version 1 1 d AppleScript Studio Depuis la version 1 2 d AppleScript Studio vous pouvez utiliser avec succ s les listes comme type de donn es pour les inscriptions Dans la ver sion 1 1 d AppleScript Studio vous pouviez initialement assigner le contenu d une inscription une liste et la lire en retour mais essayer d assigner une nouvelle liste le contenu des inscriptions par d faut ne produira pas le r sultat attendu L application Archive Maker fut d abord distribu e avec la version 1 1 d AppleScript Studio Avant la version 1 2 ce guide a list la commande register page 116 comme une commande support e par la classe User Defaults Dor navant utilser la commande register page 116 dans la versi
366. ject soit content of theObject Pour un exemple montrant la diff rence entre content et contents voir la section Version de la classe control page 280 Depuis la version 1 2 d AppleScript Studio la commande display page 537 est pr f r e la commande display panel page 547 Depuis la version d Interface Builder distribu e avec Mac OS X version 10 2 vous pouvez utiliser l objet progress indicator circulaire ind termin visible dans l illustration 4 10 Avant la version 1 1 d AppleScript Studio l application Mail Search s appelait Watson secure text field Pluriel secure text fields H rite de text field page 325 Classe Cocoa NSSecureTextField Cache de fa on illisible le texte lors de l affichage ou d un autre acc s via l interface utilisateur et est par cons quent fort utile pour un mot de passe ou pour n importe quel l ment dans lequel une valeur s curis e doit tre saisie Un utilisateur peut glisser d poser un texte dans un objet secure texte field mais il sera affich en accord avec les r glages courants du champ soit avec des ronds soit avec des caract res blancs La valeur par d faut est d afficher le texte sous forme de ronds Pour plus d informations sur la Partie IV Control View Suite Traduction trad applescript 23 2 2004 312 Chapitre 1 Classes mani re de sp cifier des caract res blancs voir la section Exemples de la class
367. jet comme le texte contenu dans un text field page 325 dans un gestionnaire d Events vous pouvez utiliser soit contents of contents of theObject soit content of theUbject Pour un exemple montrant la diff rence entre content et contents voir la section Version de la classe control page 280 Partie II Application Suite Traduction trad applescript 23 2 2004 68 Chapitre 1 Classes Version Depuis la version 1 3 d AppleScript Studio vous pouvez utiliser la pro pri t preferred type pour r gler le contenu d un pasteboard comme vous avez pu le lire dans la section Exemples de cette classe La classe Pasteboard et l application Drag and Drop furent ajout es dans la version 1 2 d AppleScript Studio Avant la version 1 2 1 d AppleScript Studio vous deviez passer par une phase pr paratoire avant de pouvoir r gler directement le contenu d un pas teboard avec de nouvelles donn es Pour faire cela vous invoquiez la com mande call method page 94 Les param tres de la commande devaient tre une liste de types d crits plus haut et le propri taire g n ralement 0 pour repr senter rien comme dans l exemple suivant call method declareTypes owner of pasteboard general with parameters string 0 set contents of pasteboard general to Testing responder Pluriel responders H rite de item page 60 Classe Cocoa NSResponder Fournit les bases po
368. jout es la data source mais il pourra les pr senter dans un ordre tri Pour activer le tri d un objet data source vous devez faire ce qui suit e Ajoutez les propri t s suivantes lors de la cr ation des objets data column dans l instruction make new sort order ascending ou descending sort type alphabetical ou numerical sort case sensitivity case sensitive ou case insensitive Par exemple make new data column at end of data columns of theDataSource with properties name name sort order ascending sort type alphabetical sort case sensitivity case sensitive R glez la propri t sorted de l objet data source sur true Par exemple set sorted of theDataSource to true R glez la propri t sort column de la data source sur la colonne initiale trier Par exemple set sort column of theDataSource to data column name of theDataSource Connectez un gestionnaire column clicked page 430 votre objet table view page 403 Cela fournira l opportunit lorsqu un utilisa teur cliquera dans l en t te l objet table header view page 402 de la colonne de modifier la colonne s lectionn e pour le tri ainsi que l ordre de tri des donn es de la colonne dans votre data source L exemple de script montr dans la section Exemples de cette classe est relative ment standard et peut tre utilis tel quel dans votre application Pour des exemples complets voir les applications T
369. ked data column propri t 406 clicked data item propri t 394 clicked data row propri t 406 clicked row propri t 407 clip view l ment 85 210 233 CLASS naines 202 close drawer commande 239 close panel commande 535 closed event 129 cmyk mode constante 179 color propri t 227 272 516 color list mode constante 179 color mode propri t 516 color panel propri t 31 color panel mode num ration 179 color well l ment 85 210 233 CLASSE Lan ences TE 271 color wheel mode constante 179 color panel classe 514 column clicked event 430 column moved event 430 column resized VEIT MORAI E E ene 431 combo box l ment 85 210 233 classe 274 combo box item l ment 276 classe 279 command key down propri t 51 conclude drop event 481 content propri t 46 65 266 280 307 373 571 Index 593 content rect propri t 222 content size propri t 207 214 content view propri t 79 199 202 207 214 content v
370. ked se r f re au bouton Dans ce cas le gestionnaire utilise la fen tre du bouton pour obtenir d autres objets on clicked theObject tell window of theUbject try set theRate to contents of text field rate set theAmount to contents of text field amount as number set contents of text field total to theRate theAmount on error set contents of text field total to 0 end try end tell end clicked L instruction suivante d sactive un bouton nomm someButton Notez que la propri t enabled n est pas propre aux objets button mais elle est h rit e de la classe control page 280 set enabled of button someButton to false Les instructions suivantes extraites de l application Unit Converter distribu e avec AppleScript Studio montrent comment d terminer si un bouton particulier d une view comportant plusieurs boutons fut la cible Ici le bouton en question le bouton Convert fait partie d un objet box page 197 on clicked theObject tell window Main Partie IV Control View Suite Traduction trad applescript 23 2 2004 260 Chapitre 1 Classes if theUbject is equal to button Convert of box 1 then my convert else if end tell end clicked Discussion Les boutons fournissent un m canisme simple pour zapper leur titre ou icone lorsque l utilisateur alterne leur tat Par exemple pour cr er dans Interface Builder un bouton qui alterne son texte entre Start et St
371. l objet dont le gestionnaire est appel show Montre l objet sp cifi comme une fen tre ou un panel en le faisant devenir objet principal et aussi objet cl Montrer une fen tre a le m me effet que de r gler sa propri t visible sur true La commande Show a deux param tres facultatifs behind et in front of mais incompatibles l un avec l autre Cela vous donne un certain contr le en ce qui concerne l ordre des fen tres Pour plus d informations sur l ordre voir la propri t level et la section Discussion de la classe window page 76 Pour plus d informations sur les fen tres voir Windows and Pa nels dans la documentation Cocoa Syntaxe show reference obligatoire behind window facultatif in front of window facultatif Param tres reference La r f rence de l objet montrer behind window page 76 La fen tre situ e juste devant celle devant tre montr e ne pas utiliser avec in front of in front of window page 76 La fen tre situ e juste derri re celle devant tre montr e ne pas utiliser avec behind Exemples Le gestionnaire launched page 135 suivant est extrait de l application XMethods Service Finder distribu e avec la version 1 2 d AppleScript Studio Le gestionnaire launched est appel vers la fin de la s quence de lan Traduction trad applescript 23 2 2004 Partie II Application Suite update 119 cement apr s que les obj
372. l ou modifi dans le gestion naire prepare drop page 488 on conclude drop theUbject drag info draglnfo Statements to deal with the concluded drop end conclude drop Traduction trad applescript 23 2 2004 Partie VIT Drag and Drop Suite drag entered 483 Voir aussi la description de cette classe ci dessus Version Le gestionnaire Conclude Drop fut ajout dans la version 1 2 d Apple Script Studio drag Non support dans la version 1 3 d AppleScript Studio Le support de ce gestionnaire est planifi pour une future version d AppleScript Studio Syntaxe drag reference obligatoire drag info drag info obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Drop est appel drag info drag info page 477 Les informations propos de l op ration de glisser Version Le gestionnaire Drag fut ajout dans la version 1 2 d AppleScript Studio bien qu il ne fasse rien dans cette version drag entered Appel lorsqu un utilisateur glisse le type r pertori de donn es dans les limites de l objet Votre application pourra ne pas avoir besoin du gestionnaire Drag Ente red tant donn que le gestionnaire drop page 486 est le seul gestionnaire requis par le support du d poser de donn es dans AppleScript Studio Partie VIT Drag and Drop Suite Traduction trad applescript 23 2 2004 484 Chapitre 2 Events Syntaxe drag entered r
373. l state value page 178 L tat de l l ment de menu sub menu Acc s lecture criture Classe menu page 495 Le sous menu de l l ment de menu s il y a tag Acc s lecture criture Classe integer La marque de l l ment de menu un l ment arbitraire associ l l ment de menu par d faut cette propri t vaut 0 vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder vous pouvez utiliser une marque par exemple pour identifier un l ment de menu particulier title Acc s lecture criture Classe Unicode text Le titre de l l ment de menu vous pouvez r gler cette propri t dans Partie VIII Menu Suite Traduction trad applescript 23 2 2004 502 Chapitre 1 Classes la fen tre Info d Interface Builder Commandes support es par les objets de la classe Menu Item Votre script peut envoyer la commande suivante un objet menu item perform action page 337 Events support s par les objets de la classe Menu Item Un objet menu item supporte les gestionnaires r pondant aux Events suivants Menu choose menu item page 505 update menu item page 506 Nib awake from nib page 123 Exemples Les instructions suivantes pr vues pour tourner dans l application diteur de Scripts montrent comment acc der aux propri t s de l l ment de menu New du menu File d une application AppleScript Studio Vous
374. lasse text field page 325 h rite de la classe control page 280 aussi supposons que vous ayez ajout un objet formatter un champ texte et l ayez nomm formatted vous pourrez alors utiliser l appel suivant pour obtenir la r f rence de cet objet Partie II Application Suite Traduction trad applescript 23 2 2004 58 Chapitre 1 Classes set theFormatter to call method formatter of text field formatted of windo Supposons que le texte format affich soit 54 00 et que vous souhai tiez obtenir la chaine de caract res exacte de ce champ texte Le gestionnaire clicked page 348 suivant obtient d abord la r f rence de l objet formatter puis utilise la commande call method page 94 pour appeler la m thode stringForObjectValue de la classe Cocoa NSFormatter pour obtenir le texte format de cet objet formatter Le gestionnaire utilise un bloc try on error pour g rer les erreurs et plusieurs instructions log page 111 pour logger les diverses tapes on clicked theObject tell window of theUbject try set theValue to contents of text field formatted get formatter then formatted text set theFormatter to call method formatter of object text field formatted log Got formatter set theString to call method stringForObjectValue of object theFormatter with parameter theValue log Got string amp theString on error log Error getting formatted text end try Perf
375. lasses action cell Pluriel action cells H rite de cell page 264 Classe Cocoa NSActionCell D finit la surface active d un objet control page 280 ou d une de ses sous classes Comme la surface active d un control un objet action cell fait trois choses il ex cute gen ralement l affichage du texte ou de la vignette il fournit le contr le avec une cible ou une action et il g re les d placements de la souris curseur en illuminant dans le sens des d tections radars correc tement son aire et en envoyant les messages action bas s sur les mouvements du curseur ses cibles Events support s par les objets de la classe Action Cell Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires d Events Exemples Voir les exemples de cell page 264 button Pluriel buttons H rite de control page 280 Classe Cocoa NSButton Sous classe de control qui intercepte les Events mouse down clic de souris et qui initie l appel du gestionnaire lorsqu il est cliqu ou appuy Un objet button contient un seul objet button cell page 261 L illus tration 4 1 montre un bouton Vous trouverez tout un assortiment de boutons dans le panneau Cocoa Controls d Interface Builder Vous pouvez r gler la plupart des attributs d un objet button dans la fen tre Info d Interface Builder Vous pouvez aussi modifier les ty
376. lecture criture Classe RGB color La couleur de fond de la view une liste de trois nombres entiers conte nant les valeurs de chaque composant de la couleur par exemple la couleur verte peut tre repr sent e par 0 65535 0 content Acc s lecture criture Classe Unicode text Le contenu de la view synonyme de contents contents Acc s lecture criture Classe Unicode text Le contenu de la view synonyme de content draws background Acc s lecture criture Classe boolean Faut il que la view dessine son fond editable Acc s lecture criture Classe boolean La view est elle ditable field editor Acc s lecture criture Classe boolean Est ce un champ diteur Un champ diteur est utilis par les ob jets supportant du texte par exemple un objet text field page 325 utilise le champ diteur de sa fen tre pour afficher et manipuler le texte le champ diteur peut tre partag par n importe quel nombre Partie XI Text View Suite Traduction trad applescript 23 2 2004 572 Chapitre 1 Classes d objets et aussi son tat peut tre constamment sur le point de se modifier pour plus d informations voir la description de la m thode fieldEditor forObject de la classe NSWindow font Acc s lecture criture Classe font page 54 La police de la view horizontally resizable Acc s lecture criture Classe boolean La view es
377. lent modifier Acc s lecture criture Classe number Traduction trad applescript 23 2 2004 Partie IV Control View Suite button 257 La touche de fonction du raccourci clavier vous pouvez r gler cette propri t sur la touche Commande ou Option ou sur les deux en m me temps dans la fen tre Info d Interface Builder toutefois la valeur retourn e par cette propri t est un nombre par d faut 0 roll over Acc s lecture criture Classe boolean Le bouton se comporte t il comme un roll over sound Acc s lecture criture Classe sound page 70 Le son produit lorsque le bouton est cliqu state Acc s lecture criture Classe une des constantes de cell state value page 178 L tat du bouton voir aussi la propri t allows mixed state title Acc s lecture criture Classe Unicode text Le titre du bouton voir aussi la section Discussion transparent Acc s lecture criture Classe boolean Le bouton est il transparent l ments des objets de la classe Button Un objet button peut contenir uniquement les l ments qu il h rite de control page 280 Commandes support es par les objets de la classe Button Votre script peut envoyer la commande suivante un objet button highlight page 335 Partie IV Control View Suite Traduction trad applescript 23 2 2004 258 Chapitre 1 Classes Events support s par les objets de la class
378. les des gestionnaires item expandable page 432 et number of browser rows page 436 on number of items theUbject outline item outlineltem set itemCount to 0 tell application Finder if count of diskNames gt O then if outlineItem is O then set itemCount to count of diskNames else set itemCount to count of items of get item outlineltem end if end if end tell return itemCount Traduction trad applescript 23 2 2004 Partie V Data View Suite number of rows 439 end number of items number of rows Appel par un objet table view page 403 ou outline view page 392 pour obtenir le nombre de lignes Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet table view ou outline view dans ce cas ce gestion naire n est pas utile ou appel Syntaxe number of rows reference obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 duquel doit tre obtenu le nombre de lignes R sultats integer Retourne le nombre de lignes de l objet table view ou outline view Exemples Le gestionnaire Number Of Rows suivant est extrait de l application Table distribu e avec AppleScript Studio Vous le trouverez dans le fi chier script withoutDataSource applescript Cette application montre comment travailler avec les donn es affich es dans les lignes et les colonnes d un objet table view page 403
379. les faire d filer horizontal ruler view Acc s lecture criture Classe n importe La r gle horizontale Partie III Container View Suite Traduction trad applescript 23 2 2004 216 Chapitre 1 ru Classes horizontal scroller Acc s lecture criture Classe n importe L ascenseur horizontal line scroll Acc s lecture criture Classe real Le nombre total de lignes a faire d filer page scroll Acc s lecture criture Classe real Le nombre total de pages faire d filer rulers visible Acc s lecture criture Classe boolean Les r gles sont elles visibles vertical line scroll Acc s lecture criture Classe real Le nombre total de lignes verticales a faire d filer vertical page scroll Acc s lecture criture Classe real Le nombre total de pages verticales faire d filer vertical ruler view Acc s lecture criture Classe n importe La r gle verticale vertical scroller Acc s lecture criture Classe n importe L ascenseur vertical visible document rect Acc s lecture uniquement Traduction trad applescript 23 2 2004 Partie III Container View Suite scroll view 217 Classe bounding rectangle Les limites visibles du document l ments des objets de la classe Scroll View Un objet scroll view peut uniquement contenir les l ments qu il h rite de la classe view page 229 Events su
380. les objets des classes open panel page 522 save panel page 529 color panel page 514 et font panel page 520 Pour des exemples montrant la terminologie correcte voir la section Exemples ci dessous La commande Display autorise votre application afficher les panels d ouverture et d enregistrement qui ont t ajout s comme propri t s de l objet application page 29 dans la version 1 1 d AppleScript Studio Syntaxe display reference obligatoire afterwards calling n importe facultatif attached to window facultatif for file types list facultatif in directory Unicode text facultatif with file name Unicode text facultatif Param tres reference La r f rence de la fen tre afficher auquel cas vous utiliserez une ins truction telle que display panelWindow pour le panel d enregistre ment ou d ouverture utilisez display save panel ou display open panel afterwards calling n importe Non support e dans la version 1 3 d AppleScript Studio la r f rence du script lancer lorsque la fen tre affich e est renvoy e attached to window page 76 La fen tre laquelle attacher la fen tre affich e attacher une fen tre lui donne le statut de document modal attach e comme une feuille la fen tre sp cifi e for file types list La liste d extensions de fichiers qui sont autoris es pour les panels d enregistrement ou d ouverture comme rtf ou txt ne pas inclure
381. licked page 348 comme dans l application Save Panel Ou vous pourriez vouloir afficher le panel lorsque l utilisateur choisit l l ment Enregistrer sous dans le menu Fichier Dans ce cas l utilisez un gestionnaire choose menu item page 505 e Si vous montrez le panel comme une feuille connectez un gestion naire panel ended page 553 la fen tre laquelle vous attacherez le panel e Pour afficher le panel comme une feuille document modal utilisez le param tre attached to et ne vous attendez pas obtenir une r ponse imm diate Le gestionnaire Panel Ended sera appel lorsque Traduction trad applescript 23 2 2004 Partie IX Panel Suite display 539 l utilisateur renverra le panel et vous pourrez obtenir des informations sur le panel ce moment l comme le d crit la section Exemples du gestionnaire panel ended page 553 Ci dessous vous pouvez voir comment l application Save Panel 2 affiche un panel en tant que feuille display save panel in directory theDirectory with file name theFileName attached to window of theObject Notez que lorsque vous affichez le panel d enregistrement d Apple Script Studio visible dans l illustration 9 4 vous utilisez la propri t save panel de l objet application page 29 e Si vous affichez le panel en suivant la m thode standard pas en tant que feuille le r sultat sera une application
382. lissez a Vhorizontal ou a la verticale les objets button cell seront respecti vement align s a Vhorizontal ou a la verticale 4 Cliquer une seule fois s lectionnera l objet matrix double cliquer s lectionnera un des objets button cell de l objet matrix Propri t s des objets de la classe Button Cell En plus des propri t s qu il h rite de cell page 264 un objet button cell poss de ces propri t s alternate image Acc s lecture criture Classe image page 58 Partie IV Control View Suite Traduction trad applescript 23 2 2004 262 Chapitre 1 Classes L image de la cellule lorsqu elle est dans son tat altern voir la section Discussion de la classe button page 254 alternate title Acc s lecture criture Classe Unicode text Le titre de la cellule lorsqu elle est dans son tat altern voir la section Discussion de la classe button page 254 bezel style Acc s lecture criture Classe une des constantes de bezel style page 175 Le style de contour de la cellule button type Acc s lecture criture Classe une des constantes de button type page 177 Le type de bouton de la cellule highlights by Acc s lecture criture Classe integer num ration quivalent de Behavior pour un bou ton dans Interface Builder Le m canisme par lequel le bouton est illumin la plupart des applica tions n auront pas besoin de tra
383. list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 combo box item page 279 sp cifier par Les formes cl s standards page 15 repr sente les l ments de la liste du menu d roulant de l objet combo box stock s sous forme d une liste d l ments texte Commandes support es par les objets de la classe Combo Box Votre script peut envoyer la commande suivante un objet combo box Traduction trad applescript 23 2 2004 Partie IV Control View Suite combo box 277 scroll page 339 Events support s par les objets de la classe Combo Box Un objet combo box supporte les gestionnaires r pondant aux Events suivants Action action page 345 Combo Box selection changed page 351 selection changing page 352 will dismiss page 355 will pop up page 356 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Edition begin editing page 346 changed page 348 end editing page 350 should begin editing page 353 should end editing page 354 Clavier keyboard up page 134 Souris mouse entered page 139 mouse exited page 139 Partie IV Control View Suite Traduction trad applescript 23 2 2004 278 Chapitre 1 Classes scroll wheel p
384. ll peut uniquement contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 data item page 379 sp cifier par Les formes cl s standards page 15 Les l ments des lignes que contient l objet data cell data row page 384 sp cifier par Les formes cl s standards page 15 Les lignes de l objet data cell Partie V Data View Suite Traduction trad applescript 23 2 2004 374 Chapitre 1 Classes Events support s par les objets de la classe Data Cell Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire getContactInfo suivant est extrait de l application Table distribu e avec AppleScript Studio Vous le trouverez dans le fi chier script WithDataSource applescript Ce gestionnaire montre com ment r gler le contenu d un objet data cell avec le contenu d un objet text field page 325 Chaque data cell est identifi e par son nom fournie plus t t lorsque la data source fut initialis e Get the values from the text fields and set the cells in the data row on getContactInfo theWindow theRow tell theWindow set contents of data cell name of theRow to contents of text field name set contents of data cell address of theRow to contents of text field address
385. llule e retourne la valeur on cell value theObject row theRow table column theColumn Set the value to an empty string for now set theValue to Make sure the row we re asked for is within the number of contacts if count of contacts is greater than theRow then set theContact to item theRow of contacts Get the column identifier to determine which field of the record to return set theID to identifier of theColumn if theID is name then set theValue to name of theContact else if theID is address then set theValue to address of theContact else if theID is city then set theValue to city of theContact else if theID is state then set theValue to state of theContact else if theID is zip then set theValue to zip of theContact end if end if Now return the value that we set return theValue Partie V Data View Suite Traduction trad applescript 23 2 2004 426 Chapitre 3 Events end cell value change cell value Appel par un objet table view page 403 ou outline view page 392 pour modifier la valeur d une cellule La mani re recommand e pour manipuler les donn es d un objet table view ou outline view est d utiliser un objet data source page 386 dans ce cas ce gestionnaire n est pas utile ou appel Syntaxe change cell value reference obligatoire row integer obligatoire table column table column obligatoire value item obligatoire Param tres reference La r f
386. m tres reference La r f rence de l objet dont le gestionnaire Mouse Moved est appel event event page 50 Les informations d Events de l Event mouse moved Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Mouse Moved un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on mouse moved theUbject event theEvent Add script statements here to handle the mouse moved event end mouse moved Vous pouvez utiliser le param tre theEvent pour obtenir des informa tions sur Event mouse moved comme l emplacement du curseur et si les touches Commande Option Majuscule ou Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples mouse up Appel lorsqu un Event mouse up rel chement du bouton de la souris survient et qu il peut affecter l objet Syntaxe mouse up reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Mouse Up est appel Partie II Application Suite Traduction trad applescript 23 2 2004 142 Chapitre 3 Events event event page 50 Les informations d Events de l Event mouse up Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Mouse Up un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnai
387. me temps la couleur du texte et de son fond ainsi que de sp cifier si la cellule dessine son fond ou non Vous pouvez cr er et acc der dans Interface Builder un objet text field cell en suivant ces tapes 1 Glissez un objet text field du panneau Cocoa Text sur la fen tre vis e 2 S lectionnez l objet text field 3 Maintenez enfonc e la touche Option et avec le curseur de la souris tirez une des poign es de redimensionnement En m me temps que vous faites glisser la souris Interface Builder cr e un objet matrix page 289 contenant plusieurs objet text field cell Suivant si vous glissez l horizontal ou la verticale les objets text field cell seront respectivement align s l horizontal ou la verticale 4 Cliquer une seule fois s lectionnera l objet matrix double cliquer s lectionnera un des objets text field cell de l objet matrix Propri t s des objets de la classe Text Field Cell En plus des propri t s qu il h rite de la classe cell page 264 un objet text field cell poss de ces propri t s background color Acc s lecture criture Classe RGB color La couleur de fond de la cellule une liste de trois nombres entiers Traduction trad applescript 23 2 2004 Partie IV Control View Suite text field cell 331 contenant les valeurs de chaque composant de la couleur par exemple la couleur rouge pourra tre repr sent e par 65535 0 0 par d faut
388. me un menu ou un l ment de menu et pour cr er les scripts g rant les actions invoqu es par ces l ments d interface Syntaxe plugin loaded reference obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Plugin loaded est appel 562 Chapitre 2 Events Exemples Cet exemple d crit comment cr er un plug in et l utiliser pour ajouter un menu et un l ment de menu Xcode Pour cr er un projet AppleScript plug in dans Xcode suivez ces tapes 1 2 3 Choisissez File New Project Dans la fen tre New Project Assistant faites d filer les choix jusqu la section Standard Apple Plug ins S lectionnez AppleScript Xcode Plugin Pour connecter le gestionnaire l application vous suivrez ces tapes 1 S lectionnez le projet dans la liste Groups amp Files de Xcode Les fichiers du projet devraient alors tre visibles dans la pr sentation d taill e Double cliquez le fichier nib pour l ouvrir dans Interface Builder Dans Interface Builder s lectionnez File s Owner dans la fen tre Nib Ouvrez la fen tre Info soit avec Cmd Maj I soit avec le menu Tools j Show Info Affichez le panneau AppleScript appuyez sur Cmd 7 ou utilisez le menu d roulant Ouvrez le groupe Plugin et s lectionnez le gestionnaire Plugin Loa ded S lectionnez le fichier script puis cliq
389. ments lesquels sont des objets que le Fin der connait bien comme les disques les fichiers et les dossiers Les op rations ex cut es par le Finder dans le gestionnaire sont get item theChild et get item outlineltem lesquelles lui de mandent d obtenir les l ments aux index sp cifi s e retourne childlten on child of item theObject outline item outlineltem child theChild set childItem to tell application Finder if outlineltem is O then set childItem to disk get item theChild of diskNames as string as string else set childItem to item theChild of get item outlineltem as string end if end tell return childltem end child of item Partie V Data View Suite Traduction trad applescript 23 2 2004 430 Chapitre 3 Events column clicked Appel par un objet table view page 403 ou outline view page 392 lorsqu une colonne a t cliqu e Le gestionnaire peut ex cuter des op rations comme r gler les propri t s de tri des colonnes d un objet data source page 386 Ce gestionnaire ne sera pas appel tant que l objet table view ou outline view contenant la colonne autorise le reclassement soit que la case Allows Reordering du table view ou de l outline view dans le panneau Attributes de la fen tre Info d Interface Builder est coch e soit que la propri t allows column property est r gl e sur true dans le script de l application Syntaxe column clicked refer
390. mes cl s standards page 15 les cellules de l objet matrix Events support s par les objets de la classe Matrix Un objet matrix supporte les gestionnaires r pondant aux Events sui vants Action clicked page 348 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 Traduction trad applescript 23 2 2004 Partie IV Control View Suite matrix 295 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples L application Drawer distribu e avec AppleScript Studio utilise un ob jet matrix contenant quatre boutons radios pour sp cifier le c t sur lequel son tiroir devra s ouvrir gauche haut droite ou bas Les instructions sui vantes extraites du gestionnaire awake from nib page 123 de cette ap plication r gle la propri t current row de l objet matrix pour indiquer le bouton radio s lectionn se basant sur les informations de la propri t edge de l objet drawer on awake from nib theUbject tell theUbject set openOnEdge to edge of drawer drawer
391. mmande go page 334 Pour d autres informations voir la classe movie view page 296 Constantes beginning frame Au d but end frame la fin poster frame Un poster frame image alignment Sp cifie l alignement d une image Les classes comme image cell page 284 et image view page 285 poss dent une propri t image alignment Constantes bottom alignment Alignement sur le bas bottom left alignment Alignement sur le coin inf rieur gauche bottom right alignment Alignement sur le coin inf rieur droit center alignment Alignement au centre left alignment Alignement gauche Partie II Application Suite Traduction trad applescript 23 2 2004 184 Chapitre 4 num rations right alignment Alignement droite top alignment Alignement sur le haut top left alignment Alignement sur le coin sup rieur gauche top right alignment Alignement sur le coin sup rieur droit image frame style Sp cifie le style du cadre d une image Les classes comme image cell page 284 et image view page 285 poss dent une propri t frame style Constantes button frame Cadre de bouton gray bezel frame Cadre gris groove frame Cadre rainur no frame Pas de cadre photo frame Cadre de photo image scaling Sp cifie la mise l chelle d une image Les classes comme image cell page 284 et image view page 285 poss dent une propri t image scaling T
392. mn page 398 La colonne de la cellule devant tre affich e Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Dis play Item Cell un objet outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra faire n importe quelle pr paration requise par l affichage de la cellule de l l ment sp cifi on will display item cell theObject outline item outlineltem cell theCell Partie V Data View Suite Traduction trad applescript 23 2 2004 450 Chapitre 3 Events table column tableColumn Prepare for cell to be displayed end will display item cell will display outline cell Appel avant que la cellule impl mentant le triangle de d veloppement ne soit affich e dans l objet outline view page 392 Ce gestionnaire ne pourra pas annuler l op ration d affichage mais peut la pr parer Apple recommande d utiliser un objet data source page 386 pour four nir en donn es un objet outline view dans ce cas ce gestionnaire n est pas utile ou appel Syntaxe will display outline cell reference obligatoire cell n importe obligatoire outline item item facultatif table column table column obligatoire Param tres reference La r f rence de l objet outline view page 392 contenant l outline cell qui sera affich cell n importe La cellule qui est sur le point d
393. modale rien d autre ne pourra se produire tant que l utilisateur n aura pas r pondu et le contr le reviendra l instruction qui suit l instruction display save panel Voici comment l application Save Panel fait cela set theResult to display save panel in directory theDirectory with file name theFileName Le r sultat est un nombre entier o 0 repr sente le bouton Annuler et 1 le bouton Enregistrer Vous pouvez aussi utiliser la commande Display pour afficher un panel que vous aurez pr alablement construit dans Interface Builder la place du panel d enregistrement standard fourni par AppleScript Studio Dans ce cas l vous aurez besoin d appeler la commande close panel page 535 lorsque votre panel sera renvoy Pour plus de d tails sur la mani re de faire cela voir l application Display Panel distribu e avec AppleScript Studio Etant donn une fen tre main et un panel preferences dans un fichier nib preferences nib le script suivant affiche le panel attach la fen tre load nib preferences set preferencesPanel to window preferences display preferencesPanel attached to window main Discussion Lorsque vous affichez une fen tre en tant qu application modale votre script attendra que l utilisateur renvoie la fen tre Si vous affichez la fen tre en tant que document modal en sp cifiant le param tre attached to l ex cution du script continue Pour e
394. modifie les limites de la fen tre agrandie 70 pixels depuis le c t gauche de l cran Il fait cela en obtenant les limites courantes de la fen tre en r glant la valeur de son l ment gauche 70 et en retournant ces limites pour le zoom on will zoom theObject screen bounds screenBounds Perform operations here before the object is zoomed set theBounds to bounds of theObject set item 1 of theBounds to 70 return theBounds end will zoom Version L Event Will Zoom est apparu avec la version 1 2 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie II Application Suite zoomed 171 zoomed Appel apr s qu un objet g n ralement une fen tre ou un panel soit agrandi Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer Syntaxe zoomed reference obligatoire Param tres reference La r f rence de l objet ayant t agrandi Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Zoomed un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer le zoom on zoomed theObject Perform operations here after the object zooms end zoomed Partie II Application Suite Traduction trad applescript 23 2 2004 Chapitre 4 Enum rations La suite Application fournit les num rations suivantes lesquelles d
395. mots ins r s ou supprim s afin de pr server un espacement et une ponctuation propres spell checking enabled Acc s lecture criture Classe boolean Est ce que la correction orthographique du text view est activ e text color Acc s lecture criture Classe RGB color La couleur du texte une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur verte peut tre repr sent e par 0 65535 0 text container inset Acc s lecture criture Classe point La quantit d espace libre que la view laisse autour du container texte associ un container texte repr sente l endroit o le texte est ar rang le cartouche est exprim sous forme d une liste de deux nombres largeur hauteur par d faut cette propri t vaut 0 0 text container origin Acc s lecture uniquement Classe point Partie XI Text View Suite Traduction trad applescript 23 2 2004 574 Chapitre 1 Classes L origine du container texte l int rieur du text view laquelle est calcul e partir des fronti res rectangulaires de la view du cartouche et du rectangle utilis par le container un container texte repr sente l endroit o le texte est arrang l origine est exprim e sous forme d une liste de deux nombres gauche droite voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordo
396. movie page 63 pour le movie view Pour lire avancer pas pas ou se rendre un endroit donn dans le film vous utiliserez des commandes comme start page 340 stop page 343 play page 338 step forward page 342 step back page 341 ou go page 334 pour se rendre un emplacement donn L illustration 4 7 montre un film lu dans un movie view dans l application Talking Head distribu e avec AppleScript Studio Vous pouvez stocker un film dans votre projet AppleScript Studio en glissant un fichier film depuis le Finder sur un des groupes de la liste Files dans le panneau Groups amp Files de Xcode ou en utilisant le menu Add Files du menu Project Vous pouvez afficher un film dans un movie view en le chargeant avec la commande load movie page 104 Traduction trad applescript 23 2 2004 Partie IV Control View Suite movie view 297 Vous pouvez ins rer un objet movie view dans un fichier nib dans In terface Builder en glissant l objet repr sent par le symbole QuickTime du panneau Cocoa GraphicsViews sur la fen tre vis e 6006 Talking Head FIG 4 7 Un objet movie view extrait de l application Talking Head Propri t s des objets de la classe Movie View En plus des propri t s qu il h rite de view page 229 un objet movie view poss de ces propri t s controller visible Acc s lecture criture Classe boolean Le contr leur est il
397. n Assistant distribu e avec AppleScript Stu dio depuis la version 1 1 L ordre dans lequel sont appel s les gestion naires d Events de l application pendant le d marrage y compris le gestion naire Launched est list dans la description du gestionnaire awake from nib page 123 Ce script suppose que la fen tre a comme nom AppleScript main lequel a t r gl dans le panneau AppleScript de la fen tre Info d Interface Builder on launched theObject Perform any initialization before making window visible set visible of window main to true end launched La plupart des classes d interface y compris les sous classes de la classe control page 280 h ritent de la classe view page 229 laquelle poss de un l ment window identifiant la fen tre contenant la view Les gestionnaires d Events d AppleScript Studio ont sp cifiquement un param tre sp cifiant l objet pour lequel le gestionnaire est appel Si l objet est une instance d une classe h ritant de view page 229 comme c est g n ralement le cas vous pouvez reprendre l exemple suivant pr sent dans un gestionnaire clicked page 348 pour avoir acc s la fen tre courante on clicked theObject set theWindow to window of theObject Use the reference to the enclosing window as needed in the handler end clicked Pour reproduire la mise au point faite par le clavier sur un objet comme par exemple un objet text fiel
398. n a t cliqu aussi vous devrez acc der cette valeur dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 edited data item Acc s lecture uniquement Classe data item page 379 L objet data item qui a t dit disponible depuis la version 1 3 d AppleScript Studio retourne missing value si aucun l ment n a t dit aussi vous devrez acc der cette valeur dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 indentation per level Acc s lecture criture Classe real La quantit d indentation par niveau par d faut cette propri t vaut 16 0 marker follows cell Acc s lecture criture Classe boolean Faut il que le marqueur suive les cellules c est dire comme les cel lules de l objet outline view sont indent s faut il que le triangle soit aussi indent Par d faut cette propri t vaut true selected data item Acc s lecture criture Classe data item page 379 L objet data item s lectionn disponible depuis la version 1 3 d Apple Script Studio retourne missing value si aucun l ment n a t s lectionn aussi vous devrez acc der cette valeur dans un bloc try on error pour un exemple de bloc try on error voir la section Traduction trad applescript 23 2
399. n terface Cocoa a elle aussi adopt ce systeme de noms et fournit Panel Suite page 511 laquelle inclut les classes color panel page 514 font panel page 520 open panel page 522 et autres classes de m me nature Connue cette histoire il n est gu re possible pour ce guide d tre compl tement coh rent lors de l utilisation de ces termes Toutefois la liste suivante montre comment certaines utilisations de panel correspondent aux termes utilis s dans le guide Aqua Human Interface Guidelines Voir Autres documentations page 5 pour savoir comment obtenir le guide Aqua Human Interface Guidelines e panel page 526 bas sur la classe NSPanel est un type sp cial de fen tres ayant normalement dans une application une fonction auxi liaire comme fournir le status l utilisateur Le guide Aqua Human Interface Guidelines se r f rera ces types de fen tres avec dialogs ou utility windows e color panel page 514 bas sur la classe NSColorPanel fournit une interface graphique standard permettant de s lectionner une couleur dans une application Le guide Aqua l appellera Colors windows Partie I Introduction Traduction trad applescript 23 2 2004 22 Chap 2 Les bases de la terminologie e font panel page 520 bas sur la classe NSFontPanel affiche la liste des polices disponibles autorisant la pr visualisation et la s lection
400. n trad applescript 23 2 2004 Chapitre 3 Events Les objets bas s sur les classes de la suite Panel supportent les gestion naires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestionnaire appropri devant tre ex cut Pour d terminer les Events support s par une classe se r f rer sa description alert ended c a Lama sue Eee 551 dialog aided 4 24 Lu LR a o pa 552 panel ended ce c a n ewe Bie Gee 8 vb papa 553 alert ended Appel apr s qu une alerte soit finie si le panel de celle ci a t affich comme tant attach une fen tre Lorsque vous affichez une alerte en tant qu application modale votre script devra attendre que l utilisateur renvoie l alerte Si vous l affichez en tant que document modal en sp cifiant le param tre attached to l ex cution du script continue Pour ex cuter toute action lorsque l utili sateur renvoie l alerte vous devrez fournir un gestionnaire Alert Ended Syntaxe alert ended reference obligatoire with reply alert reply facultatif 552 Chapitre 3 Events Param tres reference La r f rence de l objet window page 76 auquel a t attach le panel with reply alert reply La r ponse retourn e par l alerte Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Alert En ded un objet window
401. n de la classe application page 29 pour plus d informations sur la mani re de connecter un gestionnaire application L application lors de sa phase de lancement appelle certains gestionnaires s ils sont pr sents en respectant un ordre de priorit Le gestionnaire Idle fait partie de ces gestionnaires la liste est disponible dans la description du gestionnaire awake from nib page 123 Cet ordre sp cifie le moment o le gestionnaire Idle est appel Le gestionnaire Idle retourne le nombre de secondes que l application devra attendre avant de pouvoir nouveau l appeler Syntaxe idle reference obligatoire Param tres reference La r f rence de l objet application page 29 dont le gestionnaire Idle est appel R sultats integer Le nombre de secondes attendre avant le prochain appel du ges tionnaire Idle pour tre s r que le gestionnaire Idle sera de nouveau appel retournez toujours une valeur gale 1 ou plus Traduction trad applescript 23 2 2004 Partie II Application Suite keyboard down 133 Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Idle un objet application page 29 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration requ rant des appels r guliers Votre gestionnaire devra retourner le nombre de secondes attendre ava
402. n gestionnaire Will Mi niaturize un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer la r duction on will miniaturize theUbject Perform operations here before the object miniaturizes end will miniaturize will move Appel lorsqu un objet est sur le point d tre d plac Le gestionnaire ne peut pas annuler l op ration de d placement mais peut la pr parer Syntaxe will move reference obligatoire Param tres reference La r f rence de l objet qui va tre d plac Traduction trad applescript 23 2 2004 Partie II Application Suite will open 165 Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Move un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer le d placement on will move theObject Perform operations here before the object moves end will move will open Appel lorsqu un objet supportant ce gestionnaire comme une fen tre ou un panel est sur le point de s ouvrir Le gestionnaire ne peut pas annuler l op ration d ouverture mais peut la pr parer Syntaxe will open reference obligatoire Param tres reference La r f rence de l objet qui va s ouvrir comme
403. n objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer l application quitter on will quit theObject Perform operations here before the application quits end will quit Traduction trad applescript 23 2 2004 Partie II Application Suite will resize 167 will resign active Appel lorsqu un objet est sur le point d abandonner son tat actif Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer Il n existe pas de gestionnaire autorisant l application refuser l abandon de son tat actif Syntaxe will resign active reference obligatoire Param tres reference La r f rence de l objet application page 29 qui va abandonner son tat actif Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Re sign Active un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer l abandon de l tat actif on will resign active theObject Perform operations here before the object resigns its active state end will resign active will resize Appel lorsqu un objet window page 76 est sur le point d tre redimen sionn Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer et peut retourner
404. nce de l objet view page 229 dont les limites ont chang Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Bounds Changed un objet view page 229 AppleScript Studio ajoute automati quement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour r agir toute modification des li mites Pour mesurer cette modification vous devrez enregistrer les anciennes limites de la view et les comparer avec les limites courantes on bounds changed theUbject Perform operations here after bounds changed end bounds changed resized sub views Appel apr s que les sous views d un objet view page 229 soient redi mensionn es Syntaxe resized sub views reference obligatoire Param tres reference La r f rence de l objet view page 229 dont les sous views sont redi mensionn es Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Resized Sub Views un objet view page 229 AppleScript Studio ajoute auto matiquement au script d sign un gestionnaire vierge identique celui qui suit Pour d terminer la modification de la taille de la view vous devrez enregistrer l ancienne taille de la view ce que vous pouvez faire avec un gestionnaire will resize sub views page 247 et la comparer avec la taille Traduction trad applescript 23 2 2004 Partie III Container View Suite selected tab view item 2
405. nder une action Pour d terminer les commandes support es par chaque classe voir les descriptions propres chaque classe Close panel 4 44 esnea potia a a seau tue 535 a un ee a SR Re LR es eu DH 537 depay alert nicas Man LL ee a Nate he PR R 540 display MALE sico ia Eaki AS 543 display panel 4 asoc 4 un cross 547 E A ee BO eek eR NE Boe r 548 close panel Ferme le panel sp cifi retournant facultativement une valeur Syntaxe close panel reference obligatoire with result n importe facultatif Param tres reference La r f rence du panel fermer 536 Chapitre 2 Commandes with result n importe Le r sultat du panel doit tre soit un nombre ou une cha ne de ca ract res pouvant tre convertie en nombre par exemple un nombre entier indiquant le bouton appuy Exemples Le gestionnaire clicked page 348 suivant est extrait de l application Display Panel distribu e avec AppleScript Studio et il est connect aux boutons du panel de cette application Ce gestionnaire se trouve dans le fichier Settings applescript L application Display Panel montre com ment afficher un panel et obtenir des informations lorsqu il est renvoy Si le panel est affich comme une feuille document modal l ex cution de l application continue apr s que le panel soit affich Pour obtenir le choix de l utilisateur dans le panel l application connecte un gestionnaire panel ended
406. ndes support es par les objets de la classe Popup Button Votre script peut envoyer la commande suivante un objet popup but ton synchronize page 343 Events support s par les objets de la classe Popup Button Un objet popup button supporte les gestionnaires r pondant aux Events suivants Action action page 345 Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 Partie IV Control View Suite Traduction trad applescript 23 2 2004 304 Chapitre 1 Classes keyboard up page 134 Menu choose menu item page 505 will pop up page 356 Souris mouse entered page 139 mouse exited page 139 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples L instruction suivante extraite du gestionnaire awake from nib page 123 de l application Task List disponible depuis la version 1 2 d AppleScript Studio r gle le titre d un objet popup button nomm prio rity sur 3 set title of popup button priority to 3 Vous supprimerez des l ments de menu dans un popup button avec la commande delete et vous en ajouterez avec la commande make Par exemple dans le fichier Converter apples
407. nds est apparu avec la version 1 2 d AppleScript Studio Dans le dictionnaire d AppleScript Studio version 1 3 AppleScriptKit asdictionary il est indiqu que le type du pa ram tre proposed bounds est point Le type correct est bounding rectangle une liste de quatre nombres entiers gauche bas droite haut shown Appel apr s qu un objet application page 29 soit montr Syntaxe shown reference obligatoire Partie II Application Suite Traduction trad applescript 23 2 2004 158 Chapitre 3 Events Param tres reference La r f rence de l objet application page 29 ayant t montr Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Shown un objet application page 29 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois l objet application montr on shown theUbject Perform operations here after the object is shown end shown updated Appel apr s qu un objet soit mis jour Syntaxe updated reference obligatoire Param tres reference La r f rence de l objet ayant t mis jour Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Updated un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique
408. nly sentence size of myTextRef result 12 0 word 1 of myTextRef result This color of word 1 of myTextRef result 0 O 0 set color of word 1 of myTextRef to 65535 O 0 result color of first worth This is red Partie XI Text View Suite Traduction trad applescript 23 2 2004 578 Chapitre 1 Classes end tell end tell end tell Voir la section Exemples de la commande scroll page 339 pour plus d informations sur comment faire d filer le texte d un objet text view Voir la section Exemples de la classe view page 229 pour plus d in formations sur comment faire tourner le texte dans un objet text view Version Depuis la version 1 3 d AppleScript Studio la classe text page 569 a t fusionn e avec la classe Text View Les propri t s suivantes pr c demment dans la classe Text sont maintenant accessibles par l interm diaire de la classe Text View alignment background color content contents draws background editable field editor font horizontally resizable imports gra phics maximum size minimum size rich text selectable text color uses font panel et vertically resizable Depuis la version 1 2 d AppleScript Studio un script peut dire word 1 of text view 1 au lieu de word 1 of text of text view 1 le of text est pr sum bien que la seconde version fonctionne toujours Le support des Events de Glisser D poser est apparu avec la version 1 2 d
409. nn es uses font panel Acc s lecture criture Classe boolean La view peut elle utiliser le panel Polices uses ruler Acc s lecture criture Classe boolean Faut il que le text view utilise des r gles vertically resizable Acc s lecture criture Classe boolean La view est elle redimensionnable verticalement l ments des objets de la classe Text View En plus des l ments qu il h rite de la classe view page 229 un ob jet text view peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 text page 569 sp cifier par Les formes cl s standards page 15 Le texte de la view Events support s par les objets de la classe Text View Un objet text view supporte les gestionnaires r pondant aux Events sui vants Glisser D poser conclude drop page 481 Traduction trad applescript 23 2 2004 Partie XI Text View Suite text view 575 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 dition begin editing page 346 changed page 348 end editing page 350 should begin editing page 353 should end editing page 354 Clavier keyboard up page 134 Souris mouse entered page 139 mouse exited page 139 scroll wheel page 151 Nib
410. nnaire est appel comme le r sultat de l ouverture par l utili sateur des panels d enregistrement Enregistrer et Enregistrer sous ou en utilisant les raccourcis claviers quivalents et du choix d enregistrer le document Il s agit d un gestionnaire de bas niveau que vous utiliserez pour travailler avec les documents plus compliqu s ou les documents que d autres applica tions peuvent lire comme des fichiers texte Ce gestionnaire est responsable de l ouverture du fichier sp cifi par le param tre path name transmis et de sa fermeture apr s criture Le gestionnaire crit les donn es du document en fonction du type fourni par le param tre of type Par d faut le type de document d une application AppleScript Studio bas e sur le mod le AppleScript Document based Application est r gl sur DocumentType Vous pouvez changer le type de document de la cible active dans le projet Project Builder en modifiant la section Document Types du Target Editor Par exemple dans certaines versions de Pro ject Builder Document Types est situ dans la section Simple View de la section Info plist Entries Vous pouvez aussi y effectuer d autres mo difications comme sp cifier l Extension et les types d OS Si vous sp cifiez plusieurs types de document l application fournira un menu d roulant dans le panneau d enregistrement lors de l enregistrement du document lequ
411. nnaire pour annuler l op ration de d poser sinon vous devrez retourner true pour continuer l op ration de d poser Vous pouvez examiner la propri t pasteboard du param tre drag info pour par exemple d terminer si elle contient des donn es au format voulu Votre application pourra ne pas avoir besoin du gestionnaire Prepare Drop tant donn que le gestionnaire drop page 486 est le seul gestionnaire requis par le support du d poser de donn es dans AppleScript Studio Syntaxe prepare drop reference obligatoire drag info drag info obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Prepare Drop est appel Traduction trad applescript 23 2 2004 Partie VIT Drag and Drop Suite prepare drop 489 drag info drag info page 477 Les informations propos de l op ration de d poser Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Prepare Drop un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge Le param tre theObject r f rence l objet pour lequel un d poser est sur le point de se faire Le param tre draglnfo fournit l acc s l objet drag info page 477 contenant toutes les informa tions pertinentes sur l op ration de glisser Votre gestionnaire pourra faire n importe quelle pr paration n cessaire comme tre s r que les donn es n cessaires pour le d poser sont bien pr sentes Le ge
412. nt Classe bounding rectangle La surface visible de la view une liste de quatre nombres gauche bas droite haut la view a son propre syst me de coordonn es voir la propri t bounds de la classe window page 76 pour plus d infor mations sur le syst me des coordonn es Traduction trad applescript 23 2 2004 Partie III Container View Suite view 233 window Acc s lecture criture Classe window page 76 La fen tre contenant cette view l ments des objets de la classe View Un objet view peut contenir les l ments list s ci dessous Vos scripts peuvent sp cifier la plupart de ces l ments l aide des formes cl s d crites dans Les formes cl s standards page 15 box page 197 Sp cifier par Les formes cl s standards page 15 Les objets box de la view browser page 363 Sp cifier par Les formes cl s standards page 15 Les objets browser de la view button page 254 Sp cifier par Les formes cl s standards page 15 Les objets button de la view clip view page 202 Sp cifier par Les formes cl s standards page 15 Les objets clip view de la view color well page 271 Sp cifier par Les formes cl s standards page 15 Les objets color well de la view combo box page 274 Sp cifier par Les formes cl s standards page 15 Les objets combo box de la view control page 280 Sp cifie
413. nt avec des versions plus anciennes de Mac OS X mais n auront pas acc s aux nou velles caract ristiques comme par exemple l objet progress indicator page 306 ou l apparence m tal bross des fen tres 10 2 and later format autorise l acc s aux nouvelles caract ristiques mais ne garantit pas le bon fonctionnement avec les versions pr c dentes de Mac OS X Both Formats autorise l acc s aux nouvelles caract ristiques mais fonc tionnera aussi avec les versions pr c dentes de Mac OS X bien que sans les nouvelles caract ristiques Construire des applications AppleScript Studio Vous utiliserez Xcode distribu avec les Developer Tools pour cr er et construire des applications AppleScript Studio en utilisant un des trois mod les suivants Partie I Introduction Traduction trad applescript 23 2 2004 10 Chap 2 Les bases de la terminologie AppleScript Application utilis pour les applications qui n ont pas be soin de stocker des donn es dans des documents AppleScript Document based Application utilis pour les applica tions qui cr ent et g rent de multiples documents AppleScript Droplet utilis pour la cr ation de Droplets des scripts applications qui se d clenchent lorsque vous faites glissez l icone d un fichier ou d un dossier sur leur icone dans le Finder Vous utiliserez l application Interface Builder aussi distribu e avec les Developer Tools pour cr er des
414. nt le prochain appel du gestionnaire Idle on idle theUbject Add script statements here to perform idle operations return 1 call handler again in one second end idle AppleScript fournit des constantes pour indiquer le nombre de secondes dans une minute de minutes dans une heure etc Aussi pour provoquer le rappel du gestionnaire toutes les cinq minutes vous pouvez utiliser l ins truction suivante return 5 minutes Les constantes minutes hours days et weeks sont d crites dans le guide AppleScript Language Guide disponible dans l aide de xcode et sur le site d Apple Discussion Au d marrage de l application un gestionnaire Idle ne pourra pas tre appel pour la premi re fois tant que certains autres gestionnaires s ils sont install s ne l auront pas t avant Pour plus d informations voir la liste disponible dans la description du gestionnaire awake from nib page 123 keyboard down Appel lorsqu une touche du clavier est enfonc e Voir la classe responder page 68 pour plus d informations sur la gestion par l application des Events provoqu s par la souris ou le clavier Syntaxe Partie II Application Suite Traduction trad applescript 23 2 2004 134 Chapitre 3 Events keyboard down reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Keyboard Down est appel event event page 50
415. nt tous livr s l tat de projet c est dire que vous devrez d abord les compiler dans l application Xcode avant de pouvoir les essayer en tat de fonctionnement normal De plus ces exemples tant livr s l tat de projet vous aurez acc s leurs sources complets interface graphique et code Apple Script Studio Ces exemples peuvent tout fait tre modifi s am lior s bref vous pouvez les manipuler dans tous les sens et les recompiler si cela avait d j t fait afin de voir vos changements Au total il y a 33 exemples d applications livr s couvrant si possible l ensemble des caract ristiques d AppleScript Studio version 1 3 Certains mod les n cessitent une connexion internet pour fonctionner correctement cas de Currency Converter SOAP Daily Dilbert SOAP Talk entre autres car ils ont besoin de r cup rer des infos sur le net les autres fonctionnent en mode local Vous trouverez dans les sections de cette annexe un rapide descriptif de certains mod les mais pas des 33 disponibles uniquement de 4 Cette annexe n a pas pour but de vous expliquer en d tails leur fonctionnement ou le pourquoi du code des scripts mais de vous montrer ce que vous pou vez obtenir avec la technologie AppleScript Studio bas e sur le langage de scripting AppleScript pour r sumer avec un Mac et les outils d veloppeurs mis gratuitement disposition par Apple oui je sais 300 Mo a ne se charge pas en c
416. ntaxe should select column reference obligatoire table column table column obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 contenant la colonne table column table column page 398 La colonne devant tre s lectionn e Traduction trad applescript 23 2 2004 Partie V Data View Suite should select item 443 R sultats boolean Retourne true pour autoriser la colonne tre s lectionn e false pour l emp cher Si vous impl mentez ce gestionnaire vous devrez obligatoirement retourner une valeur bool enne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Select Column un objet table view page 403 ou outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestion naire vierge identique celui qui suit Votre gestionnaire devra d terminer s il autorise la colonne sp cifi e tre s lectionn e puis retournera la valeur appropri e on should select column theObject table column tableColumn set allowSelection to false Check variable perform test or call handler to see if OK to select If so set allowSelection to true return allowSelection end should select column should select item Appel pour d terminer si la s lection est autoris e lorsque l utilisateur clique sur un l ment dans un objet outline view page 392 Ce gestionnaire devra retourner true
417. nte ou non voir la section Exemples du gestionnaire will finish launching page 161 Avec la version d Interface Builder fournie avec Mac OS X version 10 2 vous aurez acc s la pr f rence Nib File Compatibility pr sente dans le panel General de la fen tre Preferences d Interface Builder Vous pourrez alors s lectionner le niveau de compatibilit de votre application en optant pour Traduction trad applescript 23 2 2004 Partie I Introduction Construire des applications AppleScript Studio 9 Version Dispo dans Support par 1 0 Developer Tools Developer Tools CD avec AppleScript 1 8 2 D cembre 2001 ou Mac OS X version 10 1 2 avec Apple Script 1 8 3 ou sup rieur 1 1 Developer Tools Developer Tools CD avec AppleScript 1 8 2 Avril 2002 ou sup rieur 1 2 Developer Tools Mac OS X 10 2 et sup rieur avec Apple Mac OS X 10 2 Script 1 9 0 ou sup rieur 1 2 1 Developer Tools Developer Tools CD avec AppleScript 1 9 1 D cembre 2002 ou Mac OS X version 10 2 3 avec AppleScript 1 9 1 ou sup rieur 1 3 Tools Xcode Mac OS X 10 3 et sup rieur avec Apple Mac OS X 10 3 Script 1 9 2 ou sup rieur TAB 1 1 Disponibilit de l environnement de d veloppement et du runtime d AppleScript Studio un des choix suivants n oubliez pas de red marrer Interface Builder pour que le changement soit effectivement pris en compte Pre 10 2 format vos applications fonctionnero
418. ntes vous ne devrez pas oublier que les donn es ne seront disponibles que lorsque le gestionnaire Drop sera appel Traduction trad applescript 23 2 2004 Partie VIT Drag and Drop Suite drop 487 Le gestionnaire Drop est le seul gestionnaire requis par le support du d poser de donn es dans AppleScript Studio Toutefois voir le gestionnaire conclude drop page 481 pour des informations sur la fourniture du glisser d poser aux objets text view page 569 et text field page 325 Syntaxe drop reference obligatoire drag info drag info obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Drop est appel pour rece voir les donn es d pos es drag info drag info page 477 Les informations propos de l op ration de d poser Exemples L application Drag and Drop distribu e depuis la version 1 2 d Apple Script Studio montre comment divers objets peuvent accepter le d poser de donn es Le gestionnaire Drop suivant extrait du fichier Text applescript de cette application montre comment accepter le texte d pos dans un objet text field page 325 Le gestionnaire Drop est appel lorsque le type appropri de donn es est d pos sur l objet Toutes les informations pertinentes sur le d poser sont contenues dans l objet drag info page 477 transmis dans le pa ram tre drag info Dans ce cas le gestionnaire v rifie juste que l objet pasteboard page 64 de
419. o jet MyStudioLib applescript d finissez les gestionnaires qui retourne ront les scripts que vous souhaitez impl menter Dans cet exemple il n y a qu un gestionnaire nomm makeLibScript1 lequel cr e un script nomm acknowledgeReceipt Bien qu il n y ait aucune instruction return makeLibScript1 retourne effectivement le script acknowledgeReceipt on makeLibScript1 script myLibScripti Handlers on acknowledgeReceipt display dialog The acknowledgeReceipt script greets you end acknowledgeReceipt end script end makeLibScripti Puis construisez le projet lequel produit un script compil nomm MyStudioLib scpt stock dans le bundle de l application Bien que cet exemple n en fournisse qu un seul vous pouvez d finir plusieurs gestionnaires devant retourner les scripts que vous souhaitez rendre accessible depuis votre librairie de scripts Finalement vous pouvez ajouter les instructions suivantes n importe quel projet AppleScript Studio ayant besoin d utiliser les scripts de votre projet MyStudioLib Ces instructions d finissent des propri t s initialis es avec la constante missing value afin de rendre les scripts accessibles partout dans le fichier Partie II Application Suite Traduction trad applescript 23 2 2004 44 Chapitre 1 Classes impl mentent un gestionnaire loadLibraryScripts qui charge le fi chier script depuis l application MyStudioLib et extrait un script obj
420. o aient acc s cette terminologie elles utiliseront en priorit la termi nologie d crite dans la section suivante La terminologie fournie par AppleScript Studio N AppleScript Studio d finit ses propres suites lesquelles s ajoutent a celles d ja d finies par Cocoa Ces suites fournissent une terminologie suppl mentaire utilisable sur les objets des scripts bas e sur la plupart des classes du framework Cocoa application Cette terminologie est d finie dans plusieurs fichiers suite d finition et suite terminologie dans le propre framework d AppleScript Studio le framework AppleScriptKit Chaque suite peut comporter des d finitions de classes lesquelles comprennent les l ments et les propri t s les d finitions de commandes et d Events les quelles ont une syntaxe associ e et des num rations ou des constantes pr d finies Note AppleScript Studio fait une distinction entre une commande un mot ou une phrase qu un script peut envoyer pour provoquer la modification d un objet et un Event une action g n ralement g n r e par l utilisateur qui provoque l ex cution du gestionnaire de l objet appropri C est dire que les scripts peuvent envoyer des commandes aux objets tan dis que les Events souvent le r sultat d une action de l utilisateur g n rent les appels aux gestionnaires des scripts Chacun des chapitres suivants d crit la terminologie des suites d Apple Script Studio
421. o plist de l ap plication lequel sp cifie diverses informations sur l application et le bundle pouvant tre utilis es lors de son fonctionnement y compris les types de documents le num ro de version et les informations de copyright Pour un exemple sur la v rification de la pr sence de la version minimum du runtime d AppleScript Studio exig e par une application voir la section Exemples du gestionnaire will finish launching page 161 Vous construirez un bundle dans Xcode en utilisant un de ces projets types Application Framework Loadable Bundle ou Palette Une applica tion AppleScript Studio contient automatiquement un bundle application principal m me si vous ne suivez aucune tape pour en cr er un ou pour sp cifier son contenu Ainsi qu un fichier Info plist il contient un dos sier Scripts dans le dossier Ressources contenant les fichiers scripts compil s de l application tous ayant comme extension scpt Pour plus d informations voir la section Exemples ci dessous Traduction trad applescript 23 2 2004 Partie II Application Suite bundle 39 Dans Mac OS X vous pouvez examiner le contenu d une application ayant t construite comme un bundle en faisant Control Clic sur son icone et en choisissant Afficher le contenu du progiciel dans le menu contextuel Pour des informations suppl mentaires sur le travail avec les bundles voir la commande path for page 11
422. objet control current editor Acc s lecture criture Classe text page 569 ou text view page 569 L diteur courant si l objet est sur le point d tre dit si ce n est pas le cas retourne rien g n ralement retourne une valeur comme current field editor of window id 1 of application StudioTest voir la propri t field editor de la classe text page 569 pour une description d un diteur double value Acc s lecture criture Classe real La valeur de l objet control au format double 0 0 si le contenu ne peut pas tre interpr t au format double enabled Acc s lecture criture Classe boolean L objet control est il activ float value Acc s lecture criture Classe real La valeur de l objet control au format d cimal 0 0 si le contenu ne peut pas tre interpr t au format d cimal font Acc s lecture criture Partie IV Control View Suite Traduction trad applescript 23 2 2004 282 Chapitre 1 Classes Classe font page 54 La police de l objet control formatter Acc s lecture criture Classe formatter page 56 Le formatter de l objet control cette propri t n est pas support e dans la version 1 3 d AppleScript Studio toutefois voir la section Exemples de la classe formatter page 56 pour une description sur la mani re d utiliser la commande call method page 94 pour obtenir le format
423. objet dans le fichier nib principal de l application comme la fen tre principale de l application Traduction trad applescript 23 2 2004 Partie II Application Suite awake from nib 125 sera appel avant tous les autres gestionnaires connect s l objet application page 29 lui m me Oo Oo File s Owner Info AppleScript 3 Name Index 0 Event Handlers v H Application activated idle launched open open untitled resigned active should open untitled should quit should quit after last window closed shown was hidden will become active will finish launching will hide will quit will resign active will show Document Key Mouse Nib OOO000000800000001 vvvyY JOO DO n A TT New Script Edit Script FIG 2 9 La fen tre Info d Interface Builder montrant les informations Apple Script de l instance File s Owner d une application Syntaxe awake from nib reference obligatoire Param tres reference La r f rence de l objet ayant t d sarchiv Partie II Application Suite Traduction trad applescript 23 2 2004 126 Chapitre 3 Events Exemples Lorsque vous connectez un gestionnaire Awake from Nib AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on awake from nib theUbject Perform operations here after awaking from nib end awake from nib Vous pouvez connecter
424. of theDataSource to data column sortColumnName of theData of theDataSource set sort order of sort column of theDataSource to sortColumnOrder of theData Use the append command to quickly populate the data source with the list of tasks append the theDataSource with tasks of theData Return true signaling success If you return false the document will fail to load and an alert will be presented return true end load data representation Traduction trad applescript 23 2 2004 Partie VI Document Suite read from file 469 Version Le gestionnaire Load Data Representation fut ajout dans la version 1 2 d AppleScript Studio L application Task List fut ajout e dans la version 1 2 d AppleScript Studio read from file Appel lorsque l application a besoin de lire les donn es d un document Ce gestionnaire est appel comme le r sultat de l ouverture par l utilisa teur du panel d ouverture et de la s lection d un ou de plusieurs fichiers ouvrir ou du glisser d poser d un document sur l icone de l application ou du double cliquement de l icone du document Les donn es fournies par ce gestionnaire sont les m mes que celles qui ont t crites par le gestionnaire write to file page 470 lorsque le document fut enregistr Il s agit d un gestionnaire de bas niveau que vous utiliserez pour travailler avec les documents plus compliqu s ou les documents que d a
425. om Ce processus est montr dans la section Exemples de la commande append page 417 Puis vous cr erez des objets data row page 384 pour un objet table view ou des objets data item page 379 pour un objet outline view pour la data source Pour chaque data row ou data item cr l objet data source cr era automatiquement des objets data cell pour chaque colonne donnant Traduction trad applescript 23 2 2004 Partie V Data View Suite data cell 373 par d faut chaque objet data cell le nom de sa colonne Apr s cr ation d une ligne ou d un l ment vous pouvez r gler les donn es de son objet data cell g n ralement en sp cifiant la ligne ou l l ment et le nom de la cellule Vous pouvez utiliser ces m mes informations pour obtenir le contenu d un objet data cell Propri t s des objets de la classe Data Cell Un objet data cell poss de ces propri t s content Acc s lecture criture Classe item page 60 Le contenu de la cellule synonyme de contents contents Acc s lecture criture Classe item page 60 Le contenu de la cellule synonyme de content name Acc s lecture criture Classe Unicode text Le nom de la cellule lorsque vous cr ez un objet data row page 384 un objet data cell est cr pour chaque colonne et par d faut le nom est r gl sur le nom de la colonne l ments des objets de la classe Data Cell Un objet data ce
426. omposants pilotables du systeme Mac OS e la terminologie de n importe quel compl ment de pilotage qu il soit estampill Apple ou autres un compl ment de pilotage est du code plac dans le dossier SystemAdditions des domaines System Li brary User et Network fournissant des commandes ou des coercitions suppl mentaires aux scripts install s sur le m me ordinateur e la terminologie de toute application scriptable Carbon ou Cocoa Les applications AppleScript Studio ont aussi acc s e leur propre terminologie en tant qu application Cocoa toutes les ap plications Cocoa dont le support du scripting est actif obtienne l acc s a la terminologie par d faut cette terminologie est d crite plus en d tails dans Les suites page 12 e la terminologie d finie par AppleScript Studio lui m me dans le fra mework AppleScriptKit un framework est une sorte de bundle page 38 ou de r pertoire dans le fichier syst me regroupant les res sources dont le programme a besoin e la terminologie des Suites d crites dans Les suites page 12 de n importe quel framework scriptable utilis par l application et de n importe quel bundle scriptable qu il charge Note Les termes de ces diverses terminologies peuvent parfois cr er des conflits lesquels peuvent provoquer des erreurs d interpr tation lors de l ex cution des scripts Partie I Introduction Traduction trad applescript 23 2 2004
427. on Exemples du ges tionnaire alert ended page 551 L application Display Alert distribu e avec AppleScript Studio utilise aussi un objet alert reply color panel Pluriel color panels H rite de panel page 526 Classe Cocoa NSColorPanel Fournit une interface standard pour la s lection des couleurs dans une application Un objet color panel utilise un objet color well page 271 pour s lectionner une couleur pr cise Pour utiliser un objet color panel dans les scripts de votre application vous pouvez acc der la propri t color pa nel associ e avec chaque objet application page 29 Notez que color panel avec un tiret est le nom de la classe tandis que color panel propri t de la classe application page 29 sp cifie un objet de cette classe Un objet color panel fournit un certain nombre de modes de s lection de couleurs que vous pouvez r gler en utilisant les constantes de color panel Traduction trad applescript 23 2 2004 Partie IX Panel Suite color panel 515 mode page 179 Toutefois lorsque vous obtenez ou que vous r glez une propri t de couleur d un objet AppleScript Studio la couleur sera exprim e au format RVB une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur Par exemple la couleur verte sera exprim e par 0 65535 0 L illustration 9 1 montre le panel Couleurs Le slider Opacity ne sera pas visible tan
428. on 1 2 avec un objet user defaults ne produira rien Partie II Application Suite Traduction trad applescript 23 2 2004 76 Chapitre 1 Classes window Pluriel windows H rite de responder page 68 Classe Cocoa NSWindow Repr sente une fen tre l cran Un objet window g re une fen tre l cran coordonnant l affichage et la gestion des Events de ses views Vous pouvez cr er et mettre en place des fen tres dans Interface Builder mais vous pouvez aussi contr ler directement plusieurs de leurs propri t s dans les scripts L illustration 2 7 montre une fen tre e Ne Window FIG 2 7 Une fen tre Lorsque vous cr ez une application AppleScript Studio gr ce au mod le d applications AppleScript Application de Xcode l application contient automatiquement par d faut une instance window stock e dans le fichier Nib MainMenu nib dans le groupe Resources du projet comme dans l illustration 2 8 Vous utiliserez ce mod le pour des applications n ayant pas besoin de documents Lorsque vous cr ez une application AppleScript Studio gr ce au mod le d applications AppleScript Document based Application l application contient automatiquement par d faut une instance window stock e dans le fichier nib Document nib Les applications Document based existent afin d autoriser l utilisateur cr er de multiples instances de document N importe quelle application est libre
429. on Cell Un objet button cell supporte les gestionnaires r pondant aux Events suivants Action clicked page 348 Nib awake from nib page 123 Exemples Les applications AppleScript Studio scriptent g n ralement les objets button plut t que directement les objets button cell et la classe button page 254 a certaines propri t s identiques celles de la classe button cell De plus la classe button page 254 h rite de la classe control page 280 laquelle poss de une propri t current cell par l interm diaire de laquelle Partie IV Control View Suite Traduction trad applescript 23 2 2004 264 Chapitre 1 Classes vous pouvez acc der aux propri t s des objets button cell d un bouton si n cessaire Par exemple vous pouvez utiliser le script suivant dans l ap plication diteur de Scripts pour acc der l objet button cell d un bou ton poussoir de la fen tre principale d une application AppleScript Studio Des instructions similaires fonctionneront dans le script d une application AppleScript Studio bien que vous n aurez pas besoin de l instruction tell application tell application testApplication check the image dims when disabled property image dims when disabled of current cell of first button of window 1 result 1 check transparency transparent of current cell of first button of window 1 result O end tell Version La propri t shows state by de cet
430. on de la propri t path ou dans la section Exemples de cette classe data Pluriel data H rite de item page 60 Classe Cocoa NSData Non support e dans la version 1 3 d AppleScript Studio Version La classe Data fut ajout e dans la version 1 2 d AppleScript Studio bien qu elle n apporte rien dans cette version default entry Pluriel default entries H rite de item page 60 Classe Cocoa ASKDefaultEntry Sp cifie une inscription dans le syst me des valeurs utilisateurs par d faut de Mac OS X un m canisme permettant de stocker les valeurs par d faut sous forme de couples de cl valeur ou la cl est simplement un nom au format string Vous utiliserez cette classe dans les instructions afin d obtenir de r gler ou de supprimer une entr e dans les valeurs par d faut d une application g n ralement utilis es pour stocker les pr f rences de l utilisateur pour cette application Pour plus d informations sur le syst me des valeurs par d faut voir user defaults page 72 ainsi que User defaults dans la documentation Co coa Vous pouvez aussi visualiser les pages Man du syst me des valeurs par Partie II Application Suite Traduction trad applescript 23 2 2004 46 Chapitre 1 Classes d faut en utilisant le menu Open Man Page du menu Help de Xcode disponible partir de Mac OS X version 10 2 pour afficher defaults ou bien en saisissant man default
431. on de la view l int rieur de sa super view sous forme d une liste de deux nombres gauche bas chaque view a son propre syst me de coordonn es avec l origine dans le coin sup rieur gauche voir la propri t bounds de la classe window page 76 pour plus d informa tions sur le syst me des coordonn es Partie III Container View Suite Traduction trad applescript 23 2 2004 232 Chapitre 1 Classes size Acc s lecture criture Classe point La taille de la view la taille est exprim e sous forme d une liste de deux nombres horizontal vertical par exemple 200 100 indiquerait une largeur de 200 et une hauteur de 100 voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es super view Acc s lecture criture Classe view page 229 La view contenant cette view tag Acc s lecture criture Classe integer L tiquette de la view vous pouvez r gler l tiquette pour certaines views comme des views text field page 325 dans la fen tre Info d Interface Builder tool tip Acc s lecture criture Classe Unicode text La bulle d aide de la view texte devant tre affich si l utilisateur laisse le curseur de la souris stationn quelques instants au dessus de la view visible Acc s lecture criture Classe boolean La view est elle visible visible rect Acc s lecture uniqueme
432. onnaires r pondant aux Events sui vants Nib awake from nib page 123 Partie II Application Suite Traduction trad applescript 23 2 2004 88 Chapitre 1 Classes Panel alert ended page 551 dialog ended page 552 panel ended page 553 Fen tre became key page 127 became main page 128 deminiaturized page 130 exposed page 131 miniaturized page 136 moved page 142 opened page 143 resigned key page 145 resigned main page 146 resized page 147 should close page 151 should zoom page 156 will close page 161 will miniaturize page 164 will move page 164 will open page 165 will resize page 167 will zoom page 169 Exemples Les applications pourraient avoir besoin d ex cuter des initialisations suppl mentaires avant d afficher la fen tre principale L emplacement o vous pouvez faire cela est dans le gestionnaire launched page 135 lequel est appel lorsque l application a fini son lancement et apr s le gestion naire awake from nib page 123 un autre choix possible pour l ex cution d initialisations suppl mentaires Vous pouvez r gler la propri t visible d une fen tre sur false dans Interface Builder puis la r gler sur true dans le gestionnaire launched page 135 comme montr ici pour afficher la fen tre Pour un exemple Traduction trad applescript 23 2 2004 Partie II Application Suite window 89 plus complet voir l applicatio
433. ontPanel Affiche la liste des polices disponibles autorisant l aper u et la s lection de la police Il n y a qu un seul panel Polices par application accessible par l in term diaire de la propri t font panel de l objet application page 29 No tez que font panel avec un tiret est le nom de la classe tandis que font panel sp cifie un objet de cette classe L illustration 9 2 montre le panel Polices Pour conna tre les limita tions d AppleScript Studio dans la gestion des polices voir la classe font page 54 Pour d autres informations sur les polices voir Font Panels and Font Handling dans la documentation Cocoa o O Font al jale Family Typeface Size Krungthep Bold 13 KufiStandardGK Regular 9 Letter Gothic 10 LiHei Pro 11 LiSong Pro 12 4 Lucida Grande v 13 v Use Family and Typeface System font FIG 9 2 Le panel Polices Propri t s des objets de la classe Font Panel En plus des propri t s qu il h rite de la classe panel page 526 un objet font panel poss de ces propri t s Cette classe n est pas accessible dans Interface Builder aussi vous ne pourrez pas y r gler ses propri t s vous devrez le faire dans un script Traduction trad applescript 23 2 2004 Partie IX Panel Suite font panel 521 enabled Acc s lecture criture Classe boolean Le panel est il activ font Acc s lecture criture Classe font page 5
434. onyme de minimized r duite son icone dans le dock minimized image Acc s lecture criture Classe image page 58 L image de la fen tre lorsqu elle est minimis e les objets window peuvent ne pas avoir d image minimis e aussi dans ce cas vous ris quez d obtenir une valeur missing value si vous essayez d obtenir cette propri t voir la section Exemples pour apprendre comment r gler cette propri t minimized title Acc s lecture criture Classe Unicode text Le titre de la fen tre lorsqu elle est minimis e ce titre appara t lorsque vous d placez le curseur de la souris au dessus de l icone de la fen tre minimis e dans le dock par d faut ce titre est identique la propri t title minimum size Acc s lecture criture Classe point La taille minimale de la fen tre repr sent e par une liste de deux nombres largeur minimale hauteur minimale avant la version 1 2 1 d AppleScript Studio vous ne pouviez pas utiliser cette propri t dans Traduction trad applescript 23 2 2004 Partie II Application Suite window 83 un script needs display Acc s lecture criture Classe boolean Faut il que la fen tre soit affich e R gler cette propri t sur true provoquera le redessinement de la fen tre vous pouvez aussi utiliser la commande update page 119 pour mettre jour une view voir aussi la propri t update display de la classe data so
435. op vous suivrez ces tapes 1 Glissez un objet button du panneau Cocoa Controls sur la fen tre vis e Vous pouvez utiliser n importe quel mod le de bouton affichant NSButton lorsque vous laissez le curseur de la souris dessus 2 Avec le bouton s lectionn dans la fen tre cible ouvrez la fen tre Info en choisissant Show Info dans le menu Tools ou appuyez sur les touches Cmd Maj I 3 Si le menu d roulant Behavior du panneau Attributes de la fen tre Info n est pas actif choisissez un type de bouton dans le menu d roulant Type qui provoque son activation soit Rounded Bevel Button Square Button ou Round Button 4 R glez le menu d roulant Behavior sur Toggle 5 Saisissez Start dans le champ Title et Stop dans le champ Alt Title 6 Pour tester le bouton choisissez Test Interface dans le menu File ou appuyez sur Cmd R Vous pouvez pr sent tester r ellement votre bouton et zapper son titre entre Start et Stop Pour re venir en mode cr ation quittez l application en choisissant Quitter newApplication du menu Interface Builder ou appuyez sur Cmd Q Le panneau Attributes fournit d autres r glages y compris des champs r glant l icone et l icone altern e des boutons affichant une icone Notez que vous pouvez afficher n importe quelle image dans un bouton pas uniquement un icone
436. opri ou en utilisant les fl ches du cla vier pour se d placer entre les pages Chaque page affiche une hi rarchie de views fournie par votre application Chaque onglet et sa hi rarchie de views associ e est repr sent par un objet tab view item page 227 Voir la classe scroll view page 213 pour plus d informations sur la mani re de mettre des objets dans des sous views d un tab view ou d une autre view dans Interface Builder Services Firewall Internet Internet Sharing Off You cannot start Internet Sharing because you have not selected a port over tart lt p which to share your connection Share your connection from Built in Ethernet To computers using On Ports Built in Ethernet FIG 3 7 Un tab view avec trois onglets Propri t s des objets de la classe Tab View En plus des propri t s qu il h rite de view page 229 un objet tab view poss de ces propri t s content rect Acc s lecture uniquement Classe bounding rectangle Les limites du contenu du tab view une liste de quatre nombres gauche bas droite haut le rectangle est mis au point par le syst me de coordonn es du tab view voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coor donn es Traduction trad applescript 23 2 2004 Partie III Container View Suite tab view 223 control size Acc s lecture criture Classe une
437. opri t s peut varier en fonction des r glages choisis dans l application Interface Builder et de Vinteraction des objets entre eux Autres documentations Cette section liste diff rentes sources de documentation sur les com posants d AppleScript Studio La documentation technique est dispo nible en ligne sur le site d Apple consacr aux d veloppeurs http developer apple com documentation Si vous avez install les outils d veloppeurs cette m me documentation est disponible dans le dossier developer Documentation sur votre disque dur La documentation est d clin e sous diff rents formats HTML ou PDF ou les deux Elle peut tre examin e soit avec un navigateur internet par exemple Safari ou Ca mino soit dans la fen tre Documentation de Xcode disponible dans le menu Help La documentation et les outils tant r guli rement mis jour si vous sou haitez tre averti vous pouvez vous abonner au programme Online de mise jour ADC et recevoir gratuitement la newsletter hebdomadaire par cour riel Voir la page http developer apple com membership pour plus de d tails sur ce programme Vous trouverez ci dessous la liste des documentations utiles pour Apple Script Studio e Building Applications With AppleScript Studio introduit les ca Partie I Introduction Traduction trad applescript 23 2 2004 6 Chap 1 propos de ce guide ract ristiques cl s d AppleScript Studio et fou
438. oquent des actions imm diates ou des r sultats visibles lorsqu un utilisateur les manipulent avec la souris La plupart des classes de cette suite h ritent de la classe view page 229 soit directement soit par l interm diaire de la classe control page 280 La suite Control View d finit aussi plusieurs Events fonctionnant avec les actions de l utilisateur invoquant des contr les Les classes commandes et Events de la suite Control View sont d crits dans les chapitres suivants A e ui did it 253 Commandes e en A A Ole 333 Re ee 345 Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Control View contient les classes suivantes SCION 5 Le ke LR a Se ee Gris PUTON s soe don dues eR a Ree a a bon ell 2 m 2 a sn De sa RE Ras pate Gumbo b k ei e op am doii Leu Dunes t ent GA 4 LL a ee E a e a irae cel on bo SU fs ee Re Sa EE ware MOATE IEW ooo Dk ee Bee ke we ee ee a UNE um ok a DE RIT a ee Ba ek R movie WIEN a ee E ee a Oe AAA popup button ek ee ew we eh progress indicator o o ee aasre re secure text field 0 secure text field cell oo 4444 44448 us Se 4 das gode eR me D gr ie BUBDDBE sun poplied npa dE QUE ek ce doe Ma eu VEX MO 2e 4 fo hae Lis BR Re a Riu test Held gell os s d am degree ER de bep 254 Chapitre 1 C
439. order left tabs bezel border et right tabs bezel border fonctionnent uniquement avec la version de Cocoa livr e avec Mac OS X 10 2 text alignment Sp cifie l alignement du texte Voir la propri t alignment de la classe text page 569 Constantes center text alignment Texte centr justified text alignment Texte justifi left text alignment Texte align gauche Partie II Application Suite Traduction trad applescript 23 2 2004 190 Chapitre 4 num rations natural text alignment Alignement du texte sur l alignement par d faut right text alignment Texte align droite tick mark position Sp cifie la position de la graduation Voir la propri t tick mark position de la classe slider page 315 Constantes tick mark above Graduation au dessus tick mark below Graduation en dessous tick mark left Graduation gauche tick mark right Graduation droite title position Sp cifie la position du titre Voir la propri t title position de la classe box page 197 Constantes above bottom Titre en bas au dessus de la ligne de base above top Titre en haut au dessus de la ligne de base at bottom Titre en bas at top Titre en haut Traduction trad applescript 23 2 2004 Partie II Application Suite title position 191 below bottom Titre en bas en dessous de la ligne de base below top Titre en haut en dessous de la ligne de ba
440. ordered Acc s lecture criture Classe boolean La cellule est elle d limit e cell size Acc s lecture uniquement Classe point La taille de la cellule la taille est exprim e sous forme d une liste de deux nombres horizontal vertical par exemple 75 19 indiquerait une largeur de 75 et une hauteur de 19 voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es Partie IV Control View Suite Traduction trad applescript 23 2 2004 266 Chapitre 1 Classes cell type Acc s lecture criture Classe une des constantes de cell type page 179 Le type de cellule content Acc s lecture criture Classe item page 60 Le contenu de la cellule synonyme de contents contents Acc s lecture criture Classe item page 60 Le contenu de la cellule synonyme de content continuous Acc s lecture criture Classe boolean La cellule g n re t elle des actions lorsqu elle est appuy e control size Acc s lecture criture Classe une des constantes de control size page 180 La taille du contr le de la cellule control tint Acc s lecture criture Classe une des constantes de control tint page 180 La couleur du contr le de la cellule control view Acc s lecture uniquement Classe control page 280 Le contr le que poss de la cellule double value Acc s lecture cr
441. orm any operations with the formatted text end tell end clicked Vous pouvez utiliser la commande call method page 94 pour faire d autres appels aux m thodes de la classe Cocoa NSFormatter image Pluriel images H rite de item page 60 Classe Cocoa NSImage Repr sente une image Traduction trad applescript 23 2 2004 Partie II Application Suite image 59 Vous ne pouvez pas en g n ral scripter une image par contre vous pouvez travailler avec l objet image view page 285 contenant l image L objet application page 29 poss de une propri t icon image permet tant d acc der l image de l icone ainsi qu aux l ments image Les objets button page 254 et button cell page 261 poss dent des propri t s image et alternate image lesquelles peuvent aussi tre utilis es pour stocker des images d icones ou n importe quelle autre image Pour d autres informa tions voir Drawing and Images dans la documentation Cocoa L illustration 2 5 montre l onglet Images de la fen tre MainMenu nib d une nouvelle application AppleScript Studio dans Interface Builder L image de l icone par d faut est disponible automatiquement Vous pou vez ins rer un objet image view page 285 dans la fen tre d une application en la glissant d posant depuis le panneau Cocoa Controls Vous pouvez alors glisser d poser l image depuis l onglet Images sur l image view Vous pouvez
442. ossibilit de faire d filer le contenu d un document qui est trop grand pour tre affich dans son int gralit En plus de g rer le d filement un objet scroll view peut afficher des r gles et des ascenseurs verticaux et horizontaux en fonction de la mani re dont il est configur La plupart des d filements sont g r s automatiquement par le scroll view mais voir la commande scroll page 339 pour le m canisme utilis pour faire d filer le contenu d un text view page 569 Un certain nombre de classes AppleScript Studio comporte automati quement un scroll view y compris les classes outline view page 392 table view page 403 et text view page 569 Dans Interface Builder vous pouvez incorporer n importe quel objet d interface dans un scroller en s lectionnant ces objets en choisissant Make subviews of du menu Layout puis en choisissant Scroll View Vous pouvez utiliser ce m me m canisme pour transformer les views d un objet box page 197 split view page 218 ou tab view page 221 en sous views Vous pouvez aussi utiliser ce m canisme pour grouper des objets dans une view personnalis e d finie par vous ou d autres types de views comme un objet matrix page 289 Pour faire cela suivez ces tapes 1 S lectionnez les objets grouper 2 Choisissez Make subviews of du menu Layout et choisissez Cus tom View 3 S lectionnez la view personnalis e obtenue
443. ou command ind pendamment de la fen tre associ e mais il est par contre attach un des bords de son parent et se d place le long de celui ci 0008 Drawer Open drawer on Left side Content Size f Top side Width 248 Right side O Bottom side Height 243 Prefer drawer on Left side Minimum Size ds Width 50 Right side Bottom side Height 50 X Drawer Offsets Maximum Size Leading 20 Width 300 h opened Trailing 20 Height 200 Today s Date Close Drawer Drawer State Opened p FIG 3 2 Une fen tre avec un tiroir ouvert extrait de l application Drawer Pour ajouter un tiroir votre application AppleScript Studio vous le glisserez d poserez depuis le panneau Cocoa Windows visible dans l illus tration 3 3 Vous utiliserez g n ralement l l ment fen tre montr avec un tiroir ouvert sur la gauche Il s agit d un objet de confort qui facilite la cr ation et la connexion d une fen tre de son tiroir et du contenu de celui ci Si vous glissez d posez cette fen tre sur la fen tre Nib principale de votre projet vous obtiendrez les trois instances visibles dans la rang e basse de Traduction trad applescript 23 2 2004 Partie III Container View Suite drawer 205 l illustration 3 4 Vous les utiliserez comme ceci e Instance NSDrawer Pour connecter des gestionnaires d Events l ob jet drawer s lec
444. ou une image circulaire tourne continuellement ainsi que des messages L illustration 4 9 montre une barre de progression ind termin e Let FIG 4 9 Une barre de progression ind termin e Vous trouverez l objet progress indicator dans le panneau Cocoa Controls d Interface Builder Depuis la version d Interface Builder dis tribu e avec Mac OS X version 10 2 vous pouvez aussi choisir l indicateur de progression circulaire ind termin visible dans l illustration 4 10 Ce type de barre de progression est souvent utilis pour montrer une activit comme une connexion a un r seau Vous pouvez r gler les attributs d un objet progress indicator dans la fen tre Info d Interface Builder Traduction trad applescript 23 2 2004 Partie IV Control View Suite progress indicator 307 Al FIG 4 10 L indicateur de progression circulaire ind termin prog Propri t s des objets de la classe Progress Indicator En plus des propri t s qu il h rite de la classe view page 229 un objet progress indicator poss de ces propri t s animation delay Acc s lecture criture Classe integer Le temps d attente entre chaque animation par d faut cette propri t vaut 0 bezeled Acc s lecture criture Classe boolean L objet progress indicator a t il un contour apparent Par d faut cette propri t vaut false content Acc s lecture criture Classe real
445. our acc der cette propri t de l application Mail Search Des instructions similaires fonctionneront l int rieur d un script d une application AppleScript Studio bien que n aurez pas besoin de Yencadrer par un bloc tell tell application Mail Search tell front window set isVertical to vertical of first split view Do something based on result end tell end tell Vous pourriez aussi avoir besoin de vous r f rer un split view pour acc der une autre view de votre application L instruction suivante extraite de l application Mail Search sp cifie un scroll view sur un split view d une fen tre tell scroll view mailboxes of split view 1 of theWindow Access properties or subviews of the scroll view end tell Version Le support des Events de glisser d poser est apparu avec la version 1 2 d AppleScript Studio Avant la version 1 1 d AppleScript Studio l application Mail Search se nommait Watson tab view Pluriel tab views H rite de view page 229 Classe Cocoa NSTabView Fournit une mani re facile de pr senter des informations sur plusieurs pages Partie III Container View Suite Traduction trad applescript 23 2 2004 222 Chapitre 1 Classes La view contient une rang e d onglets qui donne l apparence d un dos sier d onglets comme dans l illustration 3 7 L utilisateur s lectionne la page d sir e en cliquant sur l onglet appr
446. ource of table view contacts of scroll view contacts of theUbject Add the data columns to the data source of the contacts table view tell contactsDataSource make new data column at with properties name make new data column at with properties name make new data column at with properties name make new data column at with properties name make new data column at with properties name end tell the end of the data name the end of the data address the end of the data city the end of the data state the end of the data Zip columns columns columns columns columns Traduction trad applescript 23 2 2004 Partie V Data View Suite data item 379 end will open L illustration 5 2 montre l application en fonctionnement avec un contact Pour un autre exemple utilisant les objets data column voir la section Exemples de la classe data item page 379 060008 With Data Source Name Address City State Zip Matt Matteson 1234 First Avenue Yourtown CA 94567 Name Add Address Update City mid Remove State Zip FIG 5 2 L application Table Version Les propri t s sort case sensitivity sort order et sort type furent ajout es dans la version 1 2 d AppleScript Studio data item Pluriel data items H rite de data row page 384 Classe Cocoa ASKDataltem Repr sente une ligne d une dat
447. ous pouvez le faire dans le panneau Attri butes de la fen tre Info les l ments de menu disponibles par d faut ont des raccourci claviers comme Cmd N pour l l ment de menu Nouveau du menu Fichier key equivalent modifier Acc s lecture criture Classe number Non support e dans la version 1 3 d AppleScript Studio la touche de fonction du raccourci clavier par d faut aucun raccourci n est sp cifi pour les l ments de menu ajout s dans Interface Builder mais vous pouvez le faire dans le panneau Attributes de la fen tre Info les l ments de menu disponibles par d faut ont des touches de fonction Traduction trad applescript 23 2 2004 Partie VIII Menu Suite menu item 501 dans leur raccourci comme Maj Cmd P pour l l ment de menu Mise en Page du menu Fichier menu Acc s lecture criture Classe menu page 495 Le menu contenant l l ment de menu lorsque vous cr ez et modifiez des menus dans Interface Builder cette propri t est r gl e automati quement separator item Acc s lecture criture Classe boolean L l ment de menu est il un l ment s parateur Vous pouvez ajouter des l ments s parateurs dans Interface Builder en glissant un menu vide du panneau Cocoa Menus aidez vous des bulles d aide pour trouver cet l ment state Acc s lecture criture Classe une des constantes de cel
448. ove bottom constante 190 above top constante 190 accepts arrow keys propri t 364 action event oo eee eee ee eee 345 action cell classe 254 activated EVENT ner cake dt R Ae k 123 active propri t 31 272 alert ended EVET ssr bakes Pek e a ee Be 551 alert reply classe 513 alert return values num ration 174 alert type num ration 174 alignment propri t 265 280 570 allows branch selection Propri t 365 allows column reordering Propri t 404 allows column resizing Propri t 405 allows column selection Propri t 405 allows editing text attributes propri t 265 325 allows empty selection propri t 290 365 405 allows mixed state propri t 255 265 allows multiple selection propri t 365 405 523 allows undo Propri t 571 alpha Propri t 516 alpha value Propri t 78 alphabetical constante 188 alternate image propri t 255 261 371 alternate increment value propri t 316 alternate return constante 174 alternate title propri t 255 262 animate commande 333 animation delay
449. ow of theObject theTask else Set the UI to default values setDefaultUIValues window of theObject end if end if end selection changed selection changing Appel tr s souvent pendant une op ration de s lection multiple comme la s lection de plusieurs rang es dans un objet table view page 403 ou outline view page 392 o des l ments sont ajout s ou supprim s de la s lection Le gestionnaire peut ex cuter des actions en r ponse au changement de s lection bien qu il ne devra pas ex cuter de tr s longues op rations Lorsque l utilisateur conclut la s lection en rel chant la souris par exemple le gestionnaire selection changed page 351 est appel s il y en a un de Traduction trad applescript 23 2 2004 Partie IV Control View Suite should begin editing 353 connecter Syntaxe selection changing reference obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Selection Changing est appel Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Selec tion Changing un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Le param tre theObject r f rence l objet comme un objet browser page 363 outline view page 392 ou table view page 403 pour lequel la s lection change Vous pouvez utiliser ce gestionnaire pour ex cuter des actions en r ponse au
450. ows propri t 410 selected tab view item selection by rect propri t 293 selection changed EVENT same 351 selection changing OVENU andinas epa 352 send action on arrow key propri t 367 sends action when done edi ting propri t 269 separates columns propri t 367 separator item propri t 501 separator type constante i7 sequence number propri t 478 services menu propri t 33 shadowless square bezel constante 175 shared frameworks path propri t 40 shared support path propri t 40 sheet propri t 84 shift key down propri t 53 should begin editing EVENT o sas due 353 should close EVENT cased ee a dea 151 should collapse item event 440 should end editing event 354 should expand item event 441 Index 605 should open event 152 should open untitled event 153 should quit event 154 should quit after last window closed event 155 should select column event 442 should select item event 443 should select row event 44
451. page 553 l objet application page 29 auquel le panel est attach comme le d crit la section Exemples de la classe panel page 526 Le gestionnaire Panel Ended est appel lorsque le panel est renvoy La valeur retourn e par la commande Close Panel est transmise au gestionnaire Panel Ended lequel ne fait rien tant que la valeur est 1 indiquant que l utilisateur a cliqu sur le bouton Change et non le bouton Cancel Si le panel avait t affich comme une fen tre s par e application mo dale l ex cution s arr te jusqu ce que le panel soit renvoy Dans ce cas l un gestionnaire panel ended page 553 n est pas utile La valeur retourn e par la commande Close Panel est directement envoy e l appel du script lequel encore ne fait rien tant que la valeur est 1 indiquant que l utilisateur a cliqu le bouton Change et non le bouton Cancel on clicked theUbject if name of theUbject is cancel then close panel window of theUbject else if name of theObject is change then close panel window of theDbject with result 1 end if end clicked Traduction trad applescript 23 2 2004 Partie IX Panel Suite display 537 display Pr sente un panel la mode application modale ou document modal comme une feuille lorsque le param tre optionnel attached to est uti lis Vous devrez utiliser Display plut t que display panel page 547 pour afficher
452. panel Propri t 32 save panel Classe cti mr 529 scale proportionally constante 185 scale to fit constante 185 script propri t 61 scripts path propri t 40 scroll commande 339 scroll to location num ration 186 scroll view l ment 86 210 234 classe ananas 213 scroll wheel event 151 scroll wheel type constante 182 scrollable propri t 269 293 secondary type constante 176 604 Index secure text field l ment 86 211 234 classe 311 secure text field cell Classe cerier 314 select commande 117 select all commande 117 selectable propri t 269 327 573 selected constante 188 selected cell Propri t 367 selected column propri t 367 409 selected columns Propri t 409 selected data column propri t 409 selected data columns propri t 409 selected data item propri t 394 selected data items propri t 395 selected data row propri t 410 selected data rows propri t 410 selected row propri t 410 selected r
453. par Les formes cl s standards page 15 Les objets popup button du tiroir progress indicator page 306 Sp cifier par Les formes cl s standards page 15 Les objets progress indicator du tiroir scroll view page 213 Sp cifier par Les formes cl s standards page 15 Les objets scroll view du tiroir Traduction trad applescript 23 2 2004 Partie III Container View Suite drawer 211 secure text field page 311 Sp cifier par Les formes cl s standards page 15 Les objets secure text field du tiroir slider page 315 Sp cifier par Les formes cl s standards page 15 Les objets slider du tiroir split view page 218 Sp cifier par Les formes cl s standards page 15 Les objets split view du tiroir stepper page 320 Sp cifier par Les formes cl s standards page 15 Les objets stepper du tiroir tab view page 221 Sp cifier par Les formes cl s standards page 15 Les objets tab view du tiroir table header view page 402 Sp cifier par Les formes cl s standards page 15 Les objets table header view du tiroir table view page 403 Sp cifier par Les formes cl s standards page 15 Les objets table view du tiroir text field page 325 Sp cifier par Les formes cl s standards page 15 Les objets text field du tiroir text view page 569 Sp cifier par Les formes cl s standards page 15 Les objets te
454. param tre sp cifie l extension rechercher le second param tre sp cifie le r pertoire du bundle scanner transmettre une cha ne de caract res vide sp cifie une recherche dans tous les r pertoires Le gestionnaire stocke le nombre d images trouv es dans une propri t S il y a plusieurs images le gestionnaire idle charge une image en res pectant l ordre de la liste et le tour en question enregistre la r f rence de l ancienne image r gle la nouvelle image dans l image view afin de l affi cher et lib re l ancienne image S il n y a qu une seule image le gestionnaire idle ne s enquiquine pas essayer de la recharger property imagePaths property imageCount O property imageIndex 0 on launched theObject Get the path to all of the JPEG images in the application set imagePaths to call method pathsForResourcesOfType inDirectory Traduction trad applescript 23 2 2004 Partie II Application Suite load image 103 of main bundle with parameters JPG try set imageCount to count of imagePaths log imageCount end try end launched on idle theUbject If we have some images if imageCount gt O then Only load an image if this is the first or if we have more than one to cycle through if imageCount gt 1 or imageIndex is equal to 0 then Adjust the count set imagelndex to imagelndex 1 if imagelndex gt imageCount then set imagelndex to 1 en
455. pes de bouton dans vos scripts en utilisant les constantes d finies dans button type page 177 Traduction trad applescript 23 2 2004 Partie IV Control View Suite button 255 e Oe Window Do Not Press Fic 4 1 Un bouton Propri t s des objets de la classe Button En plus des propri t s qu il h rite de la classe control page 280 un objet button poss de ces propri t s allows mixed state Acc s lecture criture Classe boolean Le bouton autorise t il l tat mixte voir aussi la propri t state certains boutons peuvent uniquement indiquer deux tats comme ac tif ou inactif un tat mixte indique plus que deux tats supposons qu une checkbox sert v rifier du texte si tout le texte s lectionn est en style gras la checkbox est active si aucun mot du texte n est en gras elle est inactive par contre si quelques mots mais pas tous sont en gras son tat est mixte alternate image Acc s lecture criture Classe image page 58 L image du bouton lorsqu il est dans un tat altern voir la section Discussion alternate title Acc s lecture criture Classe Unicode text Le titre du bouton lorsqu il est dans un tat altern voir la section Discussion bezel style Acc s lecture criture Partie IV Control View Suite Traduction trad applescript 23 2 2004 256 Chapitre 1 Classes Classe une
456. plication pourrait modifier le format par d faut des dates voir la section Exemples pour plus d informations De telles modifications ne modifieront pas les valeurs par d faut globales pour les autres applications Les modifications touchant le syst me des valeurs par d faut sont p riodiquement et automatiquement enregistr es ainsi la prochaine fois que l application sera lanc e les nouvelles valeurs seront pr sentes Pour acc der aux d finitions des valeurs par d faut dans vos scripts AppleScript Studio vous pouvez utiliser la propri t user defaults qui est associ e avec chaque objet application page 29 Notez que User Defaults est le nom de la classe tandis que user defaults sp cifie un objet de cette classe Traduction trad applescript 23 2 2004 Partie II Application Suite user defaults 73 Important Vous ne devrez pas supprimer dans la version 1 2 d AppleScript Studio des inscriptions depuis le syst me des valeurs par d faut Le faire pourrait causer le crash de votre application Ce bug a t fix dans la version 1 2 1 Pour plus d informations sur le syst me des valeurs par d faut voir de fault entry page 45 ainsi que User Defaults dans la documentation Co coa Vous pouvez aussi visualiser les pages man sur le syst me des valeurs par d faut en utilisant le menu Open Man Page dans le menu Help de Xcode disponible depuis la version 10 2 de Mac OS X pour afficher defaul
457. portant Si vous travaillez avec la version d Interface Builder livr e avec Mac OS X version 10 2 voir Information sur les versions page 8 pour des informations sur le r glage de la pr f rence Nib File Compatibility launched page 135 will become active page 160 activated page 123 idle page 132 DO oO P Ww Acc der aux propri t s et aux l ments Alors que les l ments ont g n ralement un nom au singulier comme do cument window ou pasteboard vous utiliserez la forme plurielle pour acc der certains l ments de la classe application page 29 Par exemple vous pourrez utiliser le script suivant dans l diteur de Scripts pour obtenir la liste des fen tres d une application AppleScript Studio et vous pouvez uti liser une terminologie identique l int rieur d une application AppleScript Studio mais vous n aurez pas besoin du bloc tell application tell application MyApp set windowList to windows end Une classe peut lister les propri t s auxquelles vous ne pouvez pas acc der dans une application particuli re ou un moment particulier Par exemple la classe application page 29 propose une propri t key window qui identifie la fen tre comme tant la principale cible du clavier Mais si une application n a pas de fen tre ouverte il n y aura pas de fen tre cl et essayer d acc der la propri t key window retournera une valeur z ro Pour plus
458. position end column moved column resized Appel par un objet table view page 403 ou outline view page 392 apr s qu une colonne soit redimensionn e La nouvelle taille peut tre la m me que l ancienne Syntaxe column resized reference obligatoire old width real obligatoire table column table column obligatoire Param tres reference La r f rence de l objet table view page 403 ou outline view page 392 old width real L ancienne largeur de la colonne Partie V Data View Suite Traduction trad applescript 23 2 2004 432 Chapitre 3 Events table column table column page 398 La colonne pouvant avoir t redimensionn e Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Column Resized un objet table view page 403 ou outline view page 392 Apple Script Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra ex cuter toute op ration requise par la modification de la taille de la colonne peut tre apr s avoir d abord d termin si la largeur de la colonne a r ellement t modifi e on column resized theUbject table column tableColumn old width oldWidth if width of tableColumn is not equal to oldWidth then Add statements to perform any operations required after change of column width end if end column resized item expandable Appel par un objet outline view page 392
459. pour autoriser la s lection ou false pour la refuser Vous n aurez pas besoin de connecter ce gestionnaire moins que vous souhaitiez autoriser la s lection d un l ment dans certains cas mais Vinterdire dans d autres Syntaxe should select item reference obligatoire outline item item facultatif Partie V Data View Suite Traduction trad applescript 23 2 2004 444 Chapitre 3 Events Param tres reference La r f rence de l objet outline view page 392 contenant l l ment pouvant tre s lectionn outline item item page 60 L l ment pouvant tre s lectionn R sultats boolean Retourne true pour autoriser l l ment tre s lectionn false pour l emp cher Si vous impl mentez ce gestionnaire vous devrez obliga toirement retourner une valeur bool enne Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Select Item un objet outline view page 392 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra d terminer s il autorise l l ment sp cifi tre s lectionn puis retournera la valeur appropri e on should select item the bject outline item outlineltem set allowSelection to false Check variable perform test or call handler to see if OK to select If so set allowSelection to true return allowSelection end should select item should select row
460. pport s par les objets de la classe Scroll View Un objet scroll view supporte les gestionnaires r pondant aux Events suivants Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Partie III Container View Suite Traduction trad applescript 23 2 2004 218 Chapitre 1 Classes View bounds changed page 243 Exemples Comme beaucoup d objets r sident automatiquement sur un scroll view y compris les objets outline view page 392 table view page 403 et text view page 569 les applications AppleScript Studio ont souvent besoin d inclure un scroll view dans la sp cification d un objet La ligne suivante est extraite de l application Table distribu e avec AppleScript Studio tell table view contacts of scroll view contacts of window of theObject to update Vous pouvez acc der aux propri t s d un scroll view avec des instructions comme celle qui suit laquelle r gle une variable suivant si le scroll view a ou non un ascenseur vertical
461. pt Studio vous ne pouviez effectivement que r gler cette propri t et l obtenir ne retournait pas un objet bien utile depuis la version 1 3 la valeur retourn e ressemblera current field editor of window 1 voir la propri t field editor de la classe text page 569 pour la description d un diteur has resize indicator Acc s lecture criture Classe boolean Traduction trad applescript 23 2 2004 Partie II Application Suite window 81 Faut il que la fen tre ait un bouton de redimensionnement Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder has shadow Acc s lecture criture Classe boolean Faut il que la fen tre soit ombr e hides when deactivated Acc s lecture criture Classe boolean Faut il que la fen tre soit cach e lorsqu elle est d sactiv e Si oui passer une autre application provoquera le masquage de la fen tre par d faut cette propri t vaut false g n ralement utilis e avec les fen tres utilitaires un type sp cial de fen tres pr sent dans la des cription principale de cette classe vous pouvez r gler cette propri t dans la fen tre Info d Interface Builder key Acc s lecture criture Classe boolean La fen tre est elle la fen tre cl La fen tre cl est la cible courante des raccourcis claviers comparez les propri t s first responder et main level
462. ptionnels permettent de contr ler l affichage de la fen tre du pa nel Syntaxe display panel reference obligatoire afterwards calling n importe facultatif attached to window facultatif for file types list facultatif in directory Unicode text facultatif with file name Unicode text facultatif Param tres reference La r f rence de la fen tre afficher afterwards calling n importe Le script lancer lorsque l affichage est fini attached to window page 76 La fen tre laquelle attacher la fen tre du panel Partie IX Panel Suite Traduction trad applescript 23 2 2004 548 Chapitre 2 Commandes for file types list La liste d extensions de fichiers qui sont autoris es pour les panels d enregistrement ou d ouverture comme rtf ou txt non inclus le point marquant l extension in directory Unicode text Le r pertoire de d part pour les panels d enregistrement ou d ouver ture with file name Unicode text Le nom de ficher par d faut pour les panels d enregistrement ou d ou verture R sultats integer Une valeur enti re repr sentant le bouton qui a renvoy le panel une valeur 0 indique que le panel a t annul 1 indique qu il a t accept Exemples Pour des exemples montrant comment charger et afficher un panel voir les sections Exemples des gestionnaires panel ended page 553 et load nib page 106 Version Depuis la v
463. qu il h rite de la classe control page 280 un objet table view poss de ces propri t s voir la section Version de cette classe pour savoir dans quelle version d AppleScript Studio sont apparues certaines propri t s allows column reordering Acc s lecture criture Classe boolean Les colonnes peuvent elles tre r ordonn es Par d faut cette pro pri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder si vous connectez un gestionnaire column clicked page 430 un objet table view le gestionnaire ne sera pas appel tant que la valeur de cette propri t ne vaudra pas true Traduction trad applescript 23 2 2004 Partie V Data View Suite table view 405 allows column resizing Acc s lecture criture Classe boolean Les colonnes peuvent elles tre redimensionn es Par d faut cette pro pri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder allows column selection Acc s lecture criture Classe boolean Les colonnes peuvent elles tre s lectionn es Par d faut cette pro pri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder allows empty selection Acc s lecture criture Classe boolean Faut il que l objet table view autorise la s lection vide Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder
464. quels l dition commencera Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Begin Editing un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer l dition on begin editing theUbject Perform operations here before editing end begin editing Partie IV Control View Suite Traduction trad applescript 23 2 2004 348 Chapitre 3 Events changed Appel apr s que le contenu d un objet ait t modifi G n ralement utilis pour indiquer que l dition a provoqu une modi fication du texte d un objet text field page 325 text view page 569 ou autres Lorsque ce gestionnaire est appel il est trop tard pour faire la va lidation utiliser plut t le gestionnaire should end editing page 354 la place Voir aussi begin editing page 346 should begin editing page 353 et end editing page 350 Syntaxe changed reference obligatoire Param tres reference La r f rence de l objet dans lequel l dition a provoqu une modifica tion Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Changed un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour r pondre toute modification provoqu e par l dition
465. r impl menter sa propre version Cette commande a plusieurs param tres optionnels vous autorisant contr ler l affichage du dialogue Par exemple vous pouvez pr senter la fen tre en tant qu application modale ou en tant que document modal comme une feuille Afficher un dialogue en tant que feuille permet l utilisateur de continuer travailler avec d autres fen tres avant de r pondre L illustration 9 6 montre un dialogue feuille affich par l application Display Dialog distribu e avec AppleScript Studio Cette application montre comment afficher un dialogue et obtenir des informations lorsqu il est renvoy Syntaxe display dialog string obligatoire attached to window facultatif buttons list facultatif default answer Unicode text facultatif default button n importe facultatif giving up after integer facultatif with icon n importe facultatif Param tres string Le texte du dialogue afficher attached to window page 76 La fen tre laquelle est attach le dialogue fournir ce param tre fait que le dialogue est affich en tant que document modal attach la Partie IX Panel Suite Traduction trad applescript 23 2 2004 544 Chapitre 2 Commandes OSO Display Dialog Is this cool or what Awesome Don t Save Cancel oK 4 Button 3 OK Default Button OK With Icon 0 Giving Up After 10000 Text Retu
466. r autoriser la fermeture false pour l interdire Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Close un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra d terminer s il doit autoriser l objet se fermer puis retournera la valeur appropri e on should close theUbject set allowClose to false Check variable perform test or call handler to see if OK to close If so set allowClose to true return allowClose end should close should open Appel lorsqu un objet supportant ce gestionnaire comme une fen tre un panel ou un document est sur le point de s ouvrir Le gestionnaire peut retourner false pour annuler l op ration d ouver ture Syntaxe should open reference obligatoire Traduction trad applescript 23 2 2004 Partie II Application Suite should open untitled 153 Param tres reference La r f rence de l objet qui pourrait s ouvrir R sultats boolean Retourne true pour autoriser l ouverture false pour l interdire Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Should Open un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Votre gestionnaire devra d terminer s il doit autoriser l objet s ouvrir puis retournera la valeur appropri e
467. r la commande suivante un objet bundle Traduction trad applescript 23 2 2004 Partie II Application Suite bundle 41 path for page 112 Events support s par les objets de la classe Bundle Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire clicked page 348 suivant montre comment utiliser la propri t scripts path pour obtenir le chemin du r pertoire contenant les scripts dans le bundle principal de l application Il utilise la commande log page 111 pour afficher le r sultat on clicked theObject set thePath to scripts path of main bundle log thePath end clicked En fonction du nom et de l emplacement du projet les r sultats du gestionnaire pr c dent ressembleront ce qui suit 2002 09 03 19 59 56 032 test project 667 Volumes Projects test project build test project app Contents Resources Scripts La section Exemples de la commande path for page 112 montre com ment obtenir le chemin complet et d limit par des slashs du script principal forc ment compil d une application AppleScript Studio et comment trou ver et charger un script depuis le bundle principal de l application Le gestionnaire clicked page 348 suivant montre comment utiliser la commande call method page 94 pour acc der un bundle externe en l occurence ici l application Terminal livr e avec Mac OS X
468. r la fen tre du menu Fen tre soit en appuyant sur Cmd H Pour plus d informations sur les fen tres voir Windows and Panels dans la documentation Cocoa Syntaxe hide reference obligatoire Param tres reference La r f rence de l objet window page 76 recevant la commande Hide Exemples Le gestionnaire clicked page 348 suivant montre comment cacher une fen tre on clicked theObject Next line hides the window that contains the clicked object If you hide the current window be sure you have a reference to it so you can make it visible again tell window of theUbject to hide Partie II Application Suite Traduction trad applescript 23 2 2004 100 Chapitre 2 Commandes Next line would hide a window specified by name tell window second to hide end clicked Cacher une fen tre quivaut r gler sa propri t visible sur false L ins truction suivante produit le m me r sultat que de dire la fen tre de se cacher moins que la propri t can hide de la fen tre soit r gl e sur false dans ce cas la propri t visible n aura aucun effet set visible of window second to false load image Charge l image sp cifi e Vous chargerez une image en tant qu objet image page 58 et l afficherez dans une image view page 285 L objet application page 29 peut contenir des l ments image Les classes comme button page 254 cell page 264 drag info p
469. r par Les formes cl s standards page 15 Les objets control de la view image view page 285 Sp cifier par Les formes cl s standards page 15 Les objets image view de la view Partie III Container View Suite Traduction trad applescript 23 2 2004 234 Chapitre 1 Classes matrix page 289 Sp cifier par Les formes cl s standards page 15 Les objets matrix de la view movie view page 296 Sp cifier par Les formes cl s standards page 15 Les objets movie view de la view outline view page 392 Sp cifier par Les formes cl s standards page 15 Les objets outline view de la view popup button page 301 Sp cifier par Les formes cl s standards page 15 Les objets popup button de la view progress indicator page 306 Sp cifier par Les formes cl s standards page 15 Les objets progress indicator de la view scroll view page 213 Sp cifier par Les formes cl s standards page 15 Les objets scroll view de la view secure text field page 311 Sp cifier par Les formes cl s standards page 15 Les objets secure text field de la view slider page 315 Sp cifier par Les formes cl s standards page 15 Les objets slider de la view split view page 218 Sp cifier par Les formes cl s standards page 15 Les objets split view de la view stepper page 320 Sp cifier par
470. r plus d informations sur le syst me des coor donn es muted Acc s lecture criture Classe boolean Le film est il muet Par d faut cette propri t vaut false playing Acc s lecture criture Classe boolean Le film est il lu Traduction trad applescript 23 2 2004 Partie IV Control View Suite movie view 299 plays every frame Acc s lecture criture Classe boolean Faut il que le film lise chaque frame Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder plays selection only Acc s lecture criture Classe boolean Faut il que le lecteur lise uniquement la portion s lectionn e du film Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder rate Acc s lecture criture Classe real La vitesse laquelle le film est lu volume Acc s lecture criture Classe real Le volume sonore du film pour plus d informations sur le volume sonore voir la section Exemples de la classe slider page 315 Commandes support es par les objets de la classe Movie View N Votre script peut envoyer les commandes suivantes un objet movie view copy de la Core suite Cocoa d crite dans Core Suites de Scriptable Applications dans la documentation Cocoa go page 334 play page 338 pause page 337 start page 340 step back page 341
471. r sur un objet color well ouvre automatiquement un objet color panel page 514 et votre gestionnaire clicked sera appel unique ment la premi re fois que l objet color well sera cliqu Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Partie IV Control View Suite Traduction trad applescript 23 2 2004 274 Chapitre 1 Classes Exemples Vous travaillerez en g n ral avec les couleurs par l interm diaire de la propri t color panel de la classe application page 29 pas directement avec un objet color well Pour des exemples voir color panel page 514 Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio combo box Pluriel combo boxes H rite de text field page 325 Classe Cocoa NSComboBox Un contr le qui fournit deux fa ons de saisir une valeur soit directement par l interm diaire d un champ de saisie comme un champ texte soit en choisissant une
472. rad applescript 23 2 2004 50 Chapitre 1 Classes Version La classe Default Entry est apparue avec la version 1 1 d AppleScript Studio Avant la version 1 2 1 d AppleScript Studio supprimer une valeur utili sateur pouvait provoquer le crash de votre application La propri t content est apparue avec la version 1 2 d AppleScript Stu dio Pour plus d informations sur les diff rences entre content et contents consultez la section Version de la classe control page 280 Le gestionnaire getPlainText fut ajout l application SOAP Talk dans AppleScript Studio version 1 2 event Pluriel events H rite de item page 60 Classe Cocoa NSEvent Contient les informations sur les actions effectu es comme un clic de souris ou l appui sur une touche du clavier Chaque action de cette sorte est associ e avec une fen tre window page 76 et est rapport e l application application page 29 ayant cr la fen tre L objet event contient des informations pertinentes pour chaque Event comme l emplacement du curseur de la souris ou quel caract re a t saisi Plusieurs gestionnaires d Events comme keyboard down page 133 key board up page 134 mouse down page 137 et mouse up page 141 com portent un param tre event qui se r f re a l objet event associ avec le gestionnaire A Vint rieur de ces gestionnaires vous pouvez utiliser ce pa ram tre pour acc der aux p
473. raduction trad applescript 23 2 2004 Partie II Application Suite matrix mode 185 Constantes no scalling Pas de mise l chelle scale proportionally Mise l chelle proportionnelle scale to fit Mise l chelle pour le mieux matrix mode Sp cifie les modalit s d une structure ou d une matrice Une matrice est un groupe de cellules qui fonctionnent en concert comme des boutons radio Constantes highlight mode Une cellule est illumin e avant qu elle ne soit invit e traquer la souris puis teinte une fois fini list mode Les cellules sont illumin es mais elles ne traquent pas la souris radio mode S lection d une cellule la fois Lorsqu une cellule est s lectionn e la cellule pr c dente est d s lectionn e track mode Les cellules sont invit es traquer la souris chaque fois que celle ci est l int rieur des limites Aucun illuminement n est ex cut quicktime movie loop mode Sp cifie le mode de lecture d un film Vous pouvez obtenir ou r gler la propri t loop mode d un objet movie view page 296 Partie II Application Suite Traduction trad applescript 23 2 2004 186 Chapitre 4 num rations Constantes looping back and forth playback La lecture se fait en boucle et en va et vient d avant en arri re et d arri re en avant looping playback Lecture en boucle la lecture recommence au d but une fois le
474. rapidement des applications Mac OS X en ex cutant des scripts AppleScript et en respectant les directives de la guideline Aqua Il allie les caract ristiques d AppleScript de Xcode d Interface Builder et du frame work Cocoa application Xcode est un gestionnaire de projets cette application est apparue et ne fonctionne qu avec Mac OS X 10 3 Si votre syst me est ant rieur vous devrez utiliser Project Builder qui remplit les m mes fonctions Ce guide d crit la terminologie de scripting d AppleScript Studio ver sion 1 3 livr e avec la version 10 3 de Mac OS X Panther Par contre il ne d crit pas en d tails le langage AppleScript celui ci est expliqu en d tails dans le guide AppleScript Language Guide pour plus d informations voir la section Autres documentations page 5 Le chapitre Les bases de la terminologie page 7 fournit certaines informations fondamentales sur la terminologie de scripting d AppleScript Studio La terminologie des suites d AppleScript Studio est d crite par la suite dans les parties suivantes Application Suite 27 Container Vies SUE cierra Re dt de 195 Control View DUNO PRE 640406048 od CORA ee CARA ROA A 251 Data View BUITE celso rotante tanada aha aa kaaa aua acha 361 Document Suite 420 melti elec ides 58 E80 88 85 68 ER Eaa 455 4 Chap 1 propos de ce guide Drag and Drop Suite ceeevee eeu e
475. re en consid ration ses caract ristiques de tri retourne rien si aucune ligne n avait t cliqu e aussi vous devrez acc der cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 clicked row Acc s lecture uniquement Classe integer L index de la ligne ayant t cliqu e pour d clencher un gestionnaire d Event cette propri t vaut 0 si aucun Event ne survient la va leur retourn e de cette m thode est significative uniquement dans les gestionnaires clicked page 348 et double clicked page 349 corner view Acc s lecture criture Classe n importe La view de l angle sup rieur droit view utilis e pour dessiner la zone droite des en t tes des colonnes et au dessus de l ascenseur vertical de l objet scroll view page 213 par d faut il s agit d une simple view page 229 qui remplit simplement le cadre mais vous pouvez la remplacer par une view personnalis e draws grid Acc s lecture criture Classe boolean Faut il que l objet table view dessine sa grille Par d faut cette pro pri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder edited column Acc s lecture uniquement Classe integer L index de la colonne dit e cette propri t vaut O si aucune colonne n est dit e edited data column Acc s lecture uniq
476. re vierge identique celui qui suit on mouse up theUbject event theEvent Add script statements here to handle the mouse up event end mouse up Vous pouvez utiliser le param tre theEvent pour obtenir des informations sur l Event mouse up comme l emplacement du curseur le nombre de clics et si les touches Commande Option Majuscule ou Controle ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples moved Appel apr s que l objet ait t d plac Syntaxe moved reference obligatoire Param tres reference La r f rence de l objet ayant t d plac Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Moved un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Le param tre theObject r f rence l objet ayant t d plac g n ralement un objet view page 229 ou une sous classe de view Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois le d placement r alis Pour d terminer de combien l objet a t d plac vous devrez stocker son ancien emplacement et le comparer avec le nouvel emplacement Traduction trad applescript 23 2 2004 Partie II Application Suite open untitled 143 on moved theUbject Add script statements here to handle operations after a move end moved opened Appel apr
477. ri t vaut false next text Acc s lecture criture Classe text field page 325 Non support e dans la version 1 3 d AppleScript Studio se servir de la m thode de la classe NSMatrix sur laquelle cette propri t est bas e n est pas encourag e aussi cette propri t risque de ne jamais tre support e le prochain diteur de l objet text field previous text Acc s lecture criture Classe text field page 325 Non support e dans la version 1 3 d AppleScript Studio se servir de la m thode de la classe NSMatrix sur laquelle cette propri t est bas e n est pas encourag e aussi cette propri t risque de ne jamais tre support e le pr c dent diteur de l objet text field selectable Acc s lecture criture Classe boolean Le contenu de l objet text field peut il tre s lectionn Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder text color Acc s lecture criture Classe RGB color La couleur du texte une liste de trois nombres entiers contenant les Partie IV Control View Suite Traduction trad applescript 23 2 2004 328 Chapitre 1 Classes valeurs de chaque composant de la couleur par exemple la couleur rouge pourra tre repr sent e par 65535 0 0 par d faut cette propri t vaut 0 0 0 ou la couleur noire vous pouvez la r gler dans la fen tre Info d Interface Build
478. ript Studio ou Cocoa lui m me NSOperationNotSupportedForKeyScriptError 9 L op ration demand e n a pas support la r f rence sp cifi e NSCannotCreateScriptCommandError 10 L application a re u un Apple Event in valide ou non reconnu TAB 1 3 Les messages d erreur de scripting de Cocoa Partie I Introduction Traduction trad applescript 23 2 2004 Deuxi me partie Application Suite Cette partie d crit la terminologie de la suite Application d AppleScript Studio La suite Application donne sa propre version de certaines classes g n ralement utilis es par ou avec un objet application comprenant les nou velles versions de certaines classes d finies dans la Standard Suite Les classes qui remplacent les classes de la Standard Suite sont les classes application page 29 et window page 76 La Standard Suite est d crite dans La terminologie fournie par le framework Cocoa Application page 13 La suite Application d finit aussi la classe item page 60 laquelle poss de les propri t s name et ID et la classe responder page 68 la quelle h rite de la classe item page 60 et sert comme super classe pour les classes window page 76 view page 229 et control page 280 Toutes les classes h ritant de responder page 68 peuvent r pondre aux actions de l utilisateur Pour fonctionner avec les nombreuses classes de haut niveau qu elle contient la suite Application
479. riture Classe boolean L objet browser autorise t il la s lection d une branche lorsque la s lection multiple est activ e Chaque cellule peut tre soit une branche comme un r pertoire ou une feuille comme un fichier par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder allows empty selection Acc s lecture criture Classe boolean Peut il y avoir une s lection vide Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder allows multiple selection Acc s lecture criture Classe boolean Peut il y avoir plusieurs l ments de s lectionner Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d In terface Builder cell prototype Acc s lecture criture Classe browser cell page 370 La cellule prototype de l objet browser cette cellule est copi e pour afficher les l ments dans les colonnes de l objet browser displayed cell Acc s lecture criture Classe browser cell page 370 La cellule affich e dans l objet browser first visible column Acc s lecture criture Classe integer L index de la premi re colonne visible de l objet browser voir aussi la propri t maximum visible columns Partie V Data View Suite Traduction trad applescript 23 2 2004 366 Chapitre 1 Classes
480. rix page 289 ou table view page 403 Vous pouvez cr er et acc der dans Interface Builder un objet image cell en suivant ces tapes 1 Glissez un image view du panneau Cocoa Controls sur la fen tre vis e 2 S lectionnez l image view 3 Maintenez enfonc e la touche Option et avec le curseur de la souris tirez une des poign es de redimensionnement En m me temps que vous faites glisser la souris Interface Builder cr e un objet matrix page 289 contenant plusieurs objet image cell Suivant si vous glissez Vhorizontal ou la verticale les objets image cell seront respective ment align s l horizontal ou la verticale 4 Cliquer une fois s lectionnera l objet matrix double cliquer s lectionnera un des objets image cell de l objet matrix Pour plus d informations voir image page 58 ainsi que Image Views Matrices et Table Views dans la documentation Cocoa Propri t s des objets de la classe Image Cell En plus des propri t s qu il h rite de cell page 264 un objet image cell poss de ces propri t s image alignment Acc s lecture criture Classe une des constantes de image alignment page 183 L alignement de l image de la cellule Traduction trad applescript 23 2 2004 Partie IV Control View Suite image view 285 image frame style Acc s lecture criture Classe une des constantes de image frame style page 184 Le type de cadre de l im
481. rminer si l application doit quitter Le gestionnaire peut retourner false pour refuser de quitter l applica tion Syntaxe should quit reference obligatoire Param tres reference La r f rence de l objet application page 29 qui pourrait quitter R sultats boolean Retournera true pour autoriser l application quitter false pour Vinterdire Traduction trad applescript 23 2 2004 Partie II Application Suite should quit after last window closed 155 Exemples L exemple suivant de gestionnaire Should Quit appelle le gestionnaire allowQuitting crit par vous pour d terminer s il doit autoriser l applica tion quitter puis retournera la valeur appropri e Vous pourriez galement la place v rifier une propri t ou ex cuter une validation dans le gestion naire lui m me on should quit theUbject Check property perform test or call handler to see if OK to quit set allowQuit to allowQuitting the0bject return allowQuit end should quit should quit after last window closed Appel pour d terminer si l application doit quitter lorsque sa derni re fen tre est ferm e Le gestionnaire peut retourner false pour refuser de quitter l application Syntaxe should quit after last window closed reference obligatoire Param tres reference La r f rence de l objet application page 29 qui pourrait quitter lorsque sa derni re fen tre est ferm e R sultats boolean
482. rned Button Returned Gave Up Display Dialog V As Sheet FIG 9 6 Un dialogue feuille affich par la commande Display Dialog fen tre sp cifi e buttons list La liste des noms des boutons au maximum trois noms default answer Unicode text La r ponse par d faut default button n importe Le nom ou le num ro du bouton par d faut giving up after integer Le nombre de secondes attendre avant que le dialogue ne se ferme automatiquement with icon n importe Une cha ne de caract res ou un nombre entier qui sp cifie l icone a afficher une cha ne de caract res devra sp cifier dans le projet un fichier TIFF sans l extension tiff contenant une image pour le nombre entier vous pouvez utiliser les valeurs 0 1 et 2 voir la section Exemples ci dessous pour plus d informations Traduction trad applescript 23 2 2004 Partie IX Panel Suite display dialog 545 R sultats dialog reply Un objet dialog reply page 518 contenant les informations sur le dialogue renvoy Lorsque le dialogue est affich en tant que feuille attach une fen tre il n y a pas de r sultat imm diat et vous devrez installer un gestionnaire dialog ended page 552 pour r pondre au dialogue renvoy Exemples L exemple suivant affiche un dialogue avec un texte et trois boutons Il sp cifie un d lai giving up after 10 un bouton par d faut default button Goodbye et un t
483. rnit des tutoriels d taill s sur la cr ation d une application AppleScript Studio AppleScript Language Guide est le guide de base du langage Apple Script en quelque sorte le mode d emploi Technical Note TN2065 do shell script in AppleScript peut vous tre utile si vous comptez utiliser des scripts Shell dans vos N scripts AppleScript Vous la trouverez cette adresse http developer apple com technotes tn2002 tn2065 html e Aqua Human Interface Guidelines donne des recommandations sur l utilisation des l ments d interface comme les fen tres les boutons etc et sur leur positionnement dans l interface Aqua e la documentation sur Xcode et Interface Builder disponible dans la partie Tools Documentation e la documentation sur Cocoa disponible dans la partie Cocoa Docu mentation Traduction trad applescript 23 2 2004 Partie I Introduction Chapitre 2 Les bases de la terminologie La terminologie d crite dans ce guide permet aux applications Apple Script Studio de fonctionner avec les objets d interface Cocoa dans les scripts Ce chapitre fournit des informations importantes sur le fonction nement de la terminologie de scripting d AppleScript Studio Il contient les sections suivantes Information sur les versions Construire des applications AppleScript Studio 9 Les sources de la terminologie d AppleScript Studio 11 Les SUES so ccosa 4
484. rol de la fen tre document page 457 sp cifier par Les formes cl s standards page 15 Les objets document de la fen tre fournit l acc s au document depuis l interface de l application drawer page 204 sp cifier par Les formes cl s standards page 15 Les objets drawer de la fen tre Partie II Application Suite Traduction trad applescript 23 2 2004 86 Chapitre 1 Classes image view page 285 sp cifier par Les formes cl s standards page 15 Les objets image view de la fen tre matrix page 289 sp cifier par Les formes cl s standards page 15 Les objets matrix de la fen tre movie view page 296 sp cifier par Les formes cl s standards page 15 Les objets movie view de la fen tre popup button page 301 sp cifier par Les formes cl s standards page 15 Les objets popup button de la fen tre progress indicator page 306 sp cifier par Les formes cl s standards page 15 Les objets progress indicator de la fen tre scroll view page 213 sp cifier par Les formes cl s standards page 15 Les objets scroll view de la fen tre secure text field page 311 sp cifier par Les formes cl s standards page 15 Les objets secure text field de la fen tre slider page 315 sp cifier par Les formes cl s standards page 15 Les objets slider de la fen tre split view page 218 sp cifier par Les forme
485. rom file page 469 et write to file 456 page 470 Quelque soit les gestionnaires utilis s le grand avantage du support des documents par AppleScript Studio est que vos applications n auront plus besoin de construire des panels d ouverture d enregistrement ou d enre gistrement sous ou m me de vous soucier des noms de fichier choisis par l utilisateur L application ne fera que lire ou crire les donn es lorsque le gestionnaire appropri est appel Pour les gestionnaires de bas niveau elle utilisera le nom du fichier transmis au gestionnaire Les classes et Events de la suite Document sont d crits dans les chapitres suivants A a eu ee 457 nn aan ae ae A eo de 465 Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Traduction trad applescript 23 2 2004 Partie VI Document Suite Chapitre 1 Classes La suite Document contient la classe suivante document s o sra GA sons we Ae A amp ds 457 document Pluriel documents H rite de responder page 68 Classe Cocoa NSDocument Repr sente les donn es affich es dans les fen tres pouvant g n ralement tre lues depuis les fichiers ou crites dedans Le framework Cocoa application fournit un large support au document de base et depuis la version 1 2 d AppleScript Studio vous pouvez tirer partie de ce support dans les applications Apple
486. rop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Traduction trad applescript 23 2 2004 Partie IV Control View Suite stepper 323 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 View bounds changed page 243 Exemples Lorsque vous ajoutez un objet stepper une fen tre dans Interface Buil der vous pouvez r gler divers attributs de cet objet comme ses valeurs mini males maximales et courantes ou de d part et sa valeur d incr mentation Le gestionnaire clicked page 348 suivant est extrait de l application Dra wer distribu e avec AppleScript Studio Dans cette application l objet step per contr lant la propri t leading offset du tiroir est r gl pour autoriser une distance de 0 0 1000 0 avec une quantit d incr mentation de 1 0 Ce gestionnaire clicked lequel est appel lorsque l utilisateur clique sur le stepper v rifie le param tre theObject pour d terminer quel objet l a appel S il s agit de l objet stepper il obtient sa valeur et r gle la propri t leading offset de l objet drawer
487. ropri t sur false avant la mise jour de la data source puis la r gler sur true apr s comme il est montr dans la section Exemples de cette classe voir aussi la commande update page 119 l ments des objets de la classe Data Source Un objet data source peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 data cell page 372 sp cifier par Les formes cl s standards page 15 Les objets data cell de l objet data source chaque cellule stocke son nom son contenu et d autres informations Traduction trad applescript 23 2 2004 Partie V Data View Suite data source data column page 376 sp cifier par Les formes cl s standards page 15 Les objets data column de l objet data source chaque colonne stocke son nom et d autres informations data item page 379 sp cifier par Les formes cl s standards page 15 Les objets data item de l objet data source data row page 384 sp cifier par Les formes cl s standards page 15 Les objets data row de l objet data source view page 229 sp cifier par Les formes cl s standards page 15 Les views de l objet data source Commandes support es par les objets de la classe Data Source Votre script peut envoyer la commande suivante un objet data source append pag
488. ropri t s d crites ci dessous Propri t s des objets de la classe Event En plus des propri t s h rit es de la classe item page 60 un objet event poss de ces propri t s characters Acc s lecture seulement Classe Unicode text Traduction trad applescript 23 2 2004 Partie II Application Suite event 51 Les caract res de l Event plus pr cis ment le premier caract re saisi comme a click count Acc s lecture seulement Classe integer Le nombre de clic de Event 1 pour un simple clic 2 pour un double clic etc command key down Acc s lecture seulement Classe boolean La touche Cmd ou Pomme est elle enfonc e context Acc s lecture seulement Classe item page 60 Le contexte d affichage du receveur il n est pas recommand e d utiliser cette propri t control key down Acc s lecture seulement Classe boolean La touche Ctrl est elle enfonc e delta x Acc s lecture seulement Classe real La quantit x horizontale de l Event scroll wheel delta y Acc s lecture seulement Classe real La quantit y verticale de l Event scroll wheel delta z Acc s lecture seulement Classe real La quantit z pression de Event scroll wheel utile uniquement pour les p riph riques de saisie qui g n rent cette valeur comme les stylets des tablettes graphiques Partie II Application Sui
489. rouve l utilisation des groups boxes secondary type Mod le secondaire terminologie d un mod le de group box d crit dans une ancienne guideline la guideline de l interface Aqua d sapprouve l utilisation des groups boxes Traduction trad applescript 23 2 2004 Partie II Application Suite button type 177 separator type Mod le s parateur lorsque ce mod le est combin avec la constante groove border de border type page 175 il produit une ligne de s paration button type Sp cifie le mod le de bouton lequel peut affecter la fois l aspect du bouton et son comportement La propri t button type d un objet button page 254 sera r gl e avec l une des valeurs list es ci dessous Constantes momentary change button Momentan ment modifi momentary light button Momentan ment allum momentary push in button Momentan ment enfonc on off button Bouton on off push on off button Bouton poussoir radio button Bouton radio switch button Bouton case cocher toggle button Bouton bascule cell image position Sp cifie la position de l image dans une cellule Les objets comme button page 254 et cell page 264 poss dent tous les deux les propri t s image et image position Partie II Application Suite Traduction trad applescript 23 2 2004 178 Chapitre 4 Enum rations Constantes image above Image au dessus
490. rowser puis utilise la commande Update pour mettre jour son affichage on launched theObject tell application Finder set diskNames to name of every disk end tell set path separator of browser browser of window main to tell browser browser of window main to update end launched Traduction trad applescript 23 2 2004 Partie II Application Suite Chapitre 3 Events Les objets bas s sur les classes de la suite Application supportent les ges tionnaires d Events suivants un Event est une action g n ralement g n r e par l interaction avec l interface utilisateur provoquant l appel du gestion naire appropri devant tre ex cut Pour d terminer les Events support s par une classe se r f rer sa description AE LL LE LE Ree DRED S Ge SHARE a 123 awake Irom DED s av he oe Ge de dada 123 ecame kepy a 4 ack apy ne ut a ne mi Rouge es Ta 127 became MAN a da diet A a 128 GB ar q ac ae ee So dd on m ah die t da ae 129 demitaturizad 4 4 du 6 UE DA pe due 130 document nib name 130 EXPORT L 44 Aus beau NE Ree ee EES Oe 131 DR SE RSR RE A ee we OR A ee ee Ee S 132 keyboard doit gt se es 4 4 4 La du Pa a at 133 keyboard Upe lt sacre 2 ba ea tbe s e de bre paie 134 launched oz sis pe A 135 ea A Du Du Dh osent 136 OMR OW lt LL LINE LS GENE AE SE ut 137 mouse dragged gt ic 4 4 4 4 4 R R Pia mu na 138 mous
491. rrer Exemples tant donn un objet window page 76 nomm main comportant un objet progress indicator page 306 ind termin nomm barber pole l ins truction suivante provoquera le d marrage de l animation de l objet progress indicator tell progress indicator barber pole of window main to start L instruction suivante est quivalente start progress indicator barber pole of window main Pour un exemple plus complexe voir l application Talking Head dis tribu e avec AppleScript Studio step back Repositionne la lecture du film sur la frame pr c dant imm diatement la frame courante Si le film est jou alors il s arr tera sur la nouvelle frame Syntaxe step back reference obligatoire Param tres reference La r f rence de l objet movie view page 296 recevant la commande Step Back Partie IV Control View Suite Traduction trad applescript 23 2 2004 342 Chapitre 2 Commandes Exemples Vous pouvez indiquer un objet movie view page 296 de revenir en arri re avec les instructions suivantes tell window main tell movie view movie to step back end tell Pour un exemple plus complexe voir l application Talking Head dis tribu e avec AppleScript Studio step forward Repositionne la lecture du film sur la frame suivant imm diatement la frame courante Si le film est jou alors il s arr tera sur la nouvelle frame Synta
492. rrez r gler des points d arr t examiner des variables ou ex cuter pas amp pas vos scripts Vous pouvez aussi utiliser la commande log page 111 Traduction trad applescript 23 2 2004 Partie I Introduction Utiliser les exemples de scripts 21 d AppleScript Studio pour r cup rer les valeurs et les messages produits lors de l ex cution de votre application Utiliser les exemples de scripts Ce guide contient de nombreux exemples de scripts et de gestionnaires d Events complets ou partiels Dans certains cas les longues instructions sur plusieurs lignes contiennent des retours chariots afin de faciliter leur lecture Si vous copiez collez des exemples de scripts depuis ce guide dans les scripts de vos applications AppleScript Studio ou dans les scripts que vous utiliserez avec l diteur de Scripts ou une autre application vous devrez peut tre supprimer ces retours chariots afin de pouvoir les compiler Panels contre Dialogs et Windows Pour des raisons historiques le framework Cocoa application utilise le terme panel dans de nombreux cas o Aqua Human Interface Guide lines l arbitre final pour les choix d interface Mac OS X utiliserait plut t les termes dialog ou window L utilisation de panel est m me ancr e dans le nom des classes Cocoa comme NSPanel NSFontPanel NSOpen Panel etc La terminologie d AppleScript Studio bas e sur les classes d i
493. rtie II Application Suite Traduction trad applescript 23 2 2004 80 Chapitre 1 Classes vos scripts vous pourriez vouloir virer le contenu entier d une view en modifiant son contenu toutefois ce n est pas recommand et vous pouvez obtenir le m me r sultat en travaillant avec les classes tab view page 221 et tab view item page 227 current text editor Acc s lecture uniquement Classe text view page 569 L diteur de champ de la fen tre voir la propri t field editor de la classe text page 569 pour la description d un diteur document edited Acc s lecture criture Classe boolean Le document associ la fen tre a t il t dit depuis la version 1 2 d AppleScript Studio la classe Window a un l ment document page 457 par d faut cette propri t vaut false si la fen tre n a pas de document associ quivalente a la propri t modified de la classe document page 457 excluded from windows menu Acc s lecture criture Classe boolean La fen tre doit elle tre exclue de la liste du menu Fen tre Par d faut cette propri t vaut false first responder Acc s lecture criture Classe responder page 68 Le premier responder de la fen tre le premier objet de la cha ne res ponder charg de r pondre aux raccourcis claviers ou autres actions voir aussi la section Exemples de cette classe dans la version 1 2 d AppleScri
494. s should select tab view item Appel pour d terminer si les objets tab view item page 227 des objets devront tre s lectionn s tr s probable car l utilisateur a cliqu sur l onglet associ Ce gestionnaire peut retourner false pour refuser la s lection de l l ment aussi il n y aura pas de changement de tab item ou true pour l autoriser Un tab view item page 227 repr sente un onglet dans un tab view page 221 Syntaxe should select tab view item tab view obligatoire tab view item tab view item facultatif Param tres tab view page 221 le tab view dont le tab view item pourrait tre s lectionn tab view item tab view item page 227 le tab view item R sultats boolean Retourne true pour autoriser la s lection false pour l interdire Si vous impl mentez ce gestionnaire vous devrez toujours retourner une valeur bool enne Exemples L exemple suivant de gestionnaire Should Select Tab View Item appelle le gestionnaire shouldSelectTabViewltem crit par vous pour d terminer s il doit autoriser la s lection de l l ment puis retourne la valeur appropri e Vous pourriez aussi la place ex cuter une validation dans le gestionnaire lui m me ou v rifier certaines propri t s on should select tab view item theUbject Check property perform test or call handler to see if OK to select tab view item specified by theUbject set allowSelection to shouldSelectTabViewltem th
495. s dans une fen tre de l application Terminal cette application est situ e dans le r pertoire Applications Utilitaires Attention Dans la version 1 2 d AppleScript Studio vous ne devrez pas supprimer des inscriptions depuis le syst me des valeurs par d faut le faire pourrait causer le crash de votre application Ce bug a t fix dans la version 1 2 1 Propri t s des objets de la classe Default Entry En plus des propri t s h rit es de la classe item page 60 un objet default entry poss de ces propri t s content Acc s lecture criture Classe item page 60 La valeur de l inscription galement synonyme de contents pour plus d informations voir la section Notes de cette classe contents Acc s lecture criture Classe item page 60 La valeur de l inscription galement synonyme de content pour plus d informations voir la section Notes de cette classe Events support s par les objets de la classe Default Entry Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples La classe application page 29 poss de une propri t user defaults uti lisable pour manipuler les inscriptions des valeurs utilisateurs Par exemple vous pouvez utiliser l instruction suivante pour cr er une nouvelle inscrip tion dans les valeurs utilisateurs Le script d une application AppleScript Studio
496. s de la classe Depuis la version 1 3 d AppleScript Studio vous pouvez cr er des menus et des l ments de menu en utilisant make new et vous pouvez assigner un script aux l ments cr s Pour un exemple de script voir la section Pour plus d informations sur les menus voir Application Menus et Pop Faut il que le menu auto active ses l ments Par d faut cette pro pri t vaut true vous pouvez r gler cette valeur dans Interface Builder toutefois votre application n aura pas de solution pratique pour activer et d sactiver les l ments de menu des menus standards comme les menus Fichier et Edition aussi r gler cette propri t sur false pour ces menus n est pas recommand pour en savoir plus sur Traduction trad applescript 23 2 2004 Partie VIII Menu Suite menu 497 le support sous jacent de l activation des menus par Cocoa voir NS Menu et NSMenu Validation super menu Acc s lecture criture Classe menu page 495 Le menu contenant ce menu title Acc s lecture criture Classe Unicode text Le titre du menu vous pouvez r gler cette valeur dans Interface Buil der l ments des objets de la classe Menu Un objet menu peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 menu page 495 sp cifier par Les formes cl s s
497. s reference La r f rence de l objet menu item dont le gestionnaire Choose Menu Item a t appel Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Choose Menu Item un objet menu item page 499 AppleScript Studio ajoute 506 Chapitre 2 Events automatiquement au script d sign un gestionnaire vierge identique celui qui suit Ce gestionnaire est l o votre application traite avec les choix de menu de l utilisateur on choose menu item theDbject Add script statements here to handle the chosen menu item end choose menu item update menu item Appel p riodiquement lorsque l tat d un l ment de menu peut avoir besoin d tre mis a jour Ce gestionnaire devra retourner true pour activer l l ment de menu ou false pour le d sactiver Syntaxe update menu item reference obligatoire Param tres reference La r f rence de l objet menu item dont le gestionnaire Update Menu Item a t appel Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Update Menu Item un objet menu item page 499 AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique ce lui qui suit Le param tre theObject r f rence l l ment de menu choisi et vous pouvez utiliser ce param tre pour acc der aux propri t s ou aux l ments de l l ment Par exemple vous avez cr une application Ex plorateur
498. s un tableau comme il est montr dans la section Exemples de cette classe Depuis la version 1 1 d AppleScript Studio le comportement des ob jets table view et data source fut modifi comme suit si le nom que vous r glez pour une colonne dans le champ Identifier du panneau Attributes Traduction trad applescript 23 2 2004 Partie V Data View Suite table view 415 dans Interface Builder ne correspond pas au nom de l objet data column page 376 de votre data source aucune donn e ne sera fournie l objet data column pour dessiner Toutefois depuis la version 1 2 d AppleScript Studio et la version d In terface Builder distribu e avec Mac OS X 10 2 vous pouvez nommer les colonnes d un tableau en utilisant le champ Name du panneau Apple Script de la fen tre Info d Interface Builder Utilisez un nom identificateur est encore support afin d tre toujours compatible avec les versions plus anciennes Avant la version 1 1 d AppleScript Studio l application Mail Search s appelait Watson Partie V Data View Suite Traduction trad applescript 23 2 2004 Chapitre 2 Commandes Les objets bas s sur les classes de la suite Data View supportent les com mandes suivantes Une commande est un mot ou une phrase qu un script peut utiliser pour demander une action Pour d terminer les commandes support es par chaque classe voir les descriptions propres
499. s avoir besoin de lancer l application Terminal AppleScript Studio est certainement la mani re la plus simple et la plus rapide pour cr er une interface graphique un utilitaire UNIX Cette application utilise aussi entre autres le support du Glisser D poser un tiroir dans lequel vous pouvez choisir le lieu d enregistrement de votre archive plus diverses autres options Le bouton Hide Settings sert fermer le tiroir son intitul change en fonction de l tat du tiroir Hide Settings lorsqu il est ouvert Show Settings lorsqu il est ferm Mais aussi galement un objet data source page 386 pour stocker les noms des fichiers et le syst me des valeurs utilisateurs par d faut pour stocker les r glages de l application de l utilisateur courant Unit Converter length weight and mass 606 3 liquid volume E volume Type of Measu ZT SN temperature Convertir From square meters To square meters H Result lt Convert O FIG 12 2 La fen tre de l application Unit Converter avec les choix des types de mesure Unit Converter sert convertir des unit s de mesure Le type de me sure se fait dans le menu d roulant Type of Measure les choix possibles sont Length Weight and Mass Liquid Volume Volume Area et Tempe rature Le type de mesure choisi conditionne les choix possibles dans les deux autres menus d roulants From et To Par
500. s cl s standards page 15 Les objets split view de la fen tre stepper page 320 sp cifier par Les formes cl s standards page 15 Les objets stepper de la fen tre tab view page 221 sp cifier par Les formes cl s standards page 15 Les objets tab view de la fen tre Traduction trad applescript 23 2 2004 Partie II Application Suite window 87 table header view page 402 sp cifier par Les formes cl s standards page 15 Les objets table header view de la fen tre table view page 403 sp cifier par Les formes cl s standards page 15 Les objets table view de la fen tre text field page 325 sp cifier par Les formes cl s standards page 15 Les objets text field de la fen tre text view page 569 sp cifier par Les formes cl s standards page 15 Les objets text view de la fen tre view page 229 sp cifier par Les formes cl s standards page 15 Les objets view de la fen tre Commandes support es par les objets de la classe Window Votre script peut envoyer les commandes suivantes un objet window center page 98 close de la Core Suite de Cocoa d crite dans Core Suites de la documentation Cocoa hide page 99 print de la Core Suite de Cocoa register page 116 save de la Core Suite de Cocoa show page 118 update page 119 Events support s par les objets de la classe Window Un objet window supporte les gesti
501. s dame 241 3 Events 243 bounds changed cia x a la En ue e ae ee 243 resized sub VERE o o eos a eoe Rade hu ii a pu ae 244 selected tab view item 245 should select tab view item 246 will resize sub views 247 will select tab view item 248 IV Control View Suite 249 1 Classes 253 ACE ES anita A ae ue DR Oe eee 254 DUO oo du deb 8 BEd RA bug 254 Bon DEII S a e Lame MR SE Res Halte 261 aa a te ee D Ae 264 colorwell osorno Ne a B R A huge 271 COMIDO WOR a a de ee e pat pan 6 274 conti HO ID HU es LE Rai tee nm Eg rame 279 COMO bos 4 dun ahs BROS RA Eu gd 280 IAS ia a A 2e RE Re si us 284 WERE VIORE Le lt 4 ee lt X A 285 HAE OP SIN LS A A A a Gow oe RS 289 MOVIS VIEW sss a 4 4 4 3 6 4 4 we 8 Y ein K ee a 8 ur d 296 popup BL cae or a Dada ee ee a 301 progress AGAIN i cos bare OE mu bals a E WE ee 306 secure tert AAA cs 4 be Vis ee a GRR Wir 4 311 Table des Mati res IX secure text held cell 2 2 44 65 254 4 be EERE REE a ee iha AMM ro enis di a E E A i a a a ESA Ne Ne ae e lt v aux p a eee Ep nd a a Me a a d p de tet Beklee E a a kh Ae a oh i d a text Held cell 444 4 moa mi Se bo a deg ae e AE eG A pue 2 Commandes O a de dope had E HAS Be ma Lee ya BO 5 4 oe 0 dd e u SETTE Eh did DIS dE tea lu it Se a Se a a RL ST SUN MSN NN ICONO dmca LE LEUR RR a a a eee EURE
502. s dans Les formes cl s standards page 15 box page 197 Sp cifier par Les formes cl s standards page 15 Les objets box du tiroir browser page 363 Sp cifier par Les formes cl s standards page 15 Les objets browser du tiroir button page 254 Sp cifier par Les formes cl s standards page 15 Partie III Container View Suite Traduction trad applescript 23 2 2004 210 Chapitre 1 Classes Les objets button du tiroir clip view page 202 Sp cifier par Les formes cl s standards page 15 Les objets clip view du tiroir color well page 271 Sp cifier par Les formes cl s standards page 15 Les objets color well du tiroir combo box page 274 Sp cifier par Les formes cl s standards page 15 Les objets combo box du tiroir control page 280 Sp cifier par Les formes cl s standards page 15 Les objets control du tiroir image view page 285 Sp cifier par Les formes cl s standards page 15 Les objets image view du tiroir matrix page 289 Sp cifier par Les formes cl s standards page 15 Les objets matrix du tiroir movie view page 296 Sp cifier par Les formes cl s standards page 15 Les objets movie view du tiroir outline view page 392 Sp cifier par Les formes cl s standards page 15 Les objets outline view du tiroir popup button page 301 Sp cifier
503. s fichiers plist tant au format XML vous pouvez aussi les examiner avec n importe quel diteur de texte Pour obtenir la valeur d une inscription donn e dans les valeurs utilisa teur vous vous y r f rerez simplement par son nom Par exemple l instruc tion suivante compte tenu de l instruction pr c dentemake new retournera la valeur Testing set myName to contents of default entry defaultName of user defaults Important La valeur d un objet default entry est au format Unicode Text Dans Apple Script Studio version 1 3 vous pouvez convertir une valeur en nombre mais vous devrez d abord la convertir en texte brut si vous voulez la convertir en valeur bool enne Consultez la section Discussion ci dessous pour plus d informations Essayer d acc der une inscription qui n existe pas retournera une er reur aussi vous devrez mettre les instructions devant acc der aux valeurs utilisateurs dans un bloc try on error comme dans l exemple de la sec tion Discussion ci dessous Pour modifier une valeur vous utiliserez la terminologie suivante Partie II Application Suite Traduction trad applescript 23 2 2004 48 Chapitre 1 Classes set contents of default entry defaultName of user defaults to Check Le gestionnaire awake from nib page 123 suivant utilise l instruction tell user defaults pour viser la propri t user defaults page 72 de l ob jet application pag
504. s pouvez la r gler dans la fen tre Info d Interface Builder maximum value Acc s lecture criture Classe real La valeur maximale de l objet stepper par d faut cette propri t vaut 59 0 vous pouvez la r gler dans la fen tre Info d Interface Builder Partie IV Control View Suite Traduction trad applescript 23 2 2004 322 Chapitre 1 Classes minimum value Acc s lecture criture Classe real La valeur minimale de l objet stepper par d faut cette propri t vaut 0 0 vous pouvez la r gler dans la fen tre Info d Interface Builder value wraps Acc s lecture criture Classe boolean N ayant pas r ussi traduire l explication je laisse le texte original si quelqu un arrive trouver une traduction claire merci de me la faire suivre Does the value of the stepper wrap if true then when incrementing or decrementing the value will wrap around to the minimum or maximum value if false the value will stay pinned at the minimum or maximum default is true you can set this property in the Info window in Interface Builder El ments des objets de la classe Stepper Un objet stepper peut uniquement contenir les l ments qu il h rite de la classe control page 280 Events support s par les objets de la classe Stepper Un objet stepper supporte les gestionnaires r pondant aux Events sui vants Action clicked page 348 Glisser D poser conclude d
505. s pouvez utiliser la m thode scrollRangeToVisible de la classe NSText la classe text view h rite de la classe text page 569 comme NSTextView h rite de NSText Pour un objet window page 76 nomm main comportant un objet text view page 569 nomm myText dans un objet scroll view page 213 nomm scroller les instructions suivantes feront d filer jusqu au bas de l objet text view tell text view myText of scroll view scroller of window main set theText to contents set theLength to length of theText call method scrollRangeToVisible of object it with parameter theLength theLength end tell Substituer l instruction suivante la commande Call Method du script pr c dent fera d filer jusqu en haut de l objet text view call method scrollRangeToVisible of object it with parameter 0 0 start D marre un objet Diverses classes supportent cette commande Par exemple vous pouvez l utiliser pour d marrer l animation d un objet progress indicator page 306 ind termin ce qui met en route la vrille La commande Start ne fait rien avec un objet progress indicator d termin Vous pouvez aussi utiliser la commande Start pour jouer un film dans un objet movie view page 296 Traduction trad applescript 23 2 2004 Partie IV Control View Suite step back 341 Syntaxe start reference obligatoire Param tres reference La r f rence de l objet d ma
506. s propri t s data source et uses data source de cette classe ne sont pas support es dans la version 1 3 d AppleScript Studio combo box item Pluriel combo boxes items H rite de personne Classe Cocoa ASKComboBoxItem Repr sente un l ment de la liste du menu d roulant d un objet combo box Pour plus d informations voir combo box page 274 Events support s par les objets de la classe Combo Box Item Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires d Events Exemples Etant donn un objet combo box nomm combo dans la fen tre en avant plan l instruction suivante retournera la liste des l ments texte chaque l ment repr sentant un l ment de la liste du menu d roulant de cet objet combo box every combo box item of combo box combo of window 1 Voir la section Exemples de la classe combo box page 274 pour plus d informations sur la cr ation et la suppression des objets combo box item Version La classe combo box item est apparue avec la version 1 1 d AppleScript Studio Partie IV Control View Suite Traduction trad applescript 23 2 2004 280 Chapitre 1 Classes control Pluriel controls H rite de view page 229 Classe Cocoa NSControl Une super classe r sum fournissant trois caract ristiques fondamentales pour l impl mentation des dispositifs d interface utilisateur
507. s sur le syst me des coordonn es border type Acc s lecture criture Classe une des constantes de border type page 175 Le type de contour box type Acc s lecture criture Classe une des constantes de box type page 176 Traduction trad applescript 23 2 2004 Partie III Container View Suite box 199 Le type d objet box content view Acc s lecture criture Classe view page 229 Le contenu visuel de l objet box lequel contient toutes ses sous views pour des informations de m me nature voir la propri t content view de la classe window page 76 content view margins Acc s lecture criture Classe point Les marges du content view calcul es depuis le bord de l objet box une liste de deux nombres gauche bas par d faut elle est gale 5 0 5 0 afin de pouvoir modifier les r glages de cette propri t vous devrez utiliser la commande call method page 94 comme dans l exemple suivant tell box 1 set content view margins to 2 5 2 5 call method sizeToFit end tell title Acc s lecture criture Classe Unicode text Le titre de l objet box title cell Acc s lecture uniquement Classe cell page 264 La cellule du titre title font Acc s lecture criture Classe font page 54 Non support e dans la version 1 3 d AppleScript Studio la police de la cellule du titre title position Acc s lecture cr
508. se no title Sans titre Partie II Application Suite Traduction trad applescript 23 2 2004 Troisi me partie Container View Suite Cette partie d crit la terminologie de la suite Container View d Apple Script Studio La suite Container View d finit la classe view page 229 La plupart des classes de la suite Container View h rite de la classe responder page 68 soit directement soit par l interm diaire de la classe view La suite Container View d finit aussi les Events fonctionnant avec les containers views et les views qu ils contiennent Les classes commandes et Events de la suite Container View sont d crits dans les chapitres suivants RS i 197 AS LE a a PE tte af a tt ne be dt 239 A ease ea DDR SE REIMS 243 Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Container View contient les classes suivantes 5 gt gt JAM Re bare ere de D de De 0 197 PR Me decay wy gt hee a C Not Li die uma 202 PAWNEE ooe ees Swe RO PURE NN RAR MR EUR 204 scroll view 213 BOG VIEW La La Rene a R b E Ue d RA G ts Le 218 VUE s a 4 4 boum pale me R h aa dut e E amp 221 tab view WERE cc saaa as d R N Na A de a ee 227 MISMO R E Se ee Bk ee Bak Sects ae Bk ee 229 box Pluriel boxes H rite de view page 229 Classe Cocoa NSBox Une view
509. se Cocoa NSUserDefaults Fournit l acc s aux valeurs utilisateurs par d faut des applications g n ralement utilis es pour stocker les pr f rences de l application Le syst me des valeurs utilisateurs par d faut de Mac OS X stocke les valeurs par couple cl valeur o la cl est simplement une cha ne de ca ract res Il y a plusieurs domaines pour les valeurs par d faut Les valeurs par d faut du domaine global sont accessibles n importe quelle applica tion Par exemple pendant la phase Development de la construction de l application celle ci pourrait r gler une valeur utilisateur par d faut que le d bogger v rifiera pour d terminer s il doit afficher certaines informa tions de d boguage Les valeurs par d faut dans le domaine application sont g n ralement utilis es pour stocker les informations de pr f rences des ap plications Lorsqu une application AppleScript Studio est lanc e elle peuple ses valeurs par d faut sp cifiques avec les valeurs par d faut qu elle peut obtenir depuis le domaine application et le domaine global lequel contient les va leurs par d faut s appliquant toutes les applications d un utilisateur Par contre une application ne peut pas ajouter ses propres valeurs par d faut au domaine global mais elle peut faire des modifications qui l emportent sur les valeurs par d faut globales charg es l int rieur de son propre domaine Par exemple l ap
510. source item sound Partie II Application Suite Traduction trad applescript 23 2 2004 38 Chapitre 1 Classes Les l ments suivants furent ajout s l objet application dans la ver sion 1 2 d AppleScript Studio drag info pasteboard bundle Pluriel bundles H rite de item page 60 Classe Cocoa NSBundle Repr sente un emplacement dans le fichier systeme regroupant le code et les ressources pouvant tre utilis s dans un programme Chaque objet application page 29 a une propri t main bundle repr sentant le bundle principal de cette application Bien que ce soit rare dans les applications AppleScript Studio une application peut contenir des bundles suppl mentaires Un objet bundle repr sente le r pertoire o des ressources li es y compris le code ex cutable sont stock es Un bundle peut trouver les ressources demand es dans le r pertoire et peut dynamiquement charger le code ex cutable bien que cela ne sera pas n cessaire pour la plupart des applications AppleScript Studio Un objet bundle a des propri t s qui sp cifient son emplacement dans le fichier syst me ainsi que l emplacement de certains de ses l ments Vous pouvez aussi utiliser la commande path for page 112 pour obtenir le chemin des l ments du bundle de l application Un bundle peut contenir des images des sons des chaines de caract res localis es et des plugs ins Il contient aussi le fichier Inf
511. ssant descending Tri d croissant Partie II Application Suite Traduction trad applescript 23 2 2004 188 Chapitre 4 num rations Version sort order est apparu avec la version 1 2 d AppleScript Studio sort type Sp cifie le type de tri comme lors du tri des colonnes d une Data Source Constantes alphabetical Tri alphab tique numerical Tri num rique Version sort type est apparu avec la version 1 2 d AppleScript Studio tab state Sp cifie l tat d un onglet d un objet tab view item page 227 La propri t tab state d un objet tab view item est en lecture uniquement Constantes background Onglet en arri re plan pressed Onglet appuy selected Onglet s lectionn tab view type Sp cifie le type d un objet tab view page 221 par la position et le format des onglets Traduction trad applescript 23 2 2004 Partie II Application Suite text alignment 189 Constantes bottom tabs bezel border tiquettes en bas contour collerette left tabs bezel border Etiquettes gauche contour collerette no tabs bezel border Sans tiquettes contour collerette no tabs line border Sans tiquettes contour ligne no tabs no border Sans tiquettes sans contour right tabs bezel border Etiquettes droite contour collerette top tabs bezel border tiquettes en haut contour collerette Version bottom tabs bezel b
512. steboard types Acc s lecture seulement Classe list Une liste des types de donn es support s par le pasteboard compos e a partir des types de valeurs list s plus haut dans la description de cette classe Events support s par les objets de la classe Pasteboard Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Pour obtenir les donn es d un pasteboard vous aurez besoin de r gler la propri t preferred type du pasteboard par d faut celle ci sera r gl e sur string mais cette propri t peut avoir t modifi e Pour obtenir les donn es du pasteboard general au format string vous pouvez utiliser les instructions suivantes set preferred type of pasteboard general to string set myString to contents of pasteboard general Pour obtenir les donn es d un pasteboard vous devrez aussi d abord r gler la propri t preferred type du pasteboard Pour r gler les donn es du pasteboard general au format string vous pouvez utiliser les instructions suivantes mais voir aussi la section Version de cette classe set preferred type of pasteboard general to string set contents of pasteboard general to Testing Vous pouvez lister les pasteboards d une application l aide d un script comme celui qui suit vous pouvez utiliser ces m mes instructions l int rieur d une application Appl
513. stionnaire devra re tourner false pour annuler l op ration de d poser ou true pour l autoriser on prepare drop theUbject drag info draglnfo Statements to prepare for a drop In this example only allow drop if string info available if string is in types of pasteboard of dragInfo then return true else return false end if end prepare drop Version Le gestionnaire Prepare Drop fut ajout dans la version 1 2 d Apple Script Studio Partie VIT Drag and Drop Suite Traduction trad applescript 23 2 2004 Huiti me partie Menu Suite Cette partie d crit la terminologie de la suite Menu d AppleScript Studio La suite Menu d finit un petit nombre de classes et de gestionnaires pour le travail avec les menus Cette suite d crit les classes menu page 495 et menu item page 499 et les gestionnaires choose menu item page 505 et update menu item page 506 dans les chapitres suivants Le chapitre num rations page 173 de Application Suite page 27 d taille les diff rentes constantes utilis es dans cette suite Chapitre 1 Classes La suite Menu contient les classes suivantes MA 5 ao le Bae Gea te RARE ESS or 495 men POT ose Ga a due D ee A do 499 menu Pluriel menus H rite de item page 60 Classe Cocoa NSMenu Repr sente un menu Pour chaque menu de la barre de menus comme Application Fi chier dition etc il y a un objet menu Pour
514. t s ou aux l ments de l application et le param tre document pour acc der aux propri t s ou aux l ments du document Ce gestionnaire devra retourner le nom du document Nib Par exemple si votre fichier document Nib s appelle MyDocument nib votre gestionnaire pourrait ressembler cela on document nib name theObject for document theDocument If necessary statements to determine name of document nib file return MyDocument end document nib name Version Le gestionnaire Document Nib Name est apparu avec la version 1 2 d AppleScript Studio exposed Non support dans la version 1 3 d AppleScript Studio Appel apr s qu un objet window page 76 ait t expos pour visualisation Le gestionnaire peut ex cuter n importe quelle op ration demand e par l exposition de l objet window page 76 Partie II Application Suite Traduction trad applescript 23 2 2004 132 Chapitre 3 Events Syntaxe exposed reference obligatoire Param tres reference La r f rence de l objet window page 76 ayant t expos idle Appel intervalles r guliers comme il a t d fini dans l application Vous utiliserez g n ralement un gestionnaire Idle pour ex cuter de tr s longues ou r curantes op rations prenant place en dehors du circuit principal de l application Vous connecterez un gestionaire Idle un objet application Consultez la descriptio
515. t data cell Pour un objet table view page 403 vous cr erez des objets data row page 384 la place des objets data item comme le d crit la section Exemples de la classe data row page 384 Propri t s des objets de la classe Data Item En plus des propri t s qu il h rite de la classe data row page 384 un objet data item poss de ces propri t s has data items Acc s lecture uniquement Classe boolean Cet l ment contient il des objets data item has parent data item Acc s lecture uniquement Classe boolean Cet l ment a t il un l ment parent parent data item Acc s lecture criture Classe data item page 379 L l ment parent de l l ment Traduction trad applescript 23 2 2004 Partie V Data View Suite data item 381 l ments des objets de la classe Data Item Un objet data item peut contenir les l ments list s ci dessous Votre script peut acc der la plupart de ces l ments avec les formes cl s d crites dans Les formes cl s standards page 15 data cell page 372 sp cifier par Les formes cl s standards page 15 Les objets data cell de la colonne un par ligne data item page 379 sp cifier par Les formes cl s standards page 15 Les l ments imbriqu s des l ments data row page 384 sp cifier par Les formes cl s standards page 15 Les objets data row de la colonne Events support s par
516. t des Events pour glisser suivre la trace pr parer et conclure le d poser Pour des informations de m me nature voir la classe pasteboard page 64 Le support initial du glisser d poser fut ajout dans la version 1 2 d AppleScript Studio Il fournit la capacit divers l ments d interface de recevoir des Events de glisser Il n autorise pas toutefois l engagement d op rations de glisser d poser autres que celles d j support es par les classes Cocoa Entre autres les classes supportant le glisser d poser sont button page 254 clip view page 202 color well page 271 combo box page 274 control page 280 image view page 285 matrix page 289 movie view page 296 popup button page 301 progress indicator page 306 scroll view page 213 slider page 315 stepper page 320 tab view page 221 text field page 325 text view page 569 et view page 229 Pour un objet r pondant n importe quel gestionnaire de glisser d poser les gestionnaires sont d crits en d tails dans la section Events vous devrez r pertorier le type de glisser que l objet peut accepter Vous ferez cela avec la commande register page 116 en utilisant son param tre drag type pour fournir la liste des types de pasteboard drag support s Les types de pasteboard possibles sont list s dans la classe pasteboard page 64 Le gestionnaire drop page 486 est le seul gestionnaire requis par le support du d
517. t elle redimensionnable horizontalement imports graphics Acc s lecture criture Classe boolean Faut il que la view importe des graphiques maximum size Acc s lecture criture Classe point La taille maximale de la view la taille est exprim e sous forme d une liste de deux nombres horizontal vertical voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es minimum size Acc s lecture criture Classe point La taille minimale de la view la taille est exprim e sous forme d une liste de deux nombres horizontal vertical voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es rich text Acc s lecture criture Classe boolean Le texte supporte t il le format RTF Rich Text Format Par d faut cette propri t vaut true Traduction trad applescript 23 2 2004 Partie XI Text View Suite text view 573 ruler visible Acc s lecture criture Classe boolean La r gle est elle visible selectable Acc s lecture criture Classe boolean La view est elle s lectionnable smart insert delete enabled Acc s lecture criture Classe boolean Est ce que la carte d insertion et de suppression de texte est activ e Par d faut cette propri t vaut true contr le si la view ins re ou supprime les espaces autour des
518. t false dans ce cas elle n aura aucun effet zoomed Acc s lecture criture Classe boolean La fen tre est elle agrandie Traduction trad applescript 23 2 2004 Partie II Application Suite window 85 l ments des ob jets de la classe Window Un objet window peut contenir les l ments list s ci dessous Votre script peut sp cifier la plupart des l ments avec n importe laquelle des formes cl s d crites dans Les formes cl s standards page 15 box page 197 sp cifier par Les formes cl s standards page 15 Les objets box de la fen tre browser page 363 sp cifier par Les formes cl s standards page 15 Les objets browser de la fen tre button page 254 sp cifier par Les formes cl s standards page 15 Les objets button de la fen tre clip view page 202 sp cifier par Les formes cl s standards page 15 Les objets clip view de la fen tre non support s par les fen tres dans la version 1 3 d AppleScript Studio un objet scroll view page 213 utilise un clip view mais sans intervention de votre application color well page 271 sp cifier par Les formes cl s standards page 15 Les objets color well de la fen tre combo box page 274 sp cifier par Les formes cl s standards page 15 Les objets combo box de la fen tre control page 280 sp cifier par Les formes cl s standards page 15 Les objets cont
519. t outline view a partir de laquelle doit tre obtenu l l ment Traduction trad applescript 23 2 2004 Partie V Data View Suite item for 421 R sultats data item page 379 L objet data item de la ligne sp cifi e de l objet outline view Retourne aucun r sultat si la ligne sp cifi e est hors classement Exemples Les instructions suivantes sont tir es du gestionnaire mailBoxesForIndex de l application Mail Search distribu e avec AppleScript Studio Entre autres choses l application Mail Search utilise un objet outline view page 392 pour afficher les comptes e mail chacun pouvant avoir plusieurs bo tes lettres Une bo te lettres son tour a un nom et peut contenir des bo tes imbriqu es Le gestionnaire mailBoxesForIndex utilise la commande Item For pour obtenir la ligne d un certain index puis obtient les donn es le nom de la bo te de cette ligne partir du premier objet data cell page 372 de cet l ment Determine if the selected item is an account or a mailbox tell outline view mailboxes of scroll view mailboxes of split view 1 of theWindow set theItem to item for row mailboxIndex set theName to contents of data cell 1 of theltem some statements omitted end tell Partie V Data View Suite Traduction trad applescript 23 2 2004 Chapitre 3 Events Les objets bas s sur les classes de la suite Data View supportent les ges tionnaires d Events suiv
520. t que vous n aurez pas r gl la propri t shows alpha du color panel sur true Pour plus d informations sur les couleurs et les objets color panel voir Using Color dans la documentation Cocoa O Colors O Opacity FIG 9 1 Le panel Couleurs Propri t s des objets de la classe Color Panel En plus des propri t s qu il h rite de la classe panel page 526 un objet color panel poss de ces propri t s Cette classe n est pas accessible dans Interface Builder aussi vous ne pourrez pas y r gler ses propri t s vous devrez le faire dans un script Partie IX Panel Suite Traduction trad applescript 23 2 2004 516 Chapitre 1 Classes alpha Acc s lecture criture Classe real La valeur alpha de la couleur va de 0 0 transparent 1 0 opaque par d faut cette propri t vaut 1 0 color Acc s lecture criture Classe RGB color La couleur retourn e sous la forme d une liste de trois nombres en tiers valeur rouge valeur verte valeur bleue par exemple 0 0 0 repr sente la couleur noire tandis que 0 65535 0 repr sente la couleur verte color mode Acc s lecture criture Classe une des constantes de color panel mode page 179 Le mode couleur de l objet color panel continuous Acc s lecture criture Classe boolean Faut il que l objet color panel renvoie de fa on instantan e les modi fications de couleur quand l
521. t renvoy Dans ce cas un gestionnaire panel ended page 553 n est pas utile L application Open Panel distribu e avec AppleScript Studio depuis la version 1 1 montre comment utiliser le panel Ouvrir la fois comme un panel s par et comme une feuille Voir Document Suite page 455 pour des informations sur la mani re de lire et d crire des fichiers Version La propri t path names est apparue avec la version 1 1 d AppleScript Studio Depuis la version 1 1 d AppleScript Studio le nom de la classe open panel a t modifi en open panel Ceci afin de mieux diff rencier la classe open panel de la propri t open panel de l objet application page 29 Avant la version 1 1 d AppleScript Studio cette classe avait des fonctions limit es L application Open Panel a t distribu e pour la premi re fois avec la version 1 1 d AppleScript Studio Partie IX Panel Suite Traduction trad applescript 23 2 2004 526 Chapitre 1 Classes panel Pluriel panels H rite de window page 76 Classe Cocoa NSPanel Un type de fen tres qui a g n ralement une fonction auxiliaire dans une application Par exemple un panel peut tre facultativement affich comme une fen tre utilitaire laquelle peut flotter par dessus d autres fen tres Vous cr erez un objet panel dans Interface Builder en le faisant glisser en de hors du panneau Cocoa Windows Les
522. t uniquement contenir les l ments qu il h rite de la classe view page 229 Events support s par les objets de la classe Table Header View Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Vous ne scripterez g n ralement pas un objet table header view table view Pluriel table views H rite de control page 280 Classe Cocoa NSTableView Une view qui affiche des enregistrements de donn es dans un tableau et qui autorise l utilisateur diter les valeurs redimensionner et r organiser les colonnes Un objet table view affiche les donn es d une s rie d enregistrements ap parent s avec les lignes repr sentant des enregistrements individuels et les colonnes les attributs de ces enregistrements Si vous utilisez un objet data source page 386 pour alimenter en donn es le table view la data source fonctionnera avec la view pour automatiquement afficher les bonnes informa tions lorsque l utilisateur scrollera redimensionnera la fen tre r organisera les colonnes ou modifiera les lignes et les colonnes affich es Vous trouverez l objet table view dans le panneau Cocoa Data d Inter face Builder Lorsque vous ins rez un objet table view dans une fen tre cet objet est automatiquement inclus dans un objet scroll view page 213 Vous pouvez r gler la plupart des attributs des objets table view dans l
523. t utilise la commande Increment pour l incr menter Version Avant la version 1 1 d AppleScript Studio l application Mail Search se nommait Watson Traduction trad applescript 23 2 2004 Partie IV Control View Suite perform action 337 pause Non support e dans la version 1 1 d AppleScript Studio Met sur pause l activit courante Syntaxe pause reference obligatoire Param tres reference La r f rence de l objet mettre sur pause perform action Indique l objet receveur d ex cuter son action provoque l ex cution du gestionnaire concern Par exemple vous pouvez dire un objet d interface comme un objet button page 254 d ex cuter son gestionnaire clicked page 348 fournis sant par cons quent une mani re directe de scripter l interface utilisateur Notez toutefois qu appeler le gestionnaire clicked ne produira pas le retour visuel qu un utilisateur verrait s il avait r ellement cliqu sur le bouton Pour d autres limitations du scripting de l interface utilisateur voir le guide Building Applications With AppleScript Studio disponible dans l aide de Project Builder ou sur le site d Apple Syntaxe perform action reference obligatoire Param tres reference La r f rence de l objet devant ex cuter son action Exemples Vous pouvez utiliser les instructions suivantes dans l application diteur de Scripts pour provoquer l ex
524. tandards page 15 Les sous menus du menu menu item page 499 sp cifier par Les formes cl s standards page 15 Les l ments de menu du menu Events support s par les objets de la classe Menu Un objet menu supporte les gestionnaires r pondant aux Events sui vants Nib awake from nib page 123 Exemples Les instructions suivantes pr vues pour tourner dans l application diteur de Scripts visent les menus de l application TestApp applica tion totalement fictive Vous pouvez utiliser ces m mes instructions dans le Partie VIII Menu Suite Traduction trad applescript 23 2 2004 498 Chapitre 1 Classes script de votre application AppleScript Studio bien que vous n aurez pas besoin de les ins rer dans un bloc tell application tell application TestApp first menu result main menu of application TestApp title of main menu result MainMenu menu items of main menu result a list of menu items title of menu items of main menu result File Edit Window Help menus of main menu result long list sub menu of menu item id 1 of main menu of application TestApp etc menu items of sub menu of menu item id 1 of main menu result a long list end tell L exemple suivant montre comment cr er un script objet et un nouveau menu y ajouter un l ment de menu et assigner le script au nouvel l ment Create a script object script displa
525. tante 182 602 Index photo frame constante 184 play commande 338 playing propri t 71 298 plays every frame propri t 299 plays selection only propri t 299 plugin CLASSE suisse 559 plugin loaded A tipuja ii 561 popup button l ment 86 210 234 CLASSE semer 301 position propri t 83 231 poster frame constante 183 preferred edge propri t 209 302 preferred type propri t 65 prepare drop EVENE eek 488 pressed constante 188 pressure propri t 52 previous text propri t 293 327 primary type constante 176 progress indicator l ment 86 210 234 classe 306 prompt propri t 531 prototype cell propri t 293 pulls down propri t 302 push on off button constante 177 Q quicktime movie loop mode num ration 185 R radio button constante I radio mode constante 185 rate propri t 290 read from file rectangle edge num ration 186 register commande 116 regular size constante 180 regular square bezel constante
526. te Traduction trad applescript 23 2 2004 52 Chapitre 1 Classes event number Acc s lecture seulement Classe integer Le num ro de l Event il s agit d un compteur peu probable que votre application en ait une r elle utilit pour plus d informations consultez la description de la m thode event Number de NSEvent dans la documentation Cocoa event type Acc s lecture seulement Classe une des constantes de event type page 181 Le type d Event key code Acc s lecture seulement Classe integer La valeur hardware dependent de la touche appuy e il y a peu de chance que vous soyez amen travailler avec les codes du clavier et de plus aucune constante n est fournie pour les sp cifier toutefois vous pourriez vouloir essayer par exemple pour un clavier le code pour la touche suppression est 51 et 117 pour la touche d effacement arri re location Acc s lecture seulement Classe point L emplacement dans la fen tre o l Event est survenu l emplacement est retourn sous la forme d une liste de deux nombres gauche bas o par exemple 0 0 indiquerait que l Event a t produit dans le coin inf rieur gauche de la fen tre consultez la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es option key down Acc s lecture seulement Classe boolean La touche Alt est elle enfonc e press
527. te classe n est pas support e dans la version 1 3 d AppleScript Studio cell Pluriel cells H rite de personne Classe Cocoa NSCell Fournit un m canisme permettant d afficher du texte ou des images dans une view sans le chapeautage de la sous classe NSView Enorm ment utilis e par la plupart des classes control page 280 pour impl menter leur fonctionnement interne Les sous classes cell incluent ac tion cell page 254 button cell page 261 image cell page 284 et text field cell page 330 Pour plus d informations voir Controls and Cells dans la documentation Cocoa Propri t s des objets de la classe Cell Un objet cell poss de ces propri t s Traduction trad applescript 23 2 2004 Partie IV Control View Suite cell 265 alignment Acc s lecture criture Classe une des constantes de text alignment page 189 L alignement du texte de la cellule allows editing text attributes Acc s lecture criture Classe boolean Les attributs de texte peuvent ils tre dit s allows mixed state Acc s lecture criture Classe boolean La cellule autorise t elle un tat mixte Voir la description de cette propri t dans la classe button page 254 associated object Acc s lecture criture Classe item page 60 L objet associ avec la cellule bezeled Acc s lecture criture Classe boolean La cellule a t elle un contour apparent b
528. te de personne Classe Cocoa NSFont Traduction trad applescript 23 2 2004 Partie II Application Suite font 55 Non support e dans la version 1 3 d AppleScript Studio Toutefois voir la section Exemples pour plus d informations sur le r glage des polices dans Interface Builder Exemples Vous pouvez r gler pour une police donn e sa famille sa taille sa graisse et sa couleur pour l utilisation par exemple dans un objet text field page 325 ou text view page 569 tout ceci dans le panel Polices d Interface Builder visible dans l illustration 2 2 O O Font T IE i o Family Typeface Size Krungthep ms _ 13 KufiStandardGK eens 9 0 Letter Gothic 10 LiHei Pro 11 LiSong Pro 12 Lucida Grande v 13 v earch Use Family and Typeface System font 4 FIG 2 2 Le panel Font dans Interface Builder Vous pouvez utiliser le menu d roulant Extras pour pr visualiser les polices leur taille ouvrir le panel Couleurs et y choisir une couleur ainsi que d autres op rations Le menu d roulant Use Family and Typeface vous laisse choisir parmi une s lection de polices pr configur es Pour faire des modifications sur un objet sp cifique comme un text field vous s lectionnerez cet objet ouvrirez le panel Polices en naviguant dans le menu Format ou en appuyant sur Cmd T puis vous ferez vos choix Partie II Application Suite Traduction
529. te de trois nombres entiers contenant les valeurs de chaque composant de la couleur par d faut cette propri t vaut 65535 65535 65535 ou la couleur blanche vous pouvez la r gler dans la fen tre Info d Interface Builder par exemple la couleur rouge pourra tre repr sent e par 65535 0 0 bezeled Acc s lecture criture Classe boolean L objet text field a t il un contour apparent Par d faut cette pro pri t vaut true bordered Acc s lecture criture Classe boolean L objet text field a t il une bordure Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder draws background Acc s lecture criture Classe boolean Faut il que l objet text field dessine son fond derri re le texte Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder bien que vous devrez d abord r gler le type Traduction trad applescript 23 2 2004 Partie IV Control View Suite text field 327 de bordure sur no border editable Acc s lecture criture Classe boolean L objet text field est il ditable Par d faut cette propri t vaut true vous pouvez la r gler dans la fen tre Info d Interface Builder imports graphics Acc s lecture criture Classe boolean Faut il que l objet text field supporte le glisser d poser d images Par d faut cette prop
530. ter et en tirer des informations ignores multiple clicks Acc s lecture criture Classe boolean L objet control ignore t il les multiples clics integer value Acc s lecture criture Classe integer La valeur de l objet control au format entier 0 si le contenu ne peut pas tre interpr t au format entier string value Acc s lecture criture Classe Unicode text La valeur de l objet control au format texte target Acc s lecture criture Classe item page 60 La cible des actions du control l ments support s par les objets de la classe Control Un objet control peut uniquement contenir les l ments qu il h rite de la classe view page 229 Commandes support es par les objets de la classe Control Votre script peut envoyer la commande suivante un objet control Traduction trad applescript 23 2 2004 Partie IV Control View Suite control 283 perform action page 337 Events support s par les objets de la classe Control Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples La classe control est une classe r sum que vous ne viserez g n ralement pas dans vos scripts mais certainement des sous classes comme button page 254 ou slider page 315 Version La propri t content est apparue avec la version 1 2 d AppleScript Stu dio Vous pouvez utiliser au c
531. ter avec ces gestionnaires tenez compte de leurs connexions avec les objets pr sents dans l interface utilisateur qui h ritent de la classe control page 280 comme les objets button page 254 slider page 315 stepper page 320 ou text field page 325 Pour plus d informations voir Basic Event Handling dans la documen tation Cocoa Propri t s des objets de la classe Responder En plus des propri t s qu il h rite de la classe item page 60 un objet responder poss de ces propri t s menu Acc s lecture criture Classe menu page 495 Le menu de l objet responder pour un objet window page 76 cette propri t est identique la propri t main property de l ob jet application page 29 pour les autres objets elle sera non d finie jusqu ce que vous ayez ajout un menu contextuel cet objet Events support s par les objets de la classe Responder Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples La classe Responder est une classe r sum que vous ne ciblerez pas sp cifiquement dans vos scripts Toutefois consultez la section Exemples de la classe window page 76 pour voir dans quel cas vous pourrez scripter un objet responder Voir aussi les propri t s first responder key et main de la classe window page 76 Partie II Application Suite Traduction trad applescript 23 2 2004
532. ter sur la fen tre toute op ration n cessaire une fois le changement d tat ici d r duit accompli comme r gler la propri t minimized title de la fen tre on deminiaturized theUbject Add script statements here to handle deminiaturizing end deminiaturized document nib name Retourne le nom du fichier nib du document Votre application n a pas besoin d attacher ce gestionnaire si son do cument Nib s appelle document nib Si vous modifiez le nom de votre document Nib vous devrez ajouter ce gestionnaire a l objet application page 29 et retourner le nom du document Nib sans l extension nib Syntaxe Traduction trad applescript 23 2 2004 Partie II Application Suite exposed 131 document nib name reference obligatoire for document document obligatoire Param tres reference La r f rence de l objet application page 29 for document document page 457 Le document dont doit tre obtenu le nom de son fichier nib Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Document Nib Name un objet application page 29 AppleScript Studio ajoute au tomatiquement au script d sign un gestionnaire vierge identique celui qui suit Voir la description de la classe application page 29 pour plus d informations sur la mani re d y connecter un gestionnaire Vous pouvez utiliser le param tre theObject pour acc der aux propri
533. text field page 311 ainsi que Text Fields dans la documentation Cocoa Vous pouvez cr er et acc der un objet secure text field cell dans Inter face Builder en suivant ces tapes 1 Utilisez les tapes d crites dans la classe secure text field page 311 pour cr er le champ s curis 2 S lectionnez l objet secure text field 3 Tout en maintenant appuy e la touche Option saisissez avec la souris une des poign es de redimensionnement En m me temps que vous glissez Interface Builder cr e un objet matrix page 289 contenant plusieurs objets text field cell page 330 4 Cliquer une fois s lectionne l objet matrix double cliquer s lectionne un objet text field cell de l objet matrix Pour chaque cellule a s lectionnez la cellule Traduction trad applescript 23 2 2004 Partie IV Control View Suite slider 315 b ouvrez la fen tre Info et utilisez le menu d roulant pour afficher le panneau Custom Class c modifiez la classe de la cellule en NSSecureTextFieldCell Propri t s des objets de la classe Secure Text Field Cell En plus des propri t s qu il h rite de la classe text field cell page 330 un objet secure text field cell poss de ces propri t s echos bullets Acc s lecture criture Classe boolean Faut il que les caract res soient masqu s par des ronds Par d faut cette propri t vaut true si elle est r gl e sur false le masquage se fait
534. theTasks to contents of every data cell of every data row of theDataSource set theSortColumn to sort column of theDataSource Statements for working with data cells not shown end data representation Pour obtenir le contenu de chaque objet data cell d une table vous pou vez utiliser cette instruction set theData to contents of every data cell of every data row of data source of table view 1 of scroll view 1 of window main Pour obtenir le contenu de chaque objet data cell d une colonne parti culi re vous pouvez utiliser cette instruction set theData to contents of data cell zip of data rows of dataSource of table view bigTable of scroll view myScrollView of window 1 Note Vous pouvez sp cifier les objets par leur index leur nom ou par un m lange des deux comme dans les deux exemples pr c dents Pour un exemple utilisant les data cell avec des data item dans un objet outline view page 392 voir la section Exemples de la classe data item page 379 Pour un exemple qui extrait le nom partir d un objet data cell d une ligne cliqu e voir la section Exemples de la classe table view page 403 Partie V Data View Suite Traduction trad applescript 23 2 2004 376 Chapitre 1 Classes Version La propri t content est apparue avec la version 1 2 d AppleScript Stu dio Vous pouvez utiliser au choix content et contents sauf l int rieur d un gestionnaire d E
535. tie VIT Drag and Drop Suite drag info 479 Le source des donn es gliss es source mask Acc s lecture uniquement Classe integer Non support e dans la version 1 3 d AppleScript Studio d finit le type de gliss drag operation link drag operation copy drag operation generic Events support s par les objets de la classe Drag Info Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples L exemple suivant montre une des mani res d examiner un objet drag info page 477 dans un gestionnaire drop page 486 Ce gestionnaire re tournera false annulant le d poser si l objet pasteboard page 64 de cet objet ne correspond pas aux types autoris s ici la v rification porte sur le type string Si ce type est pr sent le gestionnaire utilise les donn es pour r gler le titre de l objet dont les donn es sont d pos es et retournera true pour finir l op ration de glisser on drop theUbject drag info draglnfo set dropped to false if string is in types of pasteboard of dragInfo then set title of theObject to contents of pasteboard of dragInfo set dropped to true end if return dropped end drop Version La classe Drag Info fut ajout e dans la version 1 2 d AppleScript Studio Les propri t s image location location sequence number et source mask de cette classe ne sont pas support es dans la version 1
536. ting back on set update views of theDataSource to true Le tri des data source ajout dans la version 1 2 d AppleScript Studio est d crit plus haut dans la description de cette classe Vous pouvez aussi voir le tri dans les applications Table et Task List disponibles depuis la version 1 2 d AppleScript Studio Le gestionnaire column clicked page 430 suivant montre comment g rer une modification faite dans la colonne s lectionn e pour le tri Vous connec terez le gestionnaire Column Clicked l objet table view page 403 ou outline view page 392 contenant les colonnes trier Ce gestionnaire est relativement standard et peut tre utilis tel quel dans la plupart des ap plications Il fait ce qui suit e Il obtient l identificateur de la colonne cliqu e e Il obtient la colonne courante servant pour le tri de la data source e Si les colonnes sont diff rentes l utilisateur a choisi une nouvelle co lonne pour le tri aussi il r gle la propri t sort column de la data source sur la nouvelle colonne Si les colonnes sont identiques l utilisateur a choisi un nouvel ordre de tri aussi il modifie son ordre de tri de ascending vers descending ou vice versa Il appelle la commande update page 119 pour redessiner les donn es tri es on column clicked theObject table column tableColumn Get the data source of the table view set theDataSource to data source of theObject Traduction
537. tion cach on was hidden theObject Perform operations here after the object was hidden end was hidden was miniaturized Appel apr s qu une fen tre ait t r duite Le gestionnaire peut ex cuter toute op ration ayant besoin de la r duction Vous devriez utiliser miniaturized page 136 plut t que Was Miniatu rized Partie II Application Suite Traduction trad applescript 23 2 2004 160 Chapitre 3 Events Syntaxe was miniaturized reference obligatoire Param tres reference La r f rence de l objet window page 76 ayant t r duit will become active Appel lorsque l objet est sur le point de devenir actif Le gestionnaire ne peut pas annuler l activation mais peut la pr parer L application lors de sa phase de lancement appelle certains gestion naires s ils sont pr sents en respectant un ordre de priorit Le gestionnaire Will Become Active fait partie de ces gestionnaires la liste est disponible dans la description du gestionnaire awake from nib page 123 Syntaxe will become active reference obligatoire Param tres reference La r f rence de l objet devenant l objet actif Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Be come Active un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer
538. tionnaire Ce script montre comment charger un panel avec la commande Load Nib Si les r glages de la fen tre panel n existent pas encore d termin s par la v rification de la propri t le script les cr e en appelant Load Nib transmettant le nom du fichier nib Settings nib Le script obtient alors la r f rence des r glages du panel r gl s dans Interface Builder lors de la constructon du fichier nib en utilisant son nom AppleScript settings property panelWindow missing value Following is extracted from clicked handler if not exists panelWindow then load nib SettingsPanel set panelWIndow to window settings end if Version Avant la version 1 1 d AppleScript Studio l application Mail Search s appelait Watson Avant la version 1 1 d AppleScript Studio l application Display Panel utilisait la commande load panel page 548 L utilisation de cette commande n est plus recommand e depuis la version 1 1 il vaut mieux utiliser la place la commande Load Nib comme dans la section Exemples ci dessus load sound Charge le son sp cifi Vous chargerez g n ralement un son en tant qu objet sound page 70 et le jouerez avec la commande play page 338 L objet application page 29 peut contenir des l ments sound tandis que les classes button page 254 et button cell page 261 poss dent des propri t s sound Vous pouvez jouer tous les sons support s par la cl
539. tionnez l instance NSDrawer et ouvrez la fen tre Info dans le panneau AppleScript Instance ParentWindow Pour ajouter des l ments d interface la fen tre qui poss de le tiroir double cliquez sur l instance Parent Win dow pour ouvrir la fen tre Vous pouvez aussi utiliser la fen tre Info pour connecter des gestionnaires d Events cette fen tre e Instance DrawContentsView Pour ajouter des l ments d interface au tiroir double cliquez sur instance DrawContentsView pour ouvrir une fen tre comme dans l illustration 3 5 Vous pouvez aussi utili ser la fen tre Info pour connecter des gestionnaires d Events cette fen tre Vous constaterez que la fen tre Info identifie cette instance comme tant NSView custom Une fois que vous avez ajout la fen tre et le tiroir dans Interface Buil der vous devrez suivre ces tapes pour montrer cette fen tre dans votre application et autoriser l utilisateur ouvrir et fermer le tiroir Vous pou vez montrer la fen tre en connectant un gestionnaire launched page 135 l objet File s Owner lequel repr sente l application dans la fen tre Nib Voir la classe application page 29 pour plus d informations sur File s Ow ner 000 Cocoa Windows Se LE COE gt eee 1900 Window Panel Drawer FIG 3 3 Le panneau Cocoa Windows d Interface Builder avec les tiroirs Si vous nommez applescriptement la fen tre tiroir main
540. titre du bouton par d faut message Unicode text Le texte du message de l alerte other button Unicode text Le titre de l autre bouton Partie IX Panel Suite Traduction trad applescript 23 2 2004 542 Chapitre 2 Commandes R sultats alert reply Un objet alert reply page 513 contenant les informations sur l alerte renvoy e Lorsque l alerte est affich e comme une feuille attach e la fen tre il n y a pas de r sultat imm diat et vous devrez installer un gestionnaire alert ended page 551 pour r pondre l alerte renvoy e Exemples L instruction suivante montre la syntaxe permettant d afficher une alerte en tant que feuille laquelle donne comme r sultat une alerte en tant que document modal Elle est extraite du gestionnaire clicked page 348 de l application Display Alert distribu e avec AppleScript Studio La plupart des param tres sont des variables r gl es depuis des champs texte dans la fen tre principale de l application en partie visible en arri re plan dans l illustration 9 5 display alert dialogText as dialogType message dialogMessage default button defaultButtonTitle alternate button alternateButtonTitle other button otherButtonTitle attached to window main Lorsque vous afficherez une alerte attach e une fen tre vous devrez installer un gestionnaire Alert Ended la fen tre Le gestionnaire sera appel lorsque l alerte sera renvoy e Pour
541. to true tell progress indicator progress to start set contents of text field statusMessage to statusMessage end tell set initialized to true end tell end if display window status attached to theWindow end openPanel L application Mail Search montre aussi un objet progress indicator d termin Regardez aussi le gestionnaire makeStatusPanel lequel cr e et retourne un script objet contenant les gestionnaires chargeant un status pa nel contenant un objet progress indicator r gle sa valeur minimale et maxi male et lui indique d incr menter L application Mail Search est d crite en d tails dans le guide Building Applications With AppleScript Studio Traduction trad applescript 23 2 2004 Partie IV Control View Suite secure text field 311 voir la section Autres documentations page 5 pour plus d informations sur ce document Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio La propri t content est apparue avec la version 1 2 d AppleScript Stu dio Vous pouvez utiliser au choix content et contents sauf l int rieur d un gestionnaire d Events contents of theUbject retournant une r f rence l objet plut t que son contenu courant Pour obtenir dans un gestion naire d Events le contenu d un objet comme le texte contenu dans un text field page 325 vous pouvez utiliser soit contents of contents of theOb
542. tre Info d Interface Builder Les valeurs tag de cet exemple sont extraites de l application Talking Head on choose menu item theMenuItem tell window main set theCommand to tag of theMenuItem if theCommand is equal to 1001 then else if theCommand is equal to 1006 then tell movie view movie to go to beginning frame highlight Non support e dans la version 1 3 d AppleScript Studio N utilisez pas cette commande Syntaxe highlight reference obligatoire Param tres reference La r f rence de l objet illuminer Partie IV Control View Suite Traduction trad applescript 23 2 2004 336 Chapitre 2 Commandes increment Incr mente l objet sp cifi avec la quantit sp cifi e ou avec 1 si aucune quantit n est sp cifi e Syntaxe increment reference obligatoire by real facultatif Param tres reference La r f rence de l objet incr menter by real La quantit ajouter Exemples Les instructions suivantes sont extraites du gestionnaire incrementPanel de l application Mail Search distribu e avec AppleScript Studio Ce gestionnaire est un des multiples gestionnaires faisant partie du script objet d fini dans cette application pour contr ler le status panel tell window status tell progress indicator progress to increment by 1 end tell Ces instructions visent l objet progress indicator page 306 d termin d une fen tre e
543. ts ou en saisissant man defaults dans le terminal l application Terminal est situ e dans Applications Utilitaires l ments des ob jets de la classe User Defaults Un objet user defaults peut contenir les l ments list s ci dessous Votre script peut sp cifier la plupart des l ments par les formes cl s d crites dans Les formes cl s standards page 15 default entry page 45 sp cifier par Les formes cl s standards page 15 Les valeurs utilisateur inscrites par d faut couples cl valeur Events support s par les objets de la classe User Defaults Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Vous pouvez obtenir la liste de tous les noms des valeurs utilisateur inscrites avec l instruction suivante La liste inclut galement les valeurs que vous avez pu y ajouter en plus de celles fournies par Mac OS comme AppleKeyboardUIMode et NSDateFormatString set defaultsList to name of every default entry of user defaults De m me vous pouvez obtenir les valeurs par d faut des inscriptions avec l instruction suivante set defaultsContents to contents of every default entry of user defaults Partie II Application Suite Traduction trad applescript 23 2 2004 74 Chapitre 1 Classes Les instructions pr c dentes acc dent la propri t user defaults de l objet application page 2
544. tte m me fen tre double clicked Appel apr s que l utilisateur double clique sur l objet Les sous classes de control page 280 comme outline view page 392 et table view page 403 supportent le gestionnaire Double Clicked Syntaxe double clicked reference obligatoire Partie IV Control View Suite Traduction trad applescript 23 2 2004 350 Chapitre 3 Events Param tres reference La r f rence de l objet ayant t double cliqu Exemples Le gestionnaire Double Clicked suivant est pour le table view page 403 messages de l application Mail Search distribu e avec AppleScript Stu dio Le table view affiche les emails qui furent trouv s lors de la recherche Double cliquer un message s lectionn provoquera l ouverture du message dans une fen tre document on double clicked theUbject set theController to controllerForWindow window of theDbject if theController is not equal to null then tell theController to openMessages end if end double clicked Ce gestionnaire utilise le param tre theDbject pour obtenir la fen tre du table view ainsi il peut acc der au contr leur de cette fen tre Le contr leur est charg d ex cuter les op rations de la fen tre Si le gestionnaire peut obtenir le contr leur il appelle le gestionnaire openMessages du contr leur pour v ritablement ouvrir le message s lectionn ou les messages Version Avant la version 1 1 d Appl
545. u crire les donn es lorsque le gestionnaire appropri est appel Pour les gestionnaires de bas niveau elle utilisera le nom du fichier transmis au gestionnaire AppleScript Studio inclut deux exemples d application disponible depuis la version 1 2 qui montrent comment travailler avec les applications bas es sur le mod le AppleScript Document based Application Voir la section Exemples pour plus d informations Propri t s des objets de la classe Document En plus des propri t s qu il h rite de la classe responder page 68 un objet document poss de ces propri t s file name Acc s lecture criture Classe Unicode text Le nom de fichier du document non d fini pour un nouveau document jusqu ce qu il soit r gl comme lors de l enregistrement une cha ne de caract res au format POSIX d limit par des slashs par exemple Users votreUtilisateur Documents fichier txt Traduction trad applescript 23 2 2004 Partie VI Document Suite document 461 file kind Acc s lecture criture Classe Unicode text Synonyme de la propri t file type ajout e dans la version 1 3 d AppleScript Studio uniquement pour une r tro compatibilit n utilisez pas cette propri t dans vos scripts voir la section Ver sion pour plus d informations file type Acc s lecture criture Classe Unicode text Le type de fichier du document il ne s agit pas du code
546. u il h rite de la classe save panel page 529 un objet open panel poss de ces propri t s voir la section Version de cette classe pour savoir dans quelle version d AppleScript Studio furent ajout es certaines propri t s Cette classe n est pas accessible dans Interface Buil der aussi vous ne pourrez pas y r gler ses propri t s L application Open Panel distribu e avec AppleScript Studio depuis la version 1 1 montre Traduction trad applescript 23 2 2004 Partie IX Panel Suite open panel 523 e Open lt gt jm Colorsync H Library gt Caches H Profiles 2 CFMSupport H Scripting a Classic 3 ColorPickers 3 Colors Colorsync L3 Components 3 CoreServices 2 Dictionaries H Displays DTDs 3 Extensions i E a Cancel FIG 9 3 Le panel Ouvrir comment r gler la plupart des propri t s du panel Ouvrir dans un script Propri t s des objets de la classe Open Panel allows multiple selection Acc s lecture criture Classe boolean Plusieurs l ments peuvent ils tre s lectionn s en m me temps can choose directories Acc s lecture criture Classe boolean Les r pertoires peuvent ils tre s lectionn s can choose files Acc s lecture criture Classe boolean Les fichiers peuvent ils tre s lectionn s path names Acc s lecture uniquement Classe list La list
547. u Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples mouse dragged Appel lorsqu un Event mouse dragged un glisser avec la souris sur vient et qu il peut affecter l objet Syntaxe mouse dragged reference obligatoire event event facultatif Param tres reference La r f rence de l objet dont le gestionnaire Mouse Dragged a t appel event event page 50 Les informations d Events de l Event mouse dragged Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Mouse Dragged un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit on mouse dragged theUbject event theEvent Add script statements here to handle the mouse dragged event end mouse dragged Vous pouvez utiliser le param tre theEvent pour obtenir des informa tions sur l Event mouse dragged comme l emplacement du curseur de la souris et si les touches Commande Option Majuscule ou Contr le ont t enfonc es en m me temps Voir la classe event page 50 pour des exemples Traduction trad applescript 23 2 2004 Partie II Application Suite mouse exited 139 mouse entered Appel lorsqu un Event mouse entered entr e du curseur de la souris survient et qu il peut affecter l objet C est dire que le curseur est entr dans les limites de l objet conne
548. uche de fonction modifi e Partie II Application Suite Traduction trad applescript 23 2 2004 182 Chapitre 4 num rations key down type Event enfoncement d une touche du clavier key up type Event rel chement de la touche du clavier left mouse down type Event enfoncement du bouton gauche de la souris left mouse dragged type Event gliss avec le bouton gauche de la souris left mouse up type Event rel chement du bouton gauche de la souris mouse entered type Event entr e du curseur de la souris mouse exited type Event sortie du curseur de la souris mouse moved type Event d placement du curseur de la souris other mouse down type Event enfoncement d un autre bouton de la souris other mouse dragged type Event gliss avec un autre bouton de la souris other mouse up type Event rel chement d un autre bouton de la souris periodic type Event p riodique comme un Event idle ou une minuterie right mouse down type Event enfoncement du bouton droit de la souris right mouse dragged type Event gliss avec le bouton droit de la souris right mouse up type Event rel chement du bouton droit de la souris scroll wheel type Event d filement avec la molette Traduction trad applescript 23 2 2004 Partie II Application Suite go to 183 system defined type Event d fini par le syst me go to Sp cifie un emplacement dans un film Vous transmettrez une de ces valeurs avec la co
549. ucun onglet s lectionnable la fen tre Info fournit un compteur permettant de passer d un onglet l autre Pour Partie III Container View Suite Traduction trad applescript 23 2 2004 226 Chapitre 1 Classes arriver afficher ce compteur il faudra que les objets tab view item soient s lectionn s pour se faire vous devrez double cliquer sur le tab view pour s lectionner ses tab view items apr s il vous suffira de cliquer sur le comp teur visible dans l illustration 3 8 dans le panneau Attributes pour aff cher le contenu de chaque tab item view Comme l utilisateur devra pouvoir s lectionner un onglet parmi ceux pr sent s but recherch ici vous devrez modifier le tab view item g n ralement affich de fa on programm avec des instructions comme celle qui suit o il est suppos que vous avez baptis le premier tab view item tabViewlteml tell tab view tabview of window main set the current tab view item to tab view item tabViewltemi end O O NSTabViewltem Info Attributes HA Displaying Tab Item 1 FIG 3 8 Le compteur permettant de switcher d un onglet l autre Version Le support des Events de glisser d poser est apparu avec la version 1 2 d AppleScript Studio Les tab view sont impl ment s dans AppleScript Studio par la classe Cocoa NSTabView Avant la version 10 2 de Mac OS X la classe NSTab View supportait uniquement les onglets en haut Depuis la
550. ue end action Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio stepper Pluriel steppers H rite de control page 280 Classe Cocoa NSStepper Un contr le compos de deux petites fl ches pouvant incr menter ou d cr menter une valeur apparaissant c t comme une date ou une heure Traduction trad applescript 23 2 2004 Partie IV Control View Suite stepper 321 L illustration 4 13 montre un objet stepper droite d un champ texte affichant la valeur de cet objet 4 FIG 4 13 Un objet stepper Vous trouverez l objet stepper dans le panneau Cocoa Controls d In terface Builder Vous pouvez r gler plusieurs attributs des objets stepper dans la fen tre Info d Interface Builder Pour plus d informations voir Steppers dans la documentation Cocoa Propri t s des objets de la classe Stepper En plus des propri t s qu il h rite de la classe control page 280 un objet stepper poss de ces propri t s auto repeat Acc s lecture criture Classe boolean Faut il que l objet stepper s auto incr mente ou d cr mente lorsqu il est maintenu cliqu Par d faut cette propri t vaut true vous pou vez la r gler dans la fen tre Info d Interface Builder increment value Acc s lecture criture Classe real La quantit d incr mentation de l objet stepper par d faut cette pro pri t vaut 1 0 vou
551. ue la progression du progress indicator en une seule tape Pour animer de fa on continue la barre de progression vous pouvez soit utiliser cette instruction de fa on r p t e dans une boucle soit utiliser la commande start page 340 tell progress indicator barber pole of window main to animate L instruction suivante est quivalente animate progress indicator barber pole of window main go Saute l emplacement sp cifi dans le film l objet direct Pour des informations de m me nature voir la classe movie view page 296 Syntaxe go reference obligatoire to une constante facultatif Param tres reference La r f rence du film dans lequel le saut doit tre r alis to une des constantes de go to page 183 L emplacement dans le film o doit se placer la t te de lecture Traduction trad applescript 23 2 2004 Partie IV Control View Suite highlight 335 Exemples Le gestionnaire choose menu item page 505 suivant est extrait de l ap plication Talking Head distribu e avec AppleScript Studio Ce gestion naire utilise la propri t tag de l objet menu item page 499 du menu Mo vie pour d terminer quelle commande ex cuter Pour l l ment de menu Go To Beginning le gestionnaire utilise la commande Go To pour placer la t te de lecture au d but du film Vous pou vez r gler la valeur tag d un l ment de menu dans le panneau Attributes de la fen
552. uement Classe data column page 376 L objet data column tant dit vous permet d obtenir directement Partie V Data View Suite Traduction trad applescript 23 2 2004 408 Chapitre 1 Classes l objet data column et de prendre en consid ration ses caract ristiques de tri retourne rien si aucune colonne n est dit e aussi vous devrez acc der cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la commande path for page 112 edited data row Acc s lecture uniquement Classe data row page 384 L objet data row tant dit vous permet d obtenir directement l ob jet data row et de prendre en consid ration ses caract ristiques de tri retourne rien si aucune ligne n est dit e aussi vous devrez acc der cette valeur uniquement dans un bloc try on error pour un exemple de bloc try on error voir la section Exemples de la com mande path for page 112 edited row Acc s lecture uniquement Classe integer L index de la ligne tant dit e cette propri t vaut O si aucune ligne n est dit e grid color Acc s lecture criture Classe RGB color La couleur de la grille une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur verte pourra tre repr sent e par 0 65535 0 par d faut 32767 32767 32767 ou la couleur
553. uez sur le bouton Edit Script Cela devrait vous ramener dans l application Xcode avec le fichier script ouvert et contenant un gestionnaire Plugin Loaded vierge Le listing ci dessous fournit un exemple de code que vous pouvez mettre dans un gestionnaire Plugin Loaded Cet exemple ajoute un menu Plug ins dans Xcode et un l ment de menu Display Dialog dans ce menu Il d finit aussi un script et attache le script l l ment de menu Le script affiche un dialogue Rappelez vous qu apr s la construction de votre plug in vous devrez le placer dans un des trois emplacement d crits dans la classe plugin page 559 afin qu il soit charg par Xcode lors de son prochain lancement on plugin loaded theBundle Make a new script Traduction trad applescript 23 2 2004 Partie X Plugin Suite plugin loaded 563 script pluginScript property someVariable Display Dialog on choose menu item theUbject display dialog someVariable end choose menu item end script Make a new plugin menu set pluginMenu to make new menu at end of menus of main menu with properties title Make a new Display Dialog menu item in the plugin menu set pluginItem to make new n Set the script of the new menu item set script of pluginItem to pluginScript end plugin loaded Version Le gestionnaire Plugin Loaded fut ajout dans la version 1 3 d Apple Script Studio Partie X Plugin Suite
554. un objet document page 457 sans titre Exemples Vous connecterez dans Interface Builder un gestionnaire Open Untitled en s lectionnant l instance Files Owner dans la fen tre MainMenu nib de l application puis en s lectionnant Open Untitled parmi les gestionnaires application de la fen tre Info Lorsque vous s lectionnerez le script devant accueillir ce gestionnaire AppleScript Studio ins rera automatiquement un gestionnaire vierge identique celui ci dessous L instance File s Owner de la fen tre Nib principale repr sente NSApp une constante globale qui r f rence l objet NSApplication de Vapplica tion Dans un fichier nib document l instance Files Owner repr sente g n ralement le document Le param tre theObject du gestionnaire Open Untitled r f rence l objet application page 29 pour lequel un document sans titre est sur le point d tre ouvert Vous pouvez utiliser ce param tre pour acc der aux propri t s ou aux l ments de l application afin de pr parer l ouverture du document on open untitled theUbject Perform operations here before opening an untitled document end open untitled Traduction trad applescript 23 2 2004 Partie II Application Suite resigned key 145 resigned active Appel apr s que l objet application page 29 ait abandonn son tat actif Il n y a pas de gestionnaire qui permette l application de refuser l aban
555. un objet window page 76 ou panel page 526 Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Open un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour pr parer l ouverture on will open theObject Perform operations here before the object opens end will open Partie II Application Suite Traduction trad applescript 23 2 2004 166 Chapitre 3 Events Version Dans les versions ant rieures la version 1 2 d AppleScript Studio vous pouviez connecter un gestionnaire Will Open un objet document page 457 Dans les versions ant rieures la version 1 2 d AppleScript Studio un gestionnaire Will Open n tait appel que lorsque la fen tre tait charg e depuis son fichier nib pas lorsqu elle tait ouverte Pour simuler cette ca ract ristique dans la version 1 2 vous pouvez remplacer les appels au gestion naire Will Open par des appels au gestionnaire awake from nib page 123 will quit Appel lorsque l objet application page 29 est sur le point de quitter Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer Syntaxe will quit reference obligatoire Param tres reference La r f rence de l objet application page 29 Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Will Quit u
556. un seul objet data source vous n aurez pas besoin d un num ro d index pour vous r f rer l objet data source set theDataSource to data source of table view 1 of scroll view 1 of window 1 table column page 398 sp cifier par Les formes cl s standards page 15 Les objets table column lesquels stockent les caract ristiques d affi chage et l identificateur de chaque colonne Commandes support es par les objets de la classe Table View Votre script peut envoyer la commande suivante un objet table view update page 119 Events support s par les objets de la classe Table View Action clicked page 348 double clicked page 349 Data View column clicked page 430 column moved page 430 column resized page 431 selection changed page 351 selection changing page 352 should select column page 442 should select row page 444 should selection change page 445 will display cell page 447 Partie V Data View Suite Traduction trad applescript 23 2 2004 412 Chapitre 1 nu Classes Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 14
557. untime d AppleScript Stu dio requise par votre application Pour des informations sur les versions du runtime voir Information sur les versions page 8 Le prochain exemple montre comment le gestionnaire pourrait v rifier la version requise d AppleScript Studio Si la version est disponible le ges tionnaire r pertorie un drag type lequel est uniquement support depuis la version 1 2 d AppleScript Studio Si la version 1 2 n est pas disponible Vapplication affiche un message et puis quitte Notez que le gestionnaire ne v rifie pas directement le num ro de version d AppleScript Studio Au lieu de cela il v rifie la version correspondante d AppleScript Studio comme montr dans le tableau 1 1 page 9 on will finish launching theUbject if AppleScript s version as string greater than 1 9 then Traduction trad applescript 23 2 2004 Partie II Application Suite will hide 163 tell window 1 to register drag types file names else display dialog This application requires AppleScript Studio 1 2 or later quit end if end will finish launching will hide Appel lorsque que l objet application page 29 est sur le point d tre cach soit par le menu Masquer l application du menu application ici application remplace le nom de l application soit en appuyant sur les touches Cmd H Le gestionnaire ne peut pas annuler l op ration mais peut la pr parer Vous n
558. up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Partie IV Control View Suite Traduction trad applescript 23 2 2004 320 Chapitre 1 Classes View bounds changed page 243 Exemples Lorsque vous ajoutez un objet slider une fen tre dans Interface Buil der vous pouvez r gler divers attributs de cet objet comme ses valeurs mini males maximales et courantes ou de d part et son nombre de marques Le gestionnaire action page 345 suivant est extrait de l application Language Translator distribu e avec AppleScript Studio Pour cette application le sli der est r gl pour autoriser une graduation de 0 0 7 0 laquelle correspond la graduation du volume sonore r glable avec le compl ment standard set volume o 0 0 correspond au silence et 7 0 au volume fond Le gestionnaire action page 345 lequel est appel lorsqu un utilisa teur modifie le r glage du slider obtient le slider de la fen tre depuis le param tre theObject transmis Il obtient alors une valeur de volume bas e sur le r glage courant du slider et appelle set volume pour ajuster le volume auquel le texte traduit sera lu on action theUbject set enabled of slider of window Language Translator to true set volumevalue to contents of slider volumeslider of window Language Translator as integer set volume volumeval
559. upart des applications AppleScript Studio n auront pas besoin de cette manipulation Notes Le gestionnaire Awake From Nib est apparu avec la version 1 1 d Apple Script Studio Si vous travaillez avec la version d Interface Builder distribu e avec la version 10 2 de Mac OS X consultez la section Information sur les versions page 8 pour des informations sur le r glage de la pr f rence Nib File Compatibility became key Appel apr s qu un objet window page 76 soit devenu la fen tre cl ou le premier r ceptacle de l appui sur une touche du clavier Voir aussi became main page 128 et resigned key page 145 ainsi que les propri t s key et main de la classe window page 76 Pour plus d informations voir Basic Event Handling dans la documentation Cocoa Syntaxe became key reference obligatoire Partie II Application Suite Traduction trad applescript 23 2 2004 128 Chapitre 3 Events Param tres reference La r f rence de l objet window page 76 devenu l objet cl Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Became Key un objet window page 76 AppleScript Studio ajoute automatique ment au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter sur la fen tre toute op ration n cessaire une fois le changement d tat ici cl accompli on became key theUbject
560. ur le traitement des Events et les process des com mandes Toute classe qui g re des Events doit h riter de la classe Responder comme le font les classes application page 29 document page 457 window page 76 et view page 229 Les applications Cocoa maintiennent une chaine responder laquelle lie ensemble les objets pouvant g rer les Events et les messages des actions g n r es par l utilisateur Le premier objet de la cha ne est appel le first responder Les Events incluent les Events Souris et Clavier alors que les messages des actions sp cifient des actions ou des appels aux m thodes devant tre ex cut es Dans une application AppleScript Studio les Events Cocoa et les mes sages des actions sont traduits dans les appels des gestionnaires d Events des objets de l application comme keyboard down page 133 mouse up page 141 clicked page 348 ou should zoom page 156 L op ration par Traduction trad applescript 23 2 2004 Partie II Application Suite responder 69 d faut de la cha ne responder peut tre suffisante pour la plupart des appli cations AppleScript Studio Pour certains objets comme les objets application page 29 et color well page 271 les gestionnaires d Events Clavier et Souris qui y seront connect s peuvent ne jamais tre appel s car ils sont d abord g r s par d autres objets avant l objet application Si votre application a r ellement besoin de trai
561. urce page 386 Avant la version 1 2 1 d AppleScript Studio vous ne pouviez pas uti liser cette propri t dans un script mais vous pouviez utiliser la pro pri t needs display de la classe view page 229 opaque Acc s lecture criture Classe boolean La fen tre est elle opaque Par d faut cette propri t vaut true Co coa prend en compte l opacit lorsqu il redessine une fen tre et ses views pour plus d informations voir Drawing and Images dans la do cumentation Cocoa mais la plupart des applications n auront pas be soin d utiliser cette propri t pour rendre une fen tre transparente vous utiliserez la propri t alpha value position Acc s lecture criture Classe point La position de la fen tre la position est repr sent e par une liste de deux nombres gauche bas par exemple 0 0 indiquerait le coin inf rieur gauche de la fen tre voir la propri t bounds pour plus d informations sur le syst me des coordonn es released when closed Acc s lecture criture Classe boolean Faut il que la fen tre soit lib r e lorsqu elle est ferm e Par d faut cette propri t vaut false vous pouvez r gler cette valeur dans Inter face Builder dans certaines circonstances vous pourriez pr f rer ne pas lib rer la fen tre mais plut t la masquer avec la commande hide page 99 ou en r glant sa propri t visible sur false afin de pouvoir la r afficher de nouve
562. ure criture Classe boolean Le splitter est il vertical l ments des ob jets de la classe Split View Un objet split view peut uniquement contenir les l ments qu il h rite de view page 229 Partie III Container View Suite Traduction trad applescript 23 2 2004 220 Chapitre 1 Classes Events support s par les objets de la classe Split View Un objet split view supporte les gestionnaires r pondant aux Events suivants Glisser D poser conclude drop page 481 drag page 483 drag entered page 483 drag exited page 484 drag updated page 485 drop page 486 prepare drop page 488 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Split View resized sub views page 244 will resize sub views page 247 View bounds changed page 243 Traduction trad applescript 23 2 2004 Partie III Container View Suite tab view 221 Exemples Le script suivant obtient la propri t vertical d un split view dans l ap plication Mail Search distribu e avec AppleScript Studio Ce script ne fait pas partie de l application mais vous pouvez le lancer depuis l appli cation diteur de Scripts p
563. ure Acc s lecture seulement Classe real Une valeur entre 0 0 et 1 0 repr sentant le niveau de pression de l ap Traduction trad applescript 23 2 2004 Partie II Application Suite event 53 pareil de saisie de l Event comme le stylet d une palette graphique repeated Acc s lecture seulement Classe boolean L Event est il r p t shift key down Acc s lecture seulement Classe boolean La touche Maj est elle enfonc e time stamp Acc s lecture seulement Classe real Le temps coul en secondes lorsque l Event est survenu depuis le d marrage de l ordinateur par exemple 2542 649003 en comparant les valeurs des propri t s time stamp de deux Events vous pouvez d terminer le temps coul entre ces deux Events voir aussi la section Exemples unmodified characters Acc s lecture seulement Classe Unicode text Les caract res non modifi s de l Event window Acc s lecture seulement Classe window page 76 La fen tre associ e l Event Events support s par les objets de la classe Event Cette classe n est pas accessible dans Interface Builder par cons quent vous ne pourrez pas y connecter de gestionnaires Exemples Le gestionnaire mouse down page 137 suivant montre comment d terminer l aide du param tre event si la touche Alt tait press e lors de l appui sur le bouton de la souris A nsi le gestionnaire peut utiliser
564. urner les objets des classes Cocoa center Centre la fen tre dans l cran Pour plus d informations sur les fen tres voir Windows and Panels dans la documentation Cocoa Syntaxe center reference obligatoire Param tres reference La r f rence de l objet window page 76 recevant la commande Center Exemples Le gestionnaire clicked page 348 suivant attach un objet button page 254 centre l objet window page 76 sur lequel r side le bouton La fen tre est centr e en respectant le support sur lequel elle est g n ralement affich e on clicked theObject tell window of theObject to center end clicked Traduction trad applescript 23 2 2004 Partie II Application Suite hide 99 Version La commande Center est apparue avec la version 1 1 d AppleScript Stu dio hide Cache l objet s il est visible Seuls les objets window page 76 peuvent tre cach s Cacher une fen tre a le m me effet que de r gler sa propri t visible sur false moins que la propri t can hide de la fen tre soit r gl e sur false dans ce cas la commande Hide n aura aucun effet Vous ne pourrez pas connecter les gestionnaires was hidden page 159 ou will hide page 163 un objet window page 76 Ces gestionnaires s appliquent uniquement l objet application page 29 et sont appel s uni quement lorsque l utilisateur demande le masquage de la fen tre soit avec le menu Masque
565. urrentStepperValue to contents of stepper stepperName end tell Version Le support des Events de Glisser D poser est apparu avec la version 1 2 d AppleScript Studio Traduction trad applescript 23 2 2004 Partie IV Control View Suite text field 325 text field Pluriel text fields H rite de control page 280 Classe Cocoa NSTextField Fournit la capacit de saisir d afficher et d diter du texte ainsi que d afficher du texte non ditable pouvant tre utilis pour les tiquettes Vous trouverez l objet text field dans le panneau Cocoa Text d Inter face Builder Vous pouvez r gler plusieurs attributs des objets text field dans la fen tre Info d Interface Builder Pour plus d informations sur le r glage de la police de caract res la couleur et d autres attributs d un objet text field voir la section Exemples de la classe font page 54 Vous pouvez connecter un gestionnaire action page 345 un objet text field dans Interface Builder pour r cup rer le contr le lorsqu un utilisateur a fini l dition soit en tabulant dans un autre champ ou en appuyant sur la touche Entr e Dans Interface Builder vous pouvez aussi facultativement r gler l objet text field pour qu il appelle uniquement son gestionnaire action lorsque la touche Entr e est appuy e et non lorsque l utilisateur tabule vers un autre champ Les applications AppleScript Studio supporte automatiquement l
566. us une forme faci lement exploitable pour le prochain lancement Le format List est certaine ment le meilleur choix mais chacun est libre de faire comme il veut Traduction trad applescript 23 2 2004 585 Table Sort eee Table Sort Name City Zip Age Ally McBiel Chicago 91544 28 Bart Simpson Springfield 19542 12 James Taylor Atlanta 21769 42 Joan of Ark Paris 53255 36 King Tut Egypt 00245 45 le Fic 12 4 L application Table Sort avec la liste des individus En cliquant sur l en t te d une colonne comme dans l illustration sui vante vous provoquerez le tri des donn es de cette colonne et la mise jour complete du tableau Cela est possible car un gestionnaire column clicked page 430 est connect l objet table view page 403 dans Interface Buil der Le tri se fera de fa on croissante ou d croissante chaque nouveau clic sur l en t te eee Table Sort Name City Zip Age King Tut Egypt 45 Bart Simpson Springfield 12 James Taylor Atlanta 42 Joan of Ark Paris 36 Ally McBiel Chicago FIG 12 5 La colonne Zip retri e suite au clic sur son en t te Il est galement possible de modifier le contenu du tableau tout simple ment en double cliquant sur la donn e modifier La modification se fera l cran et galement dans la data source de fa on transparente Il est tout fait possible d imposer un type pour les donn es saisies par exemple que des chiffres pour l
567. utres applica tions peuvent lire comme des fichiers texte Ce gestionnaire est responsable de l ouverture du fichier sp cifi par le param tre path name transmis et de sa fermeture une fois la lecture finie Le gestionnaire lit les donn es fournies en fonction du type fourni par le param tre of type Voir le gestionnaire write to file page 470 pour plus d informations sur les types de document Le contraire de Read From File est write to file page 470 Syntaxe read from file reference obligatoire of type Unicode text obligatoire path name Unicode text obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Read From File est appel of type Unicode text Le type extension du fichier path name Unicode text Le chemin au format POSIX d limit par des slashs du fichier Partie VI Document Suite Traduction trad applescript 23 2 2004 470 Chapitre 2 Events lire Exemples L application Plain Text distribu e depuis la version 1 2 d AppleScript Studio montre comment lire et crire des fichiers texte avec les gestionnaires de bas niveau read from file page 469 et write to file page 470 y compris l ouverture et la fermeture du fichier document Version Le gestionnaire Read From File fut ajout dans la version 1 2 d Apple Script Studio write to file Appel lorsque l application a besoin d crire des donn es dans un docu ment Ce gestio
568. vailler avec cette propri t dans leurs scripts et il n y a pas dans la version 1 3 d AppleScript Studio de constantes AppleScript Studio d finies pour l valuer toutefois vous pouvez lire la description de la classe NSCell dans la documentation Cocoa vous pouvez r gler le comportement du bouton dans Interface Builder en utilisant les menus d roulants Type et Behavior du panneau Attributes de la fen tre Info image dims when disabled Acc s lecture criture Classe boolean L image est elle estomp e lorsque l objet button cell est indisponible key equivalent modifier Acc s lecture criture Classe integer La touche de fonction du raccourci clavier voir la description de cette Traduction trad applescript 23 2 2004 Partie IV Control View Suite button cell 263 propri t dans la classe button page 254 roll over Acc s lecture criture Classe boolean L objet button cell se comporte t il comme un roll over shows state by Acc s lecture criture Classe integer Non support e dans la version 1 3 d AppleScript Studio la fa on dont l objet button cell montre son tat sound Acc s lecture criture Classe sound page 70 Le son jou par l objet button cell lorsqu il est cliqu transparent Acc s lecture criture Classe boolean L objet button cell est il transparent Events support s par les objets de la classe Butt
569. valeur dans une liste de valeurs pr s lectionn es d un menu d roulant L illustration 4 3 montre un objet combo box avec sa liste cach e 1 m FIG 4 3 Un objet combo box sans sa liste visible L illustration 4 4 montre le m me combo box mais avec la liste d roul e Vous trouverez l objet combo box dans le panneau Cocoa Text d In terface Builder Vous pouvez r gler beaucoup d attributs des objets combo box dans la fen tre Info d Interface Builder Notez que dans la version 1 3 d AppleScript Studio vous ne pouvez pas utiliser un objet data source page 386 avec un objet combo box Pour plus d informations voir Combo Boxes dans la documentation Co coa Traduction trad applescript 23 2 2004 Partie IV Control View Suite combo box 275 FIG 4 4 Un objet combo box avec sa liste d roul e Propri t s des objets de la classe Combo Box En plus des propri t s qu il h rite de text field page 325 un objet combo box poss de ces propri t s auto completes Acc s lecture criture Classe boolean Le combo box utilise t il le remplissage automatique lors de la saisie Par d faut cette propri t vaut false elle peut tre r gl e dans la fen tre Info d Interface Builder current item Acc s lecture criture Classe integer L index de l l ment courant base 0 data source Acc s lecture criture Classe data source page 386 Non support
570. vant tre charg sans l extension nib Exemples Un fichier nib stocke la description d un ou de plusieurs objets d inter face utilisateur y compris la taille l emplacement et les connexions avec les autres objets Charger un fichier nib d sarchive ou cr e une instance les objets d interface d crits dans ce type de fichier Par exemple l application Mail Search distribu e avec AppleScript Studio d finit un fichier nib pour chaque fen tre affichant les r sultats de la recherche Pour cr er une nouvelle fen tre Message il fait l appel suivant set messageWindow to makeMessageWindow Le gestionnaire makeMessageWindow contient le code suivant pour char ger le fichier nib Charger le fichier nib cr e une fen tre Message Le ges tionnaire r gle alors le nom de cette fen tre Les r sultats de ce gestionnaire sont alors affich s dans des fen tres titr es messagel message2 etc on makeMessageWindow load nib Message set windowCount to windowCount 1 set windowName to message amp windowCount set name of window message to windowName return window windowName end makeMessageWindow Traduction trad applescript 23 2 2004 Partie II Application Suite load sound 107 Les instructions suivantes sont extraites du gestionnaire clicked page 348 de l application Display Panel distribu e avec AppleScript Stu dio La d finition de property se trouve en dehors du ges
571. vantes tell window main tell movie view movie to stop end tell Pour un exemple plus complexe voir l application Talking Head dis tribu e avec AppleScript Studio synchronize Enregistre sur le disque toute modification touchant les valeurs utili sateur par d faut et met jour les valeurs non modifi es avec celle sur le Partie IV Control View Suite Traduction trad applescript 23 2 2004 344 Chapitre 2 Commandes disque Non support e dans la version 1 3 d AppleScript Studio mais voir la section Exemples pour une solution de remplacement Syntaxe synchronize reference obligatoire Param tres reference La r f rence de l objet user defaults page 72 devant tre synchronis R sultats boolean Retournera false si elle ne peut pas enregistrer de donn es sur le disque true dans l autre cas Exemples Vous pouvez utiliser la commande call method page 94 pour appeler la m thode synchronize comme dans ce qui suit Ces appels retourneront false si les donn es ne peuvent pas tre enregistr es sur le disque autrement true Fonctionne dans Jaguar ainsi que dans les versions pr c dentes set succeeded to call method synchronize of object user defaults Fonctionne uniquement dans Jaguar set succeeded to call method synchronize of user defaults Traduction trad applescript 23 2 2004 Partie IV Control View Suite Chapitre 3 Events Les objets b
572. vec la commande load image page 100 Pour des informations de m me nature voir la classe image page 58 ainsi que Images Views dans la documentation Cocoa Si vous chargez continuellement des images et que vous ne les lib rez pas la m moire utilis e par votre application va augmenter Pour des informa tions sur la mani re de lib rer des objets image page 58 movie page 63 ou sound page 70 voir la section Discussion de la commande load image page 100 eee Image Mac OS X FIG 4 5 Une fen tre affichant une image dans un objet image view extrait de l application Image Propri t s des objets de la classe Image View En plus des propri ts qu il h rite de control page 280 un objet image view poss de ces propri t s editable Acc s lecture criture Classe boolean Traduction trad applescript 23 2 2004 Partie IV Control View Suite image view 287 L image view est elle ditable Par d faut cette propri t vaut false vous pouvez la r gler dans la fen tre Info d Interface Builder image Acc s lecture criture Classe image page 58 L image de la view vous pouvez r gler cette propri t dans Interface Builder en glissant d posant une image sur l objet image view image alignment Acc s lecture criture Classe une des constantes de image alignment page 183 L alignement de l image par d faut cette propri t vaut center ali
573. vents contents of theUbject retournant une r f rence l objet plut t que son contenu courant Pour obtenir dans un gestion naire d Events le contenu d un objet comme le texte contenu dans un text field page 325 vous pouvez utiliser soit contents of contents of theObject soit content of theUbject Pour un exemple de script montrant la diff rence entre content et contents voir la section Version de la classe control page 280 data column Pluriel data columns H rite de personne Classe Cocoa ASKDataClumn Repr sente une colonne dans un objet data source page 386 Cet objet stocke le nom de la colonne la data source et d autres in formations sur la colonne Vous pouvez utiliser les l ments d un objet data column pour acc der a ses lignes ou aux cellules individuelles qui fournissent ses donn es Vous cr erez g n ralement un objet data source page 386 pour g rer les donn es d un objet outline view page 392 ou table view page 403 Vous cr erez alors chaque objet data column et leur fournirez un nom Ce processus est montr dans la section Exemples de la commande append page 417 Pour un objet outline view page 392 la colonne num ro un est la colonne outline laquelle contient les triangles de d veloppement permet tant l expansion ou la contraction de ses l ments La premi re colonne est g n ralement la colonne outline bien que vous pouvez sp cifi
574. version 1 2 d AppleScript Studio un script peut dire button 1 of tab view item 1 of tab view 1 au lieu de button 1 of view of tab view item 1 of tab view 1 bien que la version longue fonctionne toujours et se lancera avec toutes les versions d AppleScript Studio Voir la section Exemples plus haut pour un autre exemple Traduction trad applescript 23 2 2004 Partie III Container View Suite tab view item 227 tab view item Pluriel tab view items H rite de personne Classe Cocoa NSTabViewltem Repr sente un onglet dans un tab view page 221 Lorsqu un utilisateur clique sur un onglet le tab view affiche la page fournie par l application Un tab view garde un tab view item bas sur un tableau un pour chaque onglet de la view Le tab view de l illustration 3 7 comporte trois tab view item Lorsque vous glissez un tab view page 221 depuis le panneau Cocoa Containers d Interface Builder il contient par d faut deux tab view item Vous pouvez r gler le nombre de tab view item dans la fen tre Info d Inter face Builder Propri t s des objets de la classe Tab View Item Un objet tab view item poss de ces propri t s color Acc s lecture criture Classe RGB color La couleur RVB du tab view item une liste de trois nombres entiers contenant les valeurs de chaque composant de la couleur par exemple la couleur bleue peut tre repr sent e par 0 0 65535 par d faut elle
575. verte en d tails ici Pour un exemple complet mais relati vement simple voir la section Exemples de la classe data item page 379 Pour un autre exemple plus d taill voir les chapitres du guide Building Applications With AppleScript Studio qui d crivent comment construire l application Mail Search laquelle est aussi distribu e avec AppleScript Studio Version Les propri t s suivantes furent ajout es dans la version 1 3 d AppleScript Studio e clicked data item e edited data item Partie V Data View Suite Traduction trad applescript 23 2 2004 398 Chapitre 1 Classes e selected data item e selected data items Le support des Events de Glisser D poser fut ajout dans la version 1 2 d AppleScript Studio La propri t auto save expanded items de cette classe n est pas support e dans la version 1 3 d AppleScript Studio Voir la section Version de la classe table view page 403 de laquelle h rite la classe Outline View pour les propri t s ajout es dans la version 1 2 d AppleScript Studio pour le support du tri Avant la version 1 1 d AppleScript Studio l application Mail Search s appelait Watson table column Pluriel table columns H rite de personne Classe Cocoa NSTableColumn Stocke les caract ristiques d affichage et l identificateur d une colonne d un objet table view page 403 ou outline view page 392 L objet ta
576. view of est optionnel l int rieur du bloc tell les instructions pour recueillir l information de chaque champ texte sont plus simples Chaque instruction assigne une valeur une propri t du script on updateValues theWindow tell view of tab view item infoPanelName of tab view info panels of box border of theWindow set my company to contents of text field company set my name to contents of text field name set my address to contents of text field address set my city to contents of text field city set my state to contents of text field state set my zip to contents of text field zip Traduction trad applescript 23 2 2004 Partie III Container View Suite view 229 set my email to contents of text field email end tell end updateValues La section Exemples de la classe tab view page 221 d crit comment utiliser un tab view pour simuler le zapping du contenu d une view en passant d un tab view item l autre view Pluriel views H rite de responder page 68 Classe Cocoa NSView Une classe r sum d finissant l architecture de base des dessins de la gestion des Events et de l impression d une application Vos scripts en g n ral n interagissent pas directement avec les objets view ils interagissent plut t avec la plupart des classes d interface h ritant de la classe view Vous pouvez cr er et acc der un objet view dans Interface Builder en
577. votre application a uniquement besoin du support du d poser de texte vous n aurez besoin de rien de plus Toutefois une application voulant g rer les donn es d pos es sur un objet text view ou text field et n autorisant pas le support par d faut les g rer devra suivre ces tapes e R pertoriez les drag types que les text view page 569 ou text field page 325 peuvent g rer voir la commande register page 116 pour plus de d tails e Connectez le gestionnaire drop page 486 afin de g rer le texte d pos du text view ou du text field e Connectez un gestionnaire vierge Conclude Drop pour l objet text view ou le text field cela emp chera les objets texte de fournir leur propre support pour le texte d pos Syntaxe conclude drop reference obligatoire drag info drag info obligatoire Param tres reference La r f rence de l objet dont le gestionnaire Conclude Drop est appel drag info drag info page 477 Les informations propos de l op ration de glisser Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Conclude Drop un objet AppleScript Studio ajoute automatiquement au script d sign un gestionnaire vierge Votre gestionnaire pourra prendre n importe quelle d cision n cessaire afin de s occuper de la conclusion du d poser non prise en charge par le gestionnaire drop page 486 Par exemple le gestion naire pourrait nettoyer tout tat qui a t r g
578. vous ne pourrez pas y connecter de gestionnaires Partie II Application Suite Traduction trad applescript 23 2 2004 62 Chapitre 1 Classes Exemples Dans les scripts AppleScript Studio il est commode de se r f rer aux objets par leur nom Par exemple set userInput to contents of text field input of window main Pour fournir un nom AppleScript un objet dans Interface Builder vous suivrez ces tapes 1 Avec l objet s lectionn ouvrez la fen tre Info en choisissant Show Info dans le menu Tools ou en appuyant sur Cmd Maj I 2 Utilisez le menu d roulant en haut de la fen tre Info ou appuyez sur Cmd 6 pour afficher le panneau AppleScript 3 Saisissez le nom dans le champ Name Vous pouvez utiliser le script suivant dans P diteur de Scripts pour obtenir les IDs de chaque view des fen tres ouvertes d une application document based application Pour tester ce point chaque fen tre de docu ment contient un certain nombre de boutons et de champs texte Des instruc tions identiques fonctionneront dans le script d une application AppleScript Studio bien que vous n aurez pas besoin du bloc tell application tell application SimpleDocTest id of every view of every window end tell Ex cuter ce script avec trois fen tres ouvertes retournera la liste suivante contenant une liste de IDs pour chaque fen tre TL 2 3 4 5 6 7 8 9 10 11 12 13 14
579. x cuter n importe quelle action lorsque Partie IX Panel Suite Traduction trad applescript 23 2 2004 540 Chapitre 2 Commandes l utilisateur renvoie la fen tre vous devrez fournir un gestionnaire panel ended page 553 Vous pouvez voir un exemple sur ce gestionnaire dans l application Display Panel distribu e avec AppleScript Studio Version La commande Display fut ajout e dans la version 1 1 d AppleScript Stu dio Avant cette version vous pouviez utiliser la commande display panel page 547 Une commande Display diff rente tait disponible dans la suite Application de la version 1 0 d AppleScript Studio Depuis la version 1 2 d AppleScript Studio la commande Display est recommand e la place de la commande display panel page 547 Le param tre afterwards calling de cette commande n est pas sup port e dans la version 1 3 d AppleScript Studio L application Save Panel fut distribu e pour la premi re fois avec la version 1 1 d AppleScript Studio display alert Affiche Valerte sp cifi e La plupart des param tres optionnels permettent de contr ler l affichage de l alerte Vous afficherez g n ralement une alerte afin de fournir des in formations l utilisateur et laquelle il devra r pondre imm diatement Toutefois vous pouvez afficher une alerte en tant que feuille attach e la fen tre autorisant l utilisateur continuer travailler avec d
580. xe step forward reference obligatoire Param tres reference La r f rence de l objet movie view page 296 recevant la commande Step Forward Exemples Vous pouvez indiquer un objet movie view page 296 d avancer avec les instructions suivantes tell window main tell movie view movie to step forward end tell Pour un exemple plus complexe voir l application Talking Head dis tribu e avec AppleScript Studio Traduction trad applescript 23 2 2004 Partie IV Control View Suite synchronize 343 stop Arr te un objet Diverses classes supportent cette commande Par exemple vous pouvez l utiliser pour arr ter l animation d un objet progress indicator page 306 ind termin ce qui arr te la vrille La commande Stop ne fait rien avec un objet progress indicator d termin Vous pouvez aussi utiliser la commande Stop pour arr ter un film dans un objet movie view page 296 Syntaxe stop reference obligatoire Param tres reference La r f rence de l objet arr ter Exemples tant donn un objet window page 76 nomm main comportant un objet progress indicator page 306 ind termin nomm barber pole l instruction suivante provoquera l arr t de l animation de l objet progress indicator tell progress indicator barber pole of window main to stop Vous pouvez indiquer un objet movie view page 296 de s arr ter avec les instructions sui
581. xemples de la classe table view page 403 Pour un exemple suppl mentaire sur le travail avec les objets data row voir la section Exemples de la classe data cell page 372 Partie V Data View Suite Traduction trad applescript 386 Chapitre 1 Classes data source Pluriel data sources H rite de personne Classe Cocoa ASKDataSource Stocke les donn es et les fournit aux views affichant les lignes et les colonnes de donn es Un objet data source repr sente une forme de sauvegarde pour un tableau et est bas sur une classe sp ciale fournie par le framework AppleScriptKit d AppleScript Studio Pour des informations de m me nature voir les classes data cell page 372 data column page 376 data item page 379 et data row page 384 ainsi que Table Views dans la documentation Cocoa Votre application fournira un objet data source avec des lignes et des colonnes de donn es une view comme table view page 403 ou outline view page 392 Une fois que vous avez fourni les donn es l objet data source travaille avec la view pour automatiquement afficher les bonnes informations en fonction des actions de l utilisateur par exemple lorsque l utilisateur scrolle redimensionne la fen tre r organise les colonnes ou modifie les lignes et les colonnes affich es Utiliser un objet data source est plus efficace que de fournir les donn es dans les gestionnaires devant tre appel s pour chaque morc
582. xt view du tiroir view page 229 Sp cifier par Les formes cl s standards page 15 Les objets view du tiroir Commandes support es par les objets de la classe Drawer Votre script peut envoyer les commandes suivantes un objet drawer close drawer page 239 Partie III Container View Suite Traduction trad applescript 23 2 2004 212 Chapitre 1 Classes open drawer page 240 Events support s par les objets de la classe Drawer Un objet drawer supporte les gestionnaires r pondant aux Events sui vants Drawer closed page 129 opened page 143 should close page 151 should open page 152 will close page 161 will open page 165 will resize page 167 Clavier keyboard down page 133 keyboard up page 134 Souris mouse down page 137 mouse dragged page 138 mouse entered page 139 mouse exited page 139 mouse up page 141 right mouse down page 147 right mouse dragged page 149 right mouse up page 150 scroll wheel page 151 Nib awake from nib page 123 Exemples Pour un aper u du fonctionnement des tiroirs voir la description plus haut de cette classe Pour un exemple d taill voir l application Drawer distribu e avec AppleScript Studio Traduction trad applescript 23 2 2004 Partie III Container View Suite scroll view 213 scroll view Pluriel scroll views H rite de view page 229 Classe Cocoa NSScrollView Fournit la p
583. yScript on choose menu item theItem display dialog Testing end choose menu item end script Make a new menu set testMenu to make new menu at end of menus of main menu with properties title Testing Make a new menu item in the menu set displayMenuItem to make new menu item at end of menu items of testMenu with properties title Display Test name display Assign the script to the menu item set script of displayMenultem to displayScript La section Exemples de la classe menu item page 499 montre com ment acc der a des propri t s suppl mentaires Traduction trad applescript 23 2 2004 Partie VIII Menu Suite menu item 499 menu item Pluriel menu items H rite de item page 60 Classe Cocoa NSMenultem Repr sente un l ment de menu Chaque l ment de menu est associ un objet menu page 495 L illus tration 8 2 montre l l ment de menu New du menu File de la fen tre Nib d Interface Builder MainMenu nib MainMenu r Application Edit Window Help Open 0 Open Recent b Close W Save 35S Save As PRES Revert Page Setup 238P Print P FIG 8 2 L l ment de menu New du menu File de la fen tre Nib d Interface Builder Vous pouvez ajouter un l ment de menu un menu dans Interface Buil der en glissant un objet Item du panneau Cocoa Menus sur le menu concern Vous pouvez r gler les
584. ype d icone with icon 0 L exemple affiche alors un second dialogue pour montrer quel bouton a t cliqu on clicked theObject set theReply to display dialog Please click a button buttons Hello Goodbye OK default button Goodbye giving up after 10 with icon 0 display dialog button returned of theReply end clicked Dans cet exemple le contr le ne revient pas la seconde instruction display dialog tant que l utilisateur n a pas cliqu sur un bouton ou appuy sur la touche Retour ou que les 10 secondes imparties pour r pondre ne sont pas coul es Vous pouvez afficher une icone d finie dans l application en sp cifiant le fichier TIFF de cet icone Par exemple si le fichier se nomme myIcon tiff et que vous l avez mis dans votre projet Xcode vous pouvez remplacer with icon O par with icon mylcon dans le gestionnaire Clicked ci dessus Les constantes AppleScript stop note et caution ne fonctionneront pas si vous vous en servez pour sp cifier l icone dans la commande Display Dialog de votre application Utilisez plut t les valeurs 0 1 et 2 la place AppleScript Studio s appuie sur les icones fournies par Cocoa pour ces va leurs Dans Mac OS X version 10 2 transmettre O affichera une image avec un point d exclamation tandis que 1 ou 2 afficheront l icone g n rique d une application Vous pouvez toutefois utiliser les constantes stop note et caution pour afficher un dialogue pour une autre appli
585. z une instruction identique la suivante o le param tre unique est une liste sp cifiant le cadre call method setFrame of view 1 of window 1 with parameter 20 20 120 120 Pour plus d exemples utilisant la commande Call Method voir la sec tion Exemples de la classe bundle page 38 et du gestionnaire will finish launching page 161 Version Le param tre of est apparu avec la version 1 2 d AppleScript Studio pour remplacer le param tre of object Les deux syntaxes sont support es Partie II Application Suite Traduction trad applescript 23 2 2004 98 Chapitre 2 Commandes mais il est pr f rable d utiliser of Ce petit changement devrait aider clari fier l criture de vos scripts Par exemple au lieu de call method title of object window 1 vous crirez pr sent call method title of window 1 Toutefois si votre application doit tourner avec des versions plus anciennes que la 1 2 vous devrez utiliser la forme of object Depuis la version 1 2 d AppleScript Studio la commande Call Method supporte le type double data Dans les versions pr c dentes double data tait interpr t comme tant une valeur integer La commande Call Method avait de s v res limitations dans la ver sion 1 0 d AppleScript Studio y compris une mauvaise interpr tation des objets sp cifi s dans les param tres with parameter et with parameters et une incapacit correctement reto
586. z utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois que la fen tre a abandonn son tat d objet cl on resigned key theUbject Perform operations here after resigning key state end resigned key resigned main Appel apr s qu un objet window page 76 ait abandonn son tat principal comme la fen tre en avant plan et principal centre d action des op rations de l utilisateur Une fen tre peut tre principale sans tre cl premier r ceptacle des touches du clavier Voir aussi became main page 128 became key page 127 et resigned key page 145 Syntaxe resigned main reference obligatoire Param tres reference La r f rence de l objet window page 76 ayant abandonn son tat d objet principal Exemples Lorsque vous connectez dans Interface Builder un gestionnaire Resigned Main un objet window page 76 AppleScript Studio ajoute automati Traduction trad applescript 23 2 2004 Partie II Application Suite right mouse down 147 quement au script d sign un gestionnaire vierge identique celui qui suit Vous pouvez utiliser ce gestionnaire pour ex cuter toute op ration n cessaire une fois que la fen tre a abandonn son tat d objet principal on resigned main theUbject Perform operations here after resigning main end resigned main resized Appel apr s qu un objet ait t redimensionn Syntaxe resized ref
587. ze to call method cellSize of matrix 1 of window i call method setCellSize of matrix 1 of window 1 with parameter 200 20 current cell Acc s lecture criture Classe cell page 264 La cellule courante current column Acc s lecture criture Classe integer La colonne courante de l objet matrix current row Acc s lecture criture Classe integer La rang e courante de l objet matrix draws background Acc s lecture criture Classe boolean Partie IV Control View Suite Traduction trad applescript 23 2 2004 292 Chapitre 1 Classes Faut il que l objet matrix dessine son fond Par d faut cette propri t vaut false pour une matrice de boutons radios vous pouvez la r gler dans la fen tre Info d Interface Builder draws cell background Acc s lecture criture Classe boolean Faut il que les cellules de l objet matrix dessinent leur fond intercell spacing Acc s lecture criture Classe list L espace vertical et horizontal entre les cellules de l objet matrix par d faut les deux valeurs sont gales 1 0 dans le syst me de coor donn es de l objet matrix voir la propri t bounds de la classe window page 76 pour plus d informations sur le syst me des coordonn es non support e dans la version 1 3 d AppleScript Studio toutefois vous pouvez utiliser la commande call method page 94 pour obtenir ou r gler cette propri t

Terminologie d`AppleScript Studio

Contents

Download Pdf Manuals

Related Search

Related Contents