projman/hlp/fr/tcl/resource.htm

80 lines
8.1 KiB
HTML
Raw Normal View History

2015-10-19 13:27:31 +03:00
<HTML><HEAD>
<BASEFONT FACE="Times New Roman" SIZE="2" COLOR="#000000">
</HEAD>
<BODY>
<div><H3><b>resource&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Commandes Internes Tcl</b></H3></div>
<HR ALIGN="center">
<div><b>NOM</b></div>
<div ALIGN="LEFT" style="margin-left: 51px;">resource - Manipule les <i>resources</i> Macintosh
</div><br>
<div><b>SYNTAXE</b></div><br>
<div ALIGN="LEFT" style="margin-left: 51px;"><b>resource </b><i>option</i> ?<i>arg arg ...</i>?
</div><br>
<div><b>DESCRIPTION</b></div><br>
<div ALIGN="LEFT" style="margin-left: 51px;">La commande <b>resource</b> fournit des op<6F>rations g<>n<EFBFBD>riques pour la gestion des <i>resources</i> Macintosh Cette commande est support<72>e seulement sur la plateforme Macintosh. Chaque fichier Macintosh consiste en deux <i>forks</i>: une fork <i>data</i> et une fork<i> resource</i>. Vous utilisez les commandes normales <b>open</b>, <b>puts</b>, <b>close</b>, etc. pour manipuler les fork <i>data</i>. Vous devez utiliser cette commande, n<>anmoins, pour interagir avec le fork <i>resource</i> <i>Option</i> indique quelle commande resource effectuer. N'importe quel abr<62>viation unique pour <i>option</i> est acceptable Les options valides sont:
<DL>
<DT><b>resource close </b><i>rsrcRef</i>
</DT><DD>Ferme la r<>f<EFBFBD>rence resource donn<6E>e (obtenue par <b>resource</b><A HREF="142.htm"><b>open</b></A>) Les resources de ce fichier resource ne seront plus disponibles.
</DD>
<DT><br><b>resource delete</b> ?<i>options</i>? <i>resourceType</i>
</DT><DD>Cette commande effacera la resource sp<73>cifi<66>e par <i>options</i> et le type <i>resourceType</i> (voir TYPES DE RESOURCES ci-dessous) Les options vous donnent plusieurs fa<66>ons de sp<73>cifier l'effacement de la resource.
<DL>
<DT><b>-id</b> <i>resourceId</i>
</DT><DD>Si l'option <b>-id</b> est donn<6E>e l'id <i>resourceId</i> (voir IDS DE RESOURCE ci-dessous) est utilis<69> pour sp<73>cifier la resource <20> effacer L'id doit&nbsp; <20>tre un nombre - pour sp<73>cifier un nom utiliser l'option<b> -name</b>.
</DD>
<DT><b>-name</b> <i>resourceName</i>
</DT><DD>Si <b>-name</b> est sp<73>cifi<66>, la resource nomm<6D>e <i>resourceName</i> sera effac<61>e. Si <b>-id</b> est aussi fournie, alors il doit exister une resource avec A LA FOIS ce nom et cet id. Si aucun nom n'est fourni, alors l'id sera utilis<69> ind<6E>pendemment du nom de la resource.
</DD>
<DT><b>-file</b> <i>resourceRef</i>
</DT><DD>Si l'option <b>-file</b> est sp<73>cifi<66>e alors la resource sera effac<61>e du fichier point<6E> par <i>resourceRef</i> Autrement la premi<6D>re resource avec le <i>resourceName</i> donn<6E> et ou <i>resourceId</i> qui est trouv<75> dans le chemin du fichier resource sera&nbsp; effac<61>. Pour inspecter le chemin du fichier, utiliser la commande<i> </i><i>resource files</i>.
</DD>
</DL>
</DD>
<DT><br><b>resource files ?</b><i>resourceRef</i>?
</DT><DD>Si <i>resourceRef</i> n'est pas fournie, cette commande retourne une liste Tcl des r<>f<EFBFBD>rences de resource pour tous les fichiers resources couramment ouverts. La liste est dans l'ordre de recherche normal Macintosh pour les resources. Si <i>resourceRef</i> est sp<73>cifi<66>, la commande renverra le chemin vers le fichier dont le fork resource est represent<6E> par ce jeton.
</DD>
<DT><br><b>resource list </b><i>resourceType</i>?<i>resourceRef</i>?
</DT><DD>Liste tous les ids resources de type <i>resourceType</i> (voir TYPES DE RESOURCE ci-dessous) Si <i>resourceRef</i> est sp<73>cifi<66> alors la commande limitera la recherche <20> ce fichier resource particulier. Autrement, tout fichier resource couramment ouvert par l'application sera recherch<63>. Une liste Tcl de soit le nom soit l'id de resource des resources trouv<75>es sera renvoy<6F>e. Voir la section IDS DE RESOURCE ci-dessous pour plus de d<>tails au sujet de ce qu'est un id de resource.
</DD>
<DT><br><b>resource open </b><i>fileName</i> ?<i>access</i>?
</DT><DD>Ouvre la resource pour le fichier <i>fileName</i>. Les permissions d'acc<63>s fichier standard peuvent aussi <20>tre sp<73>cifi<66>es (voyez la page de manuel de <A HREF="142.htm"><b>open</b></A> pour les d<>tails). Une r<>f<EFBFBD>rence de resource (<i>resourceRef</i>) est renvoy<6F>e qui peut <20>tre utilis<69>e par les autres commandes resource. Une erreur peut se produire si le fichier n'existe pas ou si le fichier n'a pas de fork resource. N<>anmoins, si vous ouvrez le fichier avec des permissions d'<27>criture le fichier et/ou le fork resource sera cr<63><72> au lieu de g<>n<EFBFBD>rer une erreur.
</DD>
<DT><br><b>resource read </b><i>resourceType</i> <i>resourceId</i> ?<i>resourceRef</i>?
</DT><DD>Lit la totalit<69> de la resource de type <i>resourceType</i> (voir TYPES DE RESOURCE ci-dessous) et le nom ou l'id of <i>resourceId</i> (voir IDS DE RESOURCE ci-dessous) en m<>moire et retourne le r<>sultat. Si <i>resourceRef</i> est sp<73>cifi<66>, la recherche sera limit<69>e au fichier resource, autrement on recherchera tous les forks resource ouverts dans l'application. Il est important de noter que la plupart des resource Macintosh utilisent un format binaire et les donn<6E>es renvoy<6F> par cette commande peuventt contenir des NULLs ou d'autres donn<6E>es non-ASCII.
</DD>
<DT><br><b>resource types ?</b><i>resourceRef</i>?
</DT><DD>Cette commande retourne une liste Tcl de tous les types de resource (voir TYPES DE RESOURCE ci-dessous) trouv<75>s dans le fichier resource point<6E> par <i>resourceRef</i>. Si <i>resourceRef</i> n'est pas sp<73>cifi<66> elle renverra tout les types de resource trouv<75>s dans tous les fichiers resource couramment ouverts par l'application.
</DD>
<DT><br><b>resource write</b> ?<i>options</i>? <i>resourceType</i> <i>data</i>
</DT><DD>Cette commande <20>crit les <i>data</i> transmises en tant qu'une nouvelle resource de type <i>resourceType</i> (voir TYPES DE RESOURCE ci-dessous). Plusieurs options sont disponibles qui decrivent o<> et comment la resource est stock<63>e.
<DL>
<DT><b>-id</b> <i>resourceId</i></DT><DD>Si l'option <b>-id</b> est donn<6E>e, l'id <i>resourceId</i> (voir IDS DE RESOURCE ci-dessous) est utilis<69> pour la nouvelle resource, autrement un id unique sera g<>n<EFBFBD>r<EFBFBD> qui n'entrera pas en conflit avec une resource existante. N<>anmoins, l'id doit <20>tre un nombre - pour sp<73>cifier un nom utiliser l'option<b> </b><b>-name</b>.
</DD>
<DT><b>-name</b> <i>resourceName</i>
</DT><DD>Si <b>-name</b> est sp<73>cifi<66> le resource sera nomm<6D>e <i>resourceName</i>, autrement elle aura pour nom la cha<68>ne vide.
</DD>
<DT><b>-file</b> <i>resourceRef</i>
</DT><DD>Si l'option <b>-file</b> est sp<73>cifi<66>e alors la resource sera <20>crite dans le fichier point<6E> par <i>resourceRef</i>, autrement la resource la plus recemment ouverte sera utilis<69>e.
</DD>
<DT><b>-force</b>
</DT><DD>Si la resource cible existe d<>j<EFBFBD>, alors par d<>faut Tcl ne l'<27>crasera pas, mais l<>vera une erreur. Utilisez le flag -force pour forcer l'<27>crasement de la resource existante
</DD>
</DL>
</DD>
</DL>
</div><br>
<div><b>TYPES DE RESOURCE </b></div><br>
<div ALIGN="LEFT" style="margin-left: 51px;">Les types de resource sont d<>finis comme une cha<68>ne de quatre caract<63>re qui est alors mapp<70>e <20> un id sous-jacent Par exemple, <b>TEXT</b> se r<>f<EFBFBD>re au type de resource Macintosh pour le texte. Le type <b>STR#</b> est une liste de cha<68>nes index<65>e. Toutes les resources Macintosh doivent avoir un type. Voir la documentation Macintosh pour une liste plus compl<70>te des types de resource qui sont commun<75>ment utilis<69>s.
</div><br>
<div><b>IDS DE RESOURCE </b></div><br>
<div ALIGN="LEFT" style="margin-left: 51px;">Pour cette commande la notion d'un id de resource se ref<65>re <20> deux id<69>es sur les resources Macintosh. Partout o<> vous pouvez utiliser un Id de resource, vous pouvez utiliser soit le nom de resource ou un num<75>ro de resource. Les noms sont toujours recherch<63>s ou renvoy<6F>s de pr<70>f<EFBFBD>rence aux num<75>ros. Par exemple, la commande <b>resource list</b> renverra les noms s'ils existent ou les num<75>ros si le nom est NULL.
</div><br>
<div><b>PROBLEMES DE PORTABILITE</b></div><br>
<div ALIGN="LEFT" style="margin-left: 51px;">La commande <i>resource</i> est seulement disponible sur Macintosh. </div><br>
<div><b>VOIR EGALEMENT</b></div><br>
<div ALIGN="LEFT" style="margin-left: 51px;"><A HREF="142.htm">open</A></div><br>
<div>Derni<EFBFBD>re r<>vision: 8.0</div>
<br>
<br><div ALIGN="CENTER"><A HREF="index.htm"><b>Index</b></A>&nbsp;&nbsp;<A HREF="155.htm"><b>Pr<EFBFBD>c<EFBFBD>dent</b></A>&nbsp;&nbsp;<A HREF="157.htm"><b>Suivant</b></A></div>
</BODY></HTML>