Tcl/Tk Project Manager
Author: Sergey Kalinin banzaj28@yandex.ru
-
Home page: http://nuk-svk.ru
-
-
Tcl/Tk Project Manager is a full IDE for programming in TCL/Tk.
-It includes a project and file manager, a source editor with
-syntax highlighting and procedure navigation, a context-sensitive
-help system, and much more. Included TkDIFF+ - compare tools and TkREGEXP - a graphical front-end to write/debug regular expression.
-
-
Working an Unix (Linux tested) and Windows.
-
-
Begin work with ProjMan
CREAT NEW PROJECT -
Select "New project" for creation new project or "Open project" for opened existing project into "Projects" menu. -
SET ACTIVE PROJECT -
All operation with projects into ProjMan implemented only active project. -Click mouse on project name in tree for set active project. -Name of current (active) project You will see into status bar. -
DELETING PROJECT -
For deleting project You must select "Delete project" into "Projects" menu. -
EDITING FILE -
For editing file click twice on file name into tree. - - diff --git a/hlp/en/projman/pmhelp.html b/hlp/en/projman/pmhelp.html deleted file mode 100644 index 195c0ff..0000000 --- a/hlp/en/projman/pmhelp.html +++ /dev/null @@ -1,3 +0,0 @@ -
Help system manual
Needed translate from russian language! diff --git a/hlp/en/projman/pmkeys.html b/hlp/en/projman/pmkeys.html deleted file mode 100644 index 6bff41d..0000000 --- a/hlp/en/projman/pmkeys.html +++ /dev/null @@ -1,34 +0,0 @@ -
Hot keys
Ctrl + A - Saved file eith different name -
Ctrl + C - Copy selected text into clipboard. -
Ctrl + F - Search words into text. -
Ctrl + G - Goto line with number -
Ctrl + J - Get procedure list -
Ctrl + L - Get word list -
Ctrl + M - Switch editors open tabs -
Ctrl + N - Create new file -
Ctrl + O - Opened existing file. -
Ctrl + Q - Quit from Project Manager. -
Ctrl + R - Find and replacement words into text. -
Ctrl + S - Saved current opened file. -
Ctrl + T - Reverses the order of the two characters to the right of the insertion cursor -
Ctrl + U - Jump cursor on open/close bracked -
Ctrl + V - Insert text from clipboard -
Ctrl + W - Close current opened file. -
Ctrl + X - Cut selected text into clipboard. -
Ctrl + Z - Undo last operation -
Ctrl + / - Selects the entire contents of the widget -
Ctrl + \\ - Clears any selection in the widget -
F1 - Execute context-sensitive help system -
F3 - Repeat search -
F5 - Make archive. Workined with active project only. -
F6 - Make RPM -
F9 - Run current project. - - - - - - diff --git a/hlp/en/projman/pmregexp.html b/hlp/en/projman/pmregexp.html deleted file mode 100644 index 12ab354..0000000 --- a/hlp/en/projman/pmregexp.html +++ /dev/null @@ -1,81 +0,0 @@ -
VisualREGEXP
-Copyright (c) 2000-2001 Laurent Riesterer
-
Latest version 2.2
ABOUT -
VisualREGEXP helps you to design, debug or more generally work with regular -expression. As it is often difficult to write the right regexp at the first -try, this tool will show you the effect of your regexp on a sample you can -choose. -
REQUIREMENTS -
This program requires Tcl/Tk 8.3.0 or later. -
HOW TO USE - -
Launching the program -
On Unix, use 'chmod +x ...' to make the program executable. You can then
-integrate it with your Window Manager or put it into an executable path.
-
On Windows, create a shortcut and invoke the script with 'wish.exe'
-
-
Design of regexps -
To design regexp, just type the expression in the top text widget. -Press the 'Go' button to highlight the matched part of the text in the sample -text widget. - -
To get a quickref of the regexp syntax use the menu 'View/Show regexp help'. - -
You can specify some options using the checkboxes (please read Tcl help to -learn the meaning of these options). - -
Recursive design of regexps - -
Sometimes you will need more than one step to extract the information you want -from the sample. For example, imagine you want to retrieve information from -an HTML table inside an another HTML table : - - '
-
-
| ||||
| Foo | Bar |
You cannot use one global regexp to extract the two lines "One 1" and "Two 2". -You have to use a first regexp to narrow the processed region. -Type the following regexp '
| (.*?) | .*?(.*?) | ' to get the information you need. - -|||
| - abs - | -- cosh - | -- log - | -- sqrt - | -
| - acos - | -- double - | -- log10 - | -- srand - | -
| - asin - | -- exp - | -- pow - | -- tan - | -
| - atan - | -- floor - | -- rand - | -- tanh - | -
| - atan2 - | -- fmod - | -- round - | -- - | -
| - ceil - | -- hypot - | -- sin - | -- - | -
| - cos - | -- int - | -- sinh - | -- - | -
-
-
-
- abs(arg)
- Renvoie la valeur absolue de arg. Arg peut tre entier ou flottant, et le rsultat renvoy est de la mme forme. - -
- acos(arg)
- Renvoie l'arc cosinus de arg, dans l'intervalle [0,pi] radians. Arg sera dans l'intervalle [-1,1]. - -
- asin(arg)
- Renvoie l'arc sinus de arg, dans l'intervalle [-pi/2,pi/2] radians. Arg sera dans l'intervalle [-1,1]. - -
- atan(arg)
- Renvoie l'arc tangente de arg, dans l'intervalle [-pi/2,pi/2] radians. - -
- atan2(x, y)
- Renvoie l'arc tangente de y/x, dans l'intervalle [-pi,pi] radians. x et y ne peuvent tretous les deux 0. - -
- ceil(arg)
- Renvoie la plus petite valeur entire non infrieure arg. - -
- cos(arg)
- Renvoie le cosinus de arg, mesur en radians. - -
- cosh(arg)
- Renvoie le cosinus hyperbolique de arg. Si le rsultat cause un dbordement, une erreur est renvoye. - -
- double(arg)
- Si arg est une valeur flottante , retourne arg, autrement convertit arg en flottant et retourne la valeur convertie. - -
- exp(arg)
- Renvoie l'exponentiel de arg, dfini comme e**arg. Si le rsultat cause un dbordement, une erreur est renvoye. - -
- floor(arg)
- Renvoie la plus grande valeur entire non suprieure arg. -
- fmod(x, y)
- Renvoie le reste flottant de la division of x par y. Si y est 0, une erreur est renvoye. - -
- hypot(x, y)
- Calcule la longueur de l'hypotnuse d'un triangle rectangle(x*x+y*y). - -
- int(arg)
- Si arg est une valeur entire, retourne arg, autrement convertit arg en entier par truncature et retourne la valeur convertie. - -
- log(arg)
- Renvoie le logarithme naturel de arg. Arg doit tre une valeur positive. - -
- log10(arg)
- Renvoie le logarithme base 10 de arg. Arg doit tre une valeur positive. - -
- pow(x, y)
- Calcule la valeur de x elev la puissance y. Si x est ngatif, y doit tre une valeur entire. - -
- rand()
- Renvoie un nombre flottant compris entre zro et juste infrieur un ou, en termes mathmatiques, l'intervalle [0,1]. La graine vient de l'horloge interne de la machine ou peut tre fixe manuelllement avec la fonction srand. - -
- round(arg)
- Si arg est une valeur entire, retourne arg, autrement convertit arg en entier arrondi et retourne la valeur convertie. - -
- sin(arg)
- Renvoie le sinus de arg, mesur en radians. - -
- sinh(arg)
- Renvoie le sinus hyperbolique de arg. Si rsultat cause un dbordement, une erreur est renvoye. - -
- sqrt(arg)
- Renvoie la racine carre de arg. Arg doit tre non-ngatif. - -
- srand(arg)
- Le arg, qui doit tre un entier, est utilis pour rinitialiser la graine du generateur de nombre alatoire. Renvoie le premier nombre alatoire de cette graine. Chaque interprteur a sa propre graine. - -
- tan(arg)
- Renvoie la tangente de arg, mesure en radians. - -
- tanh(arg)
- Renvoie la tangente hyperbolique de arg. -
-
-
-expr 5 / ( [string length "abcd"] + 0.0 )
-
-
-expr {"0y" < "0x12"}
-
-
-set b {$a + 2}
-expr $b*4
-
-
- - diff --git a/hlp/fr/tcl/fblocked.htm b/hlp/fr/tcl/fblocked.htm deleted file mode 100644 index cc844e1..0000000 --- a/hlp/fr/tcl/fblocked.htm +++ /dev/null @@ -1,22 +0,0 @@ - -
fblocked Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/fconfigure.htm b/hlp/fr/tcl/fconfigure.htm deleted file mode 100644 index 0a1e9eb..0000000 --- a/hlp/fr/tcl/fconfigure.htm +++ /dev/null @@ -1,56 +0,0 @@ - -
fconfigure Commandes Internes Tcl
-
-
-
-
-fconfigure channelId name
-fconfigure channelId name value ?name value ...?
-
-
-
-
-
- -blocking boolean
- L'option -blocking dtermine si les oprations I/O sur le canal peuvent provoquer le bloquage du processus. La valeur de l'option doit tre une valeur boolenne correcte. Les canaux sont normalement en mode bloquant; si un canal est plac en mode non bloquant ceci affectera l'opration des commandes gets, read, puts, flush, et close; voyez la documentation de ces commandes pour les dtails. Pour que le mode non bloquant fonctionne correctement, l'application doit utiliser la boucle d'vnement Tcl (ex. en appelant Tcl_DoOneEvent ou la commande vwait). - -
- -buffering newValue
- Si newValue est full alors le systme I /O mettra la sortie en tampon jusqu'a ce que son tampon interne soit plein ou jusqu'a ce que la commande flush soit appele. Si newValue est line, alors le systme I/O flushera automatiquement la sortie pour le canal chaque fois que un caractre newline est mis. Si newValue est none, le systme I/O flushera automatiquement aprs tout opration de sortie. La valeur par dfaut de -buffering est fixe full except pour les canaux qui se connectent des priphriques terminal-like; pour ces canaux la valeur initiale est line. De plus, stdin et stdout sont initialement fixs line, et stderr est fix none. - -
- -buffersize newSize
- Newvalue doit tre un entier; sa valeur est utilise pour fixer la taille, en octets, du tampon allou pour ce canal pour stocker l'entre ou la sortie. Newvalue doit tre entre dix et un million, permettant des tampons d'une taille de dix un million octets. - -
- -encoding name
- Cette option est utilise pour specifier l'encodage du canal, ainsi les donnes peuvent tre converties de et partir d'Unicode pour tre utilises en Tcl. Par exemple, pour permettre Tcl de lire des caractres d'un fichier Japonais en shiftjis et d'en traiter et d'afficher correctement le contenu, l'encodage devra tre fix shiftjis. Ainsi, en lisant partir du canal, les octets du fichier Japonais seront convertis en Unicode au fur et mesure de leur lecture. L'criture est aussi supporte quand les chanes Tcl seront crites dans le canal elles seront automatiquement converties en l'encodage spcifi pour la sortie. -Si un fichier contient des donnes binaires pures (par exemple, une image JPEG), l'encodage du canal sera configur en binary. Tcl alors n'assignera aucune interprtation aux donnes dans le fichier et simplement lira ou ecrira des octets. La commande Tcl binary peut tre utilise pour manipuler ces donnes orientes-octet. -L'encodage par dfaut pour les canaux nouvellement ouverts est le mme que le systme d'encodage utilis pour l 'interface avec le systme d'exploitation. - -
- -eofchar char
- -eofchar {inChar outChar}
- Cette option supporte le systme de fichiers DOS qui utilise Control-z (\x1a) comme marqueur de fin de fichier. Si char n'est pas une chane vide, alors ce caractre signale fin-de-fichier quand il est rencontr pendant l'entre. Pour la sortie, le caractre fin-de-fichier est mis quand le canal est ferm. Si char est la chane vide, alors il n'y a pas de caractre spcial marqueur de fin de fichier. Pour les canaux en lecture-criture, une liste deux-lment spcifie le marqueur de fin de fichier pour l'entre et la sortie, respectivement. Comme convnience, quand vous fixez le caractre de fin-de-fichier pour un canal en lecture-criture vous pouvez specifier une simple valeur qui s'appliquera la fois la lecture et l'criture. Quand vous interrogez le caractre de fin-de-fichier d'un canal en lecture-criture, une liste deux-lments sera toujours renvoye. La valeur par dfaut de -eofchar est la chane vide dans tout les cas except pour les fichiers sous Windows. Dans ce cas, -eofchar est Control-z (\x1a) pour la lecture et la chane vide pour l'criture. - -
- -translation mode -
- -translation {inMode outMode}
- Dans les scripts Tcl la fin d'une ligne est toujours represente en utilisant un simple caractre newline (\n). Nanmoins, dans les fichiers et priphriques la fin d'une ligne peut tre represente diffremment sur diffrentes plateformes, ou mme pour diffrents priphriques sur la mme plateforme. Par exemple, sous UNIX les saut de lignes sont utiliss dans les fichiers, alors que les squences retour-chariot/linefeed sont normalement utilises dans les connections rseau. En entre (ex., avec gets et read) le systme I/O Tcl traduit automatiquement traduit la reprsentation fin-de-ligne externe en caractres newline. En sortie (ex., avec puts), le systme I/O traduit le saut de lignes en reprsentation externe fin-de-ligne. Le mode de traduction par dfaut, auto, gre tout les cas communs automatiquement, mais l'option -translation fournit un contrle explicite des traductions de fin de ligne.
-La valeur associe -translation est un simple item pour les canaux lecture-seule et criture-seule. La valeur est une liste deux-lment pour les canaux en lecture-criture; le mode de traduction de lecture est le premier lment de la liste, et le mode de traduction d'criture est le second lment. Comme convenience, quand vous fixez le mode de traduction pour un canal en lecture-criture vous pouvez specifier une seule valeur qui s'appliquera autant la lecture qu' l'criture. Quand vous demandez le mode de traduction d'un canal lecture-criture, une liste deux-lments sera toujours renvoye. Les valeurs suivantes sont couramment supportes:
-
-
-
- auto
- Comme mode traduction d'entre, auto traite newline (lf), retour chariot (cr), ou retour chariot suivi par une newline (crlf) comme la reprsentation de fin de ligne. La reprsentation de fin de ligne peut mme changer d'une ligne l'autre, et tout les cas sont traduits en newline. Comme mode de traduction de sortie, auto choisit une reprsentation spcifique la plateforme; pour les sockets sur toutes les plateformes Tcl choisit crlf, pour tous les Unix, il choisit lf, pour la plateforme Macintosh il choisit cr et pour les diffrentes versions de Windows il choisit crlf. La valeur par dfaut de -translation est auto pour l'entre et la sortie. - -
- binary
- Aucunes traductions fin de ligne ne sont effectues. Ceci est presque identique au mode lf, except qu'en plus le mode binary fixe aussi le caractre fin-de-fichier la chane vide (qui le dsactive) et fixe l'encodage binary (qui dsactive le fitrage par l'encodage). Voir la description de -eofchar et -encoding pour plus d'information. - -
- cr
- La fin d'une ligne dans le fichier ou priphrique sous-jacent est represente par un simple caractre retour chariot. Comme mode de traduction d'entre, le mode cr convertit les retours chariot en caractres newline. Comme le mode de traduction de sortie, le mode cr traduit les caractres newline en retour chariot. Ce mode est typiquement utilis sur les plateformes Macintosh. - -
- crlf
- La fin d'une ligne dans le fichier ou priphrique sous-jacent est represente par un caractre retour chariot suivi par un caractre linefeed. Comme mode de traduction d'entre,le mode crlf convertit le squences retour chariot /linefeed en caractres newline. Comme mode de traduction de sortie, le mode crlf traduit caractres newline en squences retour chariot /linefeed. Ce mode est principalement utilis sur les plateformes Windows et pour les connections rseau. - -
- lf
- la fin d'une ligne dans le fichier ou priphrique sous-jacent est reprsente par un seul caractre newline; Dans ce mode, aucune traduction ne se fait pendant soit l'entre soit la sortie. Ce mode est utilis principalement sur les plateformes UNIX. -
- - auto
-
-
-
- diff --git a/hlp/fr/tcl/fcopy.htm b/hlp/fr/tcl/fcopy.htm deleted file mode 100644 index 24cff21..0000000 --- a/hlp/fr/tcl/fcopy.htm +++ /dev/null @@ -1,65 +0,0 @@ - -
fcopy Commandes Internes Tcl
-
-
-
-
-
-
-
-
- global total
- set total $bytes
- close $in
- close $out
- if {[string length $error] != 0} {
-# l'erreur s'est produite pendant la copie
- }
-}
-set in [open $file1]
-set out [socket $serveur $port]
-fcopy $in $out -command [liste Cleanup $in $out]
-vwait total
-
-
- global total done
- incr total $ bytes
- if {([string length $error] != 0) || [eof $in] {
-set done $total
-close $in
-close $out
- } else {
-fcopy $in $out -command [list CopyMore $in $out $chunk] \
- -size $chunk
- }
-}
-set in [open $file1]
-set out [socket $serveur $port]
-set chunk 1024
-set total 0
-fcopy $in $out -command [list CopyMore $in $out $chunk] -size $chunk
-vwait done
-
-
-
-
-
- diff --git a/hlp/fr/tcl/file.htm b/hlp/fr/tcl/file.htm deleted file mode 100644 index f3d3662..0000000 --- a/hlp/fr/tcl/file.htm +++ /dev/null @@ -1,112 +0,0 @@ - -
file Commandes Internes Tcl
-
-
-
-
-
-
-
-
- file atime name ?time?
- Renvoie une chane dcimale donnant la date du dernier accs au fichier name. Si time est spcifi, c'est pour fixer la date d'accs au fichier. Le temps est mesur de la faon POSIX standard comme nombre de secondes depuis une date fixe (souvent January 1, 1970). Si le fichier n'existe pas ou que sa date d'accs ne peut tre trouve ou fixe alors une erreur est gnre. Sous Windows, le systme de fichiers FAT ne supporte pas la date d'accs (POSIX).
-
file attributes name
- - file attributesname ?option? - -
- file attributesname ?option value option value...? -
- Cette sous commande retourne ou fixe les valeurs spcifiques la plateforme associes un fichier. La premire forme retourne une liste de flags spcifiques la plateforme et leurs valeurs. La seconde forme retourne la valeur de l'option spcifique. Le troisime forme fixe une ou plusieurs des valeurs. La valeurs sont les suivantes: -Sous Unix, -group lit ou fixe le nom de groupe pour le fichier. Un group id peut tre donn la commande, mais elle retourne un nom de groupe. -owner gets ou fixe le nom de l'utilisateur propritaire du fichier. La commande retourne le nom du propritaire, mais l'id numrique peut tre transmise quand on fixe le propritaire. -permissions fixe ou lit le code octal que chmod(1) utilise. Cette commande a aussi un support limit pour fixer en utilisant les attributs symboliques pour chmod(1), de la forme [ugo]?[[+-=][rwxst],[...]], ou les attributs symboliques multiples peuvent tre spars par des virgules (exemple: u+s,go-rw ajoute sticky bit pour l'utilisateur, et enlve les permissions lecture et criture pour le groupe et le reste du monde). Un style chane simplifi ls, de la forme rwxrwxrwx (doit tre 9 caractres), est aussi support (exemple: rwxr-xr-t est quivalent 01755). -Sous Windows, -archive donne la valeur ou bien fixe ou efface l'attribut archive du fichier. -hidden donne la valeur ou bien fixe ou efface l'attribut cach du fichier. -longname expanse chaque lment de chemin en sa version longue. Cet attribut ne peut pas tre fix. -readonly donne la valeur ou bien fixe ou efface l'attribut lecture seule du fichier. -shortname donne une chane ou tout lment de chemin est remplac avec sa version courte (8.3). Cet attribut ne peut pas tre fix. -system donne ou bien fixe ou efface la valeur de l'attribut systme du fichier. -Sous Macintosh, -creator donne ou fixe le type Finder createur du fichier. -hidden donne ou bien fixe ou efface l'attribut cach du fichier. -readonly donne ou bien fixe ou efface l'attribut lecture seule du fichier. Notez que les rpertoires peuvent seulement tre vrouills si File Sharing est activ. -type donne ou fixe le type Finder du fichier. - -
file channels ?pattern?- Si pattern n'est pas spcifi, retourne une liste de noms de tous les canaux declars ouverts dans cet interprteur. Si pattern est spcifi, seulement les noms correspondants pattern sont renvoys. La correspondance est dtermine en utilisant les mmes rgles que pour string match. -
file copy ?-force? ?--? source target -
- - file copy?-force? ?--? source ?source ...? targetDir - -
- La premire forme fait une copie du fichier ou rpertoire source sous le nom de chemin target. Si target est un rpertoire existant, alors la seconde forme est utilise. La seconde forme fait une copie dans targetDir de chaque fichier source list. Si un rpertoire est spcifi comme source, alors le contenu du rpertoire sera rcursivement copi dans targetDir. Les fichiers existants ne seront pas crass moins que l'option -force soit spcifie. Essayer d'craser un rpertoire non-vide, craser un rpertoire avec un fichier, ou un fichier avec un rpertoire donnera des erreurs mme si -force a t spcifi. Les arguments sont traits dans l'ordre spcifi, s'arrtant la premire erreur, si elle existe. Un -- marque la fin des commutateurs; l'argument suivant le -- sera trait comme un source mme s'il commence avec un -. - -
file delete ?-force? ?--? pathname ?pathname ... ? -- Efface le fichier ou rpertoire spcifi par chaque argument pathname. Les rpertoires non-vide seront enlevs seulement si l'option -force est spcifie. Essayer d'effacer un fichier non-existant n'est pas consider comme une erreur. Essayer d'effacer un fichier lecture-seule provoquera l'effacement du fichier, mme si le -force flags n'est pas spcifi. Les arguments sont trait dans l'ordre spcifi, s'arrtant la premire erreur, si elle existe. Un -- marque la fin des commutateurs; l'argument suivant le -- sera trait comme un pathname mme s'il commence avec un -. - -
file dirname name- Renvoie un nom comportant tout les composants de chemin de name excluant le dernier lment. Si name est un nom de fichier relatif et contient seulement un lment de chemin, alors retourne "." (ou ":" sur le Macintosh). Si name se refre un rpertoire racine, alors le rpertoire racine est renvoy. Par exemple, -file dirname c:/ -retourne c:/. -Notez que la substitution tilde sera effectue seulement si c'est ncessaire pour que la commande aboutisse. Par exemple, -file dirname ~/src/foo.c -retourne ~/src, alors que -file dirname ~ -retourne /home (ou quelque chose de similaire). - -
file excutable name- Renvoie 1 si le fichier name est excutable par l'utilisateur courant, 0 autrement. - -
file exists name- Renvoie 1 si fichier name existe et que l'utilisateur courant a les privileges de recherche pour les rpertoires y menant, 0 autrement. - -
file extension name- Renvoie tous caractres de name aprs et incluant le dernier point dans le dernier lment de name. S'il n'y a pas point dans le dernier lment de name alors retourne la chane vide. - -
file isdirectory name- Renvoie 1 si le fichier name est un rpertoire, 0 autrement.
-
- file isfile name
- Renvoie 1 si le fichier name est un fichier ordinaire, 0 autrement. - -
file join name ?name ...?- Prend un ou plusieurs noms de fichiers et les combine, en utilisant le sparateur de chemin correct pour la plateforme courante. Si un name particulier est relatif, alors il sera joint au prcedent argument nom de fichier. Autrement, tout argument precdent sera cart, et la jointiure commencera l'argument courant. Par exemple, -file join a b /foo bar -retourne /foo/bar. -Notez que n'importe quel des noms peut contenir des sparateurs, et que le rsultat est toujours canonique pour la plateforme courante : / pour Unix et Windows, et : pour Macintosh. - -
file lstat name varName- Identique l'option stat (voir ci-dessous) except qu'elle utilise l' appel kernel lstat au lieu de stat. Ceci signifie que si name se refre un lien symbolique l'information renvoye dans varName concerne le lien plutt que le fichier auquel il se refre. Sur les systmes qui ne supportent pas les lien symboliques cette option se comporte exactement comme l'option stat. - -
file mkdir dir ?dir ...?- file mkdir dir ?dir ...? -
- file mkdir dir ?dir ...? -
- file mtime name ?time?
- Renvoie une chane dcimale donnant le temps auquel fichier name a t modifi pour la dernire fois. Si time est spcifi, c'est une pour fixer le temps pour le fichier (quivalent touch sous Unix). Le temps est mesur de la faon standard POSIX en tant que secondes depuis une date fixe (souvent 1 Janvier 1970). Si le fichier n'existe pas ou la date de modification ne peut tre trouve ou rgle, une erreur est gnre. - -
file nativename name- Renvoie le nom du fichier spcique la plate-forme. Ceci est utile si le nom de fichier est ncessaire transmettre un appel spcique la plate-forme, tel que exec sous Windows ou AppleScript sur Macintosh. -file owned name -Renvoie 1 si fichier name appartient l'utilisateur courant, 0 autrement. - -
file pathtype name- Renvoie un de absolute, relative, ou volumerelative. Si name se refre un fichier spcifique sur un volume spcifique , le chemin type sera absolute. Si name se refre un fichier relatif au rpertoire de travail courant, alors le type du chemin sera relative. Si name se refre un fichier relatif au rpertoire de travail courant sur un volume spcifi, ou un fichier spcifique sur le volume de travail courant, alors le type fichier est volumerelative. - -
file readable name- Renvoie 1 si le fichier name est lisible par l'utilisateur courant, 0 autrement. - -
- file readlink name
- Renvoie la valeur du lien symbolique dsign par name (ex. le nom du fichier vers lequel il pointe). Si name n'est pas un lien symbolique ou que sa valeur ne peut pas tre lue, alors une erreur est gnre. Sur les systmes qui ne supportent pas les liens symboliques cette option est indfinie. - -
file rename?-force? ?--? source target -
- - file rename?-force? ?--? source ?source ...? targetDir -
- La premire forme prend le fichier ou le rpertoire spcifi par le nom de chemin source et le renomme en target, en dplacant le fichier si le nom de chemin target spcifie un nom dans un rpertoire diffrent. Si target est un rpertoire existant, alors la seconde forme est utilise. La seconde forme dplace chaque fichier ou rpertoire source dans le rpertoire targetDir. Les fichiers existants ne seront pas ecrass moins que l'option -force soit spcifie. Essayer d'craser un rpertoire non-vide, craser un rpertoire avec un fichier, ou un fichier avec un rpertoire generera des erreurs. Les arguments sont traits dans l'ordre spcifi, s'arrtant la premire erreur, si elle existe. Un -- marque la fin des commutateurs; l'argument suivant le -- sera trait comme une source mme s'il commence avec un -. - -
file rootname name- Renvoie tous les caractres dans name jusqu'a mais non inclus le dernier caractre "." dans le dernier composant du nom. Si le dernier composant de name ne contient pas de point, alors retourne name. - -
file size name- Renvoie une chane dcimale donnant la taille du fichier name en octets. Si le fichier n'existe pas ou si sa taille ne peut pas tre obtenue alors une erreur est gnre. - -
file split name- Renvoie une liste dont les lments sont les composants de chemin in name. Le premier lment de la liste aura le mme type chemin que name. Tous les autres lments seront relatifs. Les sparateurs de chemin seront carts moins que ils soit ncessaires pour s'assurer qu'un lment est relatif sans ambiguit. Par exemple, sous Unix -file split /foo/~bar/baz -retourne / foo ./~bar baz pour s'assurer que les commandes suivantes qui utiliseront le troisime composant ne tentent pas d'effectuer une substitution de tilde. - -
file stat name varName- Dclenche l'appel kernel stat sur name, et utilise la variable dsigne par varName pour recevoir information renvoye par l'appel kernel. VarName est trait comme une variable tableau, et les lments suivants de cette variable sont fixes: atime, ctime, dev, gid, ino, mode, mtime, nlink, size, type, uid. Chaque lment except type est une chane dcimale avec la valeur du champ correspondant de la stat structure de retour; voyez la page de manuel de stat pour des dtails sur le sens des valeurs. L'lment type donne le type du fichier sous la mme forme que celle renvoye par la commande file type. Cette commande retourne une chane vide. - -
file tail name- Renvoie tous les caractres dans name aprs le dernier sparateur de rpertoire. Si name ne contient pas de sparateurs alors retourne name. - -
file type name- Renvoie une chane donnant le type de fichier name, qui sera l'un de file, directory, characterSpecial, blockSpecial, fifo, link, ou socket. - -
file volume- Renvoie le chemin absolu des volumes monts sur le systme, comme liste Tcl correcte. Sur Macintosh, ce sera une liste des lecteurs monts, locaux ou rseaux. N.B. si deux lecteurs ont le mme nom, ils apparairont tous deux sur la liste de volumes, mais il n'y a pas de faon, avec Tcl, d'acceder un autre que le premier de ces lecteurs. Sous UNIX, la commande retournera toujours "/", car tous les systmes de fichier sont monts localement. Sous Windows, elle renverra une liste des lecteurs locaux disponibles (ex. {a:/ c:/}). - -
file writable name- Renvoie 1 si le fichier name est inscriptible par l'utilisateur courant , 0 autrement. - -
-
-
-Cette commande opre toujours en utilisant les identificateurs rels d'utilisateur et de groupe, et non les identificateurs effectifs. -
-
-
-
-
- diff --git a/hlp/fr/tcl/fileevent.htm b/hlp/fr/tcl/fileevent.htm deleted file mode 100644 index ca7d7c4..0000000 --- a/hlp/fr/tcl/fileevent.htm +++ /dev/null @@ -1,33 +0,0 @@ - -
fileevent Commandes Internes Tcl
-
-
-
-
-fileevent channelId writable ?script -
-
-
-
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/filename.htm b/hlp/fr/tcl/filename.htm deleted file mode 100644 index 5758e67..0000000 --- a/hlp/fr/tcl/filename.htm +++ /dev/null @@ -1,81 +0,0 @@ - -
filename Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
-
- mac
- Sur les systmes Apple Macintosh, Tcl supporte deux formes de noms de chemin. Les styles normaux de noms Mac utilisent les deux points comme sparateurs de chemin Les chemins peuvent tre relatifs ou absolus, et les noms de fichier peuvent conternir tout caractre autre que les deux points Un caractre deux points en tte cause l'interprtation du reste du chemin comme relatif au rpertoire courant. Si un chemin contient deux points qui ne sont pas en tte, alors le chemin est interprt comme un chemin absolu Des squences de deux ou plus deux points ailleurs dans le chemin sont utilises pour construire des chemins relatifs ou :: se rfre au parent du rpertoire courant, ::: se rfre au parent du parent, et ainsi de suite.
-En supplment au noms style Macintosh, Tcl aussi supporte un sous ensemble de noms Unix-like Si un chemin ne contient pas les deux points, alors il est interprt comme un chemin Unix Le slash est utilis comme sparateur de chemin Le nom de chemin . se rfre au rpertoire courant, et .. se rfre au parent du rpertoire courant Nanmoins, quelque noms comme / ou /.. ne sont pas assigns, et sont interprts comme noms Macintosh En general, les commandes qui gnrent les noms de fichier renverront des noms style Macintosh, mais les commandes qui attendent des noms de fichier acceptent aussi bien les noms style Macintosh que Unix.
-Les exemples suivants illustrent les formes varies de noms de chemin:
-
-
-
:- Chemin relatif au dossier courant. -
MyFile- Chemin relatif un nom de chemin MyFile dans le dossier courant. - -
MyDisk:MyFile- Chemin absolu un fichier nomm MyFile sur le priphrique nomm MyDisk. - -
:MyDir:MyFile- Chemin relatif un fichier nomm MyFile dans un dossier nomm MyDir dans le dossier courant. - -
::MyFile- Chemin relatif un fichier nomm MyFile dans le dossier parent du dossier courant. - -
:::MyFile- Chemin relatif un fichier nomm MyFile dans le dossier deux niveaux au dessus du dossier courant. - -
/MyDisk/MyFile- Chemin absolu un fichier nomm MyFile sur le priphrique nomm MyDisk. - -
../MyFile- Chemin relatif un fichier nomm MyFile dans le dossier parent du dossier courant. - -
- - unix
- Sur les plateformes Unix, Tcl utilise des noms de chemin o les composants sont spars par des slashes. Les noms de chemin peuvent tre relatifs ou absolus, et les noms de fichier peuvent contenir tout caractre autre que le slash Les noms de fichier . et .. sont spciaux et se refrent au rpertoire courant et au parent du rpertoire courant respectivement Plusieurs caractres slashes adjacents sont interprt comme un seul sparateur. Les exemples suivants illustrent les formes varies de noms de chemin:
-
-
-
/- Chemin absolu au rpertoire racine. -
/etc/passwd- Chemin absolu vers le fichier nomm passwd dans le rpertoire etc du rpertoire racine. - -
.- Chemin relatif au rpertoire courant. -
foo- Chemin relatif au fichier foo dans le rpertoire courant. - -
foo/bar- Chemin relatif au fichier bar dans le rpertoire foo du rpertoire courant. - -
../foo- Chemin relatif au fichier foo dans le rpertoire parent du rpertoire courant. - -
- - windows
Sur les plateformes Microsoft Windows, Tcl supporte les noms relatifs au lecteur et UNC L'ensemble / et \ peut tre employ comme sparateurs de rpertoires dans les deux types de nom. Les noms relatifs au lecteur consistent en un spcificateur optionnel de lecteur suivi par un chemin absolu ou relatif Les chemins UNC ont la forme generale \\servername\sharename\path\file Sous les deux formes, les noms de fichier . et .. sont spciaux et se refrent respectivement au rpertoire courant et au parent du rpertoire courant. Les exemples suivants illustrent les formes varies de noms de chemin: --
-
\\Host\share/file- chemin UNC absolu vers un fichier appel file dans le rpertoire racine du partage share sur la machine Host. -
c:foo -- Chemin relatif au volume vers un fichier foo dans le rpertoire courant du lecteur c. - -
c:/foo- Chemin absolu vers un fichier foo dans le rpertoire racine du lecteur c. - -
foo\bar- Chemin relatif vers un fichier bar dans le rpertoire foo dans le rpertoire courant sur le volume courant . - -
\foo- Chemin relatif au volume vers un fichier foo dans le rpertoire racine du volume courant . -
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/flush.htm b/hlp/fr/tcl/flush.htm deleted file mode 100644 index b746609..0000000 --- a/hlp/fr/tcl/flush.htm +++ /dev/null @@ -1,22 +0,0 @@ - -
flush Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/for.htm b/hlp/fr/tcl/for.htm deleted file mode 100644 index a3d9672..0000000 --- a/hlp/fr/tcl/for.htm +++ /dev/null @@ -1,22 +0,0 @@ - -
for Commandes Internes Tcl
-
-
-
-
-
-
- puts "x est $x"
-}
-
- diff --git a/hlp/fr/tcl/foreach.htm b/hlp/fr/tcl/foreach.htm deleted file mode 100644 index 644842c..0000000 --- a/hlp/fr/tcl/foreach.htm +++ /dev/null @@ -1,47 +0,0 @@ - -
foreach Commandes Internes Tcl
-
-
-
-
-foreach varlist1 list1 ?varlist2 list2 ...? body -
-
-
-
-
-
-foreach {i j} {a b c d e f} {
- lappend x $j $i
-}
-# La valeur de x est "b a d c f e"
-# Il y a 3 iterations de boucle. -
-
-
-foreach i {a b c} j {d e f g} {
- lappend x $i $j
-}
-# La valeur de x est "a d b e c f {} g"
-# Il y a 4 iterations de boucle.
-
-
-
-foreach i {a b c} {j k} {d e f g} {
- lappend x $i $j $k
-}
-# La valeur de x est "a d e b f g c {} {}"
-# Il y a 3 iterations de boucle. -
-
-
- diff --git a/hlp/fr/tcl/format.htm b/hlp/fr/tcl/format.htm deleted file mode 100644 index 2353f48..0000000 --- a/hlp/fr/tcl/format.htm +++ /dev/null @@ -1,68 +0,0 @@ - -
format Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
-
-- Spcifie que l'argument converti sera justifi gauche dans son champ (les nombres sont normalement justifis droite avec des espaces en tte si besoin). - -
+- Spcifie qu'un nombre doit toujours tre affich avec un signe, mme si positif. - -
space- Spcifie qu'un espace sera ajout au dbut du nombre si le premier caractre n'est pas un signe. - -
0- Spcifie que les nombre seront remplis gauche avec des zros au lieu des espaces. - -
#- Demande une forme de sortie alternative. Pour les conversions o et O ceci garantit que le premier digit sera toujours 0. Pour conversions x ou X, 0x ou 0X (respectivement) sera ajout au dbut du rsultat moins que ce soit zro. Pour toutes conversions flottantes (e, E, f, g, et G) ceci garantit que le rsultat a toujours un point (ou le sparateur dcimal local ? NDT). Pour les conversions g et G ceci spcifie que les zros la fin ne seront pas enlevs. - -
-
-
d- Convertit un entier en chane dcimale signe. -
u- Convertit un entier en chane dcimale non signe. -
i- Convertit un entier en chane dcimale signe; l'entier peut soit tre dcimal, octal (avec 0 en tte) ou en hexadcimal (avec 0xen tte). -
o- Convertit un entier en chane octale non signe. -
x ou X- Convertit un entier en chane hexadcimale non signe, en utilisant les chiffres "0123456789abcdef" pour x et "0123456789ABCDEF" pour X). - -
c- Convertit un entier en le caractre Unicode qu'il reprsente. - -
s- Pas de conversion; insre juste une chane. -
f- Convertit un nombre flottant en chane dcimale signe de la forme xx.yyy, o le nombre de y est dtermin par la prcision (par dfaut: 6). Si la prcision est 0 alors aucun sparateur dcimal n'est affich. - -
e ou e- Convertit un nombre flottant en notation scientifique de la forme x.yyye± zz, o le nombre de y's est dtermin par la prcision (par dfaut: 6). Si la prcision est 0 alors aucun sparateur dcimal n'est affich. Si la forme E est utilise alors E est affich au lieu de e. - -
g ou G- Si l'exposant infrieur -4 ou suprieur ou gal la prcision, alors convertit nombre flottant comme pour %e ou %E. Autrement convertit comme pour %f. les zros la fin et le sparateur dcimal sont omis. - -
%- Pas de conversion; insre juste %. -
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/gets.htm b/hlp/fr/tcl/gets.htm deleted file mode 100644 index fba513c..0000000 --- a/hlp/fr/tcl/gets.htm +++ /dev/null @@ -1,23 +0,0 @@ - -
gets Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/glob.htm b/hlp/fr/tcl/glob.htm deleted file mode 100644 index 72c97ae..0000000 --- a/hlp/fr/tcl/glob.htm +++ /dev/null @@ -1,68 +0,0 @@ -[portail::entete "Manuel Tcl/Tk" "M.SALVAGNIAC"] -[Doc_Dynamic] - -
glob Commandes Internes Tcl
-
-
-
-
-
-
-
-
-directory directory- Recherche les fichiers qui correspondent au modles donns commenant dans le directory donn Ceci permet la recherche de rpertoires dont le nom contient des caractres glob-sensitive sans le besoin de placer ces caractres entre guillemets. Cette option ne peut pas tre utilise en conjonction avec -path. - -
-join- Les arguments modles restants sont traits comme un seul modle obtenu en joignant les arguments avec des sparateurs de rpertoire. - -
-nocomplain- Permet une liste vide d'tre renvoye sans erreur; sans ce switch une erreur est gnre si la liste rsultat est vide. - -
-path pathPrefix- Recherche les fichiers avec le pathPrefix donn o le reste du nom correspond aux modles donns Ceci permet la recherche de fichiers avec des noms identiques un fichier donn mme quand les noms contient des caractres glob-sensitive Cette option ne peut pas tre utilise en conjonction avec -directory. - - -
-types typeList- Liste seulement les fichiers ou rpertoires qui correspondent typeList, o les articles dans la liste ont deux formes La premire forme est comme l'option -type de la commande Unix find: b (bloc spcial fichier), c (caractre spcial fichier), d (rpertoire), f (plain fichier), l (lien symbolique), p (named pipe), ou s (socket), ou de multiple types peuvent tre spcifis dans la liste. Glob renverra tous les fichiers qui correspondent au moins un des types donns.
-La seconde forme spcifie les types auquels tous les types donns doivent correspondre. Ce sont r, w, x comme permissions de fichier, et readonly, hidden comme permission spciales Sur Macintosh, MacOS types et creators sont aussi supports, ou tout article de quatre caractres est suppos tre un type MacOS (ex. TEXT) Les articles qui sont de la forme {macintosh type XXXX} ou {macintosh creator XXXX} correspondront aux types ou creators respectivement Les types non reconnus, ou les spcifications de types/creators MacOS multiples signaleront une erreur.
-Les deux formes peuvent tre mlanges, ainsi -types {d f r w} trouvera tous les fichiers ordinaires OU les rpertoires qui ont les permissions de lecture ET d'criture. Les formes suivantes sont quivalentes:
-
glob-type d * -
glob */ -
except que le premier cas ne retourne pas le "/"final et est plus indpendant de la plateforme. -
-
--- Marque la fin des commutateurs L'argument suivant cela sera trait comme un pattern mme s'il commence avec un -. - -
-
-
?- Correspond n'importe quel caractre. - -
*- Correspond n'importe quelle squence de zro ou plus caractres. - -
[chars]- Correspond n'importe quel caractre de chars Si chars contient une squence de la forme a-b alors n'importe quel caractre entre a et b (inclus) correspondra. - -
\x- Correspond au caractre x. -
{a,b,...}- Correspond quelconque de la chanes a, b, etc. -
-
-
-
-
Windows- Pour les noms Windows UNC, les composants serveur et partage du chemin ne peuvent pas contenir de constructions?, *, ou [] Sous Windows NT, si pattern est de la forme "~username@domain" il se rfre au rpertoire home de l'utilisateur dont l'information de compte rside sur le PDC NT spcifi Autrement, l'information de compte del'utilisateur est obtenue de l 'ordinateur local Sous Windows 95 et 98, glob accepte les modles comme ".../" et "..../" pour les rpertoires successivement parents. - -
-
Macintosh - En utilisant les options, -dir, -join ou -path, glob suppose que le sparateur de rpertoire pour le modle entier est le standard ":" En n'utilisant pas ces options, glob examine chaque argument modle et utilise "/" moins que le modle contienne un ":" . -
-
-
- -[portail::pied] diff --git a/hlp/fr/tcl/global.htm b/hlp/fr/tcl/global.htm deleted file mode 100644 index 0c0e3e8..0000000 --- a/hlp/fr/tcl/global.htm +++ /dev/null @@ -1,20 +0,0 @@ - -
global Commandes Internes Tcl
-
-
-
-
-
-
-
- -
-
- diff --git a/hlp/fr/tcl/history.htm b/hlp/fr/tcl/history.htm deleted file mode 100644 index 2399c66..0000000 --- a/hlp/fr/tcl/history.htm +++ /dev/null @@ -1,53 +0,0 @@ - -
history Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
-
history- Identique history info, dcrit ci-dessous. - -
history add command ?exec?- Ajoute l'argument command l'historique comme nouvel vnement. Si exec est spcifi (ou abrg) alors la commande est aussi excute et son rsultat est renvoy. Si exec n'est pas spcifi alors une chane vide est renvoye comme rsultat. - -
history change newValue ?event? -- Remplace la valeur enregistre pour un vnement avec newValue Event spcifie l'vnement remplacer, et pointe par dfaut sur l'vnement courant (pas l'vnement -1). Cette commande est conue pour tre utilise dans les commandes qui implmentent les nouvelles formes de substitution d'historique et souhaitent remplacer l'vnement courant (qui appelle la substitution) avec la commande cre par la substitution La valeur de retour est une chane vide. - -
history clear -- Efface l'historique. La limite courante est retenue. Les numros d'vnement d'historique sont rinitialiss. - -
history event ?event? -- Renvoie la valeur de l'vnement donne par event Event est gal 1 par dfaut. - -
history info ?count? -- Renvoie une chane formate (et lisible) donnant les numros et contenus d'vnement pour chacun des vnements dans l'historique except l'vnement courant. Si count est spcifi alors seulement les count vnements les plus recent sont renvoys. - -
history keep ?count? -- Cette commande peut tre employe pour changer la taille de l'historique count vnements. Initialement, 20 vnements sont retenus dans l'historique. Si count n'est pas spcifi, la limite courante est renvoye. - -
history nextid -- Renvoie le nombre de l'vnement suivant enregistr dans l'historique. Il est utile par exemple pour afficher le numro d'vnement dans une ligne de commande. - -
history redo ?event? -- Re-excute la commande indique par event et retourne son rsultat. Event est gal 1 par dfaut. Cette commande rsulte en une rvision de l'historique, voir ci-dessous pour les dtails. - -
-
-
-
Index Prcdent Suivant -
-
- diff --git a/hlp/fr/tcl/http.htm b/hlp/fr/tcl/http.htm deleted file mode 100644 index fb0fd31..0000000 --- a/hlp/fr/tcl/http.htm +++ /dev/null @@ -1,261 +0,0 @@ - -
Http Commandes Internes Tcl
-
-
-
-
-::http::config ?options?
-::http::geturl url ?options?
-::http::formatQuery list
-::http::reset token
-::http::wait token -::http::status token
-::http::size token
-::http::code token
-::http::ncode token
-::http::data token
-::http::error token
-::http::cleanup token
-::http::register proto port command
-::http::unregister proto -
-
-
-
-
-
-
::http::config ?options?- La commande::http::config est utilis pour fixer et consulter le nom et le port du serveur proxy, et le nom de l'Agent Utilisateur utilis dans les requtes HTTP Si aucunes options ne sont spcifies, alors la configuration courante est renvoye Si un seul argument est spcifi, alors il doit tre un des flags dcrits ci-dessous Dans ce cas la valeur courante de ce paramtre est renvoye Autrement, les options seront un ensemble de flags et de valeurs qui definissent la configuration:
-
-
-
-accept mimetypes -- L'en-tte Accept de la requte La valeur par dfaut est */*, ce qui signifie que qui tout types de documents sont accepts Autrement vous pouvez donner une liste spare par des virgules de types mime que vous souhaitez recevoir recevoir Par exemple, "image/gif, image/jpeg, text/*". - -
-proxyhost hostname -- Le nom du proxy, s'il existe. Si cette valeur est la chane vide, l'URL est contact directement. - -
-proxyport number -- Le numro de port du proxy. - -
-proxyfilter command -- La commande est un callback qui est appel pendant ::http::geturl pour determiner si un proxy est requis pour un host donn Un argument, un nom de machine, est ajout command quand elle est appele Si un proxy est requis, le callback renverra une liste de deux lment contenant le serveur proxy et le port proxy Autrement le filtre renverra une liste vide Le filtre par dfaut retourne les valeurs des paramtres -proxyhost et -proxyport si ils sont non-vides. - -
-useragent string -- La valeur de l'en-tte Agent Utilisateur dans la requte HTTP Par dfaut "Tcl http client package 2.2." - -
-
::http::geturl url ?options? - -- La commande::http::geturl est la fonction principale dans le paquetage. L'option - query provoque une opration POST et l'option -validate provoque une opration HEAD; autrement, une opration GET est effectue La commande::http::geturl retourne une valeur token qui peut tre utilise pour obtenir l'information concernant la transaction Voir les sections TABLEAU D'ETAT et ERRORS pour les dtails La commande::http::geturl bloque jusqu'a ce que l'opration se termine, moins que l'option -command spcifie un callback appel quand la transaction HTTP se termine. ::http::geturl accepte plusieurs options:
-
-
-
-blocksize size- La taille de bloc utilise en lisant l'URL. Au plus size octets sont lus en une fois. Aprs chaque bloc, un appel -progress est fait (si cette option est spcifie). - -
-channel name -- Copie l'URL contenu dans le canal name au lieu de le sauvegarder dans state(body). - -
-command callback -- Appelle callback aprs la fin de la transaction HTTP. Cette option cause le retour immdiat de ::http::geturl. Le callback recoit un argument supplmentaire qui est le token renvoy par ::http::geturl. Ce jeton est le nom d'un tableau qui est dcrit dans la section TABLEAU D'ETAT.Voici un modle pour le callback:
-
proc httpCallback {token} { -
upvar #0 $token state -
# Accde au tableau d'tat Tcl -
} -
-
-handler callback -- Appelle callback chaque fois que des donnes HTTP sont disponibles; si prsent, rien d'autre ne sera fait avec les donnes HTTP. Cette fonction attend deux arguments supplmentaire: la socket pour les donnes HTTP et le token renvoy par ::http::geturl. Le jeton est le nom d'un tableau global qui est dcrit dans la section TABLEAU D'ETAT. La fonction est cense renvoyer le nombre d'octets lus de la socket. Voici un modle pour le callback:
-
proc httpHandlerCallback {socket token } { -
upvar #0 $token state -
# Accde la socket, et au tableau d'tat Tcl -
... -(exemple: set data [read $socket 1000];set nbytes [string length $data])
.. return nbytes -
} -
-
-headers keyvaluelist -- Cette option est utilise pour ajouter des en-ttes la requte HTTP. L'argument keyvaluelist doit tre une liste avec le mme nombre d'lments alternant entre cls et valeurs. Les cls deviennent les en-tte des champ noms. Les sauts de lignes sont enlevs des valeurs pour que l'en-tte ne puisse tre corrompu. Par exemple, si keyvaluelist est Pragma no-cache alors l'en-tte suivant est inclus dans la requte HTTP:
-Pragma: no-cache -
-
-progress callback -- Le callback est appel aprs chaque transfert de donnes de l'URL. Le callback attend trois arguments additionels: le token de ::http::geturl, la taille totale attendue des meta-donnes contenues dans Content-Length, et le nombre courant d'octets transfrs effectivement. La taille totale attendue peut tre inconnue, auquel cas zro est transmis au callback. Voici un modle pour le callback progress:
-proc httpProgress {token total current} {
- upvar #0 $token state
-} -
-
-query query -- Ce flag fait effectuer ::http::geturl une requte POST qui transmet la query au serveur. La query doit tre une demande formate x-url-encoding La fonction::http::formatQuery peut tre utilise pour le formatage. - -
-queryblocksize size -- La taille de bloc utilise en postant des donnes query l'URL. Au plus size octets sont crits la fois. Aprs chaque bloc, un appel -queryprogress callback est fait (si cette option est spcifie). - -
-querychannel channelID -- Ce flag fait effectuer ::http::geturl une requte POST qui passe les donnes contenues dans channelID au serveur. Les donnes contenue dans channelID doivent tre une demande formate x-url-encoding moins que l'option -type soit utilise. Si un en-tte Content-Length n'est pas spcifi via l'option -headers, ::http::geturl tente de dterminer la taille des donnes post dans l'ordre de cration de l'en-tte. Si elle est incapable de determiner la taille, elle retourne une erreur. - -
-queryprogress callback -- Le callback est faite aprs chaque transfert de donnes URL (ex. POST) et agit exactement comme l'option -progress (le format de callback est le mme). - -
-timeout millisecondes -- Si millisecondes est diffrent de zro, alors ::http::geturl programme un timeout aprs le nombre spcifi de millisecondes. Un timeout provoque un appel de ::http::reset et un callback -command, si spcifi. La valeur de retour de ::http::status est timeout aprs un timeout. - -
-type mime-type- Utilisez mime-type comme la valeur Content-Type, au lieu de de la valeur par dfaut (application/x-www-form-urlencoded) pendant une opration POST. - -
-validate boolean -- Si boolean est diffrent de zro, alors ::http::geturl does un HTTP HEAD requte. Cette requte retourne la meta information concernant l'URL, mais le contenu n'est pas renvoy. La meta information est disponible dans la variable state(meta) aprs la transaction. Voir la section TABLEAU D'ETAT pour les dtails. - -
-
::http::formatQuery key value ?key value ...? -- Cette fonction opre un x-url-encodage des donnes consultes. Elle attend un mme nombre d'arguments qui sont les cls et valeurs de la requte. Elle encode les cls et valeurs, et gnre une chane avec les sparateurs corrects (& et =). Le rsultat est convenable pour la valeur -query transmise ::http::geturl. - -
- ::http::reset token?why?
- - Cette commande rinitialise la transaction HTTP identifie par token, si elle existe. Ceci fixe la valeur state(status) why, qui est par dfaut de reset, et alors appelle le callback declar par -command. - -
::http::wait token -- Ceci est une fonction utilitaire qui bloque et attend que la transaction soit complte. Elle fonctionne seulement avec du code de confiance parcequ'elle utilise vwait. D'autre part, elle n'est pas utile pour les cas o ::http::geturl est appele sans l'option -command parce que dans ce cas l'appel ::http::geturl ne retourne pas jusqu'a ce que la transaction HTTP soit complte, et donc qu'il n'y a rien attendre. - -
::http::data token -- Ceci est une fonction utilitaire qui retourne l'lment body (ex., l'URL donne) du tableau d'tat. - -
::http::error token- Ceci est une fonction utilitaire qui retourne l'lment error du tableau d'tat. - -
::http::status token -- Ceci est une fonction utilitaire qui retourne l'lment status du tableau d'tat. - -
::http::code token -- Ceci est une fonction utilitaire qui retourne l'lment http du tableau d'tat. - -
::http::ncode token- Ceci est une fonction utilitaire qui retourne juste le code numrique de retour (200, 404, etc.) de l'lment http du tableau d'tat. - -
::http::size token -- Ceci est une fonction utilitaire qui retourne l'lment currentsize du tableau d'tat, qui reprsente le nombre d'octets reus de l' URL dans l'appel ::http::geturl. - -
::http::cleanup token -- Cette fonction nettoye l'tat associ la connection identifie par token Aprs cet appel, les fonctions comme ::http::data ne peuvent pas tre utilises pour obtenir l'information concernant l'opration Il est fortement recommand que vous appeliez cette fonction aprs avoir fini avec une requte HTTP Ne pas le faire proquera la non-libration de la mmoire, et si votre appli appelle ::http::geturl plusieurs fois, la fuite mmoire pourrait provoquer un pic de performance...ou bien pire. - -
::http::register proto port command -- Cette fonction permet de fournir des types de transport HTTP tel que HTTPS, en enregistrant un prfixe, le port par dfaut, et la commande excuter pour crer le channel Tcl. Ex.:
-
package require http -
package require tls -
http::register https 443 ::tls::socket -
set token [http::geturl https://my.secure.site/] -
-
::http::unregister proto -- Cette fonction libre un gestionnaire de protocole prcedemment declar via http::register - -
-
-
-
-
ok -- Si la transaction HTTP se termine entirement, alors le statut sera ok. Nanmoins, vous pouvez toujours vrifier la valeur http::code pour obtenir le statut HTTP La fonction http::ncode fournit just l'erreur numrique (ex., 200, 404 ou 500) alors que la fonction http::code retourne une valeur comme "HTTP 404 File not found". - -
eof -- Si le serveur ferme la socket sans rponse, alors aucune erreur n'est leve, mais le statut de la transaction sera eof. - -
error -- Le message d'erreur sera aussi stock dans l'lment error du tableau d'tat, accessible via ::http::error. - -
-
-
-
-
-
body -- Le contenu de l'URL. Sera vide si l'option -channel a t spcifie Cette valeur est renvoyee par la commande::http::data. - -
currentsize -- Le nombre courant d'octets rcupr de l'URL. Cette valeur est renvoye par la commande::http::size. - -
error -- Si dfini, c'est la chane d'erreur vue quand la transaction HTTP est avorte. - -
http -- Le statut de la rponse HTTP du serveur Cette valeur est renvoye par la commande::http::code Le format de cette valeur est:
-
HTTP/1.0 code string -Le code est un nombre de trois-digit dfini dans le standard HTTP. Un code de 200 est OK Les codes commenant avec 4 ou 5 indiquent des erreurs. Les codes commenant avec 3 sont des erreurs de redirection Dans ce cas la meta-donne Location spcifie une nouvelle URL qui contient l'information requise. -
-
meta -- Le protocole HTTP retourne les meta-donnes qui dcrivent les contenus de l'URL. L'lment meta du tableau d'tat est une liste de cls et valeurs des meta-donnes Ceci dans un format utile pour l'initialisation d'un tableau qui contient les meta-donnes:
-array set meta $state(meta)
-Certaines des cls meta-donnes sont listes ci-dessous, mais le standard HTTP en dfinit plus, et les serveurs sont libres d'ajouter les leurs.
-
-
-
Content-Type -- Le type de contenus de l'URL Les exemples inclutnt text/html, image/gif, application/postscript et application/x-tcl. -
Content-Length -- La taille dclare des contenus La taille obtenue par ::http::geturl est disponibles comme state(size). - -
Location -- Une URL alternative qui contient les donnes requises. -
-
posterror -- L'erreur, si elle existe, qui s'est produite pendant l'criture du post des donnes sur le serveur. - -
status -- Soit ok, en cas de succs, reset si rinitialis par l'utilisateur, timeout si un timeout s'est produit avant que la transaction soit complte, ou error pour une condition d'erreur Durant la transaction cette valeur est une chane vide. - -
totalsize -- Un copie de la valeur des meta-donnes Content-Length. - -
type -- Une copie de la valeur des meta-donnes Content-Type. - -
url -- L'URL requise. - -
-
-
-proc ::http::copy { url file {chunk 4096} } {
- set out [open $file w]
- set token [geturl $url -canal $out -progress ::http::Progress \
- -blocksize $chunk]
- close $out
- # Ceci finit la ligne lanc par http::Progress
- puts stderr ""
- upvar #0 $token state
- set max 0
- foreach {name value} $state (meta) {
- if {[string longueur $name] > $max} {
- set max [string longueur $name]
- }
- if {[regexp -nocase ^location$ $name]} {
- # Gre la redirection d'URL
- puts stderr "Location:$value "
- return [copy [string trim $value] $file $chunk]
- }
- }
- incr max
- foreach {name value } $ state (meta) {
- puts [format "%-*s %s" $max $name: $value]
- }
-
- return $token
-}
-proc ::http::Progress {args} {
- puts -nunwline stderr . ; flush stderr
-}
- -
-
-
-
-
- diff --git a/hlp/fr/tcl/if.htm b/hlp/fr/tcl/if.htm deleted file mode 100644 index 5d0770f..0000000 --- a/hlp/fr/tcl/if.htm +++ /dev/null @@ -1,17 +0,0 @@ - -
if Commandes Internes Tcl
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/incr.htm b/hlp/fr/tcl/incr.htm deleted file mode 100644 index 3d86c60..0000000 --- a/hlp/fr/tcl/incr.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
incr Commandes Internes Tcl
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/index.htm b/hlp/fr/tcl/index.htm deleted file mode 100644 index 5ad840e..0000000 --- a/hlp/fr/tcl/index.htm +++ /dev/null @@ -1,41 +0,0 @@ -
Commandes Internes Tcl
-
-Copyright © 1990-1994 The Regents of the University of California -Copyright © 1990-1994 The Regents of the University of California. -Copyright © 1992-1995 Karl Lehenbauer and Mark Diekhans. -Copyright © 1992-1999 Karl Lehenbauer and Mark Diekhans -Copyright © 1993-1997 Bell Labs Innovations for Lucent Technologies -Copyright © 1994-2000 Sun Microsystems, Inc. -Copyright © 1998 Mark Harrison. -Copyright © 1998-1999 Scriptics Corporation -Copyright © 1998-2000 Ajuba Solutions -Copyright © 1998-2000 Ajuba Solutions. -Copyright © 1998-2000 Scriptics Corporation. -Copyright © 2001 Donal K. Fellows -Copyright © 1995-1997 Roger E. Critchlow Jr. -diff --git a/hlp/fr/tcl/info.htm b/hlp/fr/tcl/info.htm deleted file mode 100644 index 860f9f1..0000000 --- a/hlp/fr/tcl/info.htm +++ /dev/null @@ -1,77 +0,0 @@ - -
info Commandes Internes Tcl
-
-
-
-
-
-
-
-
- info args procname
- Renvoie une liste contenant les noms des arguments de la fonction procname, dans l'ordre Procname doit tre le nom d'une fonction de commande Tcl. - -
info body procname -- Renvoie le corps de la fonction procname Procname doit tre le nom d'une fonction Tcl . - -
info cmdcount -- Renvoie un compte du nombre total de commandes qui ont t appeles dans cet interprteur. - -
info commands ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de noms de toutes les commandes Tcl dans le namespace courant, incluant la fois les commandes interne crites en C et les fonction de commandes dfinies en utilisant la commande proc. Si pattern est spcifi, seulement les noms correspondants pattern sont renvoys. A correspondance est dtermine en utilisant les mme rgles que pour string match. pattern peut tre un nom qualifi comme Foo::print*. Ainsi, il peut spcifier un namespace particulier en utilisant une squence de noms de namespace spars par ::, et peut avoir un modle correspondant des caractres spciaux la fin pour spcifier un ensemble de commandes dans ce namespace. Si pattern est un nom qualifi, la liste rsultante de noms de commande a chacun des noms qualifis avec le nom du namespace spcifi . - -
info complete command -- Renvoie 1 si command est une commande complte Tcl dans le sens o elle n'a pas de guillemets, accolades, crochets ou noms lment de tableau non fermants, Si la commande n'apparait pas complte alors 0 est renvoy. Cette commande est typiquement utilise dans les environnements orients ligne de commande pour autoriser les utilisateurs saisir des commandes rparties sur plusieurs lignes; si la commande n'est pas complte, le script peut retarder l'valualuation jusqu'a ce que des lignes supplmentaire ait t saisies pour complter la commande. <
-info default procname arg varname
-Procname doit tre le nom d'une fonction de commande Tcl et arg doit tre le nom d'un argument cette fonction Si arg n'a pas de valeur par dfaut alors la commande retourne 0. Autrement elle retourne 1 et place la valeur par dfaut de arg dans la variable varname. -
-
info exists varName -- Renvoie 1 si le nom de variable varName existe dans le contexte courant (soit comme variable globale ou locale) et a t dfinie en lui donnant une valeur, retourne 0 autrement. - -
info globals ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de tout les noms des variables globales couramment dfinies. Les variables globales sont des variables dans le namespace global . Si pattern est spcifi, seulement les noms correspondants pattern sont renvoys La correspondance est dtermine en utilisant les mme rgles que pour string match. - -
info hostname -- Renvoie le nom de l'ordinateur sur lequel cet appel est excut. - -
info level ?number? -- Si number n'est pas spcifi, cette commande retourne un nombre donnant le niveau dans la pile de la fonction appele, ou 0 si la commande est appele au premier plan Si number est spcifi, alors le rsultat est une liste consistant des noms et arguments de la fonction appelle au niveau number sur la pile Si number est positif alors il dsigne un niveau de pile particulier (1 se rfre la fonction active, 2 la fonction qu'elle a appel, et ainsi de suite); autrement cela donne un niveau relatif au niveau courant (0.htm se rfre la fonction courante, -1.htm l'appelant, et ainsi de suite). Voir la commande uplevel pour plus d'information sur la signification des niveaux de pile d'appel. - -
info library -- Renvoie le nom du rpertoire bibliothque dans lequel les scripts Tcl standards sont stocks. Ceci est actuellement la valeur de la variable tcl_library et peut tre chang en fixant tcl_library. Voir la page de manuel tclvars pour plus d'information. - -
info loaded ?interp?- Renvoie une liste dcrivant tous les packages qui ont t chargs dans interp avec la commande load. Chaque lment de la liste est une sous-liste de deux lments consistant du nom du fichier duquel le package a t charg et du nom du package. Pour les packages statiquement chargs le nom de chemin sera une chane vide. Si interp est omis alors il'nformation est renvoye pour tout packages charg dans tout interprteur du processus. Pour obtenir une liste des packages dans le courant interprteur, Spcifiez une chane vide pour l'argument interp. - -
info locals ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de tout les noms des variables locales couramment-dfinies, incluant les arguments la fonction courante, s'ils existent. Les variables dfinies avec les commandes global et upvar ne seront pas renvoyes. Si pattern est spcifi, seulement les noms correspondants pattern sont renvoys La correspondance est dtermine en utilisant les mme rgles que pour string match. - -
info nameofexecutable -- Renvoie le nom de chemin complet du fichier binaire duquel l'application a t appele. Si Tcl a t incapable d'identifier le fichier, alors une chane vide est renvoye. - -
info patchlevel -- Renvoie la valeur de la variable globale tcl_patchLevel; voyez la page de manuel tclvars pour plus d'information. - -
info procs ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de tout les noms des fonctions Tcl dans le namespace courant. Si pattern est spcifi, seulement les noms de fonction dans le namespace courant correspondants pattern sont renvoys. La correspondance est dtermin en utilisant les mme rgles que pour string match. - -
info script -- Si un fichier script Tcl est couramment valu (ex. il y a un appel actif de Tcl_EvalFile ou il y a un appel actif de la commande source), alors cette commande retourne le nom du fichier trait Autrement la commande retourne une chane vide. - -
info sharedlibextension -- Renvoie l'extension utilise sur cette plateforme pour les noms des fichiers contenant des librairies partages (par exemple, .so sous Solaris). Si les librairies partages ne sont pas supportes sur cette plateforme alors une chane vide est renvoye. - -
info tclversion -- Renvoie la valeur de la variable globale tcl_version; voyez la page de manuel tclvars pour plus d'information. -
info vars ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de tout les noms des variables (locales et globales incluses)couramment visibles. Si pattern est spcifi, seuls les noms correspondants pattern sont renvoys. La correspondance est dtermine en utilisant les mme rgles que pour string match. pattern peut tre un nom qualifi comme Foo::option*. Ainsi, il peut spcifier un namespace particulier en utilisant une squence de noms de namespace spars par ::, et peut avoir modle correspondant des caractres spciaux la fin pour spcifier un ensemble de variables dans ce namespace. Si pattern est un nom qualifi, la liste rsultante de noms de variable contient chaque variable namespace correspondante qualifie avec le nom de son namespace - -
-
-
- diff --git a/hlp/fr/tcl/interp.htm b/hlp/fr/tcl/interp.htm deleted file mode 100644 index f6efedc..0000000 --- a/hlp/fr/tcl/interp.htm +++ /dev/null @@ -1,432 +0,0 @@ - -
interp Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
-
interp alias srcPath srcCmd -- Renvoie une liste Tcl dont les lments sont les targetCmd et args associs l'alias nomm srcCmd (ce sont toutes les valeurs spcifies quand l'alias a t cr; il est possible que la commande source actuelle dans l'esclave soit diffrente de srcCmd si elle a t renomme). - -
interp alias srcPath srcCmd {} -- Efface l'alias de srcCmd dans l'interprteur esclave identifi par srcPath. srcCmd se rfre au nom sous lequel l'alias a t cr si la commande source a t renomme, la commande renomme sera efface. - -
interp alias srcPath srcCmd targetPath targetCmd ?arg arg ...? -- Cette commande cre un alias entre un esclave et un autre (voyez la commande alias esclave ci-dessous pour la cration d'alias entre un esclave et son matre) Dans cette commande, chacun des interprteurs esclave peut tre n'importe o dans la hirarchie des interprteurs sous l'interprteur qui appelle la commande. SrcPath et srcCmd identifient le source de l'alias. SrcPath est une liste Tcl dont les lments dsignent un interprteur particulier Par exemple, "a b" identifie un interprteur b, qui est une esclave de l'interprteur a, qui est un esclave de l'interprteur appelant Une liste vide spcifie l'interprteur appelant la commande srcCmd donne le nom d'une nouvelle commande, qui sera cre dans l'interprteur source. TargetPath et targetCmd spcifient une cible interprteur et commande, et l'arguments arg, s'il existe, Spcifie les arguments supplmentaires targetCmd qui sont ajouts tout argument spcifi dans l'appel de srcCmd. TargetCmd peut tre indfini l'instant de cet appel, ou il peut existe djr; il n'est pas cr par cette commande. L'alias prpare la commande cible tre appele dans l'interprteur cible chaque fois que la commande source est appele dans l'interprteur source Voir APPEL D'ALIAS ci-dessous pour plus de dtails. - -
interp aliases ?path? -- Cette commande retourne une liste Tcl de noms de toutes les commandes source des alias dfinis dans l'interprteur identifi par path.
-interp create ?-safe? ?--? ?path?
-Cre un interprteur esclave identifi par path et une nouvelle commande, appel une slave command. Le nom de la commande esclave est le dernier composant de path. Le nouvel interprteur esclave et la commande esclave sont cre dans l'interprteur identifi par le chemin obtenu en enlevant le dernier composant de path. Par exemple, si path est a bc alors un nouvel interprteur et commande esclave nomms c sont crs dans l'interprteur identifi par les chemin a b. La commande esclave peut tre employe pour manipuler le nouvel interprteur comme dcrit ci-dessous. Si path est omis, Tcl cre un nom unique de la forme interpx, o x est un entier, et l'utilise pour l'interprteur et la commande esclave. Si le switch -safe est spcifi (ou si le matre interprteur est un interprteur sr), le nouvel interprteur esclave sera cr comme un interprteur sr avec des fonctionalit limites; autrement l'esclave inclutra le jeu complet des commandes et variables Tcl internes. Le -- switch peut tre utilis pour marquer la fin des commutateurs; il peut tre ncessaires si path est une valeur inhabituelle telle que -safe. Le rsultat de la commande est le nom du nouvel interprteur. Le nom d'un interprteur esclave doit tre unique parmi tout les esclaves; une erreur se produit si le nom d'un interprteur esclave existe dj pour ce matre. -
-
interp delete ?path ...? -- Efface zro ou plus interprteurs donns par les arguments optionnels path, et pour chaque interprteur, efface aussi ses esclaves. La commande efface aussi la commande esclave de chaque interprteur effac. Pour chaque argument path, si aucun interprteur de ce nom existe, la commande lve une erreur. - -
interp eval path arg ?arg ...? -- Cette commande concatne tous les arguments arg de la mme faon que la commande concat, et value alors la chane rsultante comme script Tcl dans l'interprteur esclave identifi par path. Le rsultat de cette evaluation (incluant l'information d'erreur telle que les variables errorInfo et errorCode, si une erreur se produit) est renvoy l'interprteur appelant . - -
interp exists path- Renvoie 1 si un interprteur esclave du path spcifi existe dans ce matre, 0 autrement. Si path est omis, l'interprteur appelant est utilis. - -
interp expose path hiddenName ?exposedCmdName? -- Rend la commande cache hiddenName visible, en lui donnant ventuellement un nouveau nom exposedCmdName (ce nom est couramment accept seulement si c'est un nom global valide sans quelconque ::), dans l'interprteur dsign par path. Si une commande visible avec le nom cible existe dj, cette commande choue. Les commandes caches sont expliques plus en dtail dans COMMANDES CACHEES , ci-dessous. - -
interp hide path exposedCmdName ?hiddenCmdName? -- Cache la commande visible exposedCmdName, en la renommant en commande cache hiddenCmdName, ou conservant le mme nom si hiddenCmdName n'est pas donn, dans l'interprteur dsign par path. Si une commande cache avec le nom cibl existe dj, cette commande choue. exposedCmdName et hiddenCmdNamene peuvent pas contenir en mme temps de qualificateurs namespace, ou une erreur est leve. Les commandes cacher par interp hide sont recherches dans le namespace global mme si le namespace courant n'est pas le global. Ceci empche les esclaves d'abuser un matre interprteur en cachant les mauvaises commandes, en rendant le namespace courant diffrent du global. Les commandes caches sont expliques plus en dtail dans COMMANDES CACHEES , ci-dessous. - -
interp hidden path -- Renvoie une liste des noms de toutes les commandes caches dans l'interprteur identifi par path. - -
interp invokehidden path ?-global? hiddenCmdName ?arg ...? -- Appelle la commande cache hiddenCmdName avec les arguments fournis dans l'interprteur dsign par path. Aucune substitution ou valuation ne sont appliques aux arguments. Si le flag -global est prsent, la commande cache est appele au niveau global dans l'interprteur cible; autrement elle est appele dans le cadre d'appel courant et peut acceder aux variables locales dans ce cadre et appeler des cadres externes. Les commandes caches sont expliques plus en dtail dans COMMANDES CACHEES , ci-dessous. - -
interp issafe ?path? -- Renvoie 1 si l'interprteur identifi par le path spcifi est sr, 0 autrement. - -
interp marktrusted path -- Marque l'interprteur identifi par path comme fiable. Ne montre pas les commande caches. Cette commande peut seulement tre appele partir d'un interprteur de confiance. La commande n'a pas d'effet si l'interprteur identifi par path est dj fiable. - -
interp share srcPath channelId destPath -- Met en place le partage du canal IO identifi par channelId entre l'interprteur identifi par srcPath et l'interprteur identifi par destPath. Les deux interprteurs ont les mme permissions sur le canal IO. Les deux interprteurs doivent le fermer pour fermer le IO canal sous-jacent; les canaux IO accessibles dans un interprteur sont automatiquement ferms quand un interprteur est dtruit. - -
interp slaves ?path? -- Renvoie une liste Tcl des noms de tous les interprteurs esclaves associs l'interprteur identifi par path. Si path est omis, l'interprteur appelant est utilis. - -
interp target path alias -- Renvoie une liste Tcl dcrivant l'interprteur cible d'un alias. L'alias est spcifi avec un chemin d'interprteur et le nom de la commande source, juste comme dans interp alias plus haut. Le nom de l'interprteur cible est renvoy comme un chemin d'interprteur, relatif l'interprteur appelant . Si l'interprteur cible de l'alias est l'interprteur appelant alors une liste vide est renvoye. Si l'interprteur cible de l'alias n'est pas l'interprteur appelant ou un de ses descendants alors une erreur est gnre. La commande cible n'a pas a tre dfinie l'instant de cet appel. - -
interp transfer srcPath channelId destPath -- Rends le canal IO identifi par channelId disponible dans l'interprteur identifi par destPath et indisponible dans l'interprteur identifi par srcPath - -
-
-
-
-
slave aliases -- Renvoie une liste Tcl dont les lments sont les noms de tous les alias dans slave Les noms renvoys sont les valeurs srcCmd utilises quand les alias ont t crs (qui ne peuvent pas tre les mme que les noms des commandes courantes, si elles ont t renommes). - -
slave alias srcCmd -- Renvoie une liste Tcl dont les lments sont les targetCmd et args associs l'alias nomm srcCmd (toutes sont les valeurs spcifies quand l'alias a t cre; il est possible que la commande source actuelle dans l'esclave soit diffrente de srcCmd si elle a t renomme). - -
slave alias srcCmd {} -- Efface l'alias de srcCmd dans l'interprteur esclave. srcCmd se rfre au nom sous lequel l'alias a t cr si la commande source a t renomme, la commande renomme sera effac. - -
slave alias srcCmd targetCmd ?arg ..? -- Cre un alias tel que chaque fois que srcCmd est appele dans slave, targetCmd est appele dans le matre. Les arguments arg seront transmis targetCmd comme arguments supplmentaires, ajouts avant tout argument transmis dans l'appel de srcCmd. Voir APPEL D'ALIAS ci-dessous pour les dtails. - -
slave eval arg ?arg ..?- Cette commande concatne tous les arguments arg de la mme faon que la commande concat, et value la chane rsultante comme un script Tcl dans slave. Le rsultat de cette valuation (incluant information erreur telle que les variables errorInfo et errorCode, si une erreur se produit) est renvoy l'interprteur appelant . - -
slave expose hiddenName ?exposedCmdName? -- Cette commande expose la commande cachehiddenName, lui donnant ventuellement un nouveau nom exposedCmdName (ce nom est couramment accept seulement si c'est une nom global valide sans quelconque ::), dans slave. Si une commande visible avec le nom cibl existe dj, cette commande choue. Pour plus details sur les commande caches, voir COMMANDES CACHEES , ci-dessous. - -
slave hide exposedCmdName ?hiddenCmdName? -- Cette commande cache la commande visible exposedCmdName, en la renommant en la commande cache hiddenCmdName, ou gardant le mme nom si l'argument n'est pas donn, dans l'interprteur slave. Si une commande cache avec le nom cibl existe dj, cette commande choue. Autant exposedCmdName que hiddenCmdName ne peuvent contenir de qualificateurs namespace, ou une erreur est leve. Les commandes a cacher sont recherche dans le namespace global mme si le namespace courant n'est pas le global un . Ceci empche les esclaves d'abuser un matre interprteur en cachant les mauvaises commandes, en rendant le namespace courant diffrent du global. Pour plus details sur les commande caches, voir COMMANDES CACHEES , ci-dessous. - -
slave hidden- Renvoie une liste des noms de toutes les commande caches dans slave.
-slave invokehidden ?-global hiddenName ?arg ..?
-Cette commande appelle la commande cache hiddenName avec les arguments fournis, dans slave. Aucune substitutions ou valuations ne sont appliques aux arguments. Si le flag -global est donn, la commande est appele au niveau global dans l'esclave; autrement elle est appele dans le cadre d'appel courant et peut acceder ses variables locales ou appeler des cadres externes. Pour plus details sur les commande caches, voir COMMANDES CACHEES , ci-dessous. -
-
slave issafe -- Renvoie 1 si l'interprteur esclave est sr, 0 autrement. -
slave marktrusted -- Marque l'interprteur esclave comme fiable. Peut seulement tre appele par un interprteur de confiance. Cette commande ne rend visible aucune commande cache dans l'interprteur esclave. La commande n'a pas d'effet si l'esclave est dj fiable
-
-
-
-
-
| - after - | -- append - | -- array - | -- binary - | -
| - break - | -- case - | -- catch - | -- clock - | -
| - close - | -- concat - | -- continue - | -- eof - | -
| - error - | -- eval - | -- expr - | -- fblocked - | -
| - fcopy - | -- fileevent - | -- flush - | -- for - | -
| - foreach - | -- format - | -- gets - | -- global - | -
| - history - | -- if - | -- incr - | -- info - | -
| - interp - | -- join - | -- lappend - | -- lindex - | -
| - linsert - | -- list - | -- llength - | -- lrange - | -
| - lreplace - | -- lsearch - | -- lsort - | -- namespace - | -
| - package - | -- pid - | -- proc - | -- puts - | -
| - read - | -- regexp - | -- regsub - | -- rename - | -
| - return - | -- scan - | -- seek - | -- set - | -
| - split - | -- string - | -- subst - | -- switch - | -
| - tell - | -- trace - | -- unset - | -- update - | -
| - uplevel - | -- upvar - | -- variable - | -- vwait - | -
| - while - | -- - | -- - | -- - | -
-
-
| - cd - | -- exec - | -- exit - | -- fconfigure - | -
| - file - | -- glob - | -- load - | -- open - | -
| - pwd - | -- socket - | -- source - | -- vwait - | -
- -
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/join.htm b/hlp/fr/tcl/join.htm deleted file mode 100644 index 0e20cb4..0000000 --- a/hlp/fr/tcl/join.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
join Commandes Internes Tcl
- -
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/lappend.htm b/hlp/fr/tcl/lappend.htm deleted file mode 100644 index f4d1a8e..0000000 --- a/hlp/fr/tcl/lappend.htm +++ /dev/null @@ -1,17 +0,0 @@ - -
lappend Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/library.htm b/hlp/fr/tcl/library.htm deleted file mode 100644 index bc0a663..0000000 --- a/hlp/fr/tcl/library.htm +++ /dev/null @@ -1,119 +0,0 @@ - -
library Commandes Internes Tcl
-
-
-
-
-auto_import pattern
-auto_load cmd
-auto_mkindex dir pattern pattern ...
-auto_mkindex_old dir pattern pattern ...
-auto_qualify command namespace
-auto_reset
-tcl_findLibrary basename version patch initScript enVarName varName
-parray arrayName
-tcl_endOfWord str start
-tcl_startOfNextWord str start
-tcl_startOfPreviousWord str start
-tcl_wordBreakAfter str start
-tcl_wordBreakBefore str start
- -
-
-
-
-
-
-
- auto_execok cmd
- Dtermine si cmd est un fichier excutable ou une commande interne. Si c'est le cas, elle retourne une liste d'arguments transmettre exec pour excuter le fichier excutable ou la commande interne dsigne par cmd. Sinon, elle retourne une chane vide. Cette commande examine les rpertoires dans le chemin de recherche courant (donns par la variable d'environnement PATH) dans sa recherche d'un fichier excutable nomm cmd. Sur les plateformes Windows, la recherche est tndue avec les mmes rpertoires et extensions de fichier utiliss par exec. Auto_exec conserve l'information au sujet des recherches prcedentes dans un tableau nomm auto_execs; ceci vite la recherche du chemin dans les appels suivants pour la mme cmd. La commande auto_reset peut tre employe pour forcer auto_execok vider son cache. - -
auto_import pattern- Auto_import est appele pendant namespace import pour voir si les commandes importes spcifies par pattern rsident dans une bibliothque auto-charge. Si vrai, les commandes sont charges, ainsi elles seront disponibles dans l'interprteur pour la cration des liens d'import. Si les commandes ne rsident pas dans une bibliothque auto-charge, auto_import ne fait rien. - -
auto_load cmd- Cette commande tente de charger la dfinition d'une commande Tcl nomme cmd. Pour ceci elle recherche un auto-load path, qui est une liste d'un ou plusieurs rpertoires. Le chemin auto-load est donns par la variable globale $auto_path si elle existe. S'il n'y a pas de variable $auto_path, alors la variable d'environnement TCLLIBPATH est utilise, si elle existe. Autrement le chemin auto-load contient juste le rpertoire de la bibliothque Tcl. A l'intrieur de chaque rpertoire dans le chemin auto-load il doit y avoir un fichier tclIndex qui dcrit une ou plusieurs commandes dfinies dans ce rpertoire et un script valuer pour charger chacune des commandes. Le fichier tclIndex sera gnr avec la commande auto_mkindex Si cmd est trouv dans un fichier index, alors le script appropri est valu pour crer la commande. La commande auto_load retourne 1 si cmd est cre avec succs. La commande retourne 0 si il n'y a pas d'entre index pour cmd ou si le script ne definit actuellement pas cmd (ex. parce que l'information d'index est prime). Si une erreur se produit pendant le traitement du script, alors cette erreur est renvoye. Auto_load lit seulement l'information d'index une fois et la sauvegarde dans le tableau auto_index les appels suivants auto_load recherchent cmd dans le tableau plutt que de relire les fichiers d'index. L'information d'index mise en cache peut tre efface avec la commande auto_reset. Ceci forcera la commande auto_load suivante recharger la base de donnes d'index partir du disque. - -
auto_mkindex dir pattern pattern ...- Gnre un index utilisable par auto_load. La commande recherche dir pour tout fichiers dont les noms correspondent un des arguments pattern (la correspondance est tablie avec la commande glob), gnre un index de toutes les fonctions de commande Tcl dfinies dans tout les fichiers correspondants, et stocke l'information d'index dans un fichier nomm tclIndex dans dir. Si aucun modle n'est prcis, un modle de *.tcl sera suppos. Par exemple, la commande
-
auto_mkindex foo *.tcl -
lira tout les fichiers.tcl dans le sous-rpertoire foo et gnrera un nouveau fichier d'index foo/tclIndex. -
Auto_mkindex analyse les scripts Tcl en les "sourcant" dans un interprteur esclave et en interceptant les commandes proc et namespace qui sont excutes Des extensions peuvent utiliser le package (non document) auto_mkindex_parser pour dclarer d'autres commandes qui peuvent collaborer avec auto_load index. Vous pourrez parcourir auto.tcl pour voir comment cela fonctionne. -
Auto_mkindex_old analyse les scripts Tcl d'une manire relativement rustique s'il existe une ligne qui contient le mot proc en premiers caractres alors c'est suppos tre une dfinition de fonction et le mot suivant de la ligne est interprt comme le nom de la fonction. Les dfinitions de fonction qui n'apparaissent de cette manire (ex. elles ont des espaces avant proc) ne seront pas indexes. Si votre script contient du code "dangereux", tel que du code d'initialisation globale ou des noms de fonction avec des caractres spciaux comme $, *, [ ou ], il sera plus sur d'utiliser auto_mkindex_old. -
-
auto_reset- Dtruit toute l'information mise en cache par auto_execok et auto_load. Cette information sera relue partir du disque la prochaine fois que c'est ncessaire. Auto_reset efface aussi toutes fonctions listes dans l'index auto_load, ainsi une copie rcente sera charge la fois suivante qu'elles seront utilises. - -
auto_qualify command namespace -- Calcule une liste de noms pleinement qualifis pour command. Cette liste reflte le chemin qu'un interprteur standard Tcl suit pour la recherche de commande: d'abord il cherche la commande dans le namespace courant, et ensuite dans le namespace global. Conformment, si command est relatif et que namespace n'est pas ::, la liste renvoye a deux lments command visible par namespace, comme si c'tait une commande dans le namespace namespace; et command comme si c'tait une commande dans le namespace global. Autrement, si command est absolue (elle commence par ::), ou bien que namespace est ::, la liste contient seulement command comme si c'etait une commande dans le namespace global.
-
Auto_qualify est utilis par les auto-loading facilits en Tcl, autant pour produire des index auto-loading tel que pkgIndex.tcl, que pour effectuer l'auto-loading des fonctions l'excution. -
-
tcl_findLibrary basename version patch initScript enVarName varName -- Ceci est une fonction de recherche standard utiliser par les extensions pendant leur initialisation. Elles appellent cette fonction pour rechercher leur bibliothque de scripts dans plusieurs rpertoires standard. Le dernier composant du nom de rpertoire de la bibliothque est normalement basenameversion (ex., tk8.0), mais il pourra tre "library" quand il est situ dans les hirarchies de construction. Le fichier initScript sera "sourc" dans l'interprteur une fois qu'il est trouv. Le rpertoire dans lequel ce fichier est trouv est stock dans la variable globale varName. Si cette variable est dj dfinie (ex., par du code C pendant l'initialisation de l'application) alors aucune recherche n'est effectue. Autrement la recherche se fait dans ces rpertoires: le rpertoire nomm par la variable d'environnement enVarName; relatif au rpertoire bibliothque Tcl; relatif au fichier excutable dans l'installation standard (rpertoire bin ou bin/arch); relatif au fichier excutable dans l'arbre de construction courant; relatif au fichier excutable dans un arbre de construction parallle. - - -
parray arrayName -- Affiche sur la sortie standard les noms et valeurs de tous les lments dans le tableau arrayName. ArrayName doit tre un tableau accessible l'appelant de parray. Il peut tre soit local ou global. - -
tcl_endOfWord str start -- Renvoie l'index du premier emplacement de fin-de-mot qui se trouve aprs un index de dpart start dans la chane str. Un emplacement de fin-de-mot est dfini pour tre le premier caractre non-mot suivant le premier caractre mot aprs le point de dpart. Renvoie -1 si il n'y a plus d'emplacement fin-de-mot aprs le point de dpart. Voir la description de tcl_wordchars et tcl_nonwordchars ci-dessous pour plus de dtails sur comment Tcl dtermine quels caractres sont des caractre mots. - -
tcl_startOfNextWord str start -- Renvoie l' index du premier emplacement dbut-de-mot qui se trouve aprs un index de dpart start dans la chane str. Un emplacement dbut-de-mot est dfini pour tre le premier caractre mot suivant un caractre non-mot. Renvoie -1 si il n'y a plus d'emplacement de dbut-de-mot aprs le point de dpart. - -
tcl_startOfPreviousWord str start -- Renvoie l'index du premier emplacement dbut-de-mot qui se trouve avant un index de dpart start dans la chane str. Renvoie -1 si il n'y a plus d'emplacement de dbut-de-mot aprs le point de dpart. - -
tcl_wordBreakAfter str start -- Renvoie l'index de la premire limite de mot aprs l'index de dpart start dans la chane str. Renvoie -1 si il n'y a pas de plus limites aprs le point de dpart dans la chane donne L'index renvoy se rfre au second caractre de la paire qui comporte une limite. - -
tcl_wordBreakBefore str start -- Renvoie l'index de la premire limite de mot avant l'index de dpart start dans la chane str Renvoie -1 si il n'y a pas de plus limites avant le point de dpart dans la chane donne. L'index renvoy se rfre au second caractre de la paire qui comporte une limite. - -
-
-
-
-
- auto_execs -
- Utilise par auto_execok pour enregistrer si des commandes particulires existent comme fichiers excutables. - -
auto_index -- Utilise par auto_load pour sauvegarder l'information index lue partir du disque. - -
auto_noexec -- Si fixe une quelconque valeur, alors unknown ne tentera pas " d'auto-exec " quelconques commandes. - -
auto_noload -- Si fixe une quelconque valeur, alors unknown ne tentera pas " d'auto-load " quelconque commandes. - -
auto_path -- Si fixe, alors doit contenir une liste Tcl valide indiquant les rpertoires rechercher pendant les oprations auto-load. Cette variable est initialise au dmarrage pour contenir, dans l'ordre: les rpertoires lists dans la variable d'environnement TCLLIBPATH, le rpertoire nomm par la variable $tcl_library, le rpertoire parent de $tcl_ library, les rpertoires lists dans la variable $tcl_pkgPath. - -
env(TCL_LIBRARY) -- Si fixe, alors spcifie l'emplacement du rpertoire contenant la bibliothque des scripts (la valeur de cette variable sera assigns tcl_library variable et therefore renvoy par la commande info library). Si cette variable n'est pas fixe alors une valeur par dfaut est utilise. - -
env(TCLLIBPATH) -- Si fixe, alors doit contenir une liste Tcl valide donnant les rpertoires rechercher pendant les oprations auto-load. Les rpertoires doivent tre spcifis en format Tcl , en utilisant "/" comme sparateur de chemin, indpendemment de la plateforme. Cette variable est seulement utilise l'initialisation de la variable auto_path . - -
tcl_nonwordchars -- Cette variable contient une expression rationelle qui est utilis par les routines comme tcl_endOfWord pour identifier si un caractre fait partie d'un mot ou non. Si le modle correspond un caractre, le caractre est consider comme caractre non-mot. Sur les plateformes Windows, les espaces, tabulations, et saut de lignes sont considers comme caractres non-mots. Sous Unix, tout sauf les chiffres, lettres et underscores sont considers comme caractre non-mots. - -
tcl_wordchars -- Cette variable contient une expression rationelle qui est utilise par les routines comme tcl_endOfWord pour identifier si un caractre fait partie d'un mot ou non. Si le modle correspond un caractre, le caractre est consider comme caractre d'un mot. Sur les plateformes Windows,les mots comportent tout caractre qui n'est pas un espace, une tabulation, ou une nouvelle ligne. Sous Unix, les mots comportent des chiffres, lettres ou underscores. - -
unknown_pending -- Utilise par unknown pour enregistrer la commande(s) recherche. Elle est utilise pour detecter les erreurs o unknown s'appelle rcursivement dans une boucle infinie. La variable est dtruite avant que unknown retourne. - -
-
-
-
-
- diff --git a/hlp/fr/tcl/lindex.htm b/hlp/fr/tcl/lindex.htm deleted file mode 100644 index 1f78c0d..0000000 --- a/hlp/fr/tcl/lindex.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
lindex Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/linsert.htm b/hlp/fr/tcl/linsert.htm deleted file mode 100644 index e51cf7c..0000000 --- a/hlp/fr/tcl/linsert.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
linsert Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/list.htm b/hlp/fr/tcl/list.htm deleted file mode 100644 index 0a3e692..0000000 --- a/hlp/fr/tcl/list.htm +++ /dev/null @@ -1,23 +0,0 @@ - -
list Commandes Internes Tcl
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/llength.htm b/hlp/fr/tcl/llength.htm deleted file mode 100644 index 2243e57..0000000 --- a/hlp/fr/tcl/llength.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
llength Commandes Internes Tcl
- -
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/load.htm b/hlp/fr/tcl/load.htm deleted file mode 100644 index c6ec258..0000000 --- a/hlp/fr/tcl/load.htm +++ /dev/null @@ -1,43 +0,0 @@ - -
load Commandes Internes Tcl
-
-
-
-
-load fileName packageName
-load fileName packageName interp -
-
-
-
-
-
-
- Windows
- Quand un load choue avec une erreur "library not found", il est aussi possible qu'une n'ait t trouve Pour voir les bibliothque dpendante, tapez "dumpbin -imports <dllname>" dans une console DOS pour voir les import de la bibliothque. Quand vous chargez une DLL dans le rpertoire courant, Windows ignorera "./" comme spcificateur de chemin et utilisera une recherche heuristique pour trouver la DLL. Pour viter cela, chargez la DLL avec
-
load [file join [pwd] mylib.DLL] -
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/lrange.htm b/hlp/fr/tcl/lrange.htm deleted file mode 100644 index 8e4e731..0000000 --- a/hlp/fr/tcl/lrange.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
lrange Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/lreplace.htm b/hlp/fr/tcl/lreplace.htm deleted file mode 100644 index 7fd99f1..0000000 --- a/hlp/fr/tcl/lreplace.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
lreplace Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/lsearch.htm b/hlp/fr/tcl/lsearch.htm deleted file mode 100644 index ba3f34d..0000000 --- a/hlp/fr/tcl/lsearch.htm +++ /dev/null @@ -1,28 +0,0 @@ - -
lsearch Commandes Internes Tcl
-
-
-
-
-
-
-
- -exact
- L'lment de la liste doit contenir exactement la mme chane que pattern. - -
-glob- Pattern est un modle glob-style qui est compar chaque lment de liste en utilisant les mme rgles que la commande string match . - -
-regexp- Pattern est trait comme un expression rationelle et compar chaque lment de laliste en utilisant les rgles dcrites dans la page de rfrence re_syntax. - -
-
-
-
- diff --git a/hlp/fr/tcl/lsort.htm b/hlp/fr/tcl/lsort.htm deleted file mode 100644 index c574e3e..0000000 --- a/hlp/fr/tcl/lsort.htm +++ /dev/null @@ -1,47 +0,0 @@ - -
lsort Commandes Internes Tcl
-
-
-
-
-
-
-
-
- -ascii
- Utilise comparaison de chane avec tri ASCII. Par dfaut. - -
-dictionary- Utilise une comparaison dictionary-style. Identique -ascii except que (a) la casse est ignore sauf pour diffrencier et que (b) si deux chanes contiennent des nombres, les nombres sont compars comme des entiers, pas des caractres Par exemple, en mode -dictionary, bigBoy est entre bigbang et bigboy, et x10y entre x9y et x11y. - -
-integer- Convertit les lments de la liste en entiers et utilise la comparaison entire. - -
-real- Convertit les lments de la liste en valeurs flottantes et utilise la comparaison flottante. - -
-command command -- Utilise command comme commande de comparaison. Pour comparer deux lments, value un script Tcl consistant de command avec les deux lments ajouts comme arguments supplmentaires. Le script renverra un entier infrieur , gal , ou suprieur zro si le premier lment est consider infrieur , gal , ou suprieur au second, respectivement. - -
-increasing -- Trie la liste en ordre croissant ("plus petit" articles en premier). Par dfaut. - -
-decreasing -- Trie la liste en ordre dcroissant ("plus grand " articles en premier). - -
-index index -- Si cette option est spcifie, chacun des lments de list doit lui-mme tre une sous liste Tcl correcte. Au lieu de tris bass sur des sous listes compltes, lsort extrait l'index'ime lment de chaque sous liste et trie en se basant sur l'lment indiqu. Le mot-cl end est autoris pour l'index trier sur le dernier lment de la sous-liste. Par exemple,
-
lsort -integer -index 1 {{First 24} {Second 18} {Third 30}} -
retourne {Second 18} {First 24} {Third 30}. -
Cette option est beaucoup plus efficace que l'utilisation de -command pour atteindre le mme but. -
-
-unique
-uniqueSi cette option est spcifie, alors seulement le dernier jeu d'lments dupliqus trouv dans la liste sera retenu. Notez que les doublons sont dtermins relativement la comparaison utilise dans le tri. Ainsi si -index 0 est utilis, {1 a} et {1 b} seront considers dupliqus et seulement le second lment, {1 b}, sera retenu.
-
-
-
- diff --git a/hlp/fr/tcl/memory.htm b/hlp/fr/tcl/memory.htm deleted file mode 100644 index 3bf1eeb..0000000 --- a/hlp/fr/tcl/memory.htm +++ /dev/null @@ -1,43 +0,0 @@ - -
memory Commandes Internes Tcl
-
-
-
-
-
-
-
-
- memory info -
- Produit un rapport contenant le total allou et libre les blocs allous depuis que Tcl t lanc(le nombre courant d'appels ckalloc auquel ne correspond pas un appel ckfree), les octets courant allous, et le nombre maximum de blocs et d'octets allous. - -
memory trace [on|off] -- Active/dsactive le traage mmoire Quand le traage mmoire est activ, tout appel de ckalloc cause l'criture d'une ligne de trace vers stderr, consistant du mot ckalloc, suivi par l'adresse renvoye, le total de mmoire alloue, et le nom de fichier C et numro de ligne de le code qui a effectu l'allocation Par exemple:
-
ckalloc 40e478 98 tclProc.c 1406 -
Les appels ckfree sont tracs de la mme manire. -
-
memory validate [on|off] -- Active/dsactive la validation mmoire. Quand la validation mmoire est active, tout appel de ckalloc ou ckfree, les zone gardes sont vrifies pour toute pice de mmoire couramment existante qui a t alloue par ckalloc. Ceci a un grand impact sur la performance et doit seulement tre utilis quand des problmes d'crasement sont srieusement suspects. L'avantage d'activer la validation mmoire est qu'une zone garde crase peut tre dtecte au premier appel de ckalloc ou ckfree suivant l'crasement, plutt que quand la mmoire spcifique avec la zone garde(s) ecrase(s) est libre, ce qui peut arriver longtemps aprs l'crasement. - -
memory trace_on_at_malloc count -- Active le traage mmoire aprs count ckalloc aient t effectus. Par exemple, si vous tapez memory trace_on_at_malloc 100, aprs le 100me appel de ckalloc, l'information de trace mmoire sera affiche pour toute allocations et libration. Comme il peut y avoir une grande activit mmoire avant qu'un problme se produise, un usage judicieux de cette option peut reduire le ralentissement caus par le traage (et le volume de trace produit), si vous pouvez identifier un nombre d'allocations effectues avant le problme. Le nombre courant d'allocations mmoire qui se sont produites depuis que Tcl a t lanc est crit dans une zone prserve des echecs. - -
memory break_on_malloc count -- Aprs que count allocations aient t effectues, ckalloc emet un message cet effet et qui signale galement qu'il tente de lancer le debugger C Tcl emet alors un signal SIGINT vers lui-mme. Si vous excutez Tcl sous un debugger C, le debugger doit alors entrer en mode commande. - -
memory display file -- Ecrit une liste de toute la mmoire couramment alloue dans le fichier spcifi - -
-
-
-
-
- diff --git a/hlp/fr/tcl/msgcat.htm b/hlp/fr/tcl/msgcat.htm deleted file mode 100644 index 6c5f438..0000000 --- a/hlp/fr/tcl/msgcat.htm +++ /dev/null @@ -1,117 +0,0 @@ -
msgcat Commandes Internes Tcl
-
-
-
-
-::msgcat::mclocale ?newLocale?
-::msgcat::mcpreferences
-::msgcat::mcload dirname
-::msgcat::mcset locale src-string ?translate-string?
-::msgcat::mcunknown locale src-string -
-
-
-
-
-
-
- ::msgcat::mc src-string ?arg arg ...? -
- Renvoie une traduction de src-string en accord avec la locale de l'utilisateur courant. Si des arguments supplmentaire aprs src-string sont donns, la commande format est utilise pour substituer les arguments supplmentaires dans la traduction de src-string ::msgcat::mc recherchera les messages dfinis dans le namespace courant pour une traduction de src-string; si aucun n'est trouv, il recherchera dans le parent du namespace courant, et ainsi de suite jusqu'a ce qu'il atteigne le namespace global. Si aucune chane de traduction n'existe, ::msgcat::mcunknown est appel et la chane renvoye par ::msgcat::mcunknown est renvoye.
-
::msgcat::mc est la fonction principale utilise pour localiser une application. Au lieu d'utiliser une chane Anglaise directement, une application peut passer la chane Anglaise au travers de ::msgcat::mc et utiliser le rsultat. Si une application est crite pour une seule langue de cette faon, il est facile d'ajouter un support pour des langues supplmentaires plus tard simplement en dfinissant une nouvelle entre de catalogue de messages. -
-
::msgcat::mclocale ?newLocale? -- Cette fonction fixe locale newLocale Si newLocale est omise, la locale courante est renvoye, autrement la locale courante est fixe newLocale. La locale initiale est par dfaut la locale spcifie dans l'environnement utilisateur. Voir SPECIFICATIONS LOCALE ET SUBLOCALE ci-dessous pour une description du format chane locale. - -
::msgcat::mcpreferences -- Renvoie une liste ordonne des locales prefres des utilisateurs, base sur la spcification de langue de l'utilisateur. La liste est ordonne de la preference la plus spcifique la moins spcifique. Si l'utilisateur a spcifi LANG=en_US_funky, cette fonction retournera {en_US_funky en_US en}. - -
::msgcat::mcload dirname -- Recherche dans le rpertoire spcifi les fichiers qui correspondent au spcifications de langue renvoyes par ::msgcat::mcpreferences. Chaque fichier trouv est "sourc". L'extension de fichier est ".msg". Le nombre de fichiers message qui satisfont la spcification et ont t chargs est renvoy. -
::msgcat::mcset locale src-string ?translate-string? -- Fixe la traduction de src-string en translate-string dans la locale spcifie Si translate-string n'est pas spcifie, src-string est utilis pour les deux La fonction retourne translate-string. - -
::msgcat::mcunknown locale src-string -- Cette routine est appele par ::msgcat::mc dans le cas o une traduction de src-string n'est pas dfinie dans la locale courante L'action par dfaut est de renvoyer src-string Cette fonction peut tre redfinie par les applications, par exemple pour mettre dans un journal de message d'erreurs chaque chane inconnue. La fonction::msgcat::mcunknown est appele dans le mme contexte de pile que l'appel de ::msgcat::mc La valeur de retour de ::msgcat::mcunknown est utilise comme la valeur de retour de l'appel de ::msgcat::mc. - -
-
-
-
-
-namespace eval foo {mcset en hello "hello from ::foo"}
-puts [mc hello]
-namespace eval foo {puts [mc hello]}
-hello from ::foo
-mcset en m2 ":: message2"
-mcset en m3 ":: message3"
-namespace eval ::foo {
- mcset en m2 "::foo message2"
- mcset en m3 "::foo message3"
-}
-namespace eval ::foo::bar {
- mcset en m3 "::foo::bar message3"
-}
-puts "[mc m1]; [mc m2]; [mc m3]"
-namespace eval ::foo {puts "[mc m1]; [mc m2]; [mc m3]"}
-namespace eval ::foo::bar {puts "[mc m1]; [mc m2]; [mc m3]"}
-:: message1; ::foo message2; ::foo message3
-:: message1; ::foo message2; ::foo::bar message3
-
-
- en_UK.msg -- UK English
-
-
- ::msgcat::mcload [file join [file dirname [info script]] msgs]
-
-
-format "Sur le site %s nous produisons %d units" $city $num
-format " Sur le site %2\$s nous produisons %1\$d units" $num $city
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/namespace.htm b/hlp/fr/tcl/namespace.htm deleted file mode 100644 index 8424828..0000000 --- a/hlp/fr/tcl/namespace.htm +++ /dev/null @@ -1,195 +0,0 @@ - -
namespace Commandes Internes Tcl
-
-
-
-
-
-
-
-
namespace children ?namespace? ?pattern? -- Renvoie une liste de tous les namespaces enfants qui appartiennent namespace. Si namespace n'est pas spcifi, alors les enfants sont renvoys pour le namespace courant. Cette commande retourne des noms pleinement qualifis, qui commencent avec ::. Si l'option pattern est donne, alors cette commande retourne seulement les noms qui correspond au modle glob-style. Le modle actuel utilis est dtermin comme suit: un modle qui commence avec :: est utilis directement, autrement le namespace namespace (ou le nom pleinement qualifi du namespace courant) est ajout au modle. - -
namespace code script -- Capture le contexte namespace courant pour une excution ultrieure du script script. Retourne un nouveau script dans lequel script aura t englob dans une commande namespace code. Le nouveau script a deux proprits importantes. D'abord, il peut tre valu dans tout namespace et provoquera l'valuation de script dans le namespace courant (celui o la commande namespace code a t appele). -Deuximement, des arguments supplmentaires peuvent tre ajouts au script rsultant et ils seront transmis script comme arguments additionels. Par exemple, supposez que la commande set script [namespace code {foo bar}] est appele dans le namespace ::a::b. Ensuite eval "$script x y" peut tre excut dans tout namespace (en supposant que la valeur de script lui ait t transmise correctement) et aura le mme effet que la commande namespace eval ::a::b {foo bar x y}. Cette commande est ncessaire parce que les extensions comme Tk excutent normalement les scripts callback dans le namespace global . Une commande visible capture une commande et son contexte namespace de faon l'excuter correctement plus tard. Voir la section VALEURS VISIBLES pour quelques exemples montrant comment l'utiliser pour crer des scripts callback. - -
namespace current -- Renvoie le nom pleinement qualifi pour le namespace courant. Le nom actuel du namespace global est "" (ex., une chane vide), mais cette commande retourne :: pour le namespace global par convnience pour les programmeurs. - -
namespace delete ?namespace namespace ...? -- Chaque namespace namespace est effac et toutes variables, fonctions, et namespaces enfants contenus dans le namespace sont effacs. Si une fonction est en cours d'excution dans le namespace, le namespace sera maintenu jusqu'a ce que la fonction retourne; nanmoins, le namespace est marqu pour empcher tout autre code de le rechercher par son nom. Si un namespace n'existe pas, cette commande retourne une erreur. Si aucuns noms de namespace ne sont donns, cette commande ne fait rien. - -
namespace eval namespace arg ?arg ...? -- Active un namespace appel namespace et value tout code dans ce contexte. Si le namespace n'existe pas dj, il est cr. Si plus d'un argument arg est spcifi, les arguments sont concatns, spars par des espaces de la mme faon qu'avec la commande eval, et le rsultat est valu.
-
Si namespace a des qualificateurs namespace en tte et que les namespaces en tte n'existent pas, ils sont automatiquement crs. -
-
namespace export ?-clear? ?pattern pattern ...? -- Spcifie quelles commandes sont exportes par un namespace. Le commandes exportes sont celles qui peuvent tre plus tard importes dans un autre namespace en utilisant une commande namespace import. L'ensembles des commandes dfinies dans un namespace et des commandes que le namespace a prcedemment import peut tre export par un namespace. La commandes n'ont pas tre dfinies l'instant o la commande namespace export est excute. Chaque pattern peut contenir des caractres spciaux glob-style, mais il ne peut pas inclure quelconque qualificateurs namespace. Ainsi, le modle peut seulement spcifier des commandes dans le namespace courant (exportant). Chaque pattern est ajout la liste de modles d'export du namespace. Si le flag -clear est donn, la liste de modles d'export du namespace est rinitialise en chane vide avant que quelconques pattern arguments soient ajouts. Si aucuns patterns ne sont donns et que le flag -clear n'est pas fourni, cette commande retourne la liste d'export du namespace courant. - -
namespace forget ?pattern pattern ...? -- Redplace les commandes prcedemment importes d'un namespace. Chaque pattern est un nom qualifi tel que foo::x ou a::b::p*. Les noms qualifis contiennent des ::s et qualifient un nom avec le nom d'un ou plusieurs namespaces. Chaque pattern est qualifi avec le nom d'un namespace exportant et peut avoir des caractres spciaux glob-style dans le nom de commande la fin du nom qualifi. Les caractres glob ne peuvent pas apparaitre dans un nom de namespace. Cette commande trouve en premier les commandes exportes correspondantes. Elle vrifie ensuite si une ou plusieurs de ces commandes ont t prcedemment importes par le namespace courant. Si c'est le cas, cette commande efface les commandes importes correspondantes. Ceci annule effectivement l'action d'une commande namespace import. - -
namespace import ?-force? ?pattern pattern ...? -- Importe des commandes dans un namespace. Chaque pattern est un nom qualifi comme foo::x ou a::p*. Ainsi, elle inclut le nom d'un namespace exportant et peut avoir des caractres spciaux glob-style dans le nom de commande la fin du nom qualifi. Les caractres glob ne peuvent pas apparaitre dans un nom de namespace. Toutes les commandes qui correspondent une chane pattern et qui sont couramment exportes de leurs namespace sont ajoutes au namespace courant. Ceci est fait par cration d'une nouvelle commande dans le namespace courant qui pointe vers la commande exporte dans son namespace original; quand la nouvelle commande importe est appele, elle appelle la commande exporte. Cette commande normalement retourne une erreur si une commande importe rentre en conflit avec une commande existante. Nanmoins, si l'option -force est donne, les commandes importes remplaceront silencieusement les commandes existantes. La commande namespace import a une smantique photographique: ainsi, seulement les commandes requises couramment dfinies dans le namespace exportant sont importes. En d'autres mots, vous pouvez importer seulement les commandes qui sont dans un namespace l'instant o la commande namespace import est excute. Si une autre commande est dfinie et exporte dans ce namespace plus tard, elle ne sera pas importe. - -
namespace inscope namespace arg ?arg ...? -- Execute un script dans le contexte d'un namespace particulier. Cette commande n'est pas sense tre utilis directement par les programmeurs; des appels sont gnrs implicitement quand les applications utilisent la commande namespace code pour crer scripts callback que l'applications alors enregistre avec, par ex., des widgets Tk. La commande namespace inscope ressemble plus la commande namespace eval except qu'elle a une smantique lappend et que le namespace doit dj exister. Elle traite le premier argument comme une liste, et ajoute tout argument aprs le premier jusqu' la fin comme des lments de liste correcte. namespace inscope ::foo a x y z est quivalent namespace eval ::foo [concat a [list x y z]] Cette smantique lappend est importante parce que de nombreux scripts callback sont actuellement des prfixes. - -
namespace origin command -- Renvoie le nom pleinement qualifi de la commande originale laquelle la commande importe command se rfre. Quand une commande est importe dans un namespace, une nouvelle commande est cre dans ce namespace qui pointe vers la commande actuelle dans le namespace exportant. Si une commande est importe dans une squence de namespaces a, b,...,n o chaque namespace successif importe juste la commande du prcedent namespace, cette commande retourne le nom pleinement qualifi de la commande originale dans le premier namespace, a. Si command ne se refre pas une commande importe, le propre nom pleinement qualifi de la commande est renvoy. - -
namespace parent ?namespace? -- Renvoie le nom pleinement qualifi du namespace parent de namespace. Si namespace n'est pas spcifi, le nom pleinement qualifi du parent du namespace courant est renvoy. - -
namespace qualifiers string -- Renvoie tous les qualificateurs namespace en tte de string. Les qualificateurs sont les noms de namespace spares par ::. Pour la string ::foo::bar::x, cette commande retourne ::foo::bar, et pour :: elle retourne une chane vide. Cette commande est le complment de la commande namespace tail. Notez qu'elle ne vrifie pas si les noms de namespace sont, en fait, les noms des namespaces couramment dfinis. - -
namespace tail string -- Renvoie le simple nom la fin d'une chane qualifie. Les qualificateurs sont les noms de namespace spares par ::. Pour la string ::foo::bar::x, cette commande retourne x, et for :: elle retourne une chane vide. Cette commande est le complement de la commande namespace qualifiers. Elle ne vrifie pas si les noms de namespace sont, en fait, les noms des namespaces couramment dfinis. - -
namespace which ?-command? ?-variable? name -- Recherche name soit comme commande ou variable et retourne son nom pleinement qualifi. Par exemple, si name n'existe pas dans le namespace courant mais existe dans le namespace global, cette commande retourne un nom pleinement qualifi dans le namespace global. Si la commande ou variable n'existe pas, cette commande retourne une chane vide. Si la variable a t cre mais non dfinie, tel qu'avec la commande variable ou au travers d'une trace sur la variable, cette commande renverra le nom pleinement qualifi de la variable. Si aucun flag n'est donn, name est trait comme un nom de commande. Voir la section RESOLUTION DE NOM ci-dessous pour une explication des rgles concernant la rsolution de nom. - -
-
-
-namespace export bump
-variable num 0
-
-proc bump {} {
-variable num
-incr num
-}
-}
-variable num 0
-proc bump {} {
-variable num
-return [incr num]
-}
-}
-namespace eval Counter {
-proc test {args} {
-return $args
-}
-}
-namespace eval Counter {
-rename test ""
-}
-
-
-
-Counter::bump 5
-Counter::Reset
-
-
-
-
-
-namespace eval Debug {
-printTrace $traceLevel
-}
-namespace eval Foo {
-variable traceLevel 3
-
-namespace eval Debug {
-printTrace $traceLevel
-}
-}
-
-
-Blt::table . .g 0,0
-table . .g 0,0
-
-
-namespace export bump reset
-variable Num 0
-variable Max 100
-
-proc bump {{by 1}} {
-variable Num
-incr Num $by
-Check
-return $Num
-}
-proc reset {} {
-variable Num
-set Num 0
-}
-proc Check {} {
-variable Num
-variable Max
-if {$Num > $Max} {
-error "too high!"
-}
-}
-}
-
-
-
-
-
- diff --git a/hlp/fr/tcl/open.htm b/hlp/fr/tcl/open.htm deleted file mode 100644 index a274ec7..0000000 --- a/hlp/fr/tcl/open.htm +++ /dev/null @@ -1,93 +0,0 @@ - -
open Commandes Internes Tcl
-
-
-
-
-open fileName
-open fileName access
-open fileName access permissions -
-
-
-
-
- r
- Ouvre le fichier pour la lecture seulement; le fichier doit dj exister. C'est la valeur par dfaut si access n'est pas spcifi. - -
- r+
- Ouvre le fichier pour la lecture et l'criture; le fichier doit dj exister. - -
- w
- Ouvre le fichier pour l'criture seulement. Le tronque s'il existe. S'il n'existe pas, cre un nouveau fichier. - -
- w+
- Ouvre le fichier pour la lecture et l'criture. Le tronque s'il existe. S'il n'existe pas, cre un nouveau fichier. - -
- a
- Ouvre le fichier pour l'criture seulement. Si le fichier n'existe pas, cre un nouveau fichier vide. Positionne le curseur la fin du fichier. - -
- a+
- Ouvre le fichier pour la lecture et l'criture. Si le fichier n'existe pas, cre un nouveau fichier vide. Positionne le curseur la fin du fichier. - -
-
-
- RDONLY
- Ouvre le fichier pour la lecture seulement. -
- WRONLY
- Ouvre le fichier pour l'criture seulement. -
- RDWR
- Ouvre le fichier en lecture et criture. -
- APPEND
- Positionne le curseur la fin du fichier avant chaque criture. -
- CREAT
- Cre le fichier s'il n'existe pas dj. -
- EXCL
- Si CREAT est galement spcifi, une erreur est gnre si le fichier existe dj. - -
- NOCTTY
- Si le fichier est un terminal, ce flag empche le fichier de devenir le terminal de contrle du processus. - -
- NONBLOCK
- Empche le processus de bloquer pendant l'ouverture du fichier, et eventuellement pendant les oprations I/O suivantes. Le comportement exact de ce flag est systme- et priphrique-dependant; son emploi est dconseill (il vaut mieux utiliser la commande fconfigure pour mettre un fichier en mode non bloquant). Pour des dtails se referer la documentation de votre systme sur le flag O_NONBLOCK de l'appel systme open - -
- TRUNC
- Si le fichier existe il est tronqu longueur zro. - -
-
-
-
-
-
-
-
-
- -mode baud,parity,data,stop
- Cette option est un ensemble de 4 valeurs spares par des virgules: le baud rate, parit, nombre de bits de donnes, et nombre de bits stop pour ce port srie. Le baud rate est un simple entier qui spcifie la vitesse de connection. Parity est une des lettres suivantes: n, o, e, m, s; signifiant respectivement les options de parit "aucune", "impaire", "paire", "marque", ou "espace". Data est le nombre de bits de donnes et sera un entier de 5 8, alors que stop est le nombre de bits de stop et sera l'entier 1 ou 2. - -
- -pollinterval msec
- Cette option, disponible seulement sous Windows pour les port sries, est utilise pour fixer le temps maximum entre l'ecoute d'vnements fichier. Ceci affecte le intervalle de temps de vrification d'vnements par l'interprteur Tcl (la plus petite valeur l'emporte toujours). Utilisez cette option seulement si vous voulez couter le port srie plus souvent que 10 msec (la valeur par dfaut). - -
- -lasterror
- Cette option est disponible seulement sous Windows pour les port sries, et est en lecture seule (ne peut tre que signale). En cas d'une erreur de communication srie, read ou puts retourne une erreur Tcl gnrale I/O fichier. fconfigure -lasterror peut tre appele pour obtenir une liste des details d'erreur (ex. FRAME RXOVER). - -
-
-
-
-
- Windows (toutes versions)
- Les valeurs valides de fileName pour ouvrir un port srie sont de la forme comX:, where X est un nombre, gnralement de 1 4. Cette notation fonctionne seulement pour les port sries de 1 9, si le systme en a plus que quatre. Une tentative d'ouvrir un port srie qui n'existe pas ou a un nombre suprieur 9 chouera. Une forme alternative d'ouvrir des port sries est d'utiliser le nom de fichier \\.\comX, o X est un nombre quelconque qui correspond un port srie; veuillez noter que cette mthode est considerablement plus lente sous Windows 95 et Windows 98. - -
- Windows NT
- Quand vous excutez Tcl interactivement, il peut y avoir des interactions tranges entre la console relle, si elle est prsente, et une commande pipeline qui utilise l'entre ou la sortie standard. Si une commande pipeline est ouverte pour la lecture, toutes les lignes entres sur la console seront envoyes la commande pipeline puis l'evaluateur Tcl. Si une commande pipeline est ouverte pour l'criture, les frappes de touches entres sur la console ne seront pas visible jusqu'a ce que le le pipe soit ferm. Ce comportement se produit si la commande pipeline est une application 16-bit ou 32-bit. Ces problmes se produisent seulement parce que la fois Tcl et application enfant essayent d'acceder la console en mme temps. Si la commande pipeline est lance partir d'un script, Tcl n'accde pas la console, ou si la commande pipeline n'utilise pas l'entre ou la sortie, standard mais est redirige partir ou vers un fichier, alors les problmes vus plus haut ne se produisent pas. -
- Windows 95
- Une commande pipeline qui excute une application DOS 16-bit ne peut pas tre ouvert en lecture et criture, car les applications DOS 16-bit qui recoivent l'entre standard d'un pipe et envoient la sortie standard dans un pipe sont excutes de manire synchrone. Les commande pipelines qui n'excutent pas d'applications DOS 16-bit sont excutes de manire asynchrone et peuvent tre ouvertes en lecture et criture.
-Quand vous excutez Tcl interactivement, il peut y avoir des interactions tranges entre la console relle, si elle est prsente, et une commande pipeline qui utilise l'entre ou la sortie standard. Si une commande pipeline est ouvert pour la lecture partir d'une application 32-bit, , les frappes de touches entres sur la console seront envoyes la commande pipeline et puis l'evaluateur Tcl. Si une commande pipeline est ouvert pour l'criture sur une application 32-bit, aucune sortie n'est visible sur la console jusqu'a ce que le le pipe soit ferm. Ces problmes se produisent seulement parce que la fois Tcl et application enfant essayent d'acceder la console en mme temps. Si la commande pipeline est lance partir d'un script, Tcl n'accde pas la console, ou si la commande pipeline n'utilise pas l'entre ou la sortie, standard mais est redirige partir ou vers un fichier, alors les problmes vus plus haut ne se produisent pas. -Que Tcl s'excute interactivement ou non, si une commande pipeline est ouvert pour la lecture partir une application 16-bit DOS, l'appel de open ne retourne pas jusqu'a ce que la fin-de-fichier avoir t transmise la sortie standard du pipeline. Si un pipeline est ouvert pour l'criture sur une application 16-bit DOS, aucune donne ne sera envoyes la sortie standard du pipeline jusqu'a ce que le pipe soit ferm. Ce problme se produit parce que les applications 16-bit DOS sont excutes de manire synchrone, comme dcrit plus haut. -
- - Macintosh
- Ouvrir un port srie n'est pas encore implment sous Macintosh.
-Ouvrir un pipeline n'est pas support sous Macintosh, car les applications ne supportent pas le concept d'entre ou de sortie standard. -
- - Unix
- Les valeurs valides de fileName pour ouvrir un port srie sont gnralement de la forme /dev/ttyX, o X est a ou b, mais le nom de tout pseudo-fichier qui pointe vers un port srie peut tre employ.
-Quand vous excutez Tcl interactivement, il peut y avoir des interactions tranges entre la console relle, si elle est prsente, et une commande pipeline qui utilise l'entre ou la sortie standard. Si une commande pipeline est ouvert pour la lecture, toutes lignes entres sur la console seront envoyes au pipeline et puis l'evaluateur Tcl. Ces problmes se produisent seulement parce que la fois Tcl et application enfant essayent d'acceder la console en mme temps. Si la commande pipeline lance partir d'un script, Tcl n'accde pas la console, ou si la commande pipeline n'utilise pas l'entre ou la sortie, standard mais est redirige partir ou vers un fichier, alors les problmes vus plus haut ne se produisent pas. Voir la section PROBLEMES DE PORTABILITE de la commande exec pour une information supplmentaire non spcifique au pipelines au sujet de l'excution d'applications sur les diffrentes plateformes -
-
-
- -
-
-
- diff --git a/hlp/fr/tcl/package.htm b/hlp/fr/tcl/package.htm deleted file mode 100644 index c1f1fab..0000000 --- a/hlp/fr/tcl/package.htm +++ /dev/null @@ -1,56 +0,0 @@ - -
package Commandes Internes Tcl
-
-
-
-
-package ifneeded package version ?script?
-package names
-package present ?-exact? package ?version?
-package provide package ?version?
-package require ?-exact? package ?version?
-package unknown ?command?
-package vcompare version1 version2
-package versions package
-package vsatisfies version1 version2
-
-
-
-
-
- package forget ?package package ...?
- Efface toute information concernant chaque package spcifi de cet interprteur, incluant l'information fournie par package ifneeded et package provide. - -
- package ifneeded package version ?script?
- Cette commande apparait seulement dans les scripts de configuration systme pour rparer la base de donnes des packages. Elle indique qu'une version particulire d'un package est disponible si besoin, et que le package peut tre ajout l'interprteur par l'excution de script. Le script est sauvegards dans une base de donnes pour tre utilis par les commandes suivantes package require typiquement, script parmtre l'auto-loading pour les commandes dans le package (ou appelle load et/ou source directement), et ensuite appelle package provide pour indiquer que le package est prsent. Il peut y avoir l'information dans la base de donnes pour plusieurs versions diffrentes d'un seul package. Si la base de donnes contient dj l'information pour package et version, le nouveau script remplace l'existant. Si l'argument script est omis, le script courant pour la version version du package package est renvoy, ou une chane vide si aucune commande package ifneeded a t appele pour ces package et version. - -
- package names
- Renvoie une liste des noms de tous les packages dans l'interprteur pour lequel une version a t fournie (via package provide) ou pour lequel un script package ifneeded est disponible. L'ordre des lments dans la liste est arbitraire. - -
- package present ?-exact? package ?version?
- Cette commande est quivalente package require except qu'elle n'essaye pas et charge le package s'il n'est pas dj charg. - -
- package provide package ?version?
- Cette commande est appele pour indiquer quelle version version du package package est maintenant prsente dans l'interprteur. Elle est typiquement appele une fois comme partie d'un script ifneeded, et de nouveau par les package lui-mme quand il est finalement charg. Un erreur se produit si une version diffrente de package a t fournie par une prcdente commande package provide. Si l'argument version est omis, alors la commande retourne le numro de version qui est couramment fourni, ou une chane vide si aucune commande package provide n'a t appele pour package dans cet interprteur. - -
- package require ?-exact? package ?version?
- Cette commande est typiquement appele par le code Tcl qui souhaite utiliser une version particulire d'un package. Les arguments indiquent quel package est demand, et la commande assure qu'une version convenable du package est charg dans l'interprteur. Si la commande russit, elle retourne le numro de version qui est charg autrement elle gnre une erreur. Si le switch - exact et l'argument version sont spcifis alors seulement la version donne est admise. Si -exact est omis mais que version est spcifi, alors les versions suprieures version sont aussi admises tant qu'elles ont le mme numro de version majeure que version. Si -exact et version sont omis alors toute version est acceptable. Si une version de package a dj t fournie (en appelant l commande package provide), alors son numro de version doit satisfaire les critres donns par -exact et version et la commande retourne immdiatement. Autrement, la commande recherche la base de donnes d'information fournie par les prcedentes commandes package ifneeded pour voir si une version acceptable du package est disponible. Si c'est le cas, le script avec le numro de version acceptable le plus lev est appel; elle doit faire tout ce qui est ncessaire pour charger le package, incluant l'appel de package provide pour le package. Si la base de donnes package ifneeded ne contient pas de version acceptable du package et qu'une commande package unknown a t spcifie pour l'interprteur alors cette commande est appele; quand elle se termine, Tcl vrifie de nouveau si le package est maintenant fourni ou s'il y a un script package ifneeded pour celui-ci. Si toutes ces tapes chouent pour fournir une version acceptable du package, alors la commande retourne une erreur. - -
- package unknown ?command?
- Cette commande apporte une commande "de la dernire chance" appeler pendant package require si aucune version convenable d'un package ne peut tre trouve dans la base de donnes package ifneeded. Si l'argument command est fourni, il contient la premire partie d'une commande; quand la commande est appele pendant une commande package require, Tcl ajoute deux arguments supplmentaires donnant les nom et version du package dsir. Par exemple, si command est foo bar et que plus tard la commande package require test 2.4 est appele, alors Tcl excutera la commande foo bar test 2.4 pour charger le package. Si aucun numro de version n'est donn la commande package require, alors l'argument version pour la commande appele sera une chane vide. Si la commande package unknown est appele sans argument command, alors le courant script package unknown est renvoy, ou une chane vide s'il n'existe pas. Si command est spcifi comme chane vide, alors le courant script package unknown est enlev, s'il existe. - -
- package vcompare version1 version2
- Compare les numros de versions donns par version1 et version2. Renvoie -1 si version1 est une version prcdente version2, 0 si ils sont gal, et 1 si version1 est plus rcente que version2. - -
- package versions package
- Renvoie une liste de tout les numros de versions de package pour lequel l'information a t fournie par des commandes package ifneeded. - -
- package vsatisfies version1 version2
- Renvoie 1 si les scripts crits pour version2 fonctionneront avec version1 (ex. version1 est gal ou suprieur version2 et elles ont le mme numro de version majeure), 0 autrement. - -
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/package_create.htm b/hlp/fr/tcl/package_create.htm deleted file mode 100644 index b20172a..0000000 --- a/hlp/fr/tcl/package_create.htm +++ /dev/null @@ -1,30 +0,0 @@ - -
pkg::create Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- -name packageName
- Ce paramtre spcifie le nom du package. Il est requis. -
- -version packageVersion
- Ce paramtre spcifie la version du package. Il est requis. -
- -load filespec
- Ce paramtre spcifie une bibliothque binaire qui doit tre charg avec la commande -load. filespec est une liste de deux lments. Le premier lment est le nom du fichier charger. Le second, l'lment optionnel est une liste de commandes fournies en chargeant ce fichier. Si la liste des fonctions est vide ou omise, ::pkg::create prpare la bibliothque un chargement direct (voir pkg_mkIndex). N'importe quel nombre de paramtres -load peut tre spcifi. - -
- -source filespec
- Ce paramtre est semblable au paramtre -load , except qu'il spcifie une bibliothque Tcl qui doit tre charge avec la commande source. N'importe quel nombre de paramtres -source peut tre spcifi. -
-
-
- diff --git a/hlp/fr/tcl/pid.htm b/hlp/fr/tcl/pid.htm deleted file mode 100644 index f3a86ab..0000000 --- a/hlp/fr/tcl/pid.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
pid Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/pkg_mkindex.htm b/hlp/fr/tcl/pkg_mkindex.htm deleted file mode 100644 index 0445842..0000000 --- a/hlp/fr/tcl/pkg_mkindex.htm +++ /dev/null @@ -1,58 +0,0 @@ - -
pkg_mkIndex Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
- [1]
- Crer le(s) package(s). Chaque package peut consister en un ou plusieurs fichiers script Tcl ou fichiers binaires. Les fichiers binaires doivent tre compatibles pour le chargement avec la commande load avec un seul argument; par exemple, si le fichier est test.so il doit tre possible de charger ce fichier avec la commande load test.so. Chaque fichier script doit contenir une commande package provide pour dclarer le package et son numro de version, et chaque fichier binaire doit contenir un appel Tcl_PkgProvide. -
- [2]
- Crer l'index en appelant pkg_mkIndex. L'argument dir donne le nom d'un rpertoire et chaque argument pattern est un modle glob-style qui choisit les scripts ou fichiers binaires dans dir. Le modle par dfaut est *.tcl et *.[info sharedlibextension].
-Pkg_mkIndex crera un fichier pkgIndex.tcl dans dir avec l'information de package au sujet de tous les fichiers donns par les arguments pattern. Ceci est fait par chargement de chaque fichier dans un interprteur esclave et constatation de quels packages et nouvelles commandes apparaissent (c'est pourquoi il est essentiel d'avoir des commandes package provide ou un appel Tcl_PkgProvide dans le fichier, comme dcrit plus haut). Si vous avez un package divis en scripts et fichiers binaires, ou si vous avez des dpendances entre les fichiers, vous pouvez utiliser l'option -load ou ajuster l'ordre dans lequel pkg_mkIndex traite les fichiers. Voir CAS COMPLEXES ci-dessous. -
- - [3]
- Installer le package dans un sous rpertoire d'un des rpertoires donns par la variable tcl_pkgPath. Si $tcl_pkgPath contient plus d'un rpertoire, les packages dpendants de la machine (ex., ceux qui contient libraries partages binaires) doivent normalement tre installs sous le premier rpertoire et les packages indpendants de la machine (ex., ceux qui contiennent seulement des scripts Tcl) seront installs sous le second rpertoire. Le sous rpertoire doit inclure le script du package et/ou les fichiers binaires aussi bien que le fichier pkgIndex.tcl. Tant que le package est install dans un sous rpertoire d'un rpertoire de $tcl_pkgPath il sera automatiquement trouv pendant les commandes package require.
-Si vous installez le package nulle part ailleurs, alors vous devez vous assurer que le rpertoire contenant le package est dans la variable globale auto_path ou un sous rpertoire immdiat d'un des rpertoires de auto_path. Auto_path contient une liste de rpertoires qui sont recherch par le auto-loader et le package loader; qui par dfaut inclut $tcl_pkgPath. Le package loader vrifie aussi tous les sous rpertoire des rpertoires dans auto_path. Vous pouvez ajouter un rpertoire auto_path explicitement dans votre application, ou vous pouvez ajouter le rpertoire votre variable d'environnement TCLLIBPATH: si cette variable d'environnement est prsente, Tcl initialise auto_path avec pendant le dmarrage de l'application.
- - [4]
- Une fois les tapes prcedentes accomplies, tout ce que vous avez besoin de faire pour utiliser le package est d'appeler package require. Par exemple, si les versions 2.1, 2.3, et 3.1 du package Test ont t indexes par pkg_mkIndex, la commande package require Test rendra la version 3.1 disponible et la commande package require-exact Test 2.1 rendra la version 2.1 disponible. Il peut y avoir de nombreuses versions d'un package dans les fichiers d'index de auto_path, mais seulement un sera actuellement charg dans un interprteur donn, en se basant sur le premier appel de package require. Diffrentes versions d'un package peuvent tre charges dans diffrents interprteurs. - -
-
-
-
-
- -lazy
- L'index gnr retardera le chargement du package jusqu' l'utilisation d'une des commandes fourni par le package, au lieu de le charger immdiatement avec package require. - -
- -load pkgPat
- Le processus d'index prechargera tous les packages existants dans l'interprteur courant et correspondants pkgPat dans l'interprteur esclave utilis pour gnrer l' index. La correspondance de modle utilise les rgles de chane de correspondance. Voir CAS COMPLEXES ci-dessous. - -
- -verbose
- Gnre une sortie pendant le processus d'indexage. La sortie se fait via la fonction tclLog, qui par dfaut affiche sur stderr. - -
- --
- Termine les flags, dans les cas ou dir commence avec un tiret. - -
-
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/proc.htm b/hlp/fr/tcl/proc.htm deleted file mode 100644 index 6dc71fa..0000000 --- a/hlp/fr/tcl/proc.htm +++ /dev/null @@ -1,20 +0,0 @@ - -
proc Commandes Internes Tcl
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/puts.htm b/hlp/fr/tcl/puts.htm deleted file mode 100644 index 74eb134..0000000 --- a/hlp/fr/tcl/puts.htm +++ /dev/null @@ -1,25 +0,0 @@ - -
puts Commandes Internes Tcl
- -
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/pwd.htm b/hlp/fr/tcl/pwd.htm deleted file mode 100644 index 81a5e49..0000000 --- a/hlp/fr/tcl/pwd.htm +++ /dev/null @@ -1,15 +0,0 @@ - -
pwd Commandes Internes Tcl
-
-
-
-
-DESCRIPTION
-
-
- diff --git a/hlp/fr/tcl/re_syntax.htm b/hlp/fr/tcl/re_syntax.htm deleted file mode 100644 index 0f4de7f..0000000 --- a/hlp/fr/tcl/re_syntax.htm +++ /dev/null @@ -1,399 +0,0 @@ - -
re_syntax Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- *
- une squence de 0 ou plus correspondances l'atome - -
+ -- une squence de 1 ou plus correspondances l'atome - -
? -- une squence de 0 ou 1 correspondance l'atome - -
{m} -- une squence de exactement m correspondances l'atome - -
{m,} -- une squence de m ou plus correspondances l'atome - -
{m,n} -- une squence de m n (incluses) correspondances l'atome; m infrieur n - -
*? +? ?? {m}? {m,}? {m,n}? -- quantificateurs non-greedy, qui correspondent au mme possibilits, mais se refrent au plus petit nombre plutt qu'au plus grand nombre de correspondances (voir CORRESPONDANCES) - -
-
-
- (re)
- (o re est toute expression rationelle) correspond une correspondance re, avec la correspondance marque pour rapport - -
(?:re) -- comme prcedent, mais sans reporting (une "non-capturing" ensemble de parenthses) - -
() -- correspond une chane vide, marque pour rapport. - -
(?:) -- correspond une chane vide, sans rapport - -
[chars] -- une bracket expression, correspondante un quelconque chars (voir BRACKET EXPRESSIONS pour plus de dtail) - -
. -- correspond un seul caractre quelconque - -
\k -- (o k est un caractre non-alphanumrique) correspond au caractre interprt comme un caractre ordinaire, e.x \\ correspond un caractre antislash - -
\c -- o c est alphanumrique (ventuellement suivi par autre caractres), un escape (AREs seulement), voir ESCAPES ci-dessous - -
{ -- quand suivi par un caractre autre qu'un chiffre, correspond l'accolade ouvrante `{'; quand suivi par un chiffre, c'est le dbut d'un intervalle (voir plus haut) - -
x -- o x est un simple caractre sans autre signification, correspond ce caractre. - -
-
-
- ^
- correspond au dbut d'une ligne - -
$ -- correspond la fin d'une ligne - -
(?=re) -- positive lookahead (AREs seulement), correspond au point quelconque o une sous chane correspondante re commence - -
(?!re) -- negative lookahead (AREs seulement), correspond au point quelconque o aucune sous chane correspondante re ne commence -
-
-
| - alpha - | -- Une lettre. - | -
| - upper - | -- Une lettre majuscule. - | -
| - lower - | -- Une lettre minuscule. - | -
| - digit - | -- Un chiffre dcimal. - | -
| - xdigit - | -- Un chiffre hexadcimal. - | -
| - alnum - | -- Un caractre alphanumrique (lettre ou chiffre). - | -
| - print - | -- Un caractre alphanumrique (mme que alnum). - - | -
| - blank - - | -- Un espace ou tabulation.> - | -
| - space - | -- Un caractre produisant un espace dans du texte affich. - | -
| - punct - | -- Un caractre de ponctuation. - | -
| - graph - - | -- Un caractre avec une reprsentation visible. | -
| - cntrl - | -- Un caractre de contrle. | -
-
-
-
-
-
-
- \a -
- caractre bip (bell), comme en C - -
- \b
- backspace, comme en C - -
- \B -
- synonyme pour \ reduire la rptition des backslash dans quelques applications ou il y a des niveaux multiples de traitement des backslash - -
- \cX -
- (o X est un caractre quelconque) le caractre dont les 5 bits de poids faible sont les mme que ceux de X, et dont les autres bits sont tous zro - -
- \e -
- caractre dont le nom de squence d'assemblage est `ESC', ou le caractre avec une valeur octale de 033 - -
- \f -
- formfeed, comme en C - -
- \n -
- newline, comme en C - -
- \r -
- retour chariot, comme en C - -
- \t -
- tabulation horizontale, comme en C - -
- \uwxyz -
- (o wxyz est exactement quatre chiffres hexadcimaux) le caractre Unicode U+wxyz dans l' ordre d'octet local - -
- \Ustuvwxyz -
- (o stuvwxyz est exactement huit chiffres hexadcimaux) reserv pour une extension Unicode hypothtiquel 32 bits - -
- \v -
- tabulation verticale, comme en C. - -
- \xhhh -
- (o hhh est une squence quelconque de chiffres hexadcimaux) le caractre dont la valeur hexadcimale est 0xhhh (un simple caractre sans tenir compte de combien de chiffres hexadcimaux sont utiliss). - -
- \0 -
- le caractre dont la valeur est 0 - -
- \xy
- (o xy est exactement deux chiffres octal, et n'est pas une back reference (voir ci-dessous)) le caractre dont la valeur octale est 0xy - -
- \xyz
- (o xyz est exactement trois chiffres octaux, et n'est pas une back rfrence (voir ci-dessous)) le caractre dont la valeur octale est 0xyz - -
-
-
- \d
- [[:digit:]] -
- \s
- [[:space:]] - -
- \w -
- [[:alnum:]_] (notez l'underscore) - -
- \D -
- [^[:digit:]] -
- \S -
- [^[:space:]] - -
- \W -
- [^[:alnum:]_] (notez l'underscore) - -
-
-
- \A -
- correspond seulement au dbut de la chane (voir CORRESPONDANCES, ci-dessous, pour comment ceci diffre de `^') - -
- \m -
- correspond seulement au dbut d'un mot - -
- \M -
- correspond seulement la fin d'un mot - -
- \y -
- correspond seulement au dbut ou la fin d'un mot - -
- \Y -
- correspond seulement un point qui n'est pas le dbut ou la fin d'un mot - -
- \Z -
- correspond seulement la fin de la chane (voir CORRESPONDANCES, ci-dessous, pour comment ceci diffre de `$') - -
- \m -
- (o m est un chiffre non nul) une back reference, voir ci-dessous - -
- \mnn -
- (o m est un chiffre non nul, et nn sont d'autres chiffres, et la valeur dcimale mnn n'est pas suprieure au nombre de parenthses fermantes) une back reference, voir ci-dessous - -
-
-
-
-
- b -
- le reste de la RE est une BRE - -
- c -
- correspondance sensible la casse (par dfaut) - -
- e -
- le reste de la RE est une ERE - -
- i -
- correspondance insensible la casse (voir CORRESPONDANCES, ci-dessous) - -
- m -
- synonyme historique de n - -
- n -
- correspondance sensible au saut de ligne(voir CORRESPONDANCES, ci-dessous) - -
- p -
- correspondance partiellement sensible au saut de ligne (voir CORRESPONDANCES, ci-dessous) - -
- q -
- le reste de la RE est une chane littrale ("entre guillemets"), toute de caractres ordinaires - -
- s -
- correspondance insensible au saut de ligne (par dfaut) - -
- t -
- syntaxe srre (par dfaut; voir ci-dessous) - -
- w -
- correspondance inverse partiellement sensible au saut de ligne ("weird") (voir CORRESPONDANCES, ci-dessous) - -
- x
- syntaxe expanse (voir ci-dessous) -
-
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/read.htm b/hlp/fr/tcl/read.htm deleted file mode 100644 index a03619a..0000000 --- a/hlp/fr/tcl/read.htm +++ /dev/null @@ -1,21 +0,0 @@ - -
read Commandes Internes Tcl
-
-
-
-
-read channelId numChars -
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/regexp.htm b/hlp/fr/tcl/regexp.htm deleted file mode 100644 index 36146be..0000000 --- a/hlp/fr/tcl/regexp.htm +++ /dev/null @@ -1,57 +0,0 @@ - -
regexp Commandes Internes Tcl -
-
-
-
-
-
-
-
-
- -about
- Au lieu de tenter de correspondre une expression rationelle, retourne une liste contenant l'information concernant l'expression rationelle Le premier lment de la liste est un compte des sous expressions Le second lment est une liste de noms de proprit qui decrivent plusieurs attributs de l'expression rationelle. Ce switch est conu dans un but de debugging. - -
- -expanded
- Active l'usage de la syntaxe tendue des expressions rationelles o l'espace et les commentaires sont ignors. Identique la spcification de l'option (?x) (voir METASYNTAXE, ci-dessous). - -
- -indices
- Change ce qui est stock dans les subMatchVars Au lieu de stocker les caractres correspondants de string, chaque variable contiendra une liste de deux chanes dcimales donnant les indices dans string des premiers et derniers caractres dans l'intervalle correspondant des caractres. - -
- -line
- Active la correspondance sensible au saut de ligne Par dfaut, le saut de ligne est un caractre ordinaire sans signification spciale Avec ce flag, l' expression crochets `[^' et `.' ne correspond jamais newline, `^' correspond une chane vide aprs toute newline en plus de sa fonction normale, et `$' correspond une chane vide avant toute newline en en plus de sa fonction normale Ce flag est quivalent la spcification la fois de -linestop et -lineanchor, ou de l'option (?n) (voir METASYNTAXE, ci-dessous). - -
- -linestop
- Change le comportement de l'expression crochets `[^' et `.' de faon ce qu'elles s'arrtent aux saut de lignes Ceci est identique la spcification de l'option (?p) (voir METASYNTAXE, ci-dessous). - -
- -lineanchor
- Change le comportement de `^' et `$' (les "ancres") de faon ce qu'ils correspondent au dbut et la fin d'une ligne respectivement Ceci est identique la spcification de l'option (?w) (voir METASYNTAXE, ci-dessous). - -
- -nocase
- Cause l'interprtation des caractres majuscules de string comme minuscules pendant le traitement des correspondances. - -
- -all
- Teste la correspondance de l'expression rationelle le plus grand nombre de fois possible dans la chane, retournant le nombre total de correspondances trouves Si spcifi avec des variables de correspondance, ne contiendront l'information que pour la dernire correspondance. - -
- -inline
- Provoque le renvoi, comme liste, des donnes qui auraient t autrement places dans des variables de correspondance Quand inline est utilise, les variables de correspondance ne peuvent pas tre spcifies Si utilis avec -all, la liste sera concatne chaque itration, de ce fait une liste plate est toujours renvoye Pour chaque itration, la commande ajoutera les correspondances supplmentaires aux donnes, plus un lment pour chaque sous expression dans l'expression rationelle. Exemples:
- regexp -inline -- {\w(\w)} " inlined "
- => {in n}
- regexp -all -inline -- {\w(\w)} " inlined "
- => {in n li i ne e}
- - -start index
- Spcifie un index de caractre dans une chane pour commencer la correspondance une expression rationelle A l'utilisation de ce switch, `^' ne correspond plus au dbut de la ligne, et \A correspond toujours au dbut de la chane index Si -indices est spcifi, les indices seront indexs en partant du dbut de la chane d'entre. index sera contraint au limites de la chane d'entre. - -
- --
- Marque la fin des commutateurs L'argument suivant ceci sera trait comme exp mme s'il commence avec un -. - -
-
-
-
-
- diff --git a/hlp/fr/tcl/registry.htm b/hlp/fr/tcl/registry.htm deleted file mode 100644 index 0892f27..0000000 --- a/hlp/fr/tcl/registry.htm +++ /dev/null @@ -1,85 +0,0 @@ - -
registry Commandes Internes Tcl
-
-
-
-package require registry 1.0
-registry option keyName ?arg arg ...? -
-
-
-
-
- registry delete keyName ?valueName? -
- Si l'argument optionnel valueName est prsent, la valeur spcifie sous keyName sera efface de la base de registre. Si l'optionnelle valueName est omise, la cl spcifie et toute sous-cl ou valeurs en dessous dans la hirarchie de la base de registre seront effaces. Si la cl n'a pu tre efface alors une erreur est gnre. Si la cl n'existe pas, la commande n'a pas d'effet. - -
-registry get keyName valueName -- Renvoie les donnes associes la valeur valueName sous la cl keyName. Si la cl ou la valeur n'existe pas, alors une erreur est gnre. Pour plus details sur le format des donnes renvoyes, voir TYPES SUPPORTES, ci-dessous. - -
-registry keys keyName ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de noms de tout les sous-cls de keyName Si pattern est spcifi, seulement les noms correspondants pattern sont retourns La correspondance est dtermine en utilisant le mme rgles que pour string match. Si le keyName spcifi n'existe pas, alors une erreur est gnre. - -
registry set keyName ?valueName data ?type?? -- -Si valueName n'est pas spcifi, cre la cl keyName si elle n'existe pas dj. Si valueName est spcifi, cre la cl keyName et la valeur valueName si ncessaire Le contenu de valueName est fix data avec le type indique par type. Si type n'est pas spcifi, le type sz est suppos. Pour plus details sur les types de donnes et d'arguments , voir TYPES SUPPORTES ci-dessous. - -
registry type keyName valueName -- -Renvoie le type de la valeur valueName dans la cl keyName. Pour plus ample information sur les types possibles, voir TYPES SUPPORTES, ci-dessous. - -
-registry values keyName ?pattern? -- Si pattern n'est pas spcifi, retourne une liste de noms de toutes les valeurs de keyName. Si pattern est spcifi, seulement les noms correspondants pattern sont renvoys. La correspondance est dtermine en utilisant les mme rgles que pour string match - -
-
-
-
-
- binary
- La valeur du registre contient des donnes binaires arbitraires. Les donnes sont representes exactement enTcl, incluant tous les nulls contenus. - -
none -- La valeur du registre contient des donnes binaires arbitraires sans type dfini. Les donnes sont representes exactement en Tcl, incluant tous les nulls contenus. - -
sz -- La valeur du registre contient une chane zro terminal. Les donnes sont representes en Tcl comme chanes. - -
expand_sz -- La valeur du registre contient une chane zro terminal qui contient des rfrences non expanses aux variables d'environnements dans le style Windows normal (par exemple, "%PATH%") Les donnes sont representes en Tcl comme chane. - - -
dword -- La valeur du registre contient un nombre 32-bit little-endian. Les donnes sont representes en Tcl comme une chane dcimale. - -
dword_big_endian -- La valeur du registre contient un nombre 32-bit big-endian. Les donnes sont representes en Tcl comme une chane dcimale. - -
link -- La valeur du registre contient un lien symbolique. Les donnes sont representes exactement en Tcl, incluant tous les nulls contenus. - -
multi_sz -- La valeur du registre contient un tableau chanes zro terminal. Les donnes sont representes en Tcl comme une liste de chanes. - -
resource_list -- La valeur du registre contient une liste de pilotes de priphriques. Les donnes sont representes exactement en Tcl, incluant tous les nulls contenus. - -
-
-
-
-
- diff --git a/hlp/fr/tcl/regsub.htm b/hlp/fr/tcl/regsub.htm deleted file mode 100644 index 87c05fc..0000000 --- a/hlp/fr/tcl/regsub.htm +++ /dev/null @@ -1,38 +0,0 @@ - -
-
-
-
-
-
-
-
-
-
- -all
- Toutes les squences dans "string" qui interceptent "exp" sont trouves et la substitution est faite sur chacune de ces squences. Sans ce switch, seule la premire squence est substitue. Si -all est indiqu, alors les squences ''&' et ''\n'' sont traites pour chaque substitution en utilisation l'information de l'interception adquate. - -
- -expanded
- Autorise l'utilisation d'expressions rationnelles tendues, o le blanc et les commentaires sont ignors. Ceci est la mme chose que d'indiquer l'option embarque (?x). (voir METASYNTAXE, dans la page re_syntax) - -
- -line
- Autorise la sensibilit au retour-chariot (newline). Par dfaut newline est un caractre ordinaire sans signification particulire. Avec ce switch, les expressions entre crochets '[^' et le '.' n'interceptent jamais newline, '^' intercepte une chane vide aprs newline en complment de sa fonction normale, et '$' intercepte une chane vide avant newline en plus de sa fonction normale. Ce switch est quivalent aux switchs -linestop et -lineanchor runis, ou bien l'option embarque (?n). (voir METASYNTAXE, dans la page re_syntax ) - -
- -linestop
- Change le comportement des expressions entre crochets '[^' et l'expression '.' de faon qu'ils s'interrompent en rencontrant des retours chariots (newline). Ceci est quivalent l'option embarque (?p). (voir METASYNTAXE, dans la page re_syntax) - -
- -lineanchor
- Change le comportement des expression '^' et '$' (les ''ancres'') de telle sorte qu'ils interceptent respectivement le dbut et la fin d'une ligne. Ceci est le mme que d'indiquer l'option embarque (?w). (voir METASYNTAXE, dans la page re_syntax) - -
- -nocase
- Les lettres majuscules de "string" seront converties en minuscules avant d'tre compares "exp"; cependant les substitutions indiques par subSpec utilisent la forme originale, avant conversion, de "string". - -
- -start index
- Indique une position de caractre dans string, partir de laquelle il faut commencer la recherche d'expression rationnelle. Quand on utilise ce switch, '^' n'interceptera pas le dbut de la ligne, et \A interceptera toujours le dbut de la chane l'index indiqu. L'index sera contraint dans les limites effectives de la chane entre. - -
- --
- Marque la fin des switches. L'argument suivant cette fin sera trait comme tant l'expresssion "exp", mme s'il commence par -. -
-
-
-
- diff --git a/hlp/fr/tcl/rename.htm b/hlp/fr/tcl/rename.htm deleted file mode 100644 index 476c7d7..0000000 --- a/hlp/fr/tcl/rename.htm +++ /dev/null @@ -1,16 +0,0 @@ - -
rename Commandes Internes Tcl
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/resource.htm b/hlp/fr/tcl/resource.htm deleted file mode 100644 index 1a6455b..0000000 --- a/hlp/fr/tcl/resource.htm +++ /dev/null @@ -1,79 +0,0 @@ - -
resource Commandes Internes Tcl
-
-
-
-
-
-
-
- resource close rsrcRef -
- Ferme la rfrence resource donne (obtenue par resourceopen) Les resources de ce fichier resource ne seront plus disponibles. - -
resource delete ?options? resourceType -- Cette commande effacera la resource spcifie par options et le type resourceType (voir TYPES DE RESOURCES ci-dessous) Les options vous donnent plusieurs faons de spcifier l'effacement de la resource.
-
-
-
- -id resourceId -
- Si l'option -id est donne l'id resourceId (voir IDS DE RESOURCE ci-dessous) est utilis pour spcifier la resource effacer L'id doit tre un nombre - pour spcifier un nom utiliser l'option -name. - -
- -name resourceName -
- Si -name est spcifi, la resource nomme resourceName sera efface. Si -id 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 indpendemment du nom de la resource. - -
- -file resourceRef -
- Si l'option -file est spcifie alors la resource sera efface du fichier point par resourceRef Autrement la premire resource avec le resourceName donn et ou resourceId qui est trouv dans le chemin du fichier resource sera effac. Pour inspecter le chemin du fichier, utiliser la commande resource files. - -
-
resource files ?resourceRef? -- Si resourceRef n'est pas fournie, cette commande retourne une liste Tcl des rfrences de resource pour tous les fichiers resources couramment ouverts. La liste est dans l'ordre de recherche normal Macintosh pour les resources. Si resourceRef est spcifi, la commande renverra le chemin vers le fichier dont le fork resource est represent par ce jeton. - -
resource list resourceType?resourceRef? -- Liste tous les ids resources de type resourceType (voir TYPES DE RESOURCE ci-dessous) Si resourceRef est spcifi alors la commande limitera la recherche ce fichier resource particulier. Autrement, tout fichier resource couramment ouvert par l'application sera recherch. Une liste Tcl de soit le nom soit l'id de resource des resources trouves sera renvoye. Voir la section IDS DE RESOURCE ci-dessous pour plus de dtails au sujet de ce qu'est un id de resource. - -
resource open fileName ?access? -- Ouvre la resource pour le fichier fileName. Les permissions d'accs fichier standard peuvent aussi tre spcifies (voyez la page de manuel de open pour les dtails). Une rfrence de resource (resourceRef) est renvoye qui peut tre utilise 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. Nanmoins, si vous ouvrez le fichier avec des permissions d'criture le fichier et/ou le fork resource sera cr au lieu de gnrer une erreur. - -
resource read resourceType resourceId ?resourceRef? -- Lit la totalit de la resource de type resourceType (voir TYPES DE RESOURCE ci-dessous) et le nom ou l'id of resourceId (voir IDS DE RESOURCE ci-dessous) en mmoire et retourne le rsultat. Si resourceRef est spcifi, la recherche sera limite 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 donnes renvoy par cette commande peuventt contenir des NULLs ou d'autres donnes non-ASCII. - -
resource types ?resourceRef? -- Cette commande retourne une liste Tcl de tous les types de resource (voir TYPES DE RESOURCE ci-dessous) trouvs dans le fichier resource point par resourceRef. Si resourceRef n'est pas spcifi elle renverra tout les types de resource trouvs dans tous les fichiers resource couramment ouverts par l'application. - -
resource write ?options? resourceType data -- Cette commande crit les data transmises en tant qu'une nouvelle resource de type resourceType (voir TYPES DE RESOURCE ci-dessous). Plusieurs options sont disponibles qui decrivent o et comment la resource est stocke.
-
-
-
- -id resourceId
- Si l'option -id est donne, l'id resourceId (voir IDS DE RESOURCE ci-dessous) est utilis pour la nouvelle resource, autrement un id unique sera gnr qui n'entrera pas en conflit avec une resource existante. Nanmoins, l'id doit tre un nombre - pour spcifier un nom utiliser l'option -name. - -
- -name resourceName -
- Si -name est spcifi le resource sera nomme resourceName, autrement elle aura pour nom la chane vide. - -
- -file resourceRef -
- Si l'option -file est spcifie alors la resource sera crite dans le fichier point par resourceRef, autrement la resource la plus recemment ouverte sera utilise. - -
- -force -
- Si la resource cible existe dj, alors par dfaut Tcl ne l'crasera pas, mais lvera une erreur. Utilisez le flag -force pour forcer l'crasement de la resource existante - -
-
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/return.htm b/hlp/fr/tcl/return.htm deleted file mode 100644 index 5bb47d6..0000000 --- a/hlp/fr/tcl/return.htm +++ /dev/null @@ -1,45 +0,0 @@ - -
return Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
-
-
- ok -
- Retour normal: idem que si l'option est omise. - -
error -- Retour d'erreur: idem que si la commande error avait t utilise pour terminer la fonction, except pour la gestion des variables errorInfo et errorCode (voir ci-dessous). - -
return -- La fonction courante renvoie un code de retour de TCL_RETURN, ainsi que la fonction qui l'a appele. - -
break -- La fonction courante renvoie un code de retour de TCL_BREAK, qui terminera la boucle la plus imbrique dans le code qui a appel la fonction courante. - -
continue -- La fonction courante renvoie un code de retour de TCL_CONTINUE, qui terminera l'itration courante de la boucle la plus imbrique dans le code qui appele la fonction courante. - -
value -- Value doit tre un entier, il sera renvoy comme code de retour de la fonction courante. - -
-
-
-
- diff --git a/hlp/fr/tcl/safe.html b/hlp/fr/tcl/safe.html deleted file mode 100644 index 1778ac7..0000000 --- a/hlp/fr/tcl/safe.html +++ /dev/null @@ -1,130 +0,0 @@ - -
Safe Tcl Commandes Internes Tcl
-
-
-
-
-::safe::interpInit slave ?options...?
-::safe::interpConfigure slave ?options...?
-::safe::interpDelete slave
-::safe::interpAddToAccessPath slave directory
-::safe::interpFindInAccessPath slave directory
-::safe::setLogCmd ?cmd arg...? -
-
-
-
-
-
-
-
-
- ::safe::interpCreate ?slave? ?options...? -
- Cre un interprteur sr, installe les alias dcrits dans la section ALIAS et initialise le mcanisme d'auto-chargement et de paquet comme indiqu par les options fournies. Voir la section OPTIONS ci-dessous pour un description de l optionnel arguments. ci-dessous pour une description des arguments facultatifs. Si l'argument slave est omis, un nom sera gnr.. ::safe::interpCreate renvoie toujours le nom d'interprteur. - -
::safe::interpInit slave ?options...? -- Cette commande est identique interpCreate except qu'elle ne cre pas l'interprteur sr. slave doit avoir t cr par d'autres moyens, comme interp create-safe. - -
::safe::interpConfigure slave ?options...? -- Si aucunes options ne sont donnes, renvoie les paramtres pour toutes les options de l'interprteur sr comme liste d'options et leurs valeurs courantes pour slave. Si un argument additionnel est fourni, renvoie une liste de 2 lments name et value o name est le nom complet de cette option et value la valeur courante pour cette option et slave. Si plus de deux arguments additionnels sont fournis, il modifiera l'interprteur sr et changera chacunes et seulement les option fournies. Voir la section OPTIONS ci-dessous pour la description d'options. Exemple d'utilisation:
-
# Cre un nouvel interp avec la mme configuration que "$i0" : -
set i1 [eval safe::interpCreate [safe::interpConfigure $i0]] -
# Obtient le deleteHook courant
-
set dh [safe::interpConfigure $i0 -del] -
# Change (seulement) l'attribut de chargement statics ok d'un interp -
# et son deleteHook (laissant le reste inchang) :
- safe::interpConfigure $i0 -delete {foo bar} -statics 0 ;
-
-
::safe::interpDelete slave -- Efface l'interprteur sr et nettoie les structures de donnes principales correspondantes d'interprteur. Si un script deleteHook a t spcifi pour cet interprteur, il est valu avant l'interprteur que soit effac, avec le nom de l'interprteur comme argument additionnel. - -
::safe::interpFindInAccessPath slave directory -- Cette commande trouve et renvoie le jeton pour le vrai rpertoire directory de l'accs au chemin virtuel courant de l'interprteur sr. Elle gnre une erreur si le rpertoire n'est pas trouv. Exemple d'utilisation:
-
$slave eval [list set tk_library [::safe::interpFindInAccessPath $ name $tk_library]] -
-
::safe::interpAddToAccessPath slave directory -- Cette commande ajoute directory au chemin virtuel maintenu pour l'interprteur sr dans le matre, et retourne un jeton qui peut tre utilis dans l'interprteur sr pour obtenir accs aux fichiers dans ce rpertoire. Si le rpertoire est dj dans le chemin virtuel, elle renvoie seulement le jeton sans ajouter le rpertoire au chemin virtuel de nouveau. Exemple d'utilisation:
-
$slave eval [list set tk_library [::safe::interpAddToAccessPath $nom $ tk_library]] -
-
::safe::setLogCmd ?cmd arg...? -- Cette commande installe un script qui sera appel quand les vnements intressants du cycle de vie se produisent pour un interprteur sr. Une fois appele sans arguments, elle renvoie le script actuellement install. Si appele avec un argument, une chane vide, le script actuellement install est enlev et la journalisation est arrte. Le script sera appel avec un argument supplmentaire, une chane dcrivant l'vnement intressant. Le but principal est d'aider le debugging des interprteur srs. En utilisant ce service vous pouvez obtenir des message d'erreurs complets pendant que l'interprteur sr reoit seulement des messages d'erreurs gnriques. Ceci empche l'interprteur sr de voir des messages au sujet des checs et d'autres vnements qui pourraient contenir une information sensible telle que de vrais noms de rpertoire.
-
Exemple d'utilisation: -
::safe::setLogCmd puts stderr -
-
-
-NOTICE for slave interp10 : Setting accessPath=(/foo/bar) staticsok=1 nestedok=0 deletehook=()
-NOTICE for slave interp10 : auto_path in interp10 has been set to {$p(:0:)}
-ERROR for slave interp10 : /foo/bar/init.tcl: no such file or directory
-
-
-
-
- -accessPath directoryList
- Cette option place la liste de rpertoires desquels l'interprteur sr peut source et load des fichiers. Si cette option n'est pas spcifie, ou si elle est donne comme liste vide, l'interprteur sr emploiera les mme rpertoires que son matre pour auto-chargement. Voir la section SECURITE ci-dessous pour plus de dtail au sujet des chemins virtuels, des jetons et du contrle d'accs. - -
-statics boolean -- Cette option indique si l'interprteur sr sera autoris charger les packages statiquement lis (comme load {} Tk). La valeur par dfaut est true : les interprteur srs sont autoris charger les packages statiquement lis. - -
-noStatics -- Cette option est un raccourci de convenance pour -statics false et indique ainsi que l'interprteur sr ne sera pas autoris charger les packages statiquement lis. - -
-nested boolean -- Cette option spcifie si l'interprteur sr sera autoris charger des packages dans ses propre sous-interprteurs. La valeur par dfaut est false: les interprteur srs ne sont pas autoris charger de packages dans leurs propres interprteurs secondaires. - -
-nestedLoadOk -- Cette option est un raccourci de convenance pour -nested true et indique ainsi que l'interprteur sr sera autoris charger des packages dans ses propres interprteurs secondaires. - -
-deleteHook script -- Quand cette option est donn un script non vide, elle est value dans le matre avec le nom de l'interprteur sr comme argument additionnel juste avant supprimer rellement l'interprteur sr. Donner une valeur vide enlve n'importe quel script d'effacement actuellement install pour cet interprteur sr. La valeur par dfaut ({}) n'est n'avoir aucun appel de suppression. - -
-
-
-
-
- source fileName -
- Le fichier requis, un fichier source Tcl, est "sourc" dans interprteur sr s'il est trouv. L'alias source peut seulement " sourcer " les fichier des rpertoires qui se trouvent dans le chemin virtuel pour l'interprteur sr. L'alias source exige de l'interprteur sr qu'il utilise un des noms de jeton dans son chemin virtuel pour dsigner le rpertoire dans lequel le fichier a "sourcer" peut tre trouv. Voir la section sur la SECURITE pour une discussion plus approfondie des restrictions sur les noms de fichiers valides. - -
load fileName -- Le fichier requis, un fichier objet partag, est charg dynamiquement dans l'interprteur sr s'il est trouv. Le nom de fichier doit contenir le nom d'un jeton mentionn dans le chemin virtuel de l'interprteur sr pour tre trouv avec succs. De plus, le fichier objet partag doit contenir un point d'entre sr; voyez la page de manueluel de la commande load pour plus de dtails. - -
file ?subCmd args...? -- L'alias file donne accs un sous ensemble sr des sous-commandes de file; il permet seulement les sous-commandes dirname, join, extension, root, tail, pathname et split. Pour plus de dtails sur ces sous-commandes voyez la page de manueluel pour la commande file. - -
encoding ?subCmd args...? -- L'alias encoding donne accs un sous ensemble sr des sous-commandes de encoding il interdit de fixer l'encodage systme, mais permet tout autre sous-commandes incluant system vrifier l'encodage courant. - -
exit -- L'interprteur appelant est supprim et son traitement est arrt, mais le processus Tcl dans lequel cet interprteur existe n'est pas termin. -
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/scan.htm b/hlp/fr/tcl/scan.htm deleted file mode 100644 index 238b6a1..0000000 --- a/hlp/fr/tcl/scan.htm +++ /dev/null @@ -1,66 +0,0 @@ - -
scan Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- d
- Le champ d'entre doit tre un entier dcimal. Il est lu et la valeur est stocke dans la variable comme chane dcimale. - -
o -- Le champ d'entre doit tre un entier octal. Il est lu et la valeur est stocke dans la variable comme chane dcimale. - -
x -- Le champ d'entre doit tre un entier hexadcimal. Il est lu et la valeur est stocke dans la variable comme chane dcimale. - -
u -- Le champ d'entre doit tre un entier dcimal. La valeur est stocke dans la variable comme chane entire dcimale non signe. - -
i -- Le champ d'entre doit tre un entier La base (ex. dcimale, octal, ou hexadcimal) est dtermine de la mme faon que dcrite dans expr. La valeur est stocke dans la variable comme chane dcimale. - -
c -- Un seul caractre est lu et sa valeur binaire est stocke dans la variable comme chane dcimale. L'espace initial n'est pas saut dans ce cas, donc le champ d'entre peut tre un espace. Cette conversion est diffrente du standard ANSI dans lequel le champ d'entre consiste toujours en un simple caractre et ou aucune largeur de champ ne peut tre spcifie. - -
s -- Le champ d'entre consiste en tous les caractres jusqu'a l'espace suivant; les caractres sont copis dans la variable. - -
e ou f ou g -- Le champ d'entre doit tre un nombre virgule flottante consistant d'un signe optionnel, une chane de chiffres dcimaux pouvant contenir un point dcimal, et un exposant optionnel consistant d'un e ou E suivi par un signe optionnel et une chane de chiffres dcimaux. Il est lu et stock dans la variable comme une chane flottante. - -
[chars] -- Le champ d'entre consiste en un nombre quelconque de caractres dans chars. La chane correspondante est stocke dans la variable. Si le premier caractre entre crochets est un ] alors il est trait comme faisant partie de chars plutt que le crochet fermant l'ensemble. Si chars contient une squence de la forme a-z alors tout caractre entre a et z (inclus) correspondra. Si le premier ou dernier caractre entre crochets est un -, alors il est trait comme faisant partie de chars plutt que d'indiquer un intervalle. - -
[^chars] -- Le champ d'entre consiste en un nombre quelconque de caractres non inclus dans chars. La chane correspondante est stocke dans la variable. Si le caractre suivant immdiatement le ^ est un ] alors il est trait comme partie de l'ensemble plutt que le crochet fermant l'ensemble. Si chars contient une squence de la forme a-z alors tout caractre entre a et z (inclus) sera exclu de l'ensemble. Si le premier ou le dernier caractre entre crochets est un -, alors il est trait comme faisant partie de chars plutt que d'indiquer un intervalle. - -
n -- Aucune entre n'est utilise de la chane d'entre. Par contre, le nombre total de caractres scanns de la chane d'entre est stock dans la variable. - -
-
-
-
-
-
- diff --git a/hlp/fr/tcl/seek.htm b/hlp/fr/tcl/seek.htm deleted file mode 100644 index 1c64101..0000000 --- a/hlp/fr/tcl/seek.htm +++ /dev/null @@ -1,32 +0,0 @@ - -
seek Commandes Internes Tcl
-
-
-
-
-
-
-
- start
- La nouvelle position sera offset octets du dbut du fichier ou priphrique sous-jacent. - -
current -- La nouvelle position sera sera offset octets de la position courante; un offset ngatif dplace le curseur en arrire dans le fichier ou priphrique sous-jacent. - -
end -- La nouvelle position sera offset octets de la fin du fichier ou priphrique Un offset ngatif place le curseur avant la fin de fichier, et un offset positif place le curseur aprs la fin du fichier. - -
-
-
- diff --git a/hlp/fr/tcl/set.htm b/hlp/fr/tcl/set.htm deleted file mode 100644 index 787d5cb..0000000 --- a/hlp/fr/tcl/set.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
set Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/socket.htm b/hlp/fr/tcl/socket.htm deleted file mode 100644 index a417d4f..0000000 --- a/hlp/fr/tcl/socket.htm +++ /dev/null @@ -1,62 +0,0 @@ - -
socket Commandes Internes Tcl
-
-
-
-
-socket ?options? host port
-socket -server command ?options? port
-
-
-
-
-
-
-
-
- -myaddr addr -
- Addr donne le nom qualifi ou l'adresse IP numrique de l'interface rseau cot client utiliser pour la connection. Cette option peut tre utile si la machine cliente a plusieurs interfaces rseau Si l'option est omise alors l'interface cot client sera choisie par le logiciel systme. - -
-myport port- Port spcifie un numro de port entier utiliser pour le cot client de la connection. Si cette option est omise, un numro de port client alatoire sera choisi par le logiciel systme. - -
-async -- L'option -async induit une connection asynchrone pour la socket cliente. Ceci signifie que la socket sera cre immdiatement mais ne peut pas encore tre connecte au serveur, quand l'appel de socket retourne. Quand une gets ou flush est fait sur le socket avant que la tentative de connection ait russi ou chou, si la socket est en mode bloquant, l'opration attendra jusqu'a ce que la connection soit complte ou choue. Si la socket est en mode non bloquant et qu'une gets ou flush est fait sur la socket avant que la tentative de connection ait russi ou chou, l'opration retourne immdiatement et fblocked sur le socket retourne 1. - -
-
-
-
-
- -myaddr addr -
- Addr donne le nom qualifi ou l'adresse IP numrique de l'interface rseau du cot serveur utiliser pour la connection. Cette option peut tre utile si la machine serveur a plusieurs interfaces rseau. Si l'option est omise alors la socket serveur est attache l'adresse spciale INADDR_ANY ainsi elle peut accepter les connections sur une interface quelconque. - -
-
-
-
-
-
- -error
- Cette option lit le statut d'erreur courant de la socket donne. Ceci est utile quand vous avez besoin de determiner si une opration de connection asynchrone a russi. S'il y a eu une erreur, le message d'erreur est renvoy. Si il n'y avait pas d'erreur, une chane vide est renvoye. - -
-sockname -- Cette option retourne une liste de trois lments, l'adresse, le nom de machine et le numro de port pour la socket. Si le nom de machine ne peut pas calcul, le second lment est identique l'adresse, le premier lment de la liste. - -
-peername -- Cette option n'est pas supporte par les sockets serveur. Pour les sockets clients accepts, cette option retourne une liste de trois lments; ce sont l'adresse, le nom de machine et le port auquels la socket peer est connecte ou lie. Si le nom de machine ne peut tre calcul, le second lment de la liste est identique l'adresse, son premier lment. -
-
-
-
-
- diff --git a/hlp/fr/tcl/source.htm b/hlp/fr/tcl/source.htm deleted file mode 100644 index a62b171..0000000 --- a/hlp/fr/tcl/source.htm +++ /dev/null @@ -1,19 +0,0 @@ - -
source Commandes Internes Tcl
-
-
-
-
-
-source -rsrc resourceName ?fileName?
-source -rsrcid resourceId ?fileName?
-
-
-
-
- diff --git a/hlp/fr/tcl/split.htm b/hlp/fr/tcl/split.htm deleted file mode 100644 index f058401..0000000 --- a/hlp/fr/tcl/split.htm +++ /dev/null @@ -1,21 +0,0 @@ - -
split Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/string.htm b/hlp/fr/tcl/string.htm deleted file mode 100644 index 13d62e2..0000000 --- a/hlp/fr/tcl/string.htm +++ /dev/null @@ -1,131 +0,0 @@ - -
string Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- string bytelength string -
- Renvoie une chane dcimale donnant le nombre d'octets utiliss pour reprsenter string en mmoire. Comme UTF-8 utilise de un trois octets pour reprsenter les caractres Unicode, la longueur en octets ne sera pas la mme en gnral que la longueur des caractres. Les cas o un script gre la longueur en octets sont rares. Dans presque tous les cas, vous devrez utiliser l'opration string length. Referez-vous la page de manuel Tcl_NumUtfChars pour plus de dtails sur la reprsentation UTF-8. - -
string compare ?-nocase? ?-length int? string1 string2 -- Ralise une comparaison caractre-par-caractre des chanes string1 et string2. Renvoie -1, 0, ou 1, dpendant de si string1 est lexicographiquement infrieure , gale , ou suprieure string2. Si -length est spcifie, alors seulement les length premiers caractres sont utiliss dans la comparaison. Si -length est ngatif, elle est ignore. Si -nocase est spcifi, alors les chanes sont compares sans tenir compte de la casse. - -
string equal ?-nocase? ?-length int? string1 string2 -- Ralise une comparaison caractre-par-caractre des chanes string1 et string2. Renvoie 1 si string1 et string2 sont identiques, ou 0 sinon. Si -length est spcifie, alors seulement les length premiers caractres sont utiliss dans la comparaison Si -length est ngatif, elle est ignore Si -nocase est spcifi, alors la chanes sont compares sans tenir compte de la casse. - -
string first string1 string2 ?startIndex? -- Recherche dans string2 la squence de caractres qui correspond exactement au caractres de string1. Si trouv, retourne l' index du premier caractre de la premire correspondance dans string2. Sinon, retourne -1. Si startIndex est spcifi (dans toutes formes acceptes par la mthode index), alors la recherche est force de commencer avec le caractre de string2 spcifi par l'index. Par exemple,
-
string first a 0a23456789abcdef 5 -
renverra 10, mais -
string first a 0123456789abcdef 11 -
renverra -1. -
-
string index string charIndex- Renvoie le charIndex ime caractre de l'argument string Un charIndex de 0 corresponds au premier caractre de la chane charIndex peut tre spcifi comme suit:
-
integer Le caractre spcifi cet index intgral
end Le dernier caractre de la chane. -
end-integer Le dernier caractre de la chane moins l'offset entier spcifi (ex. end-1 se refre "c" dans "abcd"). -
Si charIndex est infrieur 0 ou suprieur ou gal la longueur de la chane alors une chane vide est renvoye. -
-
string is class ?-strict? ?-failindex varname? string -- Renvoie 1 si string est un membre valide de la classe de caractre spcifie, retourne 0 autrement Si -strict est spcifi, alors une chane vide retourne 0, autrement une chane vide renverra 1 avec toute classe. Si -failindex est spcifi, alors si la fonction retourne 0, l'index dans la chane o la classe n'est plus valide sera stock dans la variable dsigne par varname. varname ne sera pas fixe si la fonction retourne 1. Les classes de caractre suivantes sont reconnues (le nom de classe peut tre abrg): -
alpha N'importe quel caractre alphabtique Unicode. -
ascii N'importe quel caractre avec une valeur infrieure \u0080 (ceux qui sont dans l'intervalle ascii 7-bit). -
boolean N'importe quelle des formes autorises par Tcl_GetBoolean. -
control N'importe quel caractre de contrle Unicode. -
digit N'importe quel chiffre Unicode. Notez que ceci inclut les caractres en dehors de l'intervalle [0-9]. -
double N'importe quelle des formes valides pour un double en Tcl, eventuellement entour d'espaces. En cas de sous/ dbordement, 0 est renvoy et varname contiendra -1. -
false N'importe quelle forme autorise par Tcl_GetBoolean o la valeur est false. -
graph N'importe quel caractre Unicode imprimable, except l'espace. -
integer N'importe quelle des formes valides pour un entier en Tcl, eventuellement entour d'espaces. En cas de sous/dbordement, 0 est renvoy et varname contiendra -1. -
lower N'importe quel caractre alphabtique Unicode minuscule. -
print N'importe quel caractre Unicode imprimable, incluant l'espace. -
punct N'importe quel caractre de ponctuation Unicode. -
space N'importe quel caractre espace Unicode . -
true N'importe quelle forme autorise par Tcl_GetBoolean o la valeur est true. -
upper N'importe quel caractre alphabtique Unicode majuscule. -
wordchar N'importe quel caractre d'un mot Unicode. Donc tout caractre alphanumrique, et tout caractres connecteur ou de ponctuation Unicode (ex. underscore). -
xdigit N'importe quel caractre chiffre hexadcimal ([0-9A-Fa-f]). -
-
-
string last string1 string2 ?startIndex? -- Recherche dans string2 la squence de caractres qui correspond exactement au caractres de string1. Si trouv, retourne l'index du premier caractre de la dernire correspondance dans string2. S'il n'y a pas de correspondance, alors retourne -1. Si startIndex est spcifi (dans une des formes acceptes par la mthode index), alors seulement les caractres dans string2 ou avant le startIndex spcifi seront pris en compte dans la recherche. Par exemple,
-
string last a 0a23456789abcdef 15 -
renverra 10, mais -
string last a 0a23456789abcdef 9 -
renverra 1. -
-
string length string -- Renvoie une chane dcimale donnant le nombre de caractres dans string. Notez que ce n'est pas ncssairement le mme que le nombre d'octets utilis pour stocker la chane. - -
string map ?-nocase? charMap string -- Remplace les caractres dans string bass sur les paires cl-valeur dans charMap charMap est une liste de key value key value ... comme sous la forme renvoye par array get. Chaque instance d'une cl dans la chane sera remplace par sa valeur correspondante. Si -nocase est spcifi, alors la correspondance est tablie sans tenir compte de la casse. L'ensemble key et value peut tre de multiples caractres. Le remplacement est fait d'une manire ordonne, donc la cl apparaissant en premier dans la liste sera vrifie en premier, et ainsi de suite string est parcourue un seule fois, donc les premiers remplacements de cl n'affecteront pas les correspondances suivantes. Par exemple,
-
string map {abc 1 ab 2 a 3 1 0} 1abcaababcabababc -
renverra la chane 01321221. -
-
string match ?-nocase? pattern string -- Teste si pattern correspond string; retourne 1 si oui, 0 sinon. Si -nocase est spcifi, alors le modle est compar la chane sans tenir compte de la casse. Pour que deux chanes correspondent, leurs contenus doivent tre identiques except que les squences spciales suivantes peuvent apparaitre dans pattern:
-
-
-
- *
- Correspond toute squence de caractres dans string, incluant une chane vide. - -
- ?
- Correspond quelconque caractre unique dans string. - -
- [chars]
- Correspond tout caractre de l'ensemble indiqu par chars. Si une squence de la forme x-y apparait dans chars, alors tout caractre entre x et y, inclus, correspondra. Quand utilis avec -nocase, les points extrmes de l'intervalle sont convertis en minuscule en premier. En considrant que {[A-z]} correspond '_' quand la correspondance est sensible la casse ('_' est entre 'Z' et 'a'), avec -nocase c'est consider comme {[A-Za-z]} (et probablement ce qui etait exprim prcedemment). - -
- \x
- Correspond au caractre unique x. Ceci fournit un moyen d'viter l'interprtation spciale des caractres *?[]\ dans pattern. - -
-
string range string first last -- Renvoie un intervalle de caractres conscutifs de string, en commenant par le caractre dont l'index est first et finissant par le caractre dont l'index est last. Un index de 0 se rfre au premier caractre de la chane. first et last peuvent tre spcifis comme dans la mthode index. Si first est infrieur zro alors il est trait comme si c'tait zro, et si last est suprieur ou gal longueur de la chane alors il est trait comme si c'tait end. Si first est suprieur last alors une chane vide est renvoye. - -
string repeat string count -- Renvoie string rpte count fois. - -
string replace string first last ?newstring? -- Supprime un intervalle de caractres consecutifs de string, commenant avec le caractre dont l'index est first et finissant avec le caractre dont l'index est last. Un index de 0 se rfre au premier caractre de la chane First et last peuvent tre spcifis comme dans la mthode index. Si newstring est spcifie, alors elle est place dans l'intervalle des caractres supprims. Si first est infrieur zro alors il est trait comme si c'tait zro, et si last est suprieur ou gal la longueur de la chane alors il est trait comme si c'tait end. Si first est suprieur last ou la longueur de la chane initiale, ou last infrieur 0, alors la chane initiale est renvoy inchange. - -
string tolower string ?first? ?last? -- Renvoie une valeur gale string except que toute lettre en majuscule (ou titre) aura t convertie en minuscule. Si first est spcifi, il se rfre l'index du premier caractre dans la chane ou commencer les modifications. Si last est spcifi, il se rfre l'index du caractre dans la chane ou arrter (inclus) first et last peuvent tre spcifis comme dans la mthode index. - -
string totitle string ?first? ?last? -- Renvoie une valeur gale string except que le premier caractre de string est converti en sa variante Unicode titre (ou majuscule s'il n'y a pas de variante titre) et le reste de la chane est converti en minuscule. Si first est spcifi, il se rfre l'index du premier caractre dans la chane ou commencer les modifications. Si last est spcifi, il se rfre l'index du caractre dans la chane ou arrter (inclus). first et last peuvent tre spcifis comme dans la mthode index. - -
string toupper string ?first? ?last? -- Renvoie une valeur gale string except que toute lettre minuscule (ou titre) aura t convertie en majuscule. Si first est spcifi, il se rfre l'index du premier caractre dans la chane ou commencer les modifications. Si last est spcifi, il se rfre l'index du caractre dans la chane ou arrter (inclus). first et last peuvent tre spcifis comme dans la mthode index. - -
string trim string ?chars? -- Renvoie une valeur gale string except que tous les caractres en tte ou la fin de l'ensemble indiqu par chars sont enlevs. Si chars n'est pas spcifi alors tous les espaces sont enlevs (les espaces, tabulations, saut de lignes, et retour chariot). - -
string trimleft string ?chars? -- Renvoie une valeur gale string except que tous les caractres en tte de l'ensemble indiqu par chars sont enlevs. Si chars n'est pas spcifi alors tous les espaces sont enlevs (les espaces, tabulations, saut de lignes, et retour chariot). - -
string trimright string ?chars? -- Renvoie une valeur gale string except que tous les caractres la fin de l'ensemble indiqu par chars sont enlevs. Si chars n'est pas spcifi alors tous les espaces sont enlevs (les espaces, tabulations, saut de lignes, et retour chariot). - -
string wordend string charIndex -- Renvoie l'index du caractre juste aprs le dernier dans le mot contenant le caractre charIndex de string. charIndex peut tre spcifi comme dans la mthode index. Un mot est consider comme tout intervalle contigu de caractres alphanumeriques (lettres Unicode ou chiffres dcimaux ) ou underscore (connecteur de ponctuation Unicode), ou tout caractre unique autre que ceux-ci. - -
string wordstart string charIndex -- Renvoie l'index du premier caractre dans le mot contenant le caractre charIndex de string charIndex peut tre spcifi comme dans la mthode index. Un mot est consider comme tout intervalle contigu de caractres alphanumeriques (lettres Unicode ou chiffres dcimaux ) ou underscore (connecteur de ponctuation Unicode), ou tout caractre unique autre que ceux-ci. - -
-
-
- diff --git a/hlp/fr/tcl/subst.htm b/hlp/fr/tcl/subst.htm deleted file mode 100644 index 0ae4d1f..0000000 --- a/hlp/fr/tcl/subst.htm +++ /dev/null @@ -1,23 +0,0 @@ - -
subst Commandes Internes Tcl
-
-
-
-
-
-
-
-subst {xyz {$a}}
-
-
- diff --git a/hlp/fr/tcl/switch.htm b/hlp/fr/tcl/switch.htm deleted file mode 100644 index 945ff0f..0000000 --- a/hlp/fr/tcl/switch.htm +++ /dev/null @@ -1,61 +0,0 @@ - -
switch Commandes Internes Tcl
-
-
-
-
-switch ?options? string {pattern body ?pattern body ...?}
-
-
-
-
-
- -exact
- Utilise la correspondance exacte pendant la comparaison de string un modle C'est le dfaut. - -
-glob -- Pendant la comparaison de string aux modles, utilise une correspondance glob-style (ex. la mme qu'implmente par la commande string match). - -
-regexp -- Pendant la comparaison de string aux modles, utilise la correspondance expression rationelle (comme dcrit dans la page de rfrence re_syntax). - -
-- -- Marque la fin des options L'argument suivant sera trait comme string mme s'il commence avec un -. - -
- a
- -
- b
- {
- # Placement Correct du Commentaire
- format 1
- }
- a*
- {format 2}
- default
- {format 3}
-}
-
-
- diff --git a/hlp/fr/tcl/tcl.toc.html b/hlp/fr/tcl/tcl.toc.html deleted file mode 100644 index 1c4e68f..0000000 --- a/hlp/fr/tcl/tcl.toc.html +++ /dev/null @@ -1,110 +0,0 @@ -
-continue
-history
-pid
-switch
-Safe Base
-dde
-if
-pkg::create
-tcl_endOfWord
-Tcl
-encoding
-incr
-pkg_mkIndex
-tcl_findLibrary
-Tcltest
-eof
-info
-proc
-tcl_startOfNextWord
-after
-error
-interp
-puts
-tcl_startOfPreviousWord
-append
-eval
-join
-pwd
-tcl_wordBreakAfter
-array
-exec
-lappend
-re_syntax
-tcl_wordBreakBefore
-auto_execok
-exit
-lindex
-read
-tclvars
-auto_import
-expr
-linsert
-regexp
-tell
-auto_load
-fblocked
-list
-registry
-time
-auto_mkindex
-fconfigure
-llength
-regsub
-trace
-auto_mkindex_old
-fcopy
-load
-rename
-unknown
-auto_qualify
-file
-lrange
-resource
-unset
-auto_reset
-fileevent
-lreplace
-return
-update
-bgerror
-filename
-lsearch
-scan
-uplevel
-binary
-flush
-lsort
-seek
-upvar
-break
-for
-memory
-set
-variable
-catch
-foreach
-msgcat
-socket
-vwait
-cd
-format
-namespace
-source
-while
-clock
-gets
-open
-split
-close
-glob
-package
-string
-concat
-global
-parray
-subst
- - diff --git a/hlp/fr/tcl/tclsh.htm b/hlp/fr/tcl/tclsh.htm deleted file mode 100644 index 635ed0e..0000000 --- a/hlp/fr/tcl/tclsh.htm +++ /dev/null @@ -1,48 +0,0 @@ - -
tclsh Tcl Applications
-
-
-
-
-
-
-
-
-# la ligne suivante lance tclsh\
-exec tclsh "$0" "$@"
-
-
-
-
-
- argc
- Contient un compte du nombre des arguments arg (0 si aucun), non inclus le nom du fichier script. - -
argv -- Contient une liste Tcl dont les lments sont les arguments arg, dans l'ordre, ou une chane vide si il n'y a pas d'arguments arg. - -
argv0 -- Contient fileName si il a t spcifi. Autrement, contient le nom par lequel tclsh a t appel. - -
tcl_interactive -- Contient 1 si tclsh s'excute interactivement (aucun fileName n'a t spcifi et l'entre standard est un priphrique terminal-like), 0 autrement. - -
-
-
-
- diff --git a/hlp/fr/tcl/tcltest.html b/hlp/fr/tcl/tcltest.html deleted file mode 100644 index f9b8b3b..0000000 --- a/hlp/fr/tcl/tcltest.html +++ /dev/null @@ -1,309 +0,0 @@ - -
Tcltest Commandes internes Tcl
-
-
-
-
-
-::tcltest::test name desc ?constraint? script expectedAnswer
-::tcltest::cleanupTests ?runningMultipleTests?
-::tcltest::getMatchingTestFiles
-::tcltest::loadTestedCommands
-::tcltest::makeFile contents name
-::tcltest::removeFile name
-::tcltest::makeDirectory name
-::tcltest::removeDirectory name
-::tcltest::viewFile name
-::tcltest::normalizeMsg msg
-::tcltest::bytestring string
-::tcltest::saveState
-::tcltest::restoreState
-::tcltest::threadReap
-
-
-
Il est galement possible d'enrichir ce systme de test pour mettre en place votre propre systme de test sur mesure. Pour plus d'information, voir la section "Personnaliser le systme de test". -
Cette approche pour tester a t conue et initialement mise en place par Mary Ann May-Pumphrey de Sun Microsystems au dbut des annes 1990. Nous lui adressons de sincres remerciements pour avoir fait don de son travail au profit de la version publique de Tcl.
-
-
- ::tcltest::test name desc ?constraints? script expectedAnswer
- La commande ::tcltest::test lance script et compare son rsultat expectedAnswer. Elle imprime un message d'erreur si les deux ne correspondent pas. Si::tcltest::verbose contient "p" ou "s", elle imprime aussi un message si le test russit (p: passed) ou a t omis (s: skipped). Le test sera omis s'il ne correspond pas la variable ::tcltest::match, s'il correspond l'un des lments de ::tcltest::skip, ou si l'un des lments de constraints s'avre ne pas tre vrai. La commande ::tcltest::test n'a pas de valeur de retour dfinie. Voir la section "Ecrire un nouveau test" pour plus d'informations sur cette commande. -
- ::tcltest::cleanupTests ?runningMultipleTests?
- Cette commande doit normalement tre appele la fin d'un fichier de test. Elle imprime des statistiques au sujet des tests xcuts et supprime les fichiers crs par ::tcltest::makeDirectory et ::tcltest::makeFile. Les noms des fichiers et rpertoires crs en dehors de ::tcltest::makeFile et ::tcltest::makeDirectory, et qui n'ont jamais t dtruits, sont affichs dans ::tcltest::outputChannel. Cette commande restaure galement l'environnement d'xcution initial, tel que dcrit par le tableau ::env.calledFromAll doit normalement tre indiqu quand ::tcltest::cleanupTests est appel depuis un fichier "all.tcl". Des fichiers Tcl sont gnralement utiliss pour excuter des tests multiples. Pour plus d'information sur comment excuter des tests multiples, voir la section "Excuter des fichiers de test". Cette procdure n'a pas de valeur de retour dfinie. -
- ::tcltest::getMatchingTestFiles
- Cette commande est utilise quand vous voulez excuter plusieurs fichiers de test. Elle retourne la liste des tests qui doivent tre sourcs dans un fichier "all.tcl". Voir la section "Excuter des fichiers de test" pour plus d'informations. -
- ::tcltest::loadTestedCommands
- Cette commande utilise le script indiqu par l'option -load ou -loadfile pour charger les commandes testes par le systme de test. Autorise tre vide, dans le cas o; les commandes testes sont accumules dans l'interprteur qui xcute le systme de test. -
- ::tcltest::makeFile contents name
- Cre un fichier qui sera automatiquement supprim par ::tcltest::cleanupTests la fin du fichier de test. Cette procdure n'a pas de valeur de retour dfinie. -
- ::tcltest::removeFile name
- Force la suppression du fichier rfrenc par name. Ce nom de fichier doit tre indiqu en rfrence au ::tcltest::temporaryDirectory. Cette procdure n'a pas de valeur de retour dfinie. -
- ::tcltest::makeDirectory name
- Cre un rpertoire name, qui sera automatiquement supprim par ::tcltest::cleanupTests la fin du fichier de test. Cette procdure n'a pas de valeur de retour dfinie. -
- ::tcltest::removeDirectory name
- Force la suppression du fichier rfrenc par name. Cette procdure n'a pas de valeur de retour dfinie. -
- ::tcltest::viewFile file
- Renvoie le contenu de file. -
- ::tcltest::normalizeMsg msg
- Retire les fins de lignes superflues de msg. -
- ::tcltest::bytestring string
- Construit une chane qui se compose de la suite des octets demands, et non la chane forme de caractres UTF-8 corrects, partir de la valeur de string. Cela permet au testeur de crer des chanes dnormalises ou impropement formes, pour les passer des procdures C qui sont supposes accepter des chanes comprenant des NULL, et confirmer que le rsultat sous forme de chane correspond bien la suite d'octets prvue. -
- ::tcltest::saveState
- et ::tcltest::restoreState sauvent et restaurent les procdures et les variables globales. Un fichier de test peut contenir des appels ::tcltest::saveState et ::tcltest:restoreState s'il cre des variables globales ou des procdures. -
- ::tcltest::threadReap
- ::tcltest::threadReap fonctionne seulement si testthread est dfini, gnralement en compilant tcltest. Si testthread est dfini, ::tcltest::threadReap tue tous les threads l'exception du thread principal. Il rcupre l'ID du thread principal en appelant testthread names pendant l'initialisation. Cette valeur est stocke dans ::tcltest::mainThread. ::tcltest::threadReap retourne le nombre de threads existants en tout. (?) -
-
-
-
- lindex [file attributes foo.tcl] 5
-} {00644}
- catch {vwait x}
- set f [open foo w]
- fileevent $f writable {set x 1}
- vwait x
- close $f
- list [catch {vwait x} msg] $msg
-} {1 {ne peut pas attendre la variable "x": attendrait indfiniment }}
-
-
-
-
-
- ::tcltest::outputChannel
- outputfileID - par dfaut stdout, peut tre prcis en indiquant -outfile sur la ligne de commande. Tout test qui imprime des rsultats devrait envoyer cette sortie ::tcltest::outputChannel plutôt que de sortir par dfaut sur stdout. -
::tcltest::errorChannel- errorfileID - par dfaut stderr, peut tre prcis en indiquant -errfile sur la ligne de commande. Tout test qui imprime des messages d'erreur devrait le faire vers ::tcltest::errorChannel plutôt que directement dans stderr. -
::tcltest::mainThread- main thread ID - 1 par dfaut. Ce sera le seul thread qui ne sera pas tu par ::tcltest::threadReap et qui sera assign conformment la valeur de retour de testthread names l'initialisation. -
::tcltest::originalEnv- copie du tableau global "env" au dbut de l'xcution du test. Ce tableau est utilis pour restaurer le tableau "env" sa valeur initiale quand ::tcltest::cleanupTests est appele. -
::tcltest::workingDirectory- le rpertoire dans lequel le systme de test a t lanc. -
::tcltest::temporaryDirectory- le rpertoire de sortie - par dfaut ::tcltest::workingDirectory , peut tre prcis en indiquant -tmpdir en ligne de commande. -
::tcltest::testsDirectory- l o; se trouvent les tests - par dfaut ::tcltest::workingDirectory , si le script ne peut pas dterminer o; le rpertoire de tests se trouve. Il est possible de changer cette valeur par dfaut en prcisant -testdir en ligne de commande. Cette variable devrait toujours tre prcise explicitement si les tests sont xcuts depuis un fichier all.tcl. -
::tcltest::tcltest- le nom de l'xcutable utilis pour appeler le systme de test. -
::tcltest::loadScript- Le script xcut en tant que loadTestCommands. Prcis par -load ou -loadfile. -
-
-
- [string equal $tcl_platform(platform) "unix"]
-
-
-
- unix
- le test ne peut s'excuter que sur les plateformes UNIX -
- pc
- le test ne peut s'excuter que sur les plateformes Windows -
- nt
- le test ne peut s'excuter que sur les plateformes Windows NT -
- 95
- le test ne peut s'excuter que sur les plateformes Windows 95 -
- 98
- le test ne peut s'excuter que sur les plateformes Windows 98 -
- mac
- le test ne peut s'excuter que sur les plateformes Mac -
- unixOrPc
- le test ne peut s'excuter que sur les plateformes UNIX ou PC -
- macOrPC
- le test ne peut s'excuter que sur les plateformes Mac ou PC -
- macOrUnix
- le test ne peut s'excuter que sur les plateformes Mac ou Unix -
- tempNotPc
- le test ne peut tre xcut sur Windows. C'est un flag pour dsactiver temporairement un test. -
- tempNotMac
- le test ne peut tre xcut sur un Mac. C'est un flag pour dsactiver temporairement un test. -
- unixCrash
- le test se plante s'il est xcut sur UNIX. C'est un flag pour dsactiver temporairement un test. -
- pcCrash
- le test se plante s'il est xcut sur PC. C'est un flag pour dsactiver temporairement un test. -
- macCrash
- le test se plante s'il est xcut sur Mac. C'est un flag pour dsactiver temporairement un test. -
- emptyTest
- le test est vide, et donc ne vaut pas la peine d'tre xcut, mais il reste afin d'tre crit dans le futur. Cette contrainte provoque l'omission systmatique du test. -
- knownBug
- le test est connu pour se planter, et le bug n'est pas encore corrig. Cette contrainte provoque l'omission du test., sauf si l'utilisateur demande le contraire. Voir la section "Introduction" pour plus d'informations. -
- nonPortable
- ce test ne peut tre effectu que dans l'environnement de dveloppement Tcl/Tk matre. Certains tests sont par nature non portables, parce qu'ils dpendent de choses telles que la longueur de mot du processeur, la configuration du systme de fichiers, le gestionnaire de fentres, etc. Ces tests sont seulement xcuts dans l'environnement de dveloppement Tcl principal, o; la configuration est bien connue. Cette contrainte provoque l'omission du test, sauf si l'utilisateur demande le contraire. -
- userInteraction
- ce test demande une interaction avec l'utilisateur. Cette contrainte provoque l'omission du test, sauf si l'utilisateur demande le contraire. -
- interactive
- ce test ne peut tre effectu qu'en mode interactif, c'est dire si la variable globale tcl_interactive est positionne 1. -
- nonBlockFiles
- ce test ne peut s'excuter que si la plateforme supporte de mettre les fichiers en mode non-bloqu. -
- asyncPipeClose
- ce test ne peut s'excuter que si la plateforme supporte "async flush" et "async close" sur un pipe. -
- unixExecs
- le test ne peut s'excuter que si la machine dispose des commandes telles que 'cat', 'echo', etc. -
- hasIsoLocale
- le test ne peut s'excuter que s'il peut passer dans une locale ISO. -
- root
- le test ne peut s'excuter que si l'utilisateur Unix est root -
- notRoot
- le test ne peut s'excuter que si l'utilisateur Unix n'est pas root -
- eformat
- le test ne peut s'excuter que si l'application a une version fonctionnelle de sprintf respectant le format "e" des nombres flottants. -
- stdio
- le test ne peut s'excuter que si l'application courante peut fonctionner au travers d'un pipe -
-
-
-
-
- -help
- affiche le mode d'utilisation -
- -verbose <level>
- -dfinit le niveau de verbosit comme une sous-chane de "bps". Voir la section "Informations issus des tests" pour une explication de cette option. (::tcltest::verbose) -
- -match <matchList>
- -effectue seulement les tests qui correspondent aux motifs de "glob" dfinis dans <matchList>. (::tcltest::match) -
- -skip <skipList>
- -n'effectue pas les tests qui correspondent un ou plusieurs motifs de "glob" dfinis dans <skipList>. (::tcltest::skip) -
- -file <globPatternList>
- -source seulement les fichiers de test dont les noms rpondent l'un des motifs de <globPatternList> dfinis par rapport au rpertoire::tcltest::testsDirectory. Cette option n'a de sens qui si vous effectuez des tests utilisant "all.tcl" en tant que <testFile> au lieu d'effectuer directement des fichiers unitaires de test. (::tcltest::matchFiles) -
- -notfile <globPatternList>
- -source tous les fichiers sauf ceux dont les noms rpondent l'un des motifs de <globPatternList> dfinis par rapport au rpertoire::tcltest::testsDirectory. Cette option n'a de sens qui si vous effectuez des tests utilisant "all.tcl" en tant que <testFile> au lieu d'effectuer directement des fichiers unitaires de test. (::tcltest::skipFiles) -
- -constraints <list>
- -les tests contenant une contrainte parmi la liste <list> ne seront pas sauts. Notez que les lments de <list> doivent correspondrent exactement aux contraintes existantes. Ceci est utile si vous voulez avoir la certitude que les tests ayant une contrainte particulire sont effectus (par exemple, si le testeur souhaite que tous les tests contenant la contrainte knownBug soient effectus). (::tcltest::testConstraints(constraintName)) -
- -limitconstraints <bool>
- Si l'argument de cette option est 1, les tests effectus seront ceux qui respectent les contraintes dfinies par l'option -constraints. La valeur par dfaut de cet indicateur est 0 (false). Ceci est utile si vous voulez excuter seulement les tests qui rpondent aux contraintes listes par l'option -constraints. Un testeur peut vouloir cela par exemple pour n'effectuer que les tests contraints par unixOnly et aucun autre. (::tcltest::limitConstraints) -
- -load <script>
- utilisera le script indiqu pour charger les commandes tester (::tcltest::loadTestedCommands). La valeur par dfaut est un script vide. Voir galement -loadfile ci-dessous. (::tcltest::loadScript) -
- -loadfile <scriptfile>
- utilisera le contenu du fichier indiqu pour charger les commandes tester (::tcltest::loadTestedCommands).Voir galement -load ci-dessus. La valeur par dfaut est un script vide. (::tcltest::loadScript) -
- -tmpdir <directoryName>
- mettra tous les fichiers temporaires (crs avec ::tcltest::makeFile et ::tcltest::makeDirectory) dans le rpertoire indiqu. L'emplacement par dfaut est ::tcltest::workingDirectory. (::tcltest::temporaryDirectory) -
- -testdir <directoryName>
- cherche les tests excuter dans le rpertoire indiqu. L'emplacement par dfaut est ::tcltest::workingDirectory. (::tcltest::testsDirectory) -
- -preservecore <level>
- contrôle pour les fichiers core. Cette option dtermine quel niveau de contrôle sera effectu pour les fichiers "core". La valeur par dfaut pour <level> est 0. Les niveaux <level> sont dfinis comme suit :
-
-
- 0
- Pas de contrôle - ne pas contrôler les fichiers core la fin de chaque test, mais les contrôler chaque fois que::tcltest::cleanupTests est appel depuis un fichier all.tcl. -
- 1
- Vrifier l'existence de fichiers core la fin de chaque commande de test et chaque fois que::tcltest::cleanupTests est appel depuis un fichier all.tcl. -
- 2
- Vrifier l'existence de fichiers core la fin de chaque commande de test et chaque fois que::tcltest::cleanupTests est appel depuis un fichier all.tcl. Sauvegarder tout fichier core produit dans ::tcltest::temporaryDirectory. (::tcltest::preserveCore) -
- - -debug <debugLevel>
- afficher l'information de debug dans stdout. Ceci est utilis pour dbugger le code du systme de test. Le niveau de debug par dfaut est 0. Les niveaux sont dfinis ainsi:
-
-
- 0
- Ne pas afficher les informations de debug. -
- 1
- Afficher l'information indiquant si un test est saut parce qu'il ne rpond aucune des conditions indiques dans -match ou ::tcltest::match (userSpecifiedNonMatch), ou parce qu'il rpond une quelconque des conditions indiques par -skip ou ::tcltest::skip ((userSpecifiedSkip). -
- 2
- Affiche le tableau des options interprt par le processeur de ligne de commande, le contenu du tableau ::env, et toutes les variables utilisateur dfinies dans le namespace courant, quand elles sont utilises. -
- 3
- Affiche l'information concernant ce que font les procdures individuelles de le systme de test.(::tcltest::debug) -
- - -outfile <filename>
- envoie la sortie gnre par le package tcltest vers le fichier indiqu. La valeur par dfaut est stdout. Notez que la sortie de debug va systmatiquement dans stdout, quelque soit la valeur de cette option. (::tcltest::outputChannel) -
- -errfile <filename>
- envoie les erreurs gnres par le package tcltest vers le fichier indiqu. La valeur par dfaut est stderr. (::tcltest::errorChannel) -
-
-
-
- package require tcltest
- namespace import ::tcltest::*
-}
-
-# Supprime les tableaux globaux
-::tcltest::cleanupTests
-return
-
-
-
-
-
- [1]
- le nom du test ne correspond pas (en utilisant la correspondance de type "glob") un ou plusieurs lments de la variable ::tcltest::match. -
- [2]
- le nom du test correspond (en utilisant la correspondance de type "glob") un ou plusieurs lments de la variable ::tcltest::skip. -
- [3]
- l'argument constraints de l'appel ::tcltest::call, s'il existe, contient une ou plusieurs valeurs fausses. -
-
-
-
-
- ::tcltest::PrintUsageInfoHook
- afficher de l'information complmentaire, spcifique votre situation. -
- ::tcltest::processCmdLineArgsFlagHook
- avertir le systme au sujet d'options additionnelles que vous voulez qu'il comprenne. -
- ::tcltest::processCmdLineArgsHook flags
- traiter les options additionnelles que vous avez communiques au systme de test au travers de ::tcltest::processCmdLineArgsFlagHook. -
- ::tcltest::initConstraintsHook
- ajouter des contraintes additionnelles aux contraintes prdfinies par tcltest. -
- ::tcltest::cleanupTestsHook
- faire du nettoyage additionnel -
- return [list -flag1 -flag2]
-}
-
-proc ::tcltest::processCmdLineArgsHook {flagArray} {
- array set flag $flagArray
-
- if {[info exists flag(-flag1)]} {
- # Handle flag1
- }
-
- if {[info exists flag(-flag2)]} {
- # Handle flag2
- }
-
- return
-}
-
- set ::tcltest::testConstraints(win95Or98) \
- [expr {$::tcltest::testConstraints(95) || \
- $::tcltest::testConstraints(98)}]
-}
-
- # Add your cleanup code here
-}
-
- package require tcltest
- namespace import ::tcltest::*
-}
-
-test foo-1.1 {enregistrer 1 dans la variable foo} {} {
- set foo 1
-} {1}
-
-::tcltest::cleanupTests
-return
-
- package require tcltest
- namespace import ::tcltest::*
-}
-
-set ::tcltest::testSingleFile false
-set ::tcltest::testsDirectory [file dir [info script]]
-
-foreach file [::tcltest::getMatchingTestFiles] {
- if {[catch {source $file} msg]} {
- puts stdout $msg
- }
-}
-
-::tclttest::cleanupTests 1
-return
-
-
-
tclvars Commandes Internes Tcl
-
-
-
-
-
-
- env
- Cette variable est gre par Tcl comme un tableau dont les lments sont les variables d'environnements pour le processus. Lire un lment renverra la valeur de la variable d'environnement correspondante. Ecrire un lment du tableau modifiera la variable d'environnement correspondante ou en crera une nouvelle si elle n'existe pas dj. Effacer un lment de env enlvera la variable d'environnement correspondante. Les changements du tableau env affectent l'environnement transmis aux enfants par les commandes comme exec. Si le tableau entier env est effa alors Tcl arrtera de surveiller l'accs env et ne mettra plus jour les variables d'environnements.
-
Sous Windows, les variables d'environnements PATH et COMSPEC sont converties automatiquement en majuscule Par exemple, la variable PATH pourrait tre exporte par le systme d'exploitation comme "path", "Path", "PaTh", etc., ce qui autrement demanderait au code Tcl de supporter de nombreux cas spciaux. Toutes les autres variables d'environnement hrites par Tcl sont inchanges. -
Sur Macintosh, la variable d'environnement est construite par Tcl car aucune variable globale d'environnement n'existe. Les variable d'environnements qui sont cres par Tcl inclutnt: --
-
LOGIN -- Contient le nom Chooser du Macintosh. - -
USER -- Contient aussi le nom Chooser du Macintosh. -
SYS_FOLDER -- Le chemin du rpertoire systme. -
APPLE_M_FOLDER -- Le chemin du rpertoire du Menu Pomme. -
CP_FOLDER -- Le chemin du rpertoire du panneau de contrle. -
DESK_FOLDER -- Le chemin du rpertoire du bureau. -
EXT_FOLDER -- Le chemin du rpertoire d'extensions systme. -
PREF_FOLDER -- Le chemin du rpertoire des prferences. -
PRINT_MON_FOLDER -- Le chemin du rpertoire print monitor. -
SHARED_TRASH_FOLDER -- Le chemin du rpertoire de la corbeille rseau. -
TRASH_FOLDER -- Le chemin du rpertoire de la corbeille. -
START_UP_FOLDER -- Le chemin du rpertoire de dmarrage. -
PWD -- Le chemin du rpertoire par dfaut de l'application. -
Vous pouvez aussi crer votre propre variable d'environnement pour le Macintosh. Un fichier nomm Tcl Environment Variables peut tre plac dans le dossier prferences dans le dossier systme Mac. Chaque lignes de ce fichier seront de la forme VAR_NAME=var_data. -
La dernire alternative est de placer les variable d'environnements dans une resource 'STR#' nomme Tcl Environment Variables de l'application. Ceci est consider un peu plus "Mac like" qu'un fichier style Unix Environment Variable. Chaque entre dans la resource 'STR#' a le mme format que ci-dessous. Le fichier source tclMacEnv.c contient l'implmentation des mcanismes de env. Ce fichier contient de nombreux #define qui autorisent la customisation des mcanismes env pour les adapter aux besoins de votre applications. -
-
errorCode- Aprs une erreur, cette variable est fixe pour recevoir l'information supplmentaire au sujet de l'erreur sous une forme qui est facile traiter pour les programmes. errorCode consiste d'une liste Tcl avec un ou plusieurs lments. Le premier lment de la liste identifie une classe gnrale d'erreurs, et dtermine le format du reste de la liste. Les formats suivants pour errorCode sont utiliss par le noyau Tcl; les applications peuvent definir des formats supplmentaires.
-
-
-
- ARITH code msg
- Ce format est utilis quand une erreur arithmtique se produit (ex. une tentative de division par zro dans une commande expr). Code identifie l'erreur prcise et msg fournit une description comprhensible de l'erreur Code sera soit DIVZERO (pour une tentative de division par zro), DOMAIN (si un argument est en dehors du domaine d'une fonction, tel acos(-3)), IOVERFLOW (dbordement entier), OVERFLOW (dbordement flottant), ou UNKNOWN (si la cause de l'erreur ne peut pas tre dtermine). -
CHILDKILLED pid sigName msg -- Ce format est utilis quand un processus enfant a t tu cause d'un signal. Le second lment de errorCode sera l'identificateur de processus (en dcimal). Le troisime lment sera le nom symbolique du signal qui caus la fin du processus; il sera un des noms du fichier include signal.h, tel que SIGPIPE. Le quatrime lment sera un court message dcrivant le signal, tel que "write on pipe whith no readers" pour SIGPIPE. -
CHILDSTATUS pid code -- Ce format est utilis quand un processus enfant s'est termin avec un statut diffrent de zro Le second lment de errorCode sera l'identificateur de processus (en dcimal). et le troisime lment sera le code de fin renvoy par le processus (aussi en dcimal). -
CHILDSUSP pid sigName msg -- Ce format est utilis quand un processus enfant a t suspendu cause d'un signal. Le second lment de errorCode sera l'identificateur de processus (en dcimal).. Le troisime lment sera le nom symbolique du signal qui a caus la suspension du processus; ce sera un des noms du fichier include signal.h,, tel que SIGTTIN. Le quatrime lment sera sera un court message dcrivant le signal, tel que "background tty read" pour SIGTTIN. -
NONE -- Ce format est utilis pour les erreurs o aucune information supplmentaire n'est disponible pour une erreur en plus du message renvoy avec l'erreur Dans ces cas errorCode consistera en une liste contenant un seul lment dont le contenu sera NONE. -
- POSIX errName msg
- Si le premier lment de errorCode est POSIX, alors l'erreur s'est produite pendant un appel noyau POSIX. Le second lment de la liste contiendra le nom symbolique de l'erreur qui s'est produite, tel que ENOENT; ce sera une des valeurs dfinies dans le fichier include errno.h. Le troisime lment de la liste sera un message comprhensible correspondant errName, tel que "aucun fichier ou rpertoire" dans le cas de ENOENT.
Pour fixer errorCode, les applications devraient utiliser une fonction de bibliothque telle que Tcl_SetErrorCode et Tcl_PosixError, ou elles peuvent appeller la commande error. Si une de ces mthodes n'a pas t utilise, alors l'interprteur Tcl rinitialisera la variable NONE aprs l'erreur suivante. -
-
-
errorInfo- Aprs une erreur, cette chane contiendra une ou plusieurs lignes identifiant la commande Tcl et les fonctions qui taient excutes quand l'erreur la plus recente s'est produite. Son contenu prend la forme d'une trace de la pile montrant les commandes Tcl imbriques qui avait t appeles l'instant de l'erreur. -
tcl_library -- Cette variable contient le nom d'un rpertoire contenant les bibliothques systme de scripts Tcl, tel que celles utilises pour un auto-chargement. La valeur de cette variable est renvoy par la commande info library. Voir la page de manuel library pour les dtails des facilits fournies par la bibliothque de scripts Tcl. Normalement chaque application ou package aura sa propre bibliothque spcifique en plus de la bibliothque Tcl; chaque application devra fixer une variable globale avec un nom comme $app_library (o app est le nom de l'application) pour recevoir le nom de chemin rseau du rpertoire de la bibliothque de cette de l'application. La valeur initiale de tcl_library est fixe quand un interprteur est cr en cherchant plusieurs rpertoire diffrents jusqu'a ce qu'un soit trouv contenant un script de dmarrage appropri. Si la variable d'environnement TCL_LIBRARY existe, alors le rpertoire qu'elle indique est vrifi en premier. Si TCL_LIBRARY n'est pas fix ou ne se refre pas un rpertoire appropri, alors Tcl vrifie plusieurs autre rpertoires en se basant sur l'emplacement compil par dfaut, l'emplacement du binaire contenant l'application, et le rpertoire de travail courant. -
tcl_patchLevel -- Quand un interprteur est cr Tcl initialise cette variable pour recevoir une chane donnant le courant niveau de patch de Tcl, tel que 7.3p2 for Tcl 7.3 avec les deux premier patches officiels, ou 7.4b4 pour la quatrime release beta de Tcl 7.4. La valeur de cette variable est renvoy par la commande info patchlevel. -
tcl_pkgPath -- Cette variable contient une liste de rpertoires indiquant o les packages sont normalement installs. Elle n'est pas utilise sous Windows. Elle contient typiquement soit une ou deux entres; si elle contient deux entres, la premire est normalement un rpertoire pour les packages dependant de la plateforme (ex., bibliothques partages binaires) et le second est normalement un rpertoire pour les packages indpendants de la plateforme- (ex., fichiers script). Typiquement un package est install comme sous rpertoire d'une des entres de $tcl_pkgPath. Les rpertoires de $tcl_pkgPath sont inclus par dfaut dans la variable auto_path, donc eux et leurs sous-rpertoires immdiats sont automatiquement recherch pendant les commandes package require Note: tcl_pkgPath n'est pas conue pour tre modifie par les application. Sa valeur est ajoute auto_path au dmarrage; les changement dans tcl_pkgPath ne sont pas reflts dans auto_path. Si vous voulez que Tcl recherche les packages dans des rpertoires supplmentaires vous devrez ajouter leurs noms auto_path, pas tcl_pkgPath. -
tcl_platform -- Ceci est un tableau associatif dont les lments contiennent l'information concernant la plateforme sur laquelle l'application s'excute, tel que le nom du systme d'exploitation, son numro de release courant, et le jeu d'instruction de la machine Les lments lists ci-dessous seront toujours dfinis, mais ils peuvent avoir des chane vides comme valeurs si Tcl n'a pu rcuprer quelconque information en rapport De plus, les extensions et les applications peuvent ajouter des valeurs supplmentaires au tableau Les lments prdfinis sont:
-
-
-
- byteOrder
- L'ordre natif des octets de cette machine: soit littleEndian ou bigEndian -
debug -- Si cette variable existe, alors l'interprteur a t compil avec les symboles debuggage activs. Cette variable existe seulement sous Windows donc les programmeurs d'extension peuvent spcifier quel package charger, ceci dpendant de la bibliothque d'excution C qui est charge. -
machine -- Le jeu d'instruction excut par cette machine, tel que intel, PPC, 68k, ou sun4m Sur les machines UNIX, c'est la valeur renvoye par uname -m. -
-
os - - Le nom du systme d'exploitation excut sur cette machine, tel que Windows 95, Windows NT, MacOS, ou SunOS. Sur les machines UNIX, c'est la valeur renvoye par uname -s. Sur Windows 95 et Windows 98, la valeur renvoye sera Windows95 pour fournir une meilleure compatibilit ascendante avec Windows 95; pour distinguer entre les deux, vrifier osVersion. -
osVersion -- Le numro de version du systme d'exploitation excut sur cette machine. Sur les machines UNIX, c'est la valeur renvoye par uname -r Sur Windows 95, la version sera 4.0; sur Windows 98, la version sera 4.10. -
platform -- Soit windows, macintosh, ou unix. Identifie l'environnement de la machine. -
threaded -- Si cette variable existe, alors l'interprteur a t compil avec les threads activs. -
user -- Ceci identifie l'utilisateur courant bases sur l'information de login disponible sur la plateforme. Est tir de la variable d'environnement USER ou LOGNAME sous Unix, et de la valeur de GetUserName sous Windows et Macintosh. -
-
tcl_precision -- Cette variable contrle le nombre de chiffres gnrer pendant la conversion de valeurs flottantes en chanes Par dfaut de 12. 17 chiffres est "parfait" pour les flottants IEEE car il permet de convertir les valeurs double-prcision en chanes puis de revenir en binaire sans perte d'information Nanmoins, l'utilisation de 17 chiffres empche tout arrondi, et produit des rsultats plus long, et moins intuitifs Par exemple, expr 1.4 retourne 1.3999999999999999 avec tcl_precision fix 17, contre 1.4 si tcl_precision est 12. Tous les interprteurs dans un processus partagent une seule valeur tcl_precision: la changer pour un interprteur affectera tous les autres interprteurs. Nanmoins, les interprteur srs ne sont pas autoris modifier la variable. /DD> -
tcl_rcFileName -- Cette variable est utilise pendant l'initialisation pour indiquer le nom d'un fichier de dmarrage spcifique l'utilisateur. Si elle est fixe par l'initialisation spcifique l'application, alors le code Tcl de dmarrage vrifiera l'existence de ce fichier et le source s'il existe. Par exemple, pour wish la variable est fixe ~/.wishrc sous Unix et ~/wishrc.tcl sous Windows. -
tcl_rcRsrcName -- Cette variable est utilise seulement sur les systmes Macintosh. La variable est utilise pendant l'initialisation pour indiquer le nom d'une resource TEXT spcifique l'utilisateur localise dans les resource forks de l'application ou de l'extension. Si elle est fixe par l'initialisation spcifique l'application, alors le code Tcl de dmarrage vrifiera l'existence de cette resource et la source si elle existe. Par exemple, l'application Macintosh wish a la variable fixe tclshrc. -
tcl_traceCompile -- La valeur de cette variable peut tre fixe pour contrler combien d'information de traage est affiche pendant la compilation du bytecode. Par dfaut, tcl_traceCompile est zro et aucune information n'est affiche. Fixer tcl_traceCompile 1 gnre une ligne sur la sortie standard chaque fois qu'une fonction ou commande de premier niveau est compile. La fixer 2 gnre un listing dtaill sur la sortie standard des instructions bytecode mises pendant toute la compilation. Cette variable est utile pour rechercher des problmes suspects avec le compilateur Tcl. Elle est aussi parfois utile pour la conversion de code existant en Tcl8.0. -
tcl_traceExec -- La valeur de cette variable peut tre fixe pour contrler combien d'information de traage est affiche pendant l'excution du bytecode. Par dfaut, tcl_traceExec est zro et aucune information n'est affiche. Fixer tcl_traceExec 1 gnre une ligne sur la sortie standard chaque appel d'une fonction Tcl. La fixer 2 gnre une ligne de sortie chaque fois qu'une commande Tcl est appele, qui contient le nom de la commande et ses arguments. La fixer 3 produit une trace dtaille montrant le rsultat de l'excution chaque instruction bytecode. Notez que quand tcl_traceExec est 2 ou 3, les commandes tel que set et incr qui ont t entirement remplaces par une squence d'instructions bytecode ne sont pas montres. Fixer cette variable est utile pour rechercher des problmes suspects avec le compilateur et l'interprteur Tcl. Elle est aussi parfois utile pour la conversion de code existant en Tcl8.0. -
tcl_wordchars -- La valeur de cette variable est une expression rationelle qui peut tre fixe pour contrler ce qui est consider comme des caractres "mot", pour des utiisations comme la selection d'un mot par double-click dans le texte dans Tk. Il est dpendant de la plateforme. Sous Windows, il est par dfaut de \S, signifiant tout sauf le caractre espace Unicode Autrement il est par dfaut de \w, qui est tout caractre Unicode (nombre, lettre, ou underscore). -
tcl_nonwordchars -- La valeur de cette variable est une expression rationelle qui peut tre fixe pour contrler ce qui est consider comme des caractres "non-mot", pour des utilisations comme la selection d'un mot par double-click dans le texte dans Tk. Il est dpendant de la plateforme Sous Windows, il est par dfaut de \s, signifiant tout caractre espace Unicode Autrement il est par dfaut de \W, qui est tout sauf un caractre Unicode (nombre, lettre, ou underscore). -
tcl_version -- Quand un interprteur est cr Tcl initialise cette variable pour recevoir le numro de version de cette version de Tcl sous la forme x.y. Les changements de x reprsentent les changements majeurs avec probable incompatibilits et les changements de y reprsentent les petites amliorations et les corrections de bugs qui conservent une compatibilit ascendante. La valeur de cette variable est renvoy par la commande info tclversion -
-
-
- diff --git a/hlp/fr/tcl/tell.htm b/hlp/fr/tcl/tell.htm deleted file mode 100644 index a248c50..0000000 --- a/hlp/fr/tcl/tell.htm +++ /dev/null @@ -1,18 +0,0 @@ - -
tell Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/time.htm b/hlp/fr/tcl/time.htm deleted file mode 100644 index b34ecff..0000000 --- a/hlp/fr/tcl/time.htm +++ /dev/null @@ -1,19 +0,0 @@ - -
time Commandes Internes Tcl
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/trace.htm b/hlp/fr/tcl/trace.htm deleted file mode 100644 index ec70e44..0000000 --- a/hlp/fr/tcl/trace.htm +++ /dev/null @@ -1,44 +0,0 @@ - -
trace Commandes Internes Tcl
-
-
-
-
-
-
-
-
- trace variable name ops command
- Provoque l'xcution de la commande command chaque fois que la variable name est accde par un des moyens indiqu par ops. Name peut faire rfrence une variable simple, un lment d'un tableau , ou un tableau dans son entier (c'est dire que name peut juste tre le nom d'un tableau, sans parenthses d'index). Si name se rfre un tableau entier, alors command est appele pour chaque manipulation d'un lment du tableau. Si la variable n'existe pas, elle sera cre mais n'aura pas de valeur, donc elle sera visible par les requtes namespace which, mais pas par les requtes info exists.
-Ops indique quelles oprations sont suivies, et comprend une ou plusieurs des lettres suivantes: --
-
- r
- Appelle command chaque fois que la variable est lue. -
- w
- Appelle command chaque fois que la variable est crite. - -
- u
- Appelle command chaque fois que la variable est annule. Les variables peuvent tre annules explicitement avec la commande unset, ou implicitement la fin des procdures (toutes leurs variables locales sont annules). Les variables sont aussi annules quand des interprteurs sont dtruits, mais les commandes de trace ne seront pas appeles parce qu'il n'y aura pas d'interprteur pour les xcuter. - -
-Quand la trace se dclenche, trois arguments sont ajouts la fin de command , de telle sorte que la commande est rellement appele comme suit:
-command name1 name2 op
-Name1 et name2 donnent le(s) nom(s) pour la variable accde: si la variable est scalaire, alors name1 donne le nom de la variable et name2 est une chane vide; si la variable est un lment de tableau, name1 donne le nom du tableau et name2 l'index dans le tableau; si un tableau entier est dtruit et que la trace tait enregistre sur la totalit du tableau et non sur un seul lment, alors name1 donnera le nom du tableau et name2 une chane vide. Name1 et name2 ne sont pas ncessairement les mmes noms que celui utilis dans la commande trace variable: la commande upvar permet une procdure de rfrencer une variable sous un nom diffrent. Op indique quelle opration est effectue sur la variable, et est l'une des trois lettres r, w ou u qui sont dfinies plus haut.
-Command s'xcute dans le mme contexte que le code qui a appel l'opration trace: si la variable tait accde comme partie d'une procdure Tcl, alors command aura accs aux mmes variables locales que le code de la procdure. Ce contexte peut tre diffrent de celui dans lequel la trace a t cre. Si command appelle une procdure (ce qui est le cas normal) alors la procdure devra utiliser upvar ou uplevel si elle souhaite accder la variable trace. Noter aussi que name1 n'est pas ncessairement le mme que le nom utilis pour dfinir la trace sur la variable; des diffrences peuvent se produire si l'accs est fait au travers d'une variable dfinie par la commande upvar.
-Pour les traces en lecture et en criture, command peut changer la variable pour modifier le rsultat de l'opration trace. Si command modifie la valeur de la variable pendant une trace en lecture ou en criture, alors la nouvelle valeur sera retourne comme tant le rsultat de l'opration trace. La valeur de retour de command est ignore sauf dans le cas o elle retourne une erreur quelconque; dans ce cas l'opration trace renvoie aussi une erreur avec le mme message d'erreur que celui renvoy par la commande appele par trace (ce mcanisme peut tre utilis pour mettre en place des variables en lecture seule, par exemple). Pour les traces en criture, command est appele aprs que la valeur de la variable ait t change; elle peut crire une nouvelle valeur dans la variable pour forcer la valeur produite par l'opration d'criture. Pour mettre en place des variables en lecture seule, command aura charge de remettre l'ancienne valeur dans la variable.
-Pendant que command s'xcute durant une trace en lecture ou en criture, les traces sur la variable sont temporairement dsactives. Cela signifie que les lectures ou les critures appeles par command se produiront directement, sans invoquer command (ni aucune autre trace) une nouvelle fois. Cependant, si command annule la variable, les traces d'annulation seront appeles.
-Quand une trace d'annulation est appele, la variable a dj t dtruite: elle apparatra comme indfinie et ne possdant pas de traces. Si une annulation de variable se produit cause d'une fin de procdure, la trace sera appele dans le contexte de variables de la procdure appelante: le contexte de pile de la procdure qui s'est finie n'existera plus. Les traces ne seront pas dsactives pendant les traces d'annulation, donc si une commande de trace d'annulation cre une nouvelle trace et accde la variable correspondante, cette commande de trace sera appele. Les erreurs dans les traces d'annulation sont ignores.
-S'il y a plusieurs traces sur une variable elles seront appeles selon leur ordre de cration, les plus rcentes en premier. Si une trace renvoie une erreur, les traces suivantes portant sur la mme variable ne seront pas appeles. Si un lment de tableau a une trace positionne, et qu'il y a aussi une trace positionne sur le tableau dans son ensemble, la trace globale est appele avant celle qui porte sur l'lment seul.
-Une fois cre, la trace reste en effet jusqu' ce qu'elle soit retire au moyen de la commande trace vdelete dcrite ci-dessous, ou bien jusqu' ce que la variable soit annule, ou bien jusqu' ce que l'interprteur soit dtruit. L'annulation de l'lment d'un tableau retirera toutes les traces sur cet lment, mais ne retirera pas les traces sur l'ensemble du tableau.
-Cette commande retourne une chane vide. -
-
trace vdelete name ops command- S'il existe une trace positionne sur la variable name avec les oprations ops et la commande command, alors la trace est supprime, de telle sorte que command ne sera plus jamais appele. Retourne une chane vide. -
trace vinfo name- -Retourne une liste contenant un lment pour chaque trace positionne sur la variable name. Chaque lment de la liste est lui-mme une liste contenant deux lments, qui sont les ops et command associes la trace. Si name n'existe pas ou n'a aucune trace positionne, le rsultat de la commande sera une chane vide. - -
-
- diff --git a/hlp/fr/tcl/unknown.htm b/hlp/fr/tcl/unknown.htm deleted file mode 100644 index 38e84d8..0000000 --- a/hlp/fr/tcl/unknown.htm +++ /dev/null @@ -1,19 +0,0 @@ - -
unknown Commandes Internes Tcl
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/unset.htm b/hlp/fr/tcl/unset.htm deleted file mode 100644 index b9a00ba..0000000 --- a/hlp/fr/tcl/unset.htm +++ /dev/null @@ -1,17 +0,0 @@ - -
unset Commandes Internes Tcl
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/update.htm b/hlp/fr/tcl/update.htm deleted file mode 100644 index 7744b95..0000000 --- a/hlp/fr/tcl/update.htm +++ /dev/null @@ -1,21 +0,0 @@ - -
update Commandes Internes Tcl
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/uplevel.htm b/hlp/fr/tcl/uplevel.htm deleted file mode 100644 index 2d5178a..0000000 --- a/hlp/fr/tcl/uplevel.htm +++ /dev/null @@ -1,29 +0,0 @@ - -
uplevel Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/upvar.htm b/hlp/fr/tcl/upvar.htm deleted file mode 100644 index bfb9ffd..0000000 --- a/hlp/fr/tcl/upvar.htm +++ /dev/null @@ -1,44 +0,0 @@ - -
upvar Commandes Internes Tcl
-
-
-
-
-
-
- upvar $name x
- set x [expr $x+2]
-}
-
-
- puts $name
-}
-proc setByUpvar { name value } {
- upvar $name localVar
- set localVar $value
-}
-set originalVar 1
-trace variable originalVar w traceproc
-setByUpvar originalVar 2
-}
-
-
-
- diff --git a/hlp/fr/tcl/variable.htm b/hlp/fr/tcl/variable.htm deleted file mode 100644 index 3e1d84c..0000000 --- a/hlp/fr/tcl/variable.htm +++ /dev/null @@ -1,24 +0,0 @@ - -
variable Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/vwait.htm b/hlp/fr/tcl/vwait.htm deleted file mode 100644 index 326b59b..0000000 --- a/hlp/fr/tcl/vwait.htm +++ /dev/null @@ -1,20 +0,0 @@ - -
vwait Commandes Internes Tcl
-
-
-
-
-
-
-
-
-
- diff --git a/hlp/fr/tcl/while.htm b/hlp/fr/tcl/while.htm deleted file mode 100644 index 4cebde1..0000000 --- a/hlp/fr/tcl/while.htm +++ /dev/null @@ -1,23 +0,0 @@ - -
while Commandes Internes Tcl
-
-
-
-
-
-
-while {$x<10} {
- puts "x est $x"
- incr x
-}
-
- diff --git a/hlp/ru/bwidget/ArrowButton.html b/hlp/ru/bwidget/ArrowButton.html deleted file mode 100644 index 3969d3d..0000000 --- a/hlp/ru/bwidget/ArrowButton.html +++ /dev/null @@ -1,276 +0,0 @@ - -
- NAME -
- ArrowButton - - Button widget with an arrow shape. -
-
-
- CREATION -
- ArrowButton pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --activebackground -activeforeground - - - --background or -bg --borderwidth or -bd -- --disabledforeground -foreground or -fg - -- --highlightbackground -highlightcolor - - - --highlightthickness -relief - - - --repeatdelay -repeatinterval - - - --takefocus -troughcolor - -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --armcommand -arrowbd - - - --arrowrelief -clean - - - --command -dir - - - --disarmcommand -height - - - --helptext -helptype - - - --helpvar -ipadx - - - --ipady -state - - - --type -width - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName invoke - -
-DESCRIPTION
-
- -ArrowButton can be of two types following type option: -for button type, it is standard button with an arrow drawn on it; -for arrow type, it is an arrow like scrollbar's arrow. -
--WIDGET-SPECIFIC OPTIONS
-
- -armcommand -
- - -Specifies a Tcl command to associate with the ArrowButton when mouse button 1 is pressed -over the ArrowButton. When repeatdelay or repeatinterval option is positive -integer, this command is repeatedly called if mouse pointer is over the button and until -mouse button 1 is released. - -
- -arrowbd -
- - -When ArrowButton type is arrow, specifies the border width of the -arrow. Must be 1 or 2. - - -
- -arrowrelief -
- - -When ArrowButton type is arrow, specifies the relief of the arrow. -Must be raised or sunken. - - -
- -clean -
- - -Specifies a level of quality, between 0 and 2, for the arrow. -If 0, the arrow is drawn with its maximum width and height. -If 1, the base of arrow is arranged to be odd to have same edges. -If 2, the base of arrow is arranged to be odd and the orthogonal to be (base+1)/2 to -have 'straight' diagonal for edges. - -
- -command -
- - -Specifies a Tcl command to associate with the ArrowButton. This command -is typically invoked when mouse button 1 is released over the ArrowButton -window. - -
- -dir -
- - -Specifies the direction of the arrow: top, bottom, left -or right. - -
- -disarmcommand -
- - -Specifies a Tcl command to associate with the ArrowButton when mouse button 1 is released. -This command is called even if pointer is not over the ArrowButton, and always before -the command specified by command option. -It is typically used in conjuntion with armcommand, repeatdelay and -repeatinterval. - -
- -height -
- - -Specifies a desired height for the ArrowButton. The value is in screen units. - -
- -helptext -
- - -Text for dynamic help. If empty, no help is available for this widget. -See also DynamicHelp. - -
- -helptype -
- -Type of dynamic help. Use balloon or variable. -See also DynamicHelp. - -
- -helpvar -
- -Variable to use when helptype option is variable. -See also DynamicHelp. - -
- -ipadx -
- - -Specifies a minimun pad between the ArrowButton border and the right and left side -of the arrow. The value is in screen units. - -
- -ipady -
- - -Specifies a minimun pad between the ArrowButton border and the top and bottom side -of the arrow. The value is in screen units. - -
- -state -
-
-
-Specifies one of three states for the ArrowButton: normal, active,
-or disabled.
-
- If ArrowButton type is button: -
- In normal state the ArrowButton is displayed using the -foreground and background options. The active state is -typically used when the pointer is over the ArrowButton. In active state -the ArrowButton is displayed using the activeforeground and -activebackground options. In disabled state the disabledforeground and -background options determine how the ArrowButton is displayed. - -
- If ArrowButton type is arrow: -
- Only colors of arrow change. The background of ArrowButton is always -displayed using troughcolor option. -In normal state the ArrowButton is displayed using the background option. The active -state is typically used when the pointer is over the ArrowButton. In active state -the ArrowButton is displayed using the activebackground option. In disabled state -the ArrowButton is displayed with a dark stipple. - -
-
- -type -
- - -Determines the type of the ArrowButton: button for standard button look, or -arrow scrollbar's arrow look. - -
- -width -
- - -Specifies a desired width for the ArrowButton. The value is in screen units. - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName invoke -
-
-
-If ArrowButton state is not disabled, this invoke the commands of the button.
-ArrowButton is redisplayed with active color and sunken relief, and
-armcommand is called. Then ArrowButton is redisplayed with
-normal color and its defined relief, and disarmcommand then command
-are called.
-
invoke is called when ArrowButton has input focus and user press the space bar. -
- NAME -
- BWidget - - Description text -
-
-
- COMMAND -
- BWidget::XLFDfont - cmd - ?arg...? - -
- BWidget::assert - exp - ?msg? - -
- BWidget::clonename - menu - -
- BWidget::focus - option - path - -
- BWidget::get3dcolor - path - bgcolor - -
- BWidget::getname - name - -
- BWidget::grab - option - path - -
- BWidget::lreorder - list - neworder - -
- BWidget::parsetext - text - -
- BWidget::place - path - w - h - ?arg...? - -
-DESCRIPTION
-
-Description text -
--COMMAND
-
- BWidget::XLFDfont - cmd - ?arg...? -
- -Description text -
- BWidget::assert - exp - ?msg? -
- -Description text -
- BWidget::clonename - menu -
- -Description text -
- BWidget::focus - option - path -
- -Description text -
- BWidget::get3dcolor - path - bgcolor -
- -Description text -
- BWidget::getname - name -
- -Description text -
- BWidget::grab - option - path -
- -Description text -
- BWidget::lreorder - list - neworder -
- -Description text -
- BWidget::parsetext - text -
- -Description text -
- BWidget::place - path - w - h - ?arg...? -
- -Description text -
- NAME -
- Button - - Button widget with enhanced options -
-
-
- CREATION -
- Button pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --activebackground -activeforeground - - - --anchor -background or -bg - -- --bitmap -borderwidth or -bd - -- --cursor -disabledforeground - - - --font -foreground or -fg - -- --highlightbackground -highlightcolor - - - --highlightthickness -image - - - --justify -padx - - - --pady -repeatdelay - - - --repeatinterval -takefocus - - - --text -textvariable - - - --wraplength
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --armcommand -command - - - --default -disarmcommand - - - --height -helptext - - - --helptype -helpvar - - - --name -relief - - - --state -underline - - - --width
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName invoke - -
-DESCRIPTION
-
- -Button widget extends the Tk button with new options. -DynamicHelp options, -a new relief style, callback for arm/disarm, and -repeatdelay/repeatinterval options has been added. -
--WIDGET-SPECIFIC OPTIONS
-
- -armcommand -
- - -Specifies a Tcl command to associate with the Button when mouse button 1 is pressed over the -Button. When repeatdelay or repeatinterval option is positive integer, -this command is repeatedly called if mouse pointer is over the Button and until mouse -button 1 is released. - -
- -command -
- - -Specifies a Tcl command to associate with the Button. This command -is typically invoked when mouse button 1 is released over the Button -window. - -
- -default -
- - -Specifies one of three states for the default ring: normal, active, -or disabled. In active state, the button is drawn with the platform specific -appearance for a default button. In normal state, the button is drawn with the platform -specific appearance for a non-default button, leaving enough space to draw the default -button appearance. The normal and active states will result in buttons of the same size. -In disabled state, the button is drawn with the non-default button appearance without -leaving space for the default appearance. The disabled state may result -in a smaller button than the active state. - -
- -disarmcommand -
- - -Specifies a Tcl command to associate with the Button when mouse button 1 is released. -This command is called even if pointer is not over the Button, and always before -the command specified by command option. -It is typically used in conjuntion with armcommand, repeatdelay and -repeatinterval. - -
- -height -
- - -Specifies a desired height for the Button. -If an image or bitmap is being displayed in the Button then the value is in -screen units; -for text it is in lines of text. -If this option isn't specified, the Button's desired height is computed -from the size of the image or bitmap or text being displayed in it. - -
- -helptext -
- - -Text for dynamic help. If empty, no help is available for this widget. -See also DynamicHelp. - -
- -helptype -
- -Type of dynamic help. Use balloon or variable. -See also DynamicHelp. - -
- -helpvar -
- -Variable to use when helptype option is variable. -See also DynamicHelp. - -
- -name -
- - -Specifies a standard name for the button. If the option *nameName is -found in the resources database, then text and underline options -are extracted from its value. - - -
- -relief -
- - -Specifies the 3-D effect desired for the widget. Acceptable values are standard values for -button relief (raised, sunken, flat, ridge, solid, and groove) and link, which specifies that button relief is flat when pointer -is outside the button and raised when pointer is inside. - -
- -state -
- - -Specifies one of three states for the Button: normal, active, -or disabled. In normal state the Button is displayed using the -foreground and background options. The active state is -typically used when the pointer is over the Button. In active state -the Button is displayed using the activeforeground and -activebackground options. Disabled state means that the Button -should be insensitive: the default bindings will refuse to activate -the widget and will ignore mouse button presses. -In this state the disabledforeground and -background options determine how the Button is displayed. - -
- -underline -
-
-
-Specifies the integer index of a character to underline in the label of the button.
-0 corresponds to the first character of the text displayed, 1 to the next character,
-and so on.
-
The binding <Alt-char> is automatically set on the toplevel -of the Button to call Button::setfocus. - -
-
- -width -
- - -If an image or bitmap is being displayed in the Button then the value is in -screen units; -for text it is in characters. -If this option isn't specified, the Button's desired width is computed -from the size of the image or bitmap or text being displayed in it. - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName invoke -
-
-
-If Button state is not disabled, this invoke the commands of the Button.
-Button is redisplayed with active color and sunken relief, and
-armcommand is called. Then Button is redisplayed with
-normal color and its defined relief, and disarmcommand then command
-are called.
-
invoke is called when Button has input focus and user press the space bar. -
- NAME -
- ButtonBox - - Set of buttons with horizontal or vertical layout -
-
-
- CREATION -
- ButtonBox pathName ?option value...? -
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- - --background or -bg --default - --homogeneous -orient - - - --padx -pady - - - --spacing
-
-
-
- WIDGET COMMAND -
- pathName add - ?option value...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName index - index - -
- pathName invoke - index - -
- pathName itemcget - index - option - -
- pathName itemconfigure - index - ?option? ?value option value ...? - -
- pathName setfocus - index - -
-DESCRIPTION
-
- -ButtonBox layouts Button horizontally or vertically. -Some commands take an index as argument indicating on which -Button it work. This index may be specified in any of the following forms: -
-
-
-
- -number -
- -Specifies the Button numerically, where 0 corresponds -to the first added Button, 1 to the next, and so on. -
- -end or last -
- -Indicates the last item added. -
- default -
- -Indicates the default Button. -
-WIDGET-SPECIFIC OPTIONS
-
- -background -
- - -Specifies a default background color for all added buttons and for the frame. - - -
- -default -
-
-
-Specifies the default button of the button box. The value is an integer
-referencing the n-th added button, starting from 0.
-If this value is -1 (the default), all button wil be drawn with their -default
-option set to disabled, and this value can not be changed.
If this value is -not -1, the associated button is drawn with -default option set to active and -the others are drawn with -default option set to normal. The value can be changed -by configure. - -
-
- -homogeneous (read-only) -
- - -Specifies wether or not buttons must have the same width for horizontal layout. - - -
- -orient (read-only) -
- - -Specifies the orientation of the button box. If this option is horizontal -(the default), buttons are added from top to bottom. -If this option is vertical, buttons are added from left to right. - - -
- -padx -
- - -Specifies a default value for the -padx option of all added buttons. - - -
- -pady -
- - -Specifies a default value for the -pady option of all added buttons. - - -
- -spacing -
- - -Specifies the default spacing between buttons. This value can be changed before each -call to add. - - -
-WIDGET COMMAND
-
- pathName add - ?option value...? -
-
-
-Add a button to the button box.
-
-See Button for description of options. -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName index - index -
- - -Return the numerical index corresponding to the item. - -
- pathName invoke - index -
- - -Invoke the Button given by index. - -
- pathName itemcget - index - option -
- - -Returns the current value of a configuration option for the item. -Option may have any of the values accepted by the item creation command. - -
- pathName itemconfigure - index - ?option? ?value option value ...? -
- - -This command is similar to the configure command, except that it applies to the -options for an individual item, whereas configure applies to the options for -the widget as a whole. Options may have any of the values accepted by the -item creation widget command. If options are specified, options are modified as indicated -in the command and the command returns an empty string. If no options are specified, -returns a list describing the current options for the item. -Read-only options are not be modified. - -
- pathName setfocus - index -
- - -Set the focus to the Button given by index. - -
- NAME -
- ComboBox - - ComboBox widget -
-
-
- CREATION -
- ComboBox pathName ?option value...? -
-
-
- OPTIONS from ArrowButton -
-
- --background or -bg --disabledforeground -- --foreground or -fg --state -
-
-
-
- OPTIONS from Entry -
-
- --command --disabledforeground -- --dragenabled --dragendcmd -- --dragevent --draginitcmd -- --dragtype --dropcmd -- --dropenabled --dropovercmd -- --droptypes --editable -- --entrybg (see -background) --entryfg (see -foreground) -- --exportselection --font -- --helptext --helptype -- --helpvar --highlightbackground -- --highlightcolor --highlightthickness -- --insertbackground --insertborderwidth -- --insertofftime --insertontime -- --insertwidth --justify -- --selectbackground --selectborderwidth -- --selectforeground --show -- --state --takefocus -- --text --textvariable -- --width --xscrollcommand -
-
-
-
- OPTIONS from LabelFrame -
-
- --background or -bg --borderwidth or -bd -- --disabledforeground --foreground or -fg -- --helptext --helptype -- --helpvar --label (see -text) -- --labelanchor (see -anchor) --labelfont (see -font) -- --labelheight (see -height) --labeljustify (see -justify) -- --labelwidth (see -width) --name -- --padx --pady -- --relief --side -- --state --underline -- -wraplength -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --height -modifycmd - - - --postcommand -values - -
-
-
-
- WIDGET COMMAND -
- pathName bind - ?arg...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getvalue - -
- pathName setvalue - index - -
-DESCRIPTION
-
-
-ComboBox widget enables the user to select a value among a list given by the values option.
-The list of possible values can be popped by pressing the ArrowButton or by clicking in the entry
-when editable value of the ComboBox is false.
-If editable value of the ComboBox is true and the entry has the focus, the user can
-press the top and bottom arrow keys to modify its value. If the current value exactly match a value in the list,
-then the previous (for top arrow key) or then next (for bottom arrow key) value in the list is displayed.
-If the current value match the beginning of a value in the list, then this value is displayed.
-If the current value doesnt match anything, then the first value is displayed.
-
-
-WIDGET-SPECIFIC OPTIONS
-
- -height -
- - -Specifies the desired height for the window, in lines. If zero or less, then the desired -height for the window is made just large enough to hold all the elements in the listbox. - -
- -modifycmd -
- - -Specifies a Tcl command called when the user modify the value of the ComboBox by selecting it in the listbox or pressing arrow key. - -
- -postcommand -
- - -Specifies a Tcl command called before the listbox of the ComboBox is mapped. - -
- -values -
- - -Specifies the values to display in the listbox of the ComboBox. - -
-WIDGET COMMAND
-
- pathName bind - ?arg...? -
- - -Set bindings on the entry widget. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getvalue -
- - -Returns the index of the current text of the ComboBox in the list of values, -or -1 if it doesn't match any value. - -
- pathName setvalue - index -
-
-
-Set the text of the ComboBox to the value indicated by index in the list of values.
-index may be specified in any of the following forms:
-
-
-
-
- -last -
- -Specifies the last element of the list of values. -
- first -
- -Specifies the first element of the list of values. -
- -next -
- -Specifies the element following the current (ie returned by getvalue) in the list -of values. -
- previous -
- -Specifies the element preceding the current (ie returned by getvalue) in the list -of values. -
- -@number -
- -Specifies the integer index in the list of values. -
BINDINGS
- -When Entry of the ComboBox has the input focus, it has the following bindings, in addition -to the default Entry bindings: -
-
-
- Page up set the value of the ComboBox to the first value. -
- Page down set the value of the ComboBox to the last value. -
- Arrow up set the value of the ComboBox to the previous value. -
- Arrow down set the value of the ComboBox to the next value. -
- NAME -
- Dialog - - Dialog abstraction with custom buttons -
-
-
- CREATION -
- Dialog pathName ?option value...? -
-
-
- OPTIONS from ButtonBox -
-
- --background or -bg --homogeneous -- --padx --pady -- -spacing -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --anchor -bitmap - - - --cancel -default - - - --image -modal - - - --parent -separator - - - --side -title - -
-
-
-
- WIDGET COMMAND -
- pathName add - ?arg...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName draw - ?focus? - -
- pathName enddialog - result - -
- pathName getframe - -
- pathName invoke - index - -
- pathName itemcget - index - option - -
- pathName itemconfigure - index - ?option? ?value option value ...? - -
- pathName setfocus - index - -
- pathName withdraw - -
-DESCRIPTION
-
- -Dialog widget enables the user to create a dialog box. -Some commands take an index as argument indicating on which -Button it work. This index is the same specified for equivalent ButtonBox command: -
-
-
-
- -number -
- -Specifies the Button numerically, where 0 corresponds -to the first added Button, 1 to the next, and so on. -
- -end or last -
- -Indicates the last item added. -
- default -
- -Indicates the default Button. -
-WIDGET-SPECIFIC OPTIONS
-
- -anchor (read-only) -
- - -Specifies the anchor point of the ButtonBox. -Must be one of w, e, n, s or c. -If side option is set to top or bottom, -anchor values n, s and c have the same effect. -If side option is set to left or right, -anchor values w, e and c have the same effect. - - -
- -bitmap (read-only) -
- - -Specifies a bitmap to display at the left of the user frame. -image option override bitmap. - -
- -cancel -
- - -Specifies the number of the cancel button of the Dialog. When user press Esc in the Dialog, -this button is invoked. - -
- -default -
- - -Specifies the number of the default button of the Dialog. -When user press Return in the Dialog, this button is invoked. - -
- -image (read-only) -
- - -Specifies an image to display at the left of the user frame. -image option override bitmap. - -
- -modal -
- - -This option must be none, local or global. The value of this option -specifies the grab mode of the dialog and how works Dialog::draw. - - -
- -parent -
- - -Parent of the Dialog. Dialog is centered in its parent. If empty, it is centered in -root window. - -
- -separator (read-only) -
- - -Specifies wether or not to draw a separator between the user frame and the ButtonBox. - - -
- -side (read-only) -
- - -Specifies where to draw the ButtonBox relative to the user frame. Must be one of -top, left, bottom or right. - -
- -title -
- - -Title of the Dialog toplevel. - - -
-WIDGET COMMAND
-
- pathName add - ?arg...? -
- - -Add a button to the button box of the dialog box. Default -command option is -Dialog::enddialog $path index where index is number of button added. -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName draw - ?focus? -
-
-
-This command draw the Dialog, and set grab to it following modal option.
-If modal option is set to none, the command returns immediatly
-an empty string. In all other case, the command returns when Dialog::enddialog
-is called or when Dialog is destroyed.
-The return value is the result argument of Dialog::enddialog or -1 if it is destroyed.
-
-By default, the focus is set to the default button referenced by default option, -or to the toplevel of Dialog if no default button has been set. -If focus is present, it must be a pathname, or an index to a button. -Initial focus is set on this pathname or corresponding button. - -
- pathName enddialog - result -
- - -This command is typically called within a command of a button to make Dialog::draw -return. - -
- pathName getframe -
- - -Returns the pathname of the user window. -
- pathName invoke - index -
- - -Invoke the Button given by index. - -
- pathName itemcget - index - option -
- - -Returns the current value of a configuration option for the item. -Option may have any of the values accepted by the item creation command. - -
- pathName itemconfigure - index - ?option? ?value option value ...? -
- - -This command is similar to the configure command, except that it applies to the -options for an individual item, whereas configure applies to the options for -the widget as a whole. Options may have any of the values accepted by the -item creation widget command. If options are specified, options are modified as indicated -in the command and the command returns an empty string. If no options are specified, -returns a list describing the current options for the item. -Read-only options are not be modified. - -
- pathName setfocus - index -
- - -Set the focus to the Button given by index. - -
- pathName withdraw -
- - -Call this command to hide the dialog box. - -
- NAME -
- DragSite - - Commands set for Drag facilities -
-
-
- COMMAND -
- DragSite::include - class - type - event - -
- DragSite::register - path - ?option value...? - -
- DragSite::setdrag - path - subpath - initcmd - endcmd - ?force? - -
-DESCRIPTION
-
- -Commands of this namespace enable user to define a BWidget or a Tk widget as a drag site. - - - -
--COMMAND
-
- DragSite::include - class - type - event -
-
-
-This command provides a simple way to include options relatives to a drag site into
-BWidget resources definition.
-It includes the options needed for register: -dragevent, initialized to
-event, -draginitcmd and -dragendcmd, initialized to empty string,
-and two new options:
-
-
- --dragenabled Specifies wether or not drag is active (initialized to 0) - -dragtype Default or alternate dragged data type (initialized to type) -
- DragSite::register - path - ?option value...? -
-
-
-This command is used to declare path as a drag site. Options are:
-
-
-
- -dragendcmd -
-
-
-Command called when drag terminates (ie when user release drag icon).
-This command is called with the following arguments:
-
-
-
- the pathname of the drag source (the widget itself), -
- the pathname of the drop target, -
- the operation, -
- the type of the dragged data, -
- the dragged data, -
- result of the drop (result of the call to -dropcmd of the target), -
-
- -dragevent -
- - -Specifies the number of the mouse button associated to the drag. -Must be 1, 2 or 3. - - -
- -draginitcmd -
-
-
-Command called when drag initiates. When the event of option dragevent occurs on
-path, this command is called with the following arguments:
-
-
-
- pathname of the drag source (path), -
- root x-coordinate of pointer, -
- root y-coordinate of pointer, -
- a toplevel created to represent dragged data. When returning, if it -has no children, a bitmap is automatically displayed. -
-
-
- the type of the data, -
- the list of acceptable basic operations (copy, move and link) -
- and the data. -
-
- DragSite::setdrag - path - subpath - initcmd - endcmd - ?force? -
-
-
-This command provides a simple way to call register during a BWidget creation or
-configuration.
-
-
-
- path is the pathname of the BWidget, -
- subpath is the pathname of the tk widget where drag event occurs, -
- initcmd BWidget command for drag-init event, -
- endcmd BWidget command for drag-end event, -
- force specifies wether or not to call register whenever no option value has -changed (0 by default - for BWidget configuration, use 1 for BWidget creation). -
- NAME -
- DropSite - - Commands set for Drop facilities -
-
-
- COMMAND -
- DropSite::include - class - types - -
- DropSite::register - path - ?option value...? - -
- DropSite::setcursor - cursor - -
- DropSite::setdrop - path - subpath - dropover - drop - ?force? - -
- DropSite::setoperation - op - -
-DESCRIPTION
-
- -Commands of this namespace enable user to define a BWidget or a Tk widget as a drop site. -A drop site is composed of the type of object that can be dropped and associated operation, -a command called when drop occurs, and a command when an object is dragged over the widget. -A drop site must have at least one type of acceptable object and a drop command. - -
--COMMAND
-
- DropSite::include - class - types -
-
-
-This command provides a simple way to include options relatives to a drop site into
-BWidget resources definition.
-It includes the options needed for register, -dropovercmd and -dropcmd,
-initialized to empty string, and -droptypes, initialized to types,
-and one new option:
-
-
- --dropenabled Specifies wether or not drop is active (initialized to 0) -
- DropSite::register - path - ?option value...? -
-
-
-This command is used to declare path as a drop site. Options are:
-
-
-
- -dropcmd -
- - -This command is called when user release the drag icon over a valid drop target widget. -It takes the same arguments as -dragovercmd command. Its return values is passed -as a result to the -dragendcmd command of the drag source widget. - - -
- -dropovercmd -
-
-
-This command can be used to provide a dynamic drag while drag-over events.
-While a drag occurs, events <Enter>, <Motion> and <Leave> are catched.
-Arguments passed to the command are:
-
-
-
- pathname of the drop target (the widget itself), -
- pathname of the drag source, -
- event over the drop target: enter, motion or leave, -
- root x-coordinate of the pointer, -
- root y-coordinate of the pointer, -
- operation, -
- type of the dragged data, -
- dragged data. -
-
-
- 0 if widget refuse this drag. Command will not be recalled on motion/leave event. -
- 1 if widget accept this drag. Command will not be recalled on motion/leave event. -
- 2 if widget refuse this drag. Command will be recalled on each motion event to reevaluate. -
- 3 if widget accept this drag. Command will be recalled on each motion event to reevaluate. - -
- --
-- -Event
- -Old status
- -Action
- -New status
- -<Enter>
- --
- -if DropSite has dropovercmd, call it with enter
- -result of dropovercmd
- -else
- -1
- -<Motion>
- -0 or 1
- -unchanged
- -2 or 3
- -call dropovercmd with motion
- -result of dropovercmd
- -<Leave>
-- -0 or 1
- --
- -2 or 3
- -call dropovercmd with leave
- --
- -<Drop>
- -0
- -call dragendcmd of drag source
- --
- -1
- -call dropcmd and call dragendcmd of drag source
- -2
- -call dropovercmd with leave and call dragendcmd of drag source
- -3
- -call dropcmd and call dragendcmd of drag source
- -
-
- -droptypes -
-
-
-Specifies a list {type oplist ?type oplist? ...} of acceptable
-types and associated operations for the drop target.
-For each type, oplist is a list
-{descops mod ?descops mod? ...} describing operations and
-modifier keys for these operations.
-descops describe an operation. It can be a predefined operations (copy,
-move or link) or a new user defined operation, of the form {subop
-baseop ?bitmap?}.
-subop is the name given to the sub operation, baseop is the name of the
-base operation (copy, move or link) and bitmap is a bitmap
-to display for the operation.
-
If bitmap is empty, the default bitmap of the base operation is used for the -sub operation. -
subop can be a base operation, in order to change the bitmap of a base operation. -In this case, baseop must be empty or equal to subop. -
mod is the modifer key for the operation. It can be: --
-
- none to specify that no modifier key is pressed. This modifier can only be used -with a sub operation named default (and vice versa), which has the behaviour of not -display any bitmap operation. For all type, if the modifier none is not given, it is -automatically associated to the default sub operation of a copy base operation. -
- program to specifies a sub operation accessible only by DropSite::setoperation. -
- A list combining shift, control and alt, which means their -corresponding key. -
-
- DropSite::setcursor - cursor -
- - -This command can be used within the script dragovercmd. It is usefull to provide -visual effect about the state of the drag. -
- DropSite::setdrop - path - subpath - dropover - drop - ?force? -
-
-
-This command provides a simple way to call register during a BWidget creation or
-configuration.
-
-
-
- path is the pathname of the BWidget, -
- subpath is the pathname of the tk widget where drag event occurs, -
- dropover is a command for drag-over event, -
- drop is a command for drop event, -
- force specifies wether or not to call register whenever no option value -has changed (0 by default - for BWidget configuration, use 1 for BWidget creation). -
- DropSite::setoperation - op -
- -Description text -
- NAME -
- DynamicHelp - - Provide help to Tk widget or BWidget -
-
-
- COMMAND -
- DynamicHelp::configure - ?option? ?value option value ...? - -
- DynamicHelp::include - class - type - -
- DynamicHelp::register - path - type - ?arg...? - -
- DynamicHelp::sethelp - path - subpath - ?force? - -
-DESCRIPTION
-
-Description text -
--COMMAND
-
- DynamicHelp::configure - ?option? ?value option value ...? -
-
-This command configure the ballon help.
-
-
- -borderwidth -
- -Width of the black border around the balloon. - -
- -delay -
- -Define the delay in millisecond of mouse inactivity before displaying -the balloon. - -
Other standard options are: --
- - --background or -bg --font - - --foreground or -fg --justify
- DynamicHelp::include - class - type -
- -Description text -
- DynamicHelp::register - path - type - ?arg...? -
-
-Register a help text to the widget path.
-type determines the type of the help or the type of the widget.
-Depending on type, other options must be provided.
-
--
-type options balloon text variable varName text menu varName menuentry index text
If one of the option is missing or is empty, help is removed for this widget. -
For type other than balloon, varName is typically a variable -linked to a label. -
For menu, balloon type help is not available. To declare a help for menu, -you first declare the menu, and then entries of this menu. -
For example: -
-- --
- # create menu -menu .m -type menubar -# associate menubar to toplevel BEFORE DynamicHelp::register -# to make it works with menu clone name -. configure -menu .m -.m add cascade -label "File" -menu .m.file -menu .m.file -.m.file add command -label "Open..." -.m.file add command -label "Quit" -# create label for help, using variable varinfo -label .l -textvariable varinfo -# associate all entries of menu .m.file to variable varinfo -DynamicHelp::register .m.file menu varinfo -# then declare entries of .m.file -DynamicHelp::register .m.file menuentry 0 "Detach menu" -DynamicHelp::register .m.file menuentry 1 "Open a file" -DynamicHelp::register .m.file menuentry 2 "Exit demo" -
-
Notice that if popup menu is owned by a menubar, you must associate first the menubar -to its toplevel. In this case, when you create a menu popup, its clone window is also -created, and DynamicHelp::register detects the exitence of the clone window and maps -events to it. -
- DynamicHelp::sethelp - path - subpath - ?force? -
- -Description text -
- NAME -
- Entry - - Entry widget with state option, dynamic help and drag and drop facilities -
-
-
- CREATION -
- Entry pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- --disabledforeground -exportselection - - - --font -foreground or -fg - -- --highlightbackground -highlightcolor - - - --highlightthickness -insertbackground - - - --insertborderwidth -insertofftime - - - --insertontime -insertwidth - - - --justify -relief - - - --selectbackground -selectborderwidth - - - --selectforeground -takefocus - - - --text -textvariable - - - --xscrollcommand
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --command -dragenabled - - - --dragendcmd -dragevent - - - --draginitcmd -dragtype - - - --dropcmd -dropenabled - - - --dropovercmd -droptypes - - - --editable -helptext - - - --helptype -helpvar - - - --show -state - - - --width
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName invoke - -
-DESCRIPTION
-
-
-The Entry widget extends the default Tk entry. Options have been added to provide
-visual effect depending on the state of the Entry,
-DynamicHelp options,
-and Drag and
-Drop.
-Entry behaves much like a Label, with text option to set its contents.
-
Tk entry command can also be used on Entry widget.
-
-
-WIDGET-SPECIFIC OPTIONS
-
- -command -
- - -Specifies a command when user press <Return> in the Entry. - -
- -dragenabled -
- -A boolean specifying if drag is enabled. - -
- -dragendcmd -
-
-
-Specifies a command to be called when drag ended.
-dragendcmd must be a command conforming to the description of the
-option dragendcmd of DragSite::register.
-
-
If dragendcmd is empty, the internal dragend command updates the entry -following the operation (move or copy) and the dragged data -(whole or selected part of the entry). - -
-
- -dragevent -
- - -Specifies the number of the mouse button associated to the drag. -Must be 1, 2 or 3. - - -
- -draginitcmd -
-
-
-Specifies a command to be called when dragevent occurs on widget.
-draginitcmd must be a command conforming to the description of the
-option draginitcmd of DragSite::register.
-
-
if draginitcmd is empty, the command refuse the drag if entry is empty or if -portion of text is selected and event doesn't occur above the selection. In all other cases, -the command returns: --
-
- as the data type, the value of option dragtype or TEXT if empty, -
- as the operations, {copy move} if state is normal and editable -is true, or {copy} only in other cases, -
- as the data, the whole content or the selected portion of the entry. -
-
- -dragtype -
- - -Specifies an alternate type of dragged object. - - -
- -dropcmd -
-
-
-Entry has a command wrapper for drop events. This command stops auto scrolling
-and extract current position.
-
If dropcmd is not empty, it is called with the following arguments: --
-
- the pathname of the Entry, -
- the pathname of the drag source, -
- the numeric index in the entry designated by the cursor, -
- the current operation, -
- the data type, -
- the data. -
-
COLOR or FGCOLOR -reconfigure the foreground of the Entry -BGCOLOR -reconfigure the background of the Entry -TEXT, -
or any other tagreconfigure the Entry to display the associated string. -
-
- -dropenabled -
- -A boolean specifying if drop is enabled. - -
- -dropovercmd -
-
-
-Entry has a command wrapper for drag-over events. This command enables auto scrolling
-and position extraction during the drag-over.
-
If dropovercmd is empty, the wrapper accepts the drop if editable option is -true and state option is normal. -
If dropovercmd is not empty, it is called with the following arguments: --
-
- the pathname of the Entry, -
- the pathname of the drag source, -
- the event, -
- the numeric index in the entry designated by the cursor, -
- the current operation, -
- the data type, -
- the data. -
-
- -droptypes -
- - -Specifies a list of accepted dropped object/operation. -See option droptypes of -DropSite::register. -for more infromation. - -Default accepts FGCOLOR, COLOR, BGCOLOR and TEXT, -all with copy and move operations. - - -
- -editable -
- - -Specifies whether the Entry is editable by the user. Equivalent to the state option -of the Tk entry widget. - -
- -helptext -
- - -Text for dynamic help. If empty, no help is available for this widget. -See also DynamicHelp. - -
- -helptype -
- -Type of dynamic help. Use balloon or variable. -See also DynamicHelp. - -
- -helpvar -
- -Variable to use when helptype option is variable. -See also DynamicHelp. - -
- -show -
- - -If this option is specified, then the true contents of the entry are not displayed in the -window. Instead, each character in the entry's value will be displayed as the first character -in the value of this option, such as ``*''. This is useful, for example, if the entry is to -be used to enter a password. If characters in the entry are selected and copied elsewhere, the -information copied will be what is displayed, not the true contents of the entry. - -
- -state -
- - -Specifies one of two states for the Entry: normal or disabled. -In normal state the text of the Entry is displayed using the foreground option. -In disabled state the text of the Entry is displayed using the disabledforeground -option. If the entry is disabled then the value may not be changed by user input -and no insertion cursor will be displayed, even if the input focus is in the widget. -Disabled state is the same as not editable with visual effect. - -
- -width -
- - -Specifies an integer value indicating the desired width of the entry window, in average-size -characters of the widget's font. If the value is less than or equal to zero, the widget picks -a size just large enough to hold its current text. - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName invoke -
- - -Calls the command specified by the option -command. - -
- NAME -
- Label - - Label widget with state option, dynamic help and drag and drop facilities -
-
-
- CREATION -
- Label pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --anchor -background or -bg - -- --bitmap -borderwidth or -bd - -- --cursor -disabledforeground - - - --font -foreground or -fg - -- --highlightbackground -highlightcolor - - - --highlightthickness -image - - - --justify -padx - - - --pady -relief - - - --takefocus -text - - - --textvariable -wraplength - -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --dragenabled -dragendcmd - - - --dragevent -draginitcmd - - - --dragtype -dropcmd - - - --dropenabled -dropovercmd - - - --droptypes -focus - - - --height -helptext - - - --helptype -helpvar - - - --name -state - - - --underline -width - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName setfocus - -
-DESCRIPTION
-
- -The Label widget extends the default Tk label. Options have been added to provide -visual effect depending on the state of the Label, DynamicHelp options, and Drag - and Drop. -
--WIDGET-SPECIFIC OPTIONS
-
- -dragenabled -
- -A boolean specifying if drag is enabled. - -
- -dragendcmd -
- - -Specifies a command to be called when drag ended. -dragendcmd must be a command conforming to the description of the -option dragendcmd of DragSite::register. - - -
- -dragevent -
- - -Specifies the number of the mouse button associated to the drag. -Must be 1, 2 or 3. - - -
- -draginitcmd -
-
-
-Specifies a command to be called when dragevent occurs on widget.
-draginitcmd must be a command conforming to the description of the
-option draginitcmd of DragSite::register.
-
-
If draginitcmd is empty, the internal draginitcmd command is used instead -and returns: --
IMAGE {copy} <image name> - if an image is displayed. - BITMAP {copy} <bitmap name> - if a bitmap is displayed. - TEXT {copy} <text> - if a text is displayed. -
-
- -dragtype -
- - -Specifies an alternate type of dragged object. - - -
- -dropcmd -
-
-
-Specifies a command to be called when drop occurs on the widget.
-dropcmd must be a command conforming to the description of the
-option dropcmd of DropSite::register.
-
-
If dropcmd is empty, the command updates the label following the type of the data: --
COLOR or FGCOLOR -reconfigure the foreground of the Label. -BGCOLOR -reconfigure the background of the Label. -IMAGE -reconfigure the Label to display the associated image. -BITMAP -reconfigure the Label to display the associated bitmap. -image option is set to empty. -TEXT, -
or any other tagreconfigure the Label to display the associated string. -image and bitmap options are set to empty. -
-
- -dropenabled -
- -A boolean specifying if drop is enabled. - -
- -dropovercmd -
-
-
-Specifies a command to be called when drag icon is over the widget.
-dropovercmd must be a command conforming to the description of the
-option dropovercmd of DropSite::register.
-
-
If dropovercmd is empty, Label always accepts the drop if data type is -FGCOLOR, COLOR, BGCOLOR, and accepts all other data type only if -state is normal. - -
-
- -droptypes -
- - -Specifies a list of accepted dropped object/operation. -See option droptypes of -DropSite::register. -for more infromation. - -Default accepts FGCOLOR, COLOR, BGCOLOR, TEXT, BITMAP -and IMAGE, all with copy and move operations. - - -
- -focus -
- - -Specifies a pathname to set the focus on for Label::setfocus command. - - -
- -height -
- - -Specifies a desired height for the label. -If an image or bitmap is being displayed in the label then the value is in -screen units, for text it is in lines of text. -If this option isn't specified, the label's desired height is computed -from the size of the image or bitmap or text being displayed in it. - -
- -helptext -
- - -Text for dynamic help. If empty, no help is available for this widget. -See also DynamicHelp. - -
- -helptype -
- -Type of dynamic help. Use balloon or variable. -See also DynamicHelp. - -
- -helpvar -
- -Variable to use when helptype option is variable. -See also DynamicHelp. - -
- -name -
- - -Specifies a standard name for the label. If the option *nameName is -found in the resource database, then text and underline options -are extracted from its value. - - -
- -state -
- - -Specifies one of two states for the Label: normal or disabled. -In normal state the text of the Label is displayed using the foreground option. -In disabled state the text of the Label is displayed using the disabledforeground option. - -
- -underline -
-
-
-Specifies the integer index of a character to underline in the label.
-0 corresponds to the first character of the text displayed, 1 to the next character,
-and so on.
-
The binding <Alt-char> is automatically set on the toplevel -of the Label to call Label::setfocus. - -
-
- -width -
- - -Specifies a desired width for the label. -If an image or bitmap is being displayed in the label then the value is in -screen units, for text it is in characters. -If this option isn't specified, the label's desired width is computed -from the size of the image or bitmap or text being displayed in it. - - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName setfocus -
- - -Set the focus on the pathname given by -focus option if -state is normal. - -
- NAME -
- LabelEntry - - -LabelFrame containing an Entry widget. - -
-
-
- CREATION -
- LabelEntry pathName ?option value...? -
-
-
- OPTIONS from Entry -
-
- --borderwidth or -bd --command -- --disabledforeground --dragenabled -- --dragendcmd --dragevent -- --draginitcmd --dragtype -- --dropcmd --dropenabled -- --dropovercmd --droptypes -- --editable --entrybg (see -background) -- --entryfg (see -foreground) --exportselection -- --font --helptext -- --helptype --helpvar -- --highlightbackground --highlightcolor -- --highlightthickness --insertbackground -- --insertborderwidth --insertofftime -- --insertontime --insertwidth -- --justify --relief -- --selectbackground --selectborderwidth -- --selectforeground --show -- --state --takefocus -- --text --textvariable -- --width --xscrollcommand -
-
-
-
- OPTIONS from LabelFrame -
-
- --background or -bg --disabledforeground -- --foreground or -fg --helptext -- --helptype --helpvar -- --label (see -text) --labelanchor (see -anchor) -- --labelfont (see -font) --labelheight (see -height) -- --labeljustify (see -justify) --labelwidth (see -width) -- --name --padx -- --pady --side -- --state --underline -- -wraplength -
-
-
-
- WIDGET COMMAND -
- pathName bind - ?arg...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
-DESCRIPTION
-
- -LabelEntry is a widget composed of LabelFrame widget -containing an Entry widget. -Tk entry command can also be used on LabelEntry widget. - -
--WIDGET COMMAND
-
- pathName bind - ?arg...? -
- - -Set bindings on the entry widget. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- NAME -
- LabelFrame - - Frame with a Label -
-
-
- CREATION -
- LabelFrame pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- - --borderwidth or -bd --relief
-
-
-
- OPTIONS from Label -
-
- --anchor --background or -bg -- --disabledforeground --focus -- --font --foreground or -fg -- --height --helptext -- --helptype --helpvar -- --justify --name -- --padx --pady -- --state --text -- --underline --width -- -wraplength -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --side
-
-
-
- WIDGET COMMAND -
- LabelFrame::align - ?arg...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getframe - -
-DESCRIPTION
-
- -LabelFrame enables user to create a frame with a -Label positionned at any side. -LabelFrame is used by ComboBox -and SpinBox. -
--WIDGET-SPECIFIC OPTIONS
-
- -side (read-only) -
- - -Specifies where to position the Label relative to the user frame: top, bottom, left or right. - -
-WIDGET COMMAND
-
- LabelFrame::align - ?arg...? -
- - -This command align label of all widget given by args of class LabelFrame -(or "derived") by setting their width to the max one +1 - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getframe -
- - -Return the frame where the user can create any other widget. -
- NAME -
- ListBox - - ListBox widget -
-
-
- CREATION -
- ListBox pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- --cursor -highlightbackground - - - --highlightcolor -highlightthickness - - - --relief -selectbackground - - - --selectforeground -takefocus - - - --xscrollcommand -yscrollcommand - -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --deltax -deltay - - - --dragenabled -dragendcmd - - - --dragevent -draginitcmd - - - --dragtype -dropcmd - - - --dropenabled -dropovercmd - - - --dropovermode -droptypes - - - --height -multicolumn - - - --padx -redraw - - - --width
-
-
-
- WIDGET COMMAND -
- pathName bindImage - event - script - -
- pathName bindText - event - script - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName delete - ?arg...? - -
- pathName edit - item - text - ?verifycmd? - ?clickres? - ?select? - -
- pathName exists - item - -
- pathName index - item - -
- pathName insert - index - item - ?option value...? - -
- pathName item - first - ?last? - -
- pathName itemcget - item - option - -
- pathName itemconfigure - item - ?option? ?value option value ...? - -
- pathName items - ?first? - ?last? - -
- pathName move - item - index - -
- pathName reorder - neworder - -
- pathName see - item - -
- pathName selection - cmd - ?arg...? - -
- pathName xview - ?arg...? - -
- pathName yview - ?arg...? - -
-DESCRIPTION
-
- -ListBox widget uses canvas to display a list of items. -Each item is composed of a label with its own font and foreground attributes, and an optional -image or window. Each item is drawn in a single line, whose height is defined by the -deltay option, so they must have at most this height. -A item is uniquely identified by a string given at creation (by the -insert command). The ListBox can have one or more columns, depending on -multicolumn option. The user do not handle columns; the number of columns -is determined following the height of the ListBox in order to see each item vertically. - -
--WIDGET-SPECIFIC OPTIONS
-
- -deltax -
- - -Specifies horizontal pad between each columns. - - -
- -deltay -
- - -Specifies vertical size of the items. - - -
- -dragenabled -
- -A boolean specifying if drag is enabled. - -
- -dragendcmd -
- - -Specifies a command to be called when drag ended. -dragendcmd must be a command conforming to the description of the -option dragendcmd of DragSite::register. - - -
- -dragevent -
- - -Specifies the number of the mouse button associated to the drag. -Must be 1, 2 or 3. - - -
- -draginitcmd -
-
-
-ListBox has a command wrapper for drag-init events. This command refused the drag
-if no item is designated. In other cases:
-
If draginitcmd is empty, it returns: --
-
- the value of option dragtype or LISTBOX_ITEM if empty as the data type, -
- {move copy link} as the operations, -
- the item identifier as the data. -
-
-
- the pathname of the listbox, -
- the identifier of the dragged item, -
- the toplevel created to represent dragged data. -
-
- -dragtype -
- - -Specifies an alternate type of dragged object. - - -
- -dropcmd -
-
-
-ListBox has a command wrapper for drop events. This command stops auto scrolling
-and extract item and position.
-
If dropcmd is not empty, it is called with the following arguments: --
-
- the pathname of the listbox, -
- the pathname of the drag source, -
- a list describing where the drop occurs. It can be:
-
-
-
- {widget}, -
- {item item} or -
- {position index}. -
- the current operation, -
- the data type, -
- the data. -
-
- -dropenabled -
- -A boolean specifying if drop is enabled. - -
- -dropovercmd -
-
-
-LsitBox has a command wrapper for drag-over events. This command enables auto scrolling
-and position extraction during the drag-over.
-If dropovercmd is not empty, the command is called with the following aguments:
-
-
-
- the pathname of the listbox, -
- the pathname of the drag source, -
- a list describing where the drop can occur, whose elements are:
-
-
-
- the string widget if dropovertype option contains w, else empty string. -
- the targeted item if drag icon points an item and dropovertype option contains -i, else empty string. -
- an index within two items where drag icon points to if dropovertype option -contains p, else empty string. -
- optionally, the preferred method if drop can occur both inside an item and between two -items. The value is position or item. -
- the current operation, -
- the data type, -
- the data. -
-
-
- the drop status, conforming to those described in dropovercmd option of -DropSite::register, -
- the choosen method: widget, item or position. -
-
- -dropovermode -
- - -Specifies the type of drop-over interaction. Must be a combination of -w, which specifies that drop can occurs everywhere on widget, -p, which specifies that drop can occurs between two items, -and i, which specifies that drop occurs inside items. - - -
- -droptypes -
-
-
-Specifies a list of accepted dropped object/operation.
-See option droptypes of
-DropSite::register.
-for more infromation.
-
-
Default is LISTBOX_ITEM with operations copy and move. - -
-
- -height -
- - -Specifies the desired height for the listbox in units of deltay pixels. - - -
- -multicolumn -
- - -Specifies wether or not ListBox layouts items in order to see each one vertically. - - -
- -padx -
- - -Specifies distance between image or window and text of the items. - - -
- -redraw -
- - -Specifies wether or not the listbox should be redrawn when entering idle. -Set it to false if you call update while modifying the listbox. - - -
- -width -
- - -Specifies the desired width for the listbox in units of 8 pixels. - - -
-WIDGET COMMAND
-
- pathName bindImage - event - script -
- - -This command associates a command to execute whenever the event -sequence given by event occurs on the image of a item. -The item idenfier on which the event occurs is appended to the command. - -
- pathName bindText - event - script -
- - -This command associates a command to execute whenever the event -sequence given by event occurs on the label of a item. -The item idenfier on which the event occurs is appended to the command. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName delete - ?arg...? -
- - -Deletes all items in arg. arg can be a list -of items or a list of list of items. -To delete all items, do $pathName delete [$pathName items]. - -
- pathName edit - item - text - ?verifycmd? - ?clickres? - ?select? -
-
-
-Provides a way for the user to edit in place the label of an item.
-
The command takes the initial text as argument and does not modify the label of the -edited node, but returns an empty string if edition is canceled, or the typed text -if edition is accepted. -
When editing, the user can cancel by pressing Escape, or accept by pressing Return. -
clickres specifies what to do if the user click outside the editable area. -If clickres is 0 (the default), the edition is canceled. -If clickres is 1, the edition is accepted. -In all other case, the edition continues. -
If edition is accepted and modifycmd is not empty, then it is called with -the new text as argument and must return 1 to accept the new text, 0 to refuse it -and continue edition. -
select specifies wether or not the initial text should be selected. Default is 1. - -
- pathName exists - item -
- - -Returns 1 if item exists in the listbox, else 0. - -
- pathName index - item -
- - -Returns the position of item in the list. - -
- pathName insert - index - item - ?option value...? -
-
-
-Inserts a new item identified by item in the list at position index.
-
-
-
- -data -
- - -User data associated to the item. - - -
- -fill -
- - -Specifies the foreground color of the label of the item. - - -
- -font -
- - -Specifies a font for the label of the item. - - -
- -image -
- - -Specifies an image to display at the left of the label of the item. -window option override image. - -
- -indent -
- - -Specifies the amount of extra space in pixels at the left of the item. - - -
- -text -
- - -Specifies the label of the item. - - -
- -window -
- - -Specifies a pathname to display at the left of the label of the item. -window option override image. - -
- pathName item - first - ?last? -
-
-
-Its use is deprecated. Use items instead.
-If last is omitted, returns the item at index first in the list, -or an empty string if first refers to a non-existent element. -If last is specified, the command returns a list whose elements are all -of the items between first and last, inclusive. -Both first and last may have any of the standard forms for indices. - -
- pathName itemcget - item - option -
- - -Returns the current value of a configuration option for the item. -Option may have any of the values accepted by the item creation command. - -
- pathName itemconfigure - item - ?option? ?value option value ...? -
- - -This command is similar to the configure command, except that it applies to the -options for an individual item, whereas configure applies to the options for -the widget as a whole. Options may have any of the values accepted by the -item creation widget command. If options are specified, options are modified as indicated -in the command and the command returns an empty string. If no options are specified, -returns a list describing the current options for the item. -Read-only options are not be modified. - -
- pathName items - ?first? - ?last? -
- - -If first and last are omitted, returns the list of all items. -If first is specified and last omitted, returns the item at index -first, or an empty string if first refers to a non-existent element. -If first and last are specified, the command returns a list whose elements -are all of the items between first and last, -inclusive. Both first and last may have any of the standard -forms for indices. - -
- pathName move - item - index -
- - -Moves item at position index in the list. - -
- pathName reorder - neworder -
- - -Modifies the order of items in the listbox given by neworder. Items that do not -appear in neworder are no moved. - -
- pathName see - item -
- - -Arrange the scrolling area to make item visible. - -
- pathName selection - cmd - ?arg...? -
-
-
-Modifies the list of selected items following cmd:
-
-
-
- clear -
- remove all items of the selection. -
- set -
- set the selection to all items in arg -
- add -
- add all items of arg in the selection -
- remove -
- remove all items of arg of the selection -
- get -
- return the current selected items -
- pathName xview - ?arg...? -
- - -Standard command to enable horizontal scrolling of pathName. - -
- pathName yview - ?arg...? -
- - -Standard command to enable vertical scrolling of pathName. - -
- NAME -
- MainFrame - - Manage toplevel with menu, toolbar and statusbar -
-
-
- CREATION -
- MainFrame pathName ?option value...? -
-
-
- OPTIONS from ProgressBar -
-
- --background or -bg --progressfg (see -foreground) -- --progressmax (see -maximum) --progresstype (see -type) -- -progressvar (see -variable) -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --height -menu - - - --separator -textvariable - - - --width
-
-
-
- WIDGET COMMAND -
- pathName addindicator - ?arg...? - -
- pathName addtoolbar - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getframe - -
- pathName getindicator - index - -
- pathName getmenu - menuid - -
- pathName gettoolbar - index - -
- pathName setmenustate - tag - state - -
- pathName showstatusbar - name - -
- pathName showtoolbar - index - bool - -
-DESCRIPTION
-
-
-MainFrame manage toplevel to have:
-
-
-
- simple menu creation, with automatic accelerator bindings and -DynamicHelp association, -
- one or more toolbar that user can hide, -
- a status bar, displaying a user message or a menu description, and optionnaly a -ProgressBar. -
-WIDGET-SPECIFIC OPTIONS
-
- -height -
- - -Specifies the desired height for the user frame in any of the forms acceptable to -Tk_GetPixels. If this option is less than or equal to zero (the default) then the window -will not request any size at all. - -
- -menu (read-only) -
-
-
-This option describes the menu. This is a list whose each five elements describe
-one cascad menu. It has the following form:
-{menuname tags menuId tearoff menuentries...}
-where menuentries is a list where each element describe one menu entry, which can be:
-
-
-
- for a separator:
- {separator} - - for a command:
- {command menuname ?tags? ?description? ?accelerator? ?option value? ...} - - for a check button:
- {checkbutton menuname ?tags? ?description? ?accelerator? ?option value? ...} - - for a radio button:
- {radiobutton menuname ?tags? ?description? ?accelerator ?option value? ...} - - for a cascad menu:
- {cascad menuname tags menuId tearoff menuentries} -
-
-
- menuname is the name of the menu. If it contains a &, the following character -is automatically converted to the corresponding -underline option of menu add -command. -
- tags is the tags list for the entry, used for enabling or disabling menu -entries with MainFrame::setmenustate. -
- menuId is an id for the menu, from which you can get menu pathname with - MainFrame::getmenu. -
- tearoff specifies if menu has tearoff entry. -
- description specifies a string for DynamicHelp. -
- accelerator specifies a key sequence. It is a list of two elements, where the first -is one of Ctrl, Alt or CtrlAlt, and the second as letter or a digit. -An accelerator string is build and corresponding binding set on the toplevel to invoke the -menu entry. -
- option value specifies additionnal options for the entry (see menu add -command). -
Example: --set descmenu { - "&File" {} {} 0 { - {command "&New" {} "Create a new document" {Ctrl n} -command Menu::new} - {command "&Open..." {} "Open an existing document" {Ctrl o} -command Menu::open} - {command "&Save" open "Save the document" {Ctrl s} -command Menu::save} - {cascad "&Export" {} export 0 { - {command "Format &1" open "Export document to format 1" {} -command {Menu::export 1}} - {command "Format &2" open "Export document to format 2" {} -command {Menu::export 2}} - }} - {separator} - {cascad "&Recent files" {} recent 0 {}} - {separator} - {command "E&xit" {} "Exit the application" {} -command Menu::exit} - } - "&Options" {} {} 0 { - {checkbutton "Toolbar" {} "Show/hide toolbar" {} - -variable Menu::_drawtoolbar - -command {$Menu::_mainframe showtoolbar toolbar $Menu::_drawtoolbar} - } - } -} -- -
- - for a separator:
- -separator (read-only) -
- - -Specifies if separator should be drawn at the top and/or at the bottom of the user window. -Must be one of the values none, top, bottom or both. -It depends on the relief of subwidgets of user window. - -
- -textvariable -
-
-
-Specifies the textvariable option for the label of the status bar.
-DynamicHelp description
-of menu entries are mapped to this variable at the creation of the MainFrame.
-If this variable is changed by MainFrame::configure, menu description will
-not be available.
-
You change the text of the label by modifying the value of the variable. -
-
- -width -
- - -Specifies the desired width for the user frame in any of the forms acceptable to -Tk_GetPixels. If this option is less than or equal to zero (the default) then the window -will not request any size at all. - -
-WIDGET COMMAND
-
- pathName addindicator - ?arg...? -
- - -Add an indicator box at the right of the status bar. Each indicator are added from left -to right. An indicator is a Tk label widget configured with option-value pair -given by ?arg...?. -relief and -borderwidth options are respetively -defaulted to sunken and 1. Returns the pathname of the created label. -
- pathName addtoolbar -
- - -Add a toolbar to the MainFrame. Returns the pathname of the new window where to place -toolbar items. -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getframe -
- - -Returns the pathname of the user window. -
- pathName getindicator - index -
- - -Returns the pathname of the indexth added indicator. -
- pathName getmenu - menuid -
- - -Returns the pathname of the menu whose id is menuid. -
- pathName gettoolbar - index -
- - -Returns the pathname of the indexth added toolbar. -
- pathName setmenustate - tag - state -
- - -Set the -state option value of all the menu entries that have the tag tag -to state. - -
- pathName showstatusbar - name -
- - -name is one of none, status or progression. -Use none to hide the status bar, status to display the label only, or -progression to display the label and the -ProgressBar. -
- pathName showtoolbar - index - bool -
- - -Hide if bool is 0, or show if bool is 1 the indexth added toolbar. -To prevent your toplevel from resizing while hiding/showing toolbar, -do [wm geometry $top [wm geometry $top]] when it is managed. -
- NAME -
- MessageDlg - - Message dialog box -
-
-
- CREATION -
- MessageDlg pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --anchor -font - - - - --foreground or -fg --padx - --pady
-
-
-
- OPTIONS from Dialog -
-
- --background or -bg --cancel -- --default --parent -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --aspect -buttons - - - --icon -justify - - - --message -title - - - --type -width - -
-
-DESCRIPTION
-
- -MessageDlg provides a simple way to display a message dialog. -MessageDlg::create creates the message dialog, displays -it and return the index of the pressed button, or -1 if it is destroyed. -When returning, the dialog no longer exists. - -
--WIDGET-SPECIFIC OPTIONS
-
- -aspect -
- - -Specifies a non-negative integer value indicating desired -aspect ratio for the text. The aspect ratio is specified as -100*width/height. 100 means the text should -be as wide as it is tall, 200 means the text should -be twice as wide as it is tall, 50 means the text should -be twice as tall as it is wide, and so on. -Used to choose line length for text if width option -isn't specified. -Defaults to 150. - - -
- -buttons -
- - -Specifies a list of buttons to display when type option is user. -If a button has a symbolic name, its associated text will be displayed. - - -
- -icon -
- - -Specifies an icon to display. Must be one of the following: error, info, -question or warning. - - -
- -justify -
- - -Specifies how to justify lines of text. -Must be one of left, center, or right. Defaults -to left. -This option works together with the anchor, aspect, -padx, pady, and width options to provide a variety -of arrangements of the text within the window. -The aspect and width options determine the amount of -screen space needed to display the text. -The anchor, padx, and pady options determine where this -rectangular area is displayed within the widget's window, and the -justify option determines how each line is displayed within that -rectangular region. -For example, suppose anchor is e and justify is -left, and that the message window is much larger than needed -for the text. -The the text will displayed so that the left edges of all the lines -line up and the right edge of the longest line is padx from -the right side of the window; the entire text block will be centered -in the vertical span of the window. - - -
- -message -
- - -Specifies the message to display in this message box. - - -
- -title -
-
-
-Specifies a string to display as the title of the message box.
-If the value is empty (the default), a default title will be set corresponding
-to the icon option.
-The default associated title is in english, and can be modified to set it in
-another language by specifying the resource:
-
*MessageDlg.nameTitle: value
-or the equivalent tcl command: -option add *MessageDlg.nameTitle value
-where name is the name of an icon as defined in the icon option. -
For example, for french language, you can specify for a warning dialog: -option add *MessageDlg.warningTitle "Attention"
- -
-
- -type -
-
-
-Specifies a set of buttons to be displayed. The following values are possible:
-
- -
--
-
-
- -abortretryignore -
-
-Displays three buttons whose symbolic names are abort,
-retry and ignore.
-
- -ok -
-
-Displays one button whose symbolic name is ok.
-
- -okcancel -
-
-Displays two buttons whose symbolic names are ok and cancel.
-
- -retrycancel -
-
-Displays two buttons whose symbolic names are retry and cancel.
-
- -yesno -
-
-Displays two buttons whose symbolic names are yes and no.
-
- -yesnocancel -
-
-Displays three buttons whose symbolic names are yes, no
-and cancel.
-
-
- -user -
-
-Displays buttons of -buttons option.
-
- -
- -
- -width -
- - -Specifies the length of lines in the window. -If this option has a value greater than zero then the aspect -option is ignored and the width option determines the line -length. -If this option has a value less than or equal to zero, then -the aspect option determines the line length. - - -
- NAME -
- NoteBook - - Notebook manager widget -
-
-
- CREATION -
- NoteBook pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --font
-
-
-
- OPTIONS from ArrowButton -
-
- --activebackground --activeforeground -- --background or -bg --borderwidth or -bd -- --disabledforeground --foreground or -fg -- --repeatdelay --repeatinterval -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --height -homogeneous - - - --side -width - -
-
-
-
- WIDGET COMMAND -
- pathName bindtabs - event - script - -
- pathName cget - option - -
- pathName compute_size - -
- pathName configure - ?option? ?value option value ...? - -
- pathName delete - page - ?destroyframe? - -
- pathName getframe - page - -
- pathName index - page - -
- pathName insert - index - page - ?option value...? - -
- pathName itemcget - page - option - -
- pathName itemconfigure - page - ?option? ?value option value ...? - -
- pathName move - page - index - -
- pathName page - first - ?last? - -
- pathName pages - ?first? - ?last? - -
- pathName raise - ?page? - -
- pathName see - page - -
-DESCRIPTION
-
- -NoteBook widget manage a set of pages and displays one of them. - -
--WIDGET-SPECIFIC OPTIONS
-
- -height -
- - -Specifies the desired height for the pages. If this option is equal to zero (the default) -then the window will not request any size at all. -In this case, user may want to call NoteBook::compute_size to make NoteBook larger -enough to contains the largest page. - -
- -homogeneous -
- - -Specifies wether or not the label of the pages must have the same width. - - -
- -side (read-only) -
- - -Specifies the side where to place the label of the pages. Must be one -of top or bottom. -Only top is implemented for the moment. - - -
- -width -
- - -Specifies the desired width for the pages. If this option is equal to zero (the default) -then the window will not request any size at all. -In this case, user may want to call NoteBook::compute_size to make NoteBook larger -enough to contains the largest page. - -
-WIDGET COMMAND
-
- pathName bindtabs - event - script -
- - -This command associates a command to execute whenever the event -sequence given by event occurs on a tabs. The page idenfier on which -the event occurs is appended to the command. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName compute_size -
- - -This command can be called to make the NoteBook large enough to contain the largest page. -Note that if all pages use -createcmd, they will have no requested size. - -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName delete - page - ?destroyframe? -
- - -Deletes the page page. If destroyframe is 1 (the default), the frame -associated to page is destroyed. If destroyframe is 0, the frame is not -destroyed and is reused by further call to insert with the same page. - -
- pathName getframe - page -
- - -Returns the pathname of the page page. - -
- pathName index - page -
- - -Return the numerical index corresponding to the item. - -
- pathName insert - index - page - ?option value...? -
-
-
-Insert a new page idendified by page at position index in the pages list.
-index must be numeric or end. The pathname of the new page is returned.
-
-
-
- -createcmd -
- - -Specifies a command to be called the first time the page is raised. - - -
- -image -
- - -Specifies an image to display for the page at the left of the label - - -
- -leavecmd -
- - -Specifies a command to be called when a page is about to be leaved. -The command must return 0 if the page can not be leaved, or 1 if it can. - - -
- -raisecmd -
- - -Specifies a command to be called each time the page is raised. - - -
- -state -
- - -Specifies the state of the page. Must be normal or disabled. - - -
- -text -
- - -Specifies a label to display for the page. - - -
- pathName itemcget - page - option -
- - -Returns the current value of a configuration option for the item. -Option may have any of the values accepted by the item creation command. - -
- pathName itemconfigure - page - ?option? ?value option value ...? -
- - -This command is similar to the configure command, except that it applies to the -options for an individual item, whereas configure applies to the options for -the widget as a whole. Options may have any of the values accepted by the -item creation widget command. If options are specified, options are modified as indicated -in the command and the command returns an empty string. If no options are specified, -returns a list describing the current options for the item. -Read-only options are not be modified. - -
- pathName move - page - index -
- - -Moves page tab to index index. - -
- pathName page - first - ?last? -
-
-
-Its use is deprecated. Use pages instead.
-If last is omitted, returns the page at index first, or an empty string if -first refers to a non-existent element. If last is specified, the command -returns a list whose elements are all of the pages between first and last, -inclusive. Both first and last may have any of the standard -forms for indices. - -
- pathName pages - ?first? - ?last? -
- - -If first and last are omitted, returns the list of all pages. -If first is specified and last omitted, returns the page at index -first, or an empty string if first refers to a non-existent element. -If first and last are specified, the command returns a list whose elements -are all of the pages between first and last, -inclusive. Both first and last may have any of the standard -forms for indices. - -
- pathName raise - ?page? -
- - -Raise the page page, or return the raised page if page is omitted. - -
- pathName see - page -
- - -Scrolls labels to make the label of the page page visible. - -
- NAME -
- PagesManager - - Pages manager widget -
-
-
- CREATION -
- PagesManager pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --height -width - -
-
-
-
- WIDGET COMMAND -
- pathName add - page - -
- pathName cget - option - -
- pathName compute_size - -
- pathName configure - ?option? ?value option value ...? - -
- pathName delete - page - -
- pathName getframe - page - -
- pathName page - first - ?last? - -
- pathName pages - ?first? - ?last? - -
- pathName raise - ?page? - -
-DESCRIPTION
-
- -PagesManager widget manage a set of pages and displays one of them. -PagesManager does not provide any user access method, as NoteBook does, -so it can be done through a listbox, a menu, radiobutton, or whatever. - -
--WIDGET-SPECIFIC OPTIONS
-
- -height -
- - -Specifies the desired height for the pages. If this option is equal to zero (the default) -then the window will not request any size at all. -In this case, user may want to call PagesManager::compute_size to make PagesManager -larger enough to contains the largest page. - -
- -width -
- - -Specifies the desired width for the pages. If this option is equal to zero (the default) -then the window will not request any size at all. -In this case, user may want to call PagesManager::compute_size to make PagesManager -larger enough to contains the largest page. - -
-WIDGET COMMAND
-
- pathName add - page -
- - -Add a new page idendified by page. The pathname of the new page -is returned. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName compute_size -
- - -This command can be called to make the PagesManager large enough to contain the largest page. - -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName delete - page -
- - -Deletes the page page. - -
- pathName getframe - page -
- - -Returns the pathname of the page page. - -
- pathName page - first - ?last? -
-
-
-Its use is deprecated. Use pages instead.
-If last is omitted, returns the page at index first, or an empty string if -first refers to a non-existent element. If last is specified, the command -returns a list whose elements are all of the pages between first and last, -inclusive. Both first and last may have any of the standard -forms for indices. - -
- pathName pages - ?first? - ?last? -
- - -If first and last are omitted, returns the list of all pages. -If first is specified and last omitted, returns the page at index -first, or an empty string if first refers to a non-existent element. -If first and last are specified, the command returns a list whose elements -are all of the pages between first and last, -inclusive. Both first and last may have any of the standard -forms for indices. - -
- pathName raise - ?page? -
- - -Raise the page page, or return the raised page if page is omitted. - -
- NAME -
- PanedWindow - - Tiled layout manager widget -
-
-
- CREATION -
- PanedWindow pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- -background or -bg -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --pad -side - - - --width
-
-
-
- WIDGET COMMAND -
- pathName add - ?option value...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getframe - index - -
-DESCRIPTION
-
- -PanedWindow is a widget that lays out children in -a vertically or horizontally tiled format. -The user can adjust the size of the panes, with a pane control sash created -between children. -
--WIDGET-SPECIFIC OPTIONS
-
- -pad (read-only) -
- - -Specifies additional space between the button of the sash and children. - - -
- -side (read-only) -
- - -Specifies the side of the sash, which implies the layout: top or bottom -(horizontal layout), left or right (vertical layout). - -
- -width (read-only) -
- - -Specifies the width of the button of the sash. - - -
-WIDGET COMMAND
-
- pathName add - ?option value...? -
-
-
-This command add a new pane. The new pane is placed below the previous pane for vertical
-layout or at right for horizontal layout. This command returns a frame where user can place
-its widget. Valid options are:
-
-
- -minsize -
- - -Specifies the minimum size requested for the pane. -See the grid command for more information. - -
- -weight -
- - -Specifies the relative weight for apportioning any extra spaces among panes. -See the grid command for more information. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getframe - index -
- - -Returns the pathname of the indexth added pane. -
- NAME -
- PasswdDlg - - Login/Password dialog box -
-
-
- CREATION -
- PasswdDlg pathName ?option value...? -
-
-
- OPTIONS from Dialog -
-
- --anchor --background or -bg -- --homogeneous --modal -- --padx --pady -- --parent --spacing -- -title -
-
-
-
- OPTIONS from LabelEntry -
-
- --background or -bg --borderwidth or -bd -- --disabledforeground --entrybg -- --entryfg --exportselection -- --font --foreground or -fg -- --helptype --highlightbackground -- --highlightcolor --highlightthickness -- --insertbackground --insertborderwidth -- --insertofftime --insertontime -- --insertwidth --labelanchor -- --labelfont --labelheight -- --labeljustify --labelwidth -- --loginhelptext (see -helptext) --loginhelpvar (see -helpvar) -- --loginlabel (see -label) --logintext (see -text) -- --logintextvariable (see -textvariable) --loginunderline (see -underline) -- --passwdeditable (see -editable) --passwdhelptext (see -helptext) -- --passwdhelpvar (see -helpvar) --passwdlabel (see -label) -- --passwdstate (see -state) --passwdtext (see -text) -- --passwdtextvariable (see -textvariable) --passwdunderline (see -underline) -- --relief --selectbackground -- --selectborderwidth --selectforeground -- -wraplength -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --command -type - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
-DESCRIPTION
-
-
-PasswdDlg provides a simple way to display a login/password dialog.
-PasswdDlg::create creates the dialog, displays it, and return the value of login
-and password in a list, or an empty list if it is destroyed or user press cancel.
-When returning, the dialog no longer exists.
-
Additionnal resources can be set to modify other text:
-
- *loginName Label for login LabelEntry - *passwordName Label for password LabelEntry -- - -
-WIDGET-SPECIFIC OPTIONS
-
- -command -
- - -Specifies a command to call when user press ok button. - - -
- -type -
-
-
-Specifies a set of buttons to be displayed. The following values are possible:
-
- -
--
-
-
- -ok -
-
-Displays one button whose symbolic name is ok.
-
- -okcancel -
-
-Displays two buttons whose symbolic names are ok and cancel.
-
- -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- -
- NAME -
- ProgressBar - - Progress indicator widget -
-
-
- CREATION -
- ProgressBar pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- - --foreground or -fg --orient - --relief -troughcolor - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
-DESCRIPTION
-
- -ProgressBar widget indicates the user the progress of a lengthly operation. -It is used by MainFrame -and ProgressDlg. -
--WIDGET-SPECIFIC OPTIONS
-
- -height -
- - -Specifies the desired height for the progress indicator. - -
- -maximum -
- - -Specifies the maximum value of the variable. - - -
- -type -
-
-
-Specifies the type of the ProgressBar. Must be one of normal, incremental or
-infinite.
-
If type is normal, the progress indicator is drawn proportional -to the variable value and maximum option each time the variable is set. -
If type is incremental, the value of the progress indicator is maintained internally, -and incremented each time the variable is set by its value. The progress indicator is drawn proportional -to the internal value and maximum option. -
If type is infinite, the value of the progress indicator is maintained internally, -and incremented each time the variable is set by its value. The progress indicator grow from left to -right if internal value (modulo maximum) is less than maximum/2, and from right to left if -internal value is greater than maximum/2. -
See -variable option for special case of its value, - -
-
- -variable -
- - -Specifies the variable attached to the progress indicator. -Progress indicator is updated when the value of the variable changes. -If the value of the variable is negative, the progress indicator is not -displayed (it is drawn flat with background color -- usefull for ProgressDlg to make it invisible). If its value 0, progress indicator -is reinitialized. - - -
- -width -
- - -Specifies the desired width for the progress indicator. - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- NAME -
- ProgressDlg - - Progress indicator dialog box -
-
-
- CREATION -
- ProgressDlg pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --font -textvariable - -
-
-
-
- OPTIONS from Dialog -
-
- --background or -bg --parent -- --separator --title -
-
-
-
- OPTIONS from ProgressBar -
-
- --background or -bg --borderwidth or -bd -- --foreground or -fg --maximum -- --relief --troughcolor -- --type --variable -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --command -height - - - --stop -width - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
-DESCRIPTION
-
- -ProgressDlg provides a simple way to display a progress indicator dialog. -ProgressDlg::create creates the dialog, displays it, set a local -grab to it and immediatly return. The dialog is updated by modifying the -value of the variable of options -textvariable and -variable. -You have to destroy the dialog after use. - -
--WIDGET-SPECIFIC OPTIONS
-
- -command -
- - -Specifies a command to call when user press stop button. - - -
- -height -
- - -Specifies a desired height for the label in lines of text. - - -
- -stop -
- - -Specifies the text of the button typically used to stop process. If empty, no button will -be drawn. This can be a symbolic name. - - -
- -width -
- - -Specifies a desired width for the label in characters. - - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- NAME -
- ScrollView - - Display the visible area of a scrolled window -
-
-
- CREATION -
- ScrollView pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- --cursor -relief - -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --fill -foreground or -fg - -- --height -width - - - --window
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
-DESCRIPTION
-
- -ScrollView displays the visible area of a scrolled window within -its scroll region. - -
--WIDGET-SPECIFIC OPTIONS
-
- -fill -
- - -Specifies the fill color of the rectangle. - - -
- -foreground -
- - -Specifies the color of the border of the rectangle. - - -
- -height -
- - -Specifies the desired height for the ScrollView. - -
- -width -
- - -Specifies the desired width for the ScrollView. - -
- -window -
- - -Specifies the window to view. This widget must have -xscrollcommand and --yscrollcommand options, and respond to xview and yview command. -In order to make ScrollView working with other scrollbar, -xscrollcommand and --yscrollcommand options of the widget must be set before the widget is passed to -the -window option of the ScrollView (for example, if the widget is handled by -a ScrolledWindow, call setwidget before setting -window option). - - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
BINDINGS
- -
- If mouse button 1 is pressed and dragged over the ScrollView, the top left corner of -the visible area of the scrolled window is moved proportionally to the mouse displacement. -
- If mouse button 3 is pressed over the ScrollView, the top left corner of the visible -area is proportionally set to this point. -
- NAME -
- ScrollableFrame - - Scrollable frame containing widget -
-
-
- CREATION -
- ScrollableFrame pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- - --background or -bg --xscrollcommand - --yscrollcommand
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --areaheight -areawidth - - - --constrainedheight -constrainedwidth - - - --height -width - - - --xscrollincrement -yscrollincrement - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getframe - -
- pathName see - widget - ?vert? - ?horz? - -
- pathName xview - ?arg...? - -
- pathName yview - ?arg...? - -
-DESCRIPTION
-
- -ScrollableFrame widget containing widget. - -
--WIDGET-SPECIFIC OPTIONS
-
- -areaheight -
- - -Specifies the height for the scrollable area. If zero, then the height -of the scrollable area is made just large enough to hold all its children. - -
- -areawidth -
- - -Specifies the width for the scrollable area. If zero, then the width -of the scrollable area window is made just large enough to hold all its children. - -
- -constrainedheight -
- - -Specifies whether or not the scrollable area should have the same height of the -scrolled window. If true, vertical scrollbar is not needed. - - -
- -constrainedwidth -
- - -Specifies whether or not the scrollable area should have the same width of the -scrolled window. If true, horizontal scrollbar is not needed. - - -
- -height -
- - -Specifies the desired height for the window in pixels. - - -
- -width -
- - -Specifies the desired width for the window in pixels. - - -
- -xscrollincrement -
- - -See xscrollincrement option of canvas widget. - - -
- -yscrollincrement -
- - -See yscrollincrement option of canvas widget. - - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getframe -
- - -Return the pathname of the scrolled frame where widget should be created. - -
- pathName see - widget - ?vert? - ?horz? -
- - -Arrange scrollable area to make widget visible in the window. -vert and horz specify which part of widget must be preferably -visible, in case where widget is too tall or too large to be entirely visible. -vert must be top (the default) or bottom, -and horz must be left (the default) or right. -If vert or horz is not a valid value, area is not scrolled in this direction. - -
- pathName xview - ?arg...? -
- - -Standard command to enable horizontal scrolling of pathName. - -
- pathName yview - ?arg...? -
- - -Standard command to enable vertical scrolling of pathName. - -
- NAME -
- ScrolledWindow - - Generic scrolled widget -
-
-
- CREATION -
- ScrolledWindow pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- --relief
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --auto -scrollbar - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getframe - -
- pathName setwidget - widget - -
-DESCRIPTION
-
- -ScrolledWindow enables user to create easily a widget with its scrollbar. -Scrollbars are created by ScrolledWindow and scroll commands are automatically associated to -a scrollable widget with ScrolledWindow::setwidget. -
--WIDGET-SPECIFIC OPTIONS
-
- -auto -
-
-
-Specifies the desired auto managed scrollbar:
-
- none means scrollbar are always drawn -
- horizontal means horizontal scrollbar is drawn as needed -
- vertical means vertical scrollbar is drawn as needed -
- both means horizontal and vertical scrollbars are drawn as needed -
- horizontal means horizontal scrollbar is drawn as needed -
-
- -scrollbar (read-only) -
- - -Specifies the desired scrollbar: none, horizontal, vertical -or both. This option is not modifiable with ScrolledWindow::configure. - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getframe -
- - -Return the pathname of the frame where the scrolled widget should be created. This command -is no longer needed. You can directly create the scrolled widget as the child -of pathName. -
- pathName setwidget - widget -
- - -Associate widget to the the scrollbars. widget is packed -in with option expand to yes and fill to both. -widget must be a scrollable widget, i.e. have the options -xscrollcommand/yscrollcommand and the command xview/yview, -such as canvas or text. -
- NAME -
- SelectColor - - Color selection widget -
-
-
- CREATION -
- SelectColor pathName ?option value...? -
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --color -command - - - --height -parent - - - --title -type - - - --variable -width - -
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- SelectColor::setcolor - index - color - -
-DESCRIPTION
-
- -SelectColor provides a simple way to select color. It can be displayed -as a dialog box or as a menubutton. - -
--WIDGET-SPECIFIC OPTIONS
-
- -color -
- - -Specifies the color value of the widget. - - -
- -command -
- - -When type is menubutton, -specifies a command to call when user select a color. - - -
- -height -
- - -When type is menubutton, specifies the desired height for the button. - - -
- -parent -
- - -Parent of the Dialog. Dialog is centered in its parent. If empty, it is centered in -root window. - -
- -title -
- - -Title of the Dialog toplevel. - - -
- -type (read-only) -
-
-
-Specifies the type of the SelectColor widget. Must be dialog or menubutton.
-
If type option is dialog, SelectColor::create directly creates the -dialog, displays it and return an empty string if cancel button is pressed or if dialog is -destroyed, and the selected color if ok button is pressed. In all cases, dialog is destroyed. -
If type option is menubutton, SelectColor::create returns the -pathname of the widget created. It is composed of a button from which user can access a menu -displaying predefined colors. - -
-
- -variable -
- - -Specifies a variable to link to the color value of the widget. - - -
- -width -
- - -When type is menubutton, specifies the desired width for the button. - - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- SelectColor::setcolor - index - color -
- - -Set the value of user predefined color at index index to color. -index must be between 1 and 5. - -
- NAME -
- SelectFont - - Font selection widget -
-
-
- CREATION -
- SelectFont pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- - --background or -bg --font
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --command -parent - - - --sampletext -title - - - --type
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- SelectFont::loadfont - -
-DESCRIPTION
-
-
-SelectFont provides a simple way to choose font. It can be displayed
-as a dialog box or as a toolbar.
-
Textual items in Dialog box uses -name options so they
-can be translated to any language. Symbolic name used are
-ok, cancel, font, size, style,
-bold, italic, underline and overstrike.
-
-
-WIDGET-SPECIFIC OPTIONS
-
- -command -
- - -Specifies a command to call when user select a new font when SelectFont type -option is toolbar. - - -
- -parent -
- - -Parent of the Dialog. Dialog is centered in its parent. If empty, it is centered in -root window. - -
- -sampletext -
- - -Specifies the text displayed in the preview area. - - -
- -title -
- - -Title of the Dialog toplevel. - - -
- -type -
-
-
-Specifies the type of the SelectFont widget. Must be dialog or toolbar.
-
If type option is dialog, SelectFont::create directly creates the -dialog, displays it and return an empty string if cancel button is pressed or if dialog is -destroyed, and the selected font if ok button is pressed. In all cases, dialog is destroyed. -
If type option is toolbar, SelectFont::create returns the pathname -of the widget created. - -
-
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- SelectFont::loadfont -
- - -Load the font available in the system. - -
- NAME -
- Separator - - 3D separator widget -
-
-
- CREATION -
- Separator pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- - --background or -bg --orient
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --relief
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
-DESCRIPTION
-
- -Separator is a widget that display an horizontal or vertical 3-D line. - -
--WIDGET-SPECIFIC OPTIONS
-
- -relief -
- - -Specifies the relief of the Separator. Must be groove (the default) or ridge. - - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- NAME -
- SpinBox - - SpinBox widget -
-
-
- CREATION -
- SpinBox pathName ?option value...? -
-
-
- OPTIONS from ArrowButton -
-
- --background or -bg --disabledforeground -- --foreground or -fg --repeatdelay -- --repeatinterval --state -
-
-
-
- OPTIONS from Entry -
-
- --command --disabledforeground -- --dragenabled --dragendcmd -- --dragevent --draginitcmd -- --dragtype --dropcmd -- --dropenabled --dropovercmd -- --droptypes --editable -- --entrybg (see -background) --entryfg (see -foreground) -- --exportselection --font -- --helptext --helptype -- --helpvar --highlightbackground -- --highlightcolor --highlightthickness -- --insertbackground --insertborderwidth -- --insertofftime --insertontime -- --insertwidth --justify -- --selectbackground --selectborderwidth -- --selectforeground --show -- --state --takefocus -- --text --textvariable -- --width --xscrollcommand -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --modifycmd -range - - - --values
-
-
-
- WIDGET COMMAND -
- pathName bind - ?arg...? - -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getvalue - -
- pathName setvalue - index - -
-DESCRIPTION
-
- -SpinBox widget enables the user to select a value among a list given by the values -option or a set of values defined by a mininum, a maximum and an increment. -Notice that range option defines a list of values, so getvalue and -setvalue work with both values and range. - -
--WIDGET-SPECIFIC OPTIONS
-
- -modifycmd -
- - -Specifies a Tcl command called when the user modify the value of the SpinBox. - -
- -range -
- - -Specifies a list of three intergers (or real) describing the minimum, maximum and increment -of the SpinBox. - -
- -values -
- - -Specifies the values accepted by the SpinBox. This option takes precedence over -range option. - -
-WIDGET COMMAND
-
- pathName bind - ?arg...? -
- - -Set bindings on the entry widget. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getvalue -
- - -Returns the index of the current text of the SpinBox in the list of values, -or -1 if it doesn't match any value. - -
- pathName setvalue - index -
-
-
-Set the text of the SpinBox to the value indicated by index in the list of values.
-index may be specified in any of the following forms:
-
-
-
-
- -last -
- -Specifies the last element of the list of values. -
- first -
- -Specifies the first element of the list of values. -
- -next -
- -Specifies the element following the current (ie returned by getvalue) in the list -of values. -
- previous -
- -Specifies the element preceding the current (ie returned by getvalue) in the list -of values. -
- -@number -
- -Specifies the integer index in the list of values. -
BINDINGS
- -When Entry of the SpinBox has the input focus, it has the following bindings, in addition -to the default Entry bindings: -
-
-
- Page up set the value of the SpinBox to the last value. -
- Page down set the value of the SpinBox to the first value. -
- Arrow up set the value of the SpinBox to the next value. -
- Arrow down set the value of the SpinBox to the previous value. -
- NAME -
- TitleFrame - - Frame with a title -
-
-
- CREATION -
- TitleFrame pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- --font -foreground or -fg - -- --relief -text - -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --baseline -ipad - - - --side
-
-
-
- WIDGET COMMAND -
- pathName cget - option - -
- pathName configure - ?option? ?value option value ...? - -
- pathName getframe - -
-DESCRIPTION
-
- -TitleFrame enables user to create a frame with a title like XmFrame Motif widget. -
--WIDGET-SPECIFIC OPTIONS
-
- -baseline -
- - -Specifies the vertical alignment of the title: top, center or bottom. - -
- -ipad -
- - -Specifies a pad between the border of the frame and the user frame. -The value is in screen units. - -
- -side -
- - -Specifies the horizontal alignment of the title: left, center or right. - -
-WIDGET COMMAND
-
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName getframe -
- - -Return the frame where the user can create any other widget. -
- NAME -
- Tree - - Tree widget -
-
-
- CREATION -
- Tree pathName ?option value...? -
-
-
- STANDARD OPTIONS -
-
- --background or -bg --borderwidth or -bd -- --cursor -highlightbackground - - - --highlightcolor -highlightthickness - - - --relief -selectbackground - - - --selectforeground -takefocus - - - --xscrollcommand -yscrollcommand - -
-
-
-
- WIDGET-SPECIFIC OPTIONS -
-
- --closecmd -deltax - - - --deltay -dragenabled - - - --dragendcmd -dragevent - - - --draginitcmd -dragtype - - - --dropcmd -dropenabled - - - --dropovercmd -dropovermode - - - --droptypes -height - - - --linesfill -linestipple - - - --opencmd -padx - - - --redraw -showlines - - - --width
-
-
-
- WIDGET COMMAND -
- pathName bindImage - event - script - -
- pathName bindText - event - script - -
- pathName cget - option - -
- pathName closetree - node - -
- pathName configure - ?option? ?value option value ...? - -
- pathName delete - ?arg...? - -
- pathName edit - node - text - ?verifycmd? - ?clickres? - ?select? - -
- pathName exists - node - -
- pathName index - node - -
- pathName insert - index - parent - node - ?option value...? - -
- pathName itemcget - node - option - -
- pathName itemconfigure - node - ?option? ?value option value ...? - -
- pathName move - parent - node - index - -
- pathName nodes - node - ?first? - ?last? - -
- pathName opentree - node - -
- pathName parent - node - -
- pathName reorder - node - neworder - -
- pathName see - node - -
- pathName selection - cmd - ?arg...? - -
- pathName visible - node - -
- pathName xview - ?arg...? - -
- pathName yview - ?arg...? - -
-DESCRIPTION
-
- -Tree widget uses canvas to display a hierarchical list of items (called nodes). -Each node is composed of a label with its own font and foreground attributes, and an optional -image or window. Each node can have a list of subnodes, which can be collapsed or expanded. -Each node is drawn in a single line, whose height is defined by the -deltay option, so they must have at most this height. -A node is uniquely identified by a string given at creation (by the -insert command). The node named root is the root of -the tree and is not drawn. -The tree structure is directly maintained by the widget. - -
--WIDGET-SPECIFIC OPTIONS
-
- -closecmd -
- - -Specifies a command to be called when user close a node. The -closed node is appended to the command. - - -
- -deltax -
- - -Specifies horizontal indentation between a node and its children. - - -
- -deltay -
- - -Specifies vertical size of the nodes. - - -
- -dragenabled -
- -A boolean specifying if drag is enabled. - -
- -dragendcmd -
- - -Specifies a command to be called when drag ended. -dragendcmd must be a command conforming to the description of the -option dragendcmd of DragSite::register. - - -
- -dragevent -
- - -Specifies the number of the mouse button associated to the drag. -Must be 1, 2 or 3. - - -
- -draginitcmd -
-
-
-Tree has a command wrapper for drag-init events. This command refused the drag
-if no node is designated. In other cases:
-
If draginitcmd is empty, it returns: --
-
- the value of option dragtype or TREE_NODE if empty as the data type, -
- {copy move link} as the operations, -
- the node identifier as the data. -
-
-
- the pathname of the tree, -
- the identifier of the dragged node, -
- the toplevel created to represent dragged data. -
-
- -dragtype -
- - -Specifies an alternate type of dragged object. - - -
- -dropcmd -
-
-
-Tree has a command wrapper for drop events. This command stops auto scrolling
-and extract node and position.
-
If dropcmd is not empty, it is called with the following arguments: --
-
- the pathname of the tree, -
- the pathname of the drag source, -
- a list describing where the drop occurs. It can be:
-
-
-
- {widget}, -
- {node node} or -
- {position node index}. -
- the current operation, -
- the data type, -
- the data. -
-
- -dropenabled -
- -A boolean specifying if drop is enabled. - -
- -dropovercmd -
-
-
-Tree has a command wrapper for drag-over events. This command enables auto scrolling
-and position extraction during the drag-over.
-If dropovercmd is not empty, the command is called with the following aguments:
-
-
-
- the pathname of the tree, -
- the pathname of the drag source, -
- a list describing where the drop can occur, whose elements are:
-
-
-
- the string widget if dropovertype option contains w, else empty string. -
- the targeted node if drag icon points a node and dropovertype option contains n, else empty string. -
- a list containing a node and the position within the children of the node where drag -icon points to if dropovertype option contains p, else empty string. -
- optionally, the preferred method if drop can occur both inside a node and between two -nodes. The value is position or node. -
- the current operation, -
- the data type, -
- the data. -
-
-
- the drop status, conforming to those described in dropovercmd option of -DropSite::register, -
- the choosen method: widget, node or position. -
-
- -dropovermode -
- - -Specifies the type of drop-over interaction. Must be a combination of -w, which specifies that drop can occurs everywhere on widget, -p, which specifies that drop can occurs between two nodes, -and n, which specifies that drop occurs inside nodes. - - -
- -droptypes -
-
-
-Specifies a list of accepted dropped object/operation.
-See option droptypes of
-DropSite::register.
-for more infromation.
-
-
Default is TREE_NODE with operations copy and move. - -
-
- -height -
- - -Specifies the desired height for the tree in units of deltay pixels. - - -
- -linesfill -
- - -Specifies a foreground color for the lines between nodes. - - -
- -linestipple -
- - -Specifies a stipple bitmap for the lines between nodes. - - -
- -opencmd -
- - -Specifies a command to be called when user open a node. The -opened node is appended to the command. - - -
- -padx -
- - -Specifies distance between image or window and text of the nodes. - - -
- -redraw -
- - -Specifies wether or not the tree should be redrawn when entering idle. -Set it to false if you call update while modifying the tree. - - -
- -showlines -
- - -Specifies whether or not lines should be drawn between nodes. - - -
- -width -
- - -Specifies the desired width for the tree in units of 8 pixels. - - -
-WIDGET COMMAND
-
- pathName bindImage - event - script -
- - -This command associates a command to execute whenever the event -sequence given by event occurs on the image of a node. -The node idenfier on which the event occurs is appended to the command. - -
- pathName bindText - event - script -
- - -This command associates a command to execute whenever the event -sequence given by event occurs on the label of a node. -The node idenfier on which the event occurs is appended to the command. - -
- pathName cget - option -
- - -Returns the current value of the configuration option given by option. -Option may have any of the values accepted by the creation command. -
- pathName closetree - node -
- - -This command close all the subtree given by node (recurse -through the tree starting at node and set open option to 0) - -
- pathName configure - ?option? ?value option value ...? -
- - -Query or modify the configuration options of the widget. If no option is specified, -returns a list describing all of the available options for pathName. -If option is specified with no value, then the command returns a list -describing the one named option (this list will be identical to the corresponding -sublist of the value returned if no option is specified). If one or -more option-value pairs are specified, then the command modifies the given widget -option(s) to have the given value(s); in this case the command returns an empty string. -Option may have any of the values accepted by the creation command. -Read-only options are not be modified. - -
- pathName delete - ?arg...? -
- - -Deletes all nodes (and children of them) in arg. arg can be a list -of nodes or a list of list of nodes. -To delete all the tree, do $pathName delete [$pathName nodes root]. - -
- pathName edit - node - text - ?verifycmd? - ?clickres? - ?select? -
-
-
-Provides a way for the user to edit in place the label of a node. This is
-possible only if node is visible (all its parents are open).
-
The command takes the initial text as argument and does not modify the label of the -edited node, but returns an empty string if edition is canceled, or the typed text -if edition is accepted. -
When editing, the user can cancel by pressing Escape, or accept by pressing Return. -
clickres specifies what to do if the user click outside the editable area. -If clickres is 0 (the default), the edition is canceled. -If clickres is 1, the edition is accepted. -In all other case, the edition continues. -
If edition is accepted and modifycmd is not empty, then it is called with -the new text as argument and must return 1 to accept the new text, 0 to refuse it -and continue edition. -
select specifies wether or not the initial text should be selected. Default is 1. - -
- pathName exists - node -
- - -Returns whether or not node exists in the tree. - -
- pathName index - node -
- - -Returns the position of node in its parent. - -
- pathName insert - index - parent - node - ?option value...? -
-
-
-Inserts a new node identified by node in the children list of parent
-at position index.
-
-
-
- -data -
- - -User data associated to the node. - - -
- -drawcross -
-
-
-Specifies how the cross used to expand or collapse the children of a node
-should be drawn.
-Must be one of auto, allways or never.
-
If auto, the cross is drawn only if the node has children. -If allways, the cross is always drawn. -If never, the cross is never drawn. - -
-
- -fill -
- - -Specifies the foreground color of the label of the node. - - -
- -font -
- - -Specifies a font for the label of the node. - - -
- -image -
- - -Specifies an image to display at the left of the label of the node. -window option override image. - -
- -open -
- - -Specifies wether or not the children of the node should be drawn. - - -
- -text -
- - -Specifies the label of the node. - - -
- -window -
- - -Specifies a pathname to display at the left of the label of the node. -window option override image. - -
- pathName itemcget - node - option -
- - -Returns the current value of a configuration option for the item. -Option may have any of the values accepted by the item creation command. - -
- pathName itemconfigure - node - ?option? ?value option value ...? -
- - -This command is similar to the configure command, except that it applies to the -options for an individual item, whereas configure applies to the options for -the widget as a whole. Options may have any of the values accepted by the -item creation widget command. If options are specified, options are modified as indicated -in the command and the command returns an empty string. If no options are specified, -returns a list describing the current options for the item. -Read-only options are not be modified. - -
- pathName move - parent - node - index -
- - -Moves node to the children list of parent at position index. -parent can not be a descendant of node. - -
- pathName nodes - node - ?first? - ?last? -
-
-
-Returns parts of the children of node, following first and last.
-If first and last are omitted, returns the list of all children. -If first is specified and last omitted, returns the child at index -first, or an empty string if first refers to a non-existent element. -If first and last are specified, the command returns a list whose elements -are all of the children between first and last, -inclusive. Both first and last may have any of the standard -forms for indices. - -
- pathName opentree - node -
- - -This command open all the subtree given by node (recurse -through the tree starting at node and set open option to 1) - -
- pathName parent - node -
- - -Returns the parent of node. - -
- pathName reorder - node - neworder -
- - -Modifies the order of children of node given by neworder. Children of -node that do not appear in neworder are no moved. - -
- pathName see - node -
- - -Arrange the scrolling area to make node visible. - -
- pathName selection - cmd - ?arg...? -
-
-
-Modifies the list of selected nodes following cmd:
-
-
-
- clear -
- remove all nodes of the selection. -
- set -
- set the selection to all nodes in arg -
- add -
- add all nodes of arg in the selection -
- remove -
- remove all nodes of arg of the selection -
- get -
- return the current selected nodes -
- pathName visible - node -
- - -Returns whether or not node is visible (all its parents are open). - -
- pathName xview - ?arg...? -
- - -Standard command to enable horizontal scrolling of pathName. - -
- pathName yview - ?arg...? -
- - -Standard command to enable vertical scrolling of pathName. - -
Under construction ...-
- NAME -
- Widget - - The Widget base class -
-
-
- COMMAND -
- Widget::addmap - class - subclass - subpath - options - -
- Widget::bwinclude - class - subclass - subpath - ?arg...? - -
- Widget::cget - path - option - -
- Widget::configure - path - options - -
- Widget::declare - class - optlist - -
- Widget::destroy - path - -
- Widget::focusNext - w - -
- Widget::focusOK - w - -
- Widget::focusPrev - w - -
- Widget::generate-doc - dir - widgetlist - -
- Widget::generate-widget-doc - class - iscmd - file - -
- Widget::getoption - path - option - -
- Widget::hasChanged - path - option - pvalue - -
- Widget::init - class - path - options - -
- Widget::setoption - path - option - value - -
- Widget::subcget - path - subwidget - -
- Widget::syncoptions - class - subclass - subpath - options - -
- Widget::tkinclude - class - tkwidget - subpath - ?arg...? - -
-DESCRIPTION
-
-
-The Widget namespace handle data associated to all BWidget and provide commands
-to easily define BWidget.
-
For commands can be used to define a BWidget:
-tkinclude, bwinclude, declare, addmap and syncoptions.
-Here is the definition of ComboBox widget:
-
-
-namespace eval ComboBox {
- # We're using ArrowButton, Entry and LabelFrame
- ArrowButton::use
- Entry::use
- LabelFrame::use
-
- # Include resources of LabelFrame
- Widget::bwinclude ComboBox LabelFrame .labf \
- rename {-text -label} \
- remove {-focus} \
- prefix {label -justify -width -anchor -height -font} \
- initialize {-relief sunken -borderwidth 2}
-
- # Include resources of Entry
- Widget::bwinclude ComboBox Entry .e \
- remove {-relief -bd -borderwidth -bg -fg} \
- rename {-foreground -entryfg -background -entrybg}
-
- # Declare new resources
- Widget::declare ComboBox {
- {-height TkResource 0 0 listbox}
- {-values String "" 0}
- {-modifycmd String "" 0}
- {-postcommand String "" 0}
- }
-
- # Map resources to subwidget
- Widget::addmap ComboBox "" :cmd {-background {}}
- Widget::addmap ComboBox ArrowButton .a \
- {-foreground {} -background {} -disabledforeground {} -state {}}
-
- # Synchronize subwidget options
- Widget::syncoptions ComboBox Entry .e {-text {}}
- Widget::syncoptions ComboBox LabelFrame .labf {-label -text -underline {}}
-
- proc use {} {}
-}
- |
-COMMAND
-
- Widget::addmap - class - subclass - subpath - options -
-
-
-This command map some resources to subwidget.
-Mapped resources automatically configure subwidget when widget is configured.
-
-
-
- class is the class of the new BWidget -
- subclass is the class the subwidget (BWidget class, e.g Entry, or empty for Tk widget) -
- subpath is the path of the subwidget -
- options is the list {option realres ...} of options to map to subwidget -
- Widget::bwinclude - class - subclass - subpath - ?arg...? -
-
-
-This command includes into a new BWidget the resources of another BWidget.
-Arguments are:
-
-
-
- class class of the new widget -
- subclass class name of the BWidget to be included -
- subpath path of the widget to configure when BWidget is configured -
- options is:
-
-
-
- include {option option ...}
-
list of options to include (all if not defined) - - remove {option option ...}
-
list of options to remove - - rename {option name option name ...}
-
list of options to rename - - prefix {prefix option option ...}
-
pefix all option by prefix - - initialize {option value option value ...}
-
default value of options - - readonly {option value option value ...}
-
new readonly flag -
- include {option option ...}
-
- Widget::cget - path - option -
- - -Returns the value of option of BWidget path. cget tests the option -existence and takes care of synchronization with subwidget. -Typically called by the BWidget cget command. - -
- Widget::configure - path - options -
- -Description text -
- Widget::declare - class - optlist -
-
-
-This command declare new resources for a BWidget.
-
-
-
- class is class of the new widget -
- options is the list describing new options. Each new option is a list
-{option type value ro ?args?} where:
-
-
-
- option is the name of the option -
- type is the type of the option -
- value is the default value of the option -
- ro is the readonly flag of the option -
- args depends on type -
-type can be: -
--
-
- TkResource -
-
-value of option denotes a resource of a Tk widget. args must be class or
-{class realoption}. class is the creation command of the Tk widget, e.g.
-entry.
-The second form must be used if option has not the same name in Tk widget,
-but realoption.
-
If value is empty, it is initialized to the default value of the Tk widget. -
-
- - BwResource -
-
-value of option denotes a resource of a BWidget. args must be class or
-{class realoption}. class is the name of the namespace of the BWidget, e.g.
-LabelFrame.
-The second form must be used if option has not the same name in BWidget,
-but realoption.
-
If value is empty, it is initialized to the default value of the BWidget. -
-
- - Int -
- value of option is an integer. -args can be {?min? ?max?} to force it to be in a range. The test is -[expr $option>$min] && [expr $option<$max] so -if args is {0 10}, value must be beetween 0 and 10 exclude, -if args is {=0 =10} , value must be beetween 0 and 10 include. - - -
- Boolean -
- value of option is a boolean. True values can be 1, true or yes. -False values can be 0, false or no. Widget::cget always return -0 or 1. - - -
- Enum -
- -value of option is a element of a enumeration. args must be the list -of enumeration, e.g. {top left bottom right}. - - -
- Flag -
- -value of option is a combination of a set of chars. args must be a -string defining the set. - - -
- String -
-
-
- value of option is any uncontrolled string. -
- - - Synonym -
-
-
- option is a synonym of option args. value has no effect here. -
- -
- Widget::destroy - path -
- -Description text -
- Widget::focusNext - w -
- -Description text -
- Widget::focusOK - w -
- -Description text -
- Widget::focusPrev - w -
- -Description text -
- Widget::generate-doc - dir - widgetlist -
- -Description text -
- Widget::generate-widget-doc - class - iscmd - file -
- -Description text -
- Widget::getoption - path - option -
- - -Returns the value of option of BWidget path. This command does not test -option existence, does not handle synonym and does not take care of synchronization with -subwidget. - -
- Widget::hasChanged - path - option - pvalue -
- -Description text -
- Widget::init - class - path - options -
- -Description text -
- Widget::setoption - path - option - value -
- - -Set the value of option of BWidget path without option test, subwidget mapping, -synonym handling and does not set the modification flag. - -
- Widget::subcget - path - subwidget -
- - -Returns the list of all option/value of BWidget path that are mapped to subwidget. - -
- Widget::syncoptions - class - subclass - subpath - options -
-
-
-This command synchronize options value of a subwidget.
-Used when an option of a subwidget is modified out of the BWidget configure command.
-
-
-
- class is the class of the new BWidget -
- subclass is the class the subwidget (BWidget class, e.g Entry, or empty for Tk widget) -
- subpath is the path of the subwidget -
- options is the list {option realres ...} of options to synchronize -with subwidget -
- Widget::tkinclude - class - tkwidget - subpath - ?arg...? -
-
-
-This command includes into a new BWidget the resources of a Tk widget.
-Arguments are:
-
-
-
- class class of the new widget -
- tkwidger command name of the Tk widget to be included -
- subpath path of the widget to configure when BWidget is configured -
- options is:
-
-
-
- include {option option ...}
-
list of options to include (all if not defined) - - remove {option option ...}
-
list of options to remove - - rename {option name option name ...}
-
list of options to rename - - prefix {prefix option option ...}
-
pefix all option by prefix - - initialize {option value option value ...}
-
default value of options - - readonly {option value option value ...}
-
new readonly flag -
- include {option option ...}
-
-Entry
-Button
-ArrowButton
-ProgressBar
-ScrollView
-Separator
-MainFrame
-LabelFrame
-TitleFrame
-ScrolledWindow
-ScrollableFrame
-PanedWindow
-ButtonBox
-PagesManager
-NoteBook
-Dialog
-LabelEntry
-ComboBox
-SpinBox
-Tree
-ListBox
-MessageDlg
-ProgressDlg
-PasswdDlg
-SelectFont
-SelectColor
-Widget
-DynamicHelp
-DragSite
-DropSite
-BWidget
- diff --git a/hlp/ru/bwidget/navtree.html b/hlp/ru/bwidget/navtree.html deleted file mode 100644 index d6ca56d..0000000 --- a/hlp/ru/bwidget/navtree.html +++ /dev/null @@ -1,39 +0,0 @@ - -Brief description
-Simple Widgets
- Label
- Entry
- Button
- ArrowButton
- ProgressBar
- ScrollView
- Separator
-Manager Widgets
- MainFrame
- LabelFrame
- TitleFrame
- ScrolledWindow
- ScrollableFrame
- PanedWindow
- ButtonBox
- PagesManager
- NoteBook
- Dialog
-Composite Widgets
- LabelEntry
- ComboBox
- SpinBox
- Tree
- ListBox
- MessageDlg
- ProgressDlg
- PasswdDlg
- SelectFont
- SelectColor
-Commands Classes
- Widget
- DynamicHelp
- DragSite
- DropSite
- BWidget
- diff --git a/hlp/ru/bwidget/options.htm b/hlp/ru/bwidget/options.htm deleted file mode 100644 index 0c6f494..0000000 --- a/hlp/ru/bwidget/options.htm +++ /dev/null @@ -1,449 +0,0 @@ -
-
-
- NAME
-
- options - Standard options supported by widgets
- DESCRIPTION -
-
-
- -activebackground, activeBackground, Foreground
-
- -activeborderwidth, activeBorderWidth, BorderWidth -
- -activeforeground, activeForeground, Background -
- -anchor, anchor, Anchor -
- -background or -bg, background, Background -
- -bitmap, bitmap, Bitmap -
- -borderwidth or -bd, borderWidth, BorderWidth -
- -cursor, cursor, Cursor -
- -disabledforeground, disabledForeground, DisabledForeground -
- -exportselection, exportSelection, ExportSelection -
- -font, font, Font -
- -foreground or -fg, foreground, Foreground -
- -highlightbackground, highlightBackground, HighlightBackground -
- -highlightcolor, highlightColor, HighlightColor -
- -highlightthickness, highlightThickness, HighlightThickness -
- -image, image, Image -
- -insertbackground, insertBackground, Foreground -
- -insertborderwidth, insertBorderWidth, BorderWidth -
- -insertofftime, insertOffTime, OffTime -
- -insertontime, insertOnTime, OnTime -
- -insertwidth, insertWidth, InsertWidth -
- -jump, jump, Jump -
- -justify, justify, Justify -
- -orient, orient, Orient -
- -padx, padX, Pad -
- -pady, padY, Pad -
- -relief, relief, Relief -
- -repeatdelay, repeatDelay, RepeatDelay -
- -repeatinterval, repeatInterval, RepeatInterval -
- -selectbackground, selectBackground, Foreground -
- -selectborderwidth, selectBorderWidth, BorderWidth -
- -selectforeground, selectForeground, Background -
- -setgrid, setGrid, SetGrid -
- -takefocus, takeFocus, TakeFocus -
- -text, text, Text -
- -textvariable, textVariable, Variable -
- -troughcolor, troughColor, Background -
- -underline, underline, Underline -
- -wraplength, wrapLength, WrapLength -
- -xscrollcommand, xScrollCommand, ScrollCommand -
- -yscrollcommand, yScrollCommand, ScrollCommand -
- -activeborderwidth, activeBorderWidth, BorderWidth -
- KEYWORDS -
-
NAME
-options - Standard options supported by widgets -DESCRIPTION
-This manual entry describes the common configuration options supported -by widgets in the Tk toolkit. Every widget does not necessarily support -every option (see the manual entries for individual widgets for a list -of the standard options supported by that widget), but if a widget does -support an option with one of the names listed below, then the option -has exactly the effect described below. --In the descriptions below, ``Command-Line Name'' refers to the -switch used in class commands and configure widget commands to -set this value. For example, if an option's command-line switch is --foreground and there exists a widget .a.b.c, then the -command -
.a.b.c configure -foreground black-may be used to specify the value black for the option in the -the widget .a.b.c. Command-line switches may be abbreviated, -as long as the abbreviation is unambiguous. -``Database Name'' refers to the option's name in the option database (e.g. -in .Xdefaults files). ``Database Class'' refers to the option's class value -in the option database. -
-
-
- Command-Line Name: -activebackground
-
- Database Name: activeBackground -
- Database Class: Foreground -
- Database Name: activeBackground -
- Specifies background color to use when drawing active elements. -An element (a widget or portion of a widget) is active if the -mouse cursor is positioned over the element and pressing a mouse button -will cause some action to occur. -If strict Motif compliance has been requested by setting the -tk_strictMotif variable, this option will normally be -ignored; the normal background color will be used instead. -For some elements on Windows and Macintosh systems, the active color -will only be used while mouse button 1 is pressed over the element. -
- Command-Line Name: -activeborderwidth
-
- Database Name: activeBorderWidth -
- Database Class: BorderWidth -
- Database Name: activeBorderWidth -
- Specifies a non-negative value indicating -the width of the 3-D border drawn around active elements. See above for -definition of active elements. -The value may have any of the forms acceptable to Tk_GetPixels. -This option is typically only available in widgets displaying more -than one element at a time (e.g. menus but not buttons). -
- Command-Line Name: -activeforeground
-
- Database Name: activeForeground -
- Database Class: Background -
- Database Name: activeForeground -
- Specifies foreground color to use when drawing active elements. -See above for definition of active elements. -
- Command-Line Name: -anchor
-
- Database Name: anchor -
- Database Class: Anchor -
- Database Name: anchor -
- Specifies how the information in a widget (e.g. text or a bitmap) -is to be displayed in the widget. -Must be one of the values n, ne, e, se, -s, sw, w, nw, or center. -For example, nw means display the information such that its -top-left corner is at the top-left corner of the widget. -
- Command-Line Name: -background or -bg
-
- Database Name: background -
- Database Class: Background -
- Database Name: background -
- Specifies the normal background color to use when displaying the -widget. -
- Command-Line Name: -bitmap
-
- Database Name: bitmap -
- Database Class: Bitmap -
- Database Name: bitmap -
- Specifies a bitmap to display in the widget, in any of the forms -acceptable to Tk_GetBitmap. -The exact way in which the bitmap is displayed may be affected by -other options such as anchor or justify. -Typically, if this option is specified then it overrides other -options that specify a textual value to display in the widget; -the bitmap option may be reset to an empty string to re-enable -a text display. -In widgets that support both bitmap and image options, -image will usually override bitmap. -
- Command-Line Name: -borderwidth or -bd
-
- Database Name: borderWidth -
- Database Class: BorderWidth -
- Database Name: borderWidth -
- Specifies a non-negative value indicating the width -of the 3-D border to draw around the outside of the widget (if such a -border is being drawn; the relief option typically determines -this). The value may also be used when drawing 3-D effects in the -interior of the widget. -The value may have any of the forms acceptable to Tk_GetPixels. -
- Command-Line Name: -cursor
-
- Database Name: cursor -
- Database Class: Cursor -
- Database Name: cursor -
- Specifies the mouse cursor to be used for the widget. -The value may have any of the forms acceptable to Tk_GetCursor. -
- Command-Line Name: -disabledforeground
-
- Database Name: disabledForeground -
- Database Class: DisabledForeground -
- Database Name: disabledForeground -
- Specifies foreground color to use when drawing a disabled element. -If the option is specified as an empty string (which is typically the -case on monochrome displays), disabled elements are drawn with the -normal foreground color but they are dimmed by drawing them -with a stippled fill pattern. -
- Command-Line Name: -exportselection
-
- Database Name: exportSelection -
- Database Class: ExportSelection -
- Database Name: exportSelection -
- Specifies whether or not a selection in the widget should also be -the X selection. -The value may have any of the forms accepted by Tcl_GetBoolean, -such as true, false, 0, 1, yes, or no. -If the selection is exported, then selecting in the widget deselects -the current X selection, selecting outside the widget deselects any -widget selection, and the widget will respond to selection retrieval -requests when it has a selection. The default is usually for widgets -to export selections. -
- Command-Line Name: -font
-
- Database Name: font -
- Database Class: Font -
- Database Name: font -
- Specifies the font to use when drawing text inside the widget. -
- Command-Line Name: -foreground or -fg
-
- Database Name: foreground -
- Database Class: Foreground -
- Database Name: foreground -
- Specifies the normal foreground color to use when displaying the widget. -
- Command-Line Name: -highlightbackground
-
- Database Name: highlightBackground -
- Database Class: HighlightBackground -
- Database Name: highlightBackground -
- Specifies the color to display in the traversal highlight region when -the widget does not have the input focus. -
- Command-Line Name: -highlightcolor
-
- Database Name: highlightColor -
- Database Class: HighlightColor -
- Database Name: highlightColor -
- Specifies the color to use for the traversal highlight rectangle that is -drawn around the widget when it has the input focus. -
- Command-Line Name: -highlightthickness
-
- Database Name: highlightThickness -
- Database Class: HighlightThickness -
- Database Name: highlightThickness -
- Specifies a non-negative value indicating the width of the highlight -rectangle to draw around the outside of the widget when it has the -input focus. -The value may have any of the forms acceptable to Tk_GetPixels. -If the value is zero, no focus highlight is drawn around the widget. -
- Command-Line Name: -image
-
- Database Name: image -
- Database Class: Image -
- Database Name: image -
- Specifies an image to display in the widget, which must have been -created with the image create command. -Typically, if the image option is specified then it overrides other -options that specify a bitmap or textual value to display in the widget; -the image option may be reset to an empty string to re-enable -a bitmap or text display. -
- Command-Line Name: -insertbackground
-
- Database Name: insertBackground -
- Database Class: Foreground -
- Database Name: insertBackground -
- Specifies the color to use as background in the area covered by the -insertion cursor. This color will normally override either the normal -background for the widget (or the selection background if the insertion -cursor happens to fall in the selection). -
- Command-Line Name: -insertborderwidth
-
- Database Name: insertBorderWidth -
- Database Class: BorderWidth -
- Database Name: insertBorderWidth -
- Specifies a non-negative value indicating the width -of the 3-D border to draw around the insertion cursor. -The value may have any of the forms acceptable to Tk_GetPixels. -
- Command-Line Name: -insertofftime
-
- Database Name: insertOffTime -
- Database Class: OffTime -
- Database Name: insertOffTime -
- Specifies a non-negative integer value indicating the number of -milliseconds the insertion cursor should remain ``off'' in each blink cycle. -If this option is zero then the cursor doesn't blink: it is on -all the time. -
- Command-Line Name: -insertontime
-
- Database Name: insertOnTime -
- Database Class: OnTime -
- Database Name: insertOnTime -
- Specifies a non-negative integer value indicating the number of -milliseconds the insertion cursor should remain ``on'' in each blink cycle. -
- Command-Line Name: -insertwidth
-
- Database Name: insertWidth -
- Database Class: InsertWidth -
- Database Name: insertWidth -
- Specifies a value indicating the total width of the insertion cursor. -The value may have any of the forms acceptable to Tk_GetPixels. -If a border has been specified for the insertion -cursor (using the insertBorderWidth option), the border -will be drawn inside the width specified by the insertWidth -option. -
- Command-Line Name: -jump
-
- Database Name: jump -
- Database Class: Jump -
- Database Name: jump -
- For widgets with a slider that can be dragged to adjust a value, -such as scrollbars, this option determines when -notifications are made about changes in the value. -The option's value must be a boolean of the form accepted by -Tcl_GetBoolean. -If the value is false, updates are made continuously as the -slider is dragged. -If the value is true, updates are delayed until the mouse button -is released to end the drag; at that point a single notification -is made (the value ``jumps'' rather than changing smoothly). -
- Command-Line Name: -justify
-
- Database Name: justify -
- Database Class: Justify -
- Database Name: justify -
- When there are multiple lines of text displayed in a widget, this -option determines how the lines line up with each other. -Must be one of left, center, or right. -Left means that the lines' left edges all line up, center -means that the lines' centers are aligned, and right means -that the lines' right edges line up. -
- Command-Line Name: -orient
-
- Database Name: orient -
- Database Class: Orient -
- Database Name: orient -
- For widgets that can lay themselves out with either a horizontal -or vertical orientation, such as scrollbars, this option specifies -which orientation should be used. Must be either horizontal -or vertical or an abbreviation of one of these. -
- Command-Line Name: -padx
-
- Database Name: padX -
- Database Class: Pad -
- Database Name: padX -
- Specifies a non-negative value indicating how much extra space -to request for the widget in the X-direction. -The value may have any of the forms acceptable to Tk_GetPixels. -When computing how large a window it needs, the widget will -add this amount to the width it would normally need (as determined -by the width of the things displayed in the widget); if the geometry -manager can satisfy this request, the widget will end up with extra -internal space to the left and/or right of what it displays inside. -Most widgets only use this option for padding text: if they are -displaying a bitmap or image, then they usually ignore padding -options. -
- Command-Line Name: -pady
-
- Database Name: padY -
- Database Class: Pad -
- Database Name: padY -
- Specifies a non-negative value indicating how much extra space -to request for the widget in the Y-direction. -The value may have any of the forms acceptable to Tk_GetPixels. -When computing how large a window it needs, the widget will add -this amount to the height it would normally need (as determined by -the height of the things displayed in the widget); if the geometry -manager can satisfy this request, the widget will end up with extra -internal space above and/or below what it displays inside. -Most widgets only use this option for padding text: if they are -displaying a bitmap or image, then they usually ignore padding -options. -
- Command-Line Name: -relief
-
- Database Name: relief -
- Database Class: Relief -
- Database Name: relief -
- Specifies the 3-D effect desired for the widget. Acceptable -values are raised, sunken, flat, ridge, -solid, and groove. -The value -indicates how the interior of the widget should appear relative -to its exterior; for example, raised means the interior of -the widget should appear to protrude from the screen, relative to -the exterior of the widget. -
- Command-Line Name: -repeatdelay
-
- Database Name: repeatDelay -
- Database Class: RepeatDelay -
- Database Name: repeatDelay -
- Specifies the number of milliseconds a button or key must be held -down before it begins to auto-repeat. Used, for example, on the -up- and down-arrows in scrollbars. -
- Command-Line Name: -repeatinterval
-
- Database Name: repeatInterval -
- Database Class: RepeatInterval -
- Database Name: repeatInterval -
- Used in conjunction with repeatDelay: once auto-repeat -begins, this option determines the number of milliseconds between -auto-repeats. -
- Command-Line Name: -selectbackground
-
- Database Name: selectBackground -
- Database Class: Foreground -
- Database Name: selectBackground -
- Specifies the background color to use when displaying selected -items. -
- Command-Line Name: -selectborderwidth
-
- Database Name: selectBorderWidth -
- Database Class: BorderWidth -
- Database Name: selectBorderWidth -
- Specifies a non-negative value indicating the width -of the 3-D border to draw around selected items. -The value may have any of the forms acceptable to Tk_GetPixels. -
- Command-Line Name: -selectforeground
-
- Database Name: selectForeground -
- Database Class: Background -
- Database Name: selectForeground -
- Specifies the foreground color to use when displaying selected -items. -
- Command-Line Name: -setgrid
-
- Database Name: setGrid -
- Database Class: SetGrid -
- Database Name: setGrid -
- Specifies a boolean value that determines whether this widget controls the -resizing grid for its top-level window. -This option is typically used in text widgets, where the information -in the widget has a natural size (the size of a character) and it makes -sense for the window's dimensions to be integral numbers of these units. -These natural window sizes form a grid. -If the setGrid option is set to true then the widget will -communicate with the window manager so that when the user interactively -resizes the top-level window that contains the widget, the dimensions of -the window will be displayed to the user in grid units and the window -size will be constrained to integral numbers of grid units. -See the section GRIDDED GEOMETRY MANAGEMENT in the wm manual -entry for more details. -
- Command-Line Name: -takefocus
-
- Database Name: takeFocus -
- Database Class: TakeFocus -
- Database Name: takeFocus -
- Determines whether the window accepts the focus during keyboard -traversal (e.g., Tab and Shift-Tab). -Before setting the focus to a window, the traversal scripts -consult the value of the takeFocus option. -A value of 0 means that the window should be skipped entirely -during keyboard traversal. -1 means that the window should receive the input -focus as long as it is viewable (it and all of its ancestors are mapped). -An empty value for the option means that the traversal scripts make -the decision about whether or not to focus on the window: the current -algorithm is to skip the window if it is -disabled, if it has no key bindings, or if it is not viewable. -If the value has any other form, then the traversal scripts take -the value, append the name of the window to it (with a separator space), -and evaluate the resulting string as a Tcl script. -The script must return 0, 1, or an empty string: a -0 or 1 value specifies whether the window will receive -the input focus, and an empty string results in the default decision -described above. -Note: this interpretation of the option is defined entirely by -the Tcl scripts that implement traversal: the widget implementations -ignore the option entirely, so you can change its meaning if you -redefine the keyboard traversal scripts. -
- Command-Line Name: -text
-
- Database Name: text -
- Database Class: Text -
- Database Name: text -
- Specifies a string to be displayed inside the widget. The way in which -the string is displayed depends on the particular widget and may be -determined by other options, such as anchor or justify. -
- Command-Line Name: -textvariable
-
- Database Name: textVariable -
- Database Class: Variable -
- Database Name: textVariable -
- Specifies the name of a variable. The value of the variable is a text -string to be displayed inside the widget; if the variable value changes -then the widget will automatically update itself to reflect the new value. -The way in which the string is displayed in the widget depends on the -particular widget and may be determined by other options, such as -anchor or justify. -
- Command-Line Name: -troughcolor
-
- Database Name: troughColor -
- Database Class: Background -
- Database Name: troughColor -
- Specifies the color to use for the rectangular trough areas -in widgets such as scrollbars and scales. -
- Command-Line Name: -underline
-
- Database Name: underline -
- Database Class: Underline -
- Database Name: underline -
- Specifies the integer index of a character to underline in the widget. -This option is used by the default bindings to implement keyboard -traversal for menu buttons and menu entries. -0 corresponds to the first character of the text displayed in the -widget, 1 to the next character, and so on. -
- Command-Line Name: -wraplength
-
- Database Name: wrapLength -
- Database Class: WrapLength -
- Database Name: wrapLength -
- For widgets that can perform word-wrapping, this option specifies -the maximum line length. -Lines that would exceed this length are wrapped onto the next line, -so that no line is longer than the specified length. -The value may be specified in any of the standard forms for -screen distances. -If this value is less than or equal to 0 then no wrapping is done: lines -will break only at newline characters in the text. -
- Command-Line Name: -xscrollcommand
-
- Database Name: xScrollCommand -
- Database Class: ScrollCommand -
- Database Name: xScrollCommand -
- Specifies the prefix for a command used to communicate with horizontal -scrollbars. -When the view in the widget's window changes (or -whenever anything else occurs that could change the display in a -scrollbar, such as a change in the total size of the widget's -contents), the widget will -generate a Tcl command by concatenating the scroll command and -two numbers. -Each of the numbers is a fraction between 0 and 1, which indicates -a position in the document. 0 indicates the beginning of the document, -1 indicates the end, .333 indicates a position one third the way through -the document, and so on. -The first fraction indicates the first information in the document -that is visible in the window, and the second fraction indicates -the information just after the last portion that is visible. -The command is -then passed to the Tcl interpreter for execution. Typically the -xScrollCommand option consists of the path name of a scrollbar -widget followed by ``set'', e.g. ``.x.scrollbar set'': this will cause -the scrollbar to be updated whenever the view in the window changes. -If this option is not specified, then no command will be executed. -
- Command-Line Name: -yscrollcommand
-
- Database Name: yScrollCommand -
- Database Class: ScrollCommand -
- Database Name: yScrollCommand -
- Specifies the prefix for a command used to communicate with vertical -scrollbars. This option is treated in the same way as the -xScrollCommand option, except that it is used for vertical -scrollbars and is provided by widgets that support vertical scrolling. -See the description of xScrollCommand for details -on how this option is used. - -
KEYWORDS
-class, name, standard option, switch --Copyright © 1990-1994 The Regents of the University of California. -Copyright © 1994-1996 Sun Microsystems, Inc. -Copyright © 1995-1997 Roger E. Critchlow Jr.- diff --git a/hlp/ru/projman/about.html b/hlp/ru/projman/about.html deleted file mode 100644 index 76a5634..0000000 --- a/hlp/ru/projman/about.html +++ /dev/null @@ -1,19 +0,0 @@ - - - -
Документация
Документация предоставлена компанией -DataX/FLORIN, Inc. -
© Все права защищены 1992-2001. -
Разрешается некоммерческое использование документации как целиком так и отдельных частей с разрешения авторов и с обязательной ссылкой на
-DataX/FLORIN, Inc. и на
-Sergey Kalinin
-
-
-
-
-
-
diff --git a/hlp/ru/projman/faq.txt b/hlp/ru/projman/faq.txt
deleted file mode 100644
index f2cbb1c..0000000
--- a/hlp/ru/projman/faq.txt
+++ /dev/null
@@ -1,62 +0,0 @@
-Tcl/Tk Project Manager FAQ 0.1
-
-В. Что такое ProjMan?
-
-О.Tcl/Tk Project Manager - это интегрированная среда программирования на
-интерпретирующем языке высокого уровня Tcl/Tk, приспособленная для
-создания и поддержки многофайловых проектов.
-
-В. Почему ProjMan лучше других IDE?
-
-О. * Встроенная справочная ситема позволяет разобраться в языке даже новичку.
-* Простота визуального интерфейса не влияет на удобочитаемость кода.
-* Адаптированность под развитые средства системы Linux делают ProjMan еще более мощным инструментом в руках опытного программиста
-* Среда как и сама Linux является OpenSource.
-
-В. Как установить ProjMan? Что для этого нужно?
-
-О. Поскольку ProjMan написан непосредственно на Tcl/Tk, он способен работать
-под управлением UNIX/XWindow, MSWindows, Macintosh c установленным
-дистрибутивом языка Tcl/Tk(в Linux и Win32 проверенна работоспособность,
-на счет других ОС дайте знать).
-
-Вам потребуется интерпретатор языка Tcl/Tk(более подробную информацию по
-Tcl/Tk можно найти на сайте http://www.tcl-tk.org), BWidget Автор: Сергей Калинин (aka BanZaj) banzaj28@yandex.ru
- IDE для программирования на Tcl/Tk
- Включает в себя:
- СОЗДАНИЕ ПРОЕКТА
- Для начала необходимо создать новый (либо открыть существующий) проект.
- ОТКРЫТИЕ ПРОЕКТА
- Чтобы открыть (добавить в дерево проектов) существующий проект, необходимо в меню "Проекты" выбрать пункт "Открыть проект". После этого на экран будет выведено окно выбора директории, где Вам следует выбрать каталог с тем проектом, который хотите добавить, для этого щелкните левой кнопкой мыши на нужном каталоге (в нижнем поле должно появиться полное путевое имя этого каталога) и нажмите кнопку "Выбрать". После этого откроется форма нового проекта с заполненными некоторыми полями, необходимо заполнить все поля и нажать кнопку "Создать". файлы проекта будут скопированы в директорию с проектами, установленную в "Настройках" и проект отобразится в дереве проектов.
- ВЫБОР АКТИВНОГО ПРОЕКТА
- Все операции с проектами доступны только для активного проекта.
-Название активного проекта отображается в строке статуса внизу основного окна программы. Чтобы сделать нужный проект активным необходимо щелкнуть мышкой на имени проекта в дереве проектов.
- УДАЛЕНИЕ ПРОЕКТА
- Для удаления текущего (активного) проекта нужно в меню "Проекты" выбрать пункт "Удалить проект" и подтвердить операцию.
- РЕДАКТИРОВАНИЕ ФАЙЛА
- Чтобы открыть нужный файл для просмотра или редактирования щелкните два раза мышкой на имени этого файла. Редактор позволяет одновременно открывать большое количество файлов. Переключения между окнами редактора осуществляется нажатием сочитания клавиш Control + m.
-
-
-
-
diff --git a/hlp/ru/projman/pmhelp.html b/hlp/ru/projman/pmhelp.html
deleted file mode 100644
index aa62e39..0000000
--- a/hlp/ru/projman/pmhelp.html
+++ /dev/null
@@ -1,9 +0,0 @@
- Для облегчения доступа к справочной информации Project Manager оснащен контекстно-зависимой справочной системой. Через систему помощи доступна документация по Tcl/Tk Project manager, по операторам и командам языка Tcl и графического расширения Tk.
- Чтобы воспользоваться встроенной справочной системой нужно нажать на клавишу F1, в результате чего на экран будет выведено окно справочной системы.
- Для получения справки по какому-либо оператору необходимо в редакторе выделить этот оператор и нажать F1. Либо в окне справочной системы найти в списке операторов нужный Вам и щелкнуть на него мышкой.
-
-
-
-
diff --git a/hlp/ru/projman/pmkeys.html b/hlp/ru/projman/pmkeys.html
deleted file mode 100644
index 7229a64..0000000
--- a/hlp/ru/projman/pmkeys.html
+++ /dev/null
@@ -1,29 +0,0 @@
- Ctrl + A - Сохранить файл под другим именем.
- Ctrl + C - Команда копирует выделенный в окне редактора текст в буфер обмена.
- Ctrl + F - Поиск заданного выражения в тексте.
- Ctrl + G - Перейти к строке с заданным номером.
- Ctrl + J - Вывести список функций с именами полностью или частично совпадающими с введенным.
- Ctrl + L - Вывести список слов, полностью или частично совпадающих с введенным.
- Ctrl + M - Переключение между открытыми файлами (между окнами редактора).
- Ctrl + N - Создать новый файл. Команда вызывает диалог создания файла.
- Ctrl + O - Открыть файл.
- Ctrl + Q - Выход из Project Manager-a.
- Ctrl + R - Поиск и замена заданного выражения в тексте.
- Ctrl + S - Сохранить файл. Сохраняется файл, который открыт в текущем окне редактора.
- Ctrl + T - Поменять местами два символа, стоящих до и после курсора.
- Ctrl + U - Перемещает курсор на соответствующую открытую или закрытую скобку.
- Ctrl + V - Вставка фрагмента текста из буфера обмена, скопированного предыдущей командой.
- Ctrl + W - Закрыть файл. Команда закрывает файл открытый в текущем окне редактора.
- Ctrl + X - Вырезать выделенный фрагмент текста в буфер омена.
- Ctrl + Z - Отменить операцию
- F1 - Вызов системы помощи по программе и по языку. Если в тексте выделить команду и нажать данную клавишу то будет выведена на экран подсказка по этой команде.
- F3 - Повторный поиск, команда работает с последним введенным выражением в диалоговом окне поиска
- F5 - Команда создания архивного файла. Работает только с активным проектом
- F6 - Создание RPM.
- F9 - Выполнение ("компиляция") текущего (активного) проекта.
-
-
-
diff --git a/hlp/ru/projman/pmregexp.html b/hlp/ru/projman/pmregexp.html
deleted file mode 100644
index 12ab354..0000000
--- a/hlp/ru/projman/pmregexp.html
+++ /dev/null
@@ -1,81 +0,0 @@
- Copyright (c) 2000-2001 Laurent Riesterer
- ABOUT
- VisualREGEXP helps you to design, debug or more generally work with regular
-expression. As it is often difficult to write the right regexp at the first
-try, this tool will show you the effect of your regexp on a sample you can
-choose.
- REQUIREMENTS
- This program requires Tcl/Tk 8.3.0 or later.
- HOW TO USE
-
- Launching the program
- On Unix, use 'chmod +x ...' to make the program executable. You can then
-integrate it with your Window Manager or put it into an executable path.
- Design of regexps
- To design regexp, just type the expression in the top text widget.
-Press the 'Go' button to highlight the matched part of the text in the sample
-text widget.
-
- To get a quickref of the regexp syntax use the menu 'View/Show regexp help'.
-
- You can specify some options using the checkboxes (please read Tcl help to
-learn the meaning of these options).
-
- Recursive design of regexps
-
- Sometimes you will need more than one step to extract the information you want
-from the sample. For example, imagine you want to retrieve information from
-an HTML table inside an another HTML table :
-
- ' You cannot use one global regexp to extract the two lines "One 1" and "Two 2".
-You have to use a first regexp to narrow the processed region.
-Type the following regexp ' Optimization of regexps
-
- When you need to match a list of words, use the menu
-'Insert regexp/Make regexp' to design an optimized version of the word list.
-
- For example, the list 'aa aab ab ad' is optimized into 'a(ab?|b|d)'.
-
- Processing the sample text
-
- Use can use VisualREGEXP to perform modification of a text.
-Just use the menu 'Select mode/Use replace'. You can now design a regexp to
-match what you want. Then use the replace text widget to enter the substitution
-you want to apply (use \0, \1, \2, ... to match the subregexp, use the color
-to map the number with the matched sub-expressions).
-
- After the substitution, you can save the new text using the 'File/Save ...'
-menu. You can let the program choose the end-of-line format or force them for
-a specific environment (Unix, Windows, Mac).
-
- CONTACT
-
- Send your bug reports, suggestions or any feedback to:
- laurent.riesterer@free.fr The top row contains the File, Edit, View, Mark, Merge and Help menus. The second row contains the labels which identify the contents of each text window. Below that is a toolbar which contains navigation and merge selection tools.
-
- The left-most text widget displays the contents of FILE1, the most recently checked-in revision, REV or REV1, respectively (as per the startup options described in the "On Command Line" help). The right-most widget displays the contents of FILE2, FILE or REV2, respectively. Clicking the right mouse button over either of these windows will give you a context sensitive menu with actions that will act on the window you clicked over. For example, if you click right over the right hand window and select "Edit", the file displayed on the right hand side will be loaded into a text editor.
-
- At the bottom of the display is a two line window called the "Line Comparison" window. This will show the "current line" from the left and right windows, one on top of the other. The "current line" is defined by the line that has the blinking insertion cursor, which can be set by merely clicking on any line in the display. This window may be hidden if the View menu item Show Line Comparison is deselected.
- All difference regions (DRs) are highlighted to set them apart from the surrounding text. The current difference region, or CDR, is further set apart so that it can be correlated to its partner in the other text widget (that is, the CDR on the left matches the CDR on the right).
-
- Changing the CDR
-
- The CDR can be changed in a sequential manner by means of the Next and Previous buttons. The First and Last buttons allow you to quickly navigate to the first or last CDR, respectively. For random access to the DRs, use the dropdown listbox in the toolbar or the diff map, described below.
-
- By clicking right over a window and using the popup menu you can select Find Nearest Diff to find the diff record nearest the point where you clicked.
-
- You may also select any highlighted diff region as the current diff region by double-clicking on it.
-
- Operations
-
- 1. From the File menu:
-
- The New... button displays a dialog where you may choose two files to compare. Selecting "Ok" from the dialog will diff the two files. The Recompute Diffs button recomputes the differences between the two files whose names appear at the top of the TkDiff window. The Write Report... lets you create a report file that contains the information visible in the windows. Lastly, the Exit button terminates TkDiff.
-
- 2. From the Edit menu:
-
- Copy copies the currently selected text to the system clipboard. Find pops up a dialog to let you search either text window for a specified text string. Edit File 1 and Edit File 2 launch an editor on the files displayed in the left- and right-hand panes. Preferences pops up a dialog box from which display (and other) options can be
-changed and saved.
-
- 3. From the View menu:
-
- Show Line Numbers toggles the display of line numbers in the text widgets. If Synchronize Scrollbars is on, the left and right text widgets are synchronized i.e. scrolling one of the windows scrolls the other. If Auto Center is on, pressing the Next or Prev buttons centers the new CDR automatically. Show Diff Map toggles the display of the diff map (see below) on or off. Show Merge Preview shows or hides the merge preview (see below). Show Line Comparison toggles the display of the "line comparison" window at the bottom of the display.
-
- 4. From the Mark menu:
-
-The Mark Current Diff creates a new toolbar button that will jump to the current diff region. The Clear Current Diff Mark will remove the toolbar mark button associated with the current diff region, if one exists.
-
- 5. From the Merge menu:
-
-The Show Merge Window button pops up a window with the current merged version of the two files. The Write Merge File button will allow you to save the contents of that window to a file.
-
- 6. From the Help menu:
-
-The About TkDiff button displays copyright and author information. The On GUI button generates this window. The On Command Line button displays help on the TkDiff command line options. The On Preferences button displays help on the user-settable preferences.
-
- 7. From the toolbar:
-
-The first tool is a dropdown list of all of the differences in a standard diff-type format. You may use this list to go directly to any diff record. The Next and Previous buttons take you to the "next" and "previous" DR, respectively. The First and Last buttons take you to the "first" and "last" DR. The Center button centers the CDRs in their respective text windows. You can set Auto Center in Preferences to do this automatically for you as you navigate through the diff records.
-
- Keyboard Navigation
-
- When a text widget has the focus, you may use the following shortcut keys:
- The cursor, Home, End, PageUp and PageDown keys work as expected, adjusting the view in whichever text window has the focus. Note that if Synchronize Scrollbars is set in Preferences, both windows will scroll at the same time.
-
- Scrolling
-
- To scroll the text widgets independently, make sure Synchronize Scrollbars in Preferences is off. If it is on, scrolling any text widget scrolls all others. Scrolling does not change the current diff record (CDR).
-
- Diff Marks
-
- You can set "markers" at specific diff regions for easier navigation. To do this, click on the Set Mark button. It will create a new toolbar button that will jump back to this diff region. To clear a diff mark, go to that diff record and click on the Clear Mark button.
-
- Diff Map
-
- The diff map is a map of all the diff regions. It is shown in the middle of the main window if "Diff Map" on the View menu is on. The map is a miniature of the file's diff regions from top to bottom. Each diff region is rendered as a patch of color, Delete as red, Insert as green and Change as blue. In the case of a 3-way merge, overlap regions are marked in yellow. The height of each patch corresponds to the relative size of the diff region. A thumb lets you interact with the map as if it were a scrollbar.
-All diff regions are drawn on the map even if too small to be visible. For large files with small diff regions, this may result in patches overwriting each other.
-
- Merging
-
- To merge the two files, go through the difference regions (via "Next", "Prev" or whatever other means you prefer) and select "Left" or "Right" (next to the "Merge Choice:" label) for each. Selecting "Left" means that the the left-most file's version of the difference will be used in creating the final result; choosing "Right" means that the right-most file's difference will be used. Each choice is recorded, and can be changed arbitrarily many times. To commit the final, merged result to disk, choose "Write Merge File..." from the Merge menu.
-
- Merge Preview
-
- To see a preview of the file that would be written by "Write Merge File...", select "Show Merge Window" in the View menu. A separate window is shown containing the preview. It is updated as you change merge choices. It is synchronized with the other text widgets if "Synchronize Scrollbars" is on.
-
- Credits
-
- Thanks to Wayne Throop for beta testing, and for giving valuable suggestions (and code!) along the way. Thanks (and credit) to John Heidemann for his window tags routines, which I shamelessly stole (with permission) out of his great Tk-based Solitaire game, Klondike. Thanks to D. Elson (author of tkCVS) for writing the code that extends the RCS support to include CVS. Thanks to John Brown for writing the code that extends the revision control support to SCCS.
-
- Major thanks to Warren Jones (wjones@tc.fluke.com) and Peter Brandstrom (qraprbm@era-lvk.ericsson.se) for going way above and beyond the call. Warren added support for NT and cleaned up the Unix code as well. Peter, independently, did the same thing and then added the new interface. The end result was the 2.x series... Many, many thanks to you both!
-
- Major thanks also to Bryan Oakley (boakley@vignette.com), who made the GUI even more appealing... Bryan did a ton of work, the result of which was the 3.x series. Dorothy Robinson provided helpful comments and patches for 3.x, too. Thanks, Bryan and Dorothy!
-
- Thanks to Dean Jones (dean@gallant.com) for permission to use his icons in the toolbar.
-
- Thanks to Laurent Riesterer (laurent.riesterer@free.fr) for adding support to display the differences between files in directories.
-
- Many, many thanks also to the many others who have written and provided ideas and encouragement and code since TkDiff was first released! I haven't done much coding since the 1.x series; almost every new feature that has come about since then has been the result of volunteer efforts. Thanks, folks!
- Author
- Comments
-
- Questions and comments should be sent to the TkDiff mailing list at
-http://www.accurev.com/free/tkdiff.
-
- To get it, please visit:
- Клиентская часть реализации протокола HTTP/1.0. Пакет http обеспечивает клиентскую часть протокола
- HTTP/1.0 и реализует операции GET, POST и HEAD. Он позволяет
- конфигурировать сервер-представитель (proxy) для выхода через
- межсетевые экраны. Пакет совместим с политикой безопасности
- Safesock. Процедура ::http::geturl
- выполняет HTTP транзакцию. В зависимости от заданной опции это
- может быть GET, POST или HEAD транзакция. Величина,
- возвращаемая процедурой
- ::http::geturl, является признаком (token) выполнения
- транзакции. Кроме того, ее значение совпадает с именем массива в
- пространстве имен ::http, который содержит информацию о
- выполнении транзакции. Элементы массива описаны ниже, см. "Массив
- состояния транзакции". Если процедура вызвана с опцией -command, операция
- выполняется в фоновом режиме. Процедура ::http::geturl
- завершается сразу после формирования HTTP запроса, а результаты
- запроса обрабатываются после их получения. Для успешной работы в
- таком режиме необходимо, чтобы был запущен обработчик
- событий. Это всегда так для Tk-приложений. В чисто Tcl -
- приложениях можно использовать процедуру ::http::wait для запуска
- обработчика событий. Команда ::http::config используется, чтобы
- установить или запросить имя proxy-сервера, порта и
- пользовательского приложения (User-Agent), используемые в
- HTTP запросах. Если никакие опции не заданы, возвращается
- текущая конфигурация. Если задан единственный аргумент,
- тогда, он должен быть именем одной из опций, описанных
- ниже. В этом случае возвращается текущая величина указанной
- опции. В противном случае аргументы состоят из пар: имя
- опции - присваиваемое значение. Команда ::http::geturl - основная команда пакета.
- Если задана опция -query, выполняется операция POST,
- если задана опция -validate, выполняется операция
- HEAD. В противном случае выполняется операция GET. Команда
- возвращает признак - имя массива, который может быть
- использован для получения дополнительной информации о
- состоянии транзакции. Подробности см. "Массив
- состояния транзакции". Команда завершается после
- завершения соответствующей операции, если она вызвана без
- опции -command. В противном случае команда
- ::http::geturl завершается немедленно, а по
- завершении операции вызывается соответствующая команда для
- обработки ее результатов. Команда ::http::geturl
- может использоваться с различными опциями: Обеспечивает вызов команды callback после
- завершения транзакции. При использовании этой опции
- команда ::http::geturl завершается сразу. Команда
- callback вызывается с аргументом token,
- который содержит имя массива, описанного ниже, см. "Массив
- состояния транзакции". Ниже приведен шаблон
- типовой процедуры для использования в данной опции: Опция обеспечивает вызов команды callback как
- только HTTP данные получены. Команда получает два
- дополнительных аргумента: HTTP socket и имя
- массива token, возвращенное командой
- ::http::geturl (см. "Массив состояния
- транзакции"). Команда должна возвращать число
- байтов, прочитанных из socket. Ниже приведен
- шаблон подобной процедуры: Опция используется для включения в заголовок HTTP
- запроса дополнительных полей. Аргумент должен быть
- правильным списком с четным числом элементов, состоящим
- попеременно из ключей и их значений. Ключи используются
- как имена полей заголовка. Из значений удаляются символы
- перехода на новую строку, чтобы избежать формирования
- неправильного заголовка. Например, если
- keyvaluelist содержит список {Pragma
- no-cache} будет сформирован следующий заголовок
- запроса: Опция обеспечивает вызов команды callback для
- обработки очередной порции данных. Команда
- callback получает три аргумента: значение
- token, возвращенное командой
- ::http::geturl, предполагаемый полный размер
- данных из мета-данных и текущее количество поступивших
- данных в байтах. Если предполагаемый полный размер
- неизвестен, вместо него подставляется 0. Ниже приведен
- шаблон для процедуры, вызываемой по опции
- -progress: Команда
- ::http::geturl возвращает token - имя
- Tcl-массива, содержащего информацию о HTTP транзакции. Для
- упрощения доступа к массиву можно использовать следующую
- конструкцию: Массив содержит следующие элементы: Мета данные, описывающие содержание документа. Данный
- элемент массива содержит список ключей и их значений. Чтобы
- облегчить доступ к данным можно использовать следующую
- конструкцию: Некоторые ключи мета данных перечислены ниже, но в HTTP
- стандарте их перечислено больше, кроме того, сервер может
- добавлять собственные. Запрошенный адрес. Пример: Механизм создания и управления безопасными
- интерпретаторами. Safe Tcl - это механизм безопасного исполнения
- ненадежных Tcl скриптов и предоставления этим скриптам
- опосредованного доступа к потенциально опасным функциям. Safe Tcl служит для того, чтобы ненадежные скрипты не
- смогли нарушить работу вызывающего их приложения: он
- предотвращает покушения на несанкционированный доступ к
- информации и нарушение целостности вызывающего этот скрипт
- процесса. Safe Tcl позволяет интерпретатору-предку
- создавать безопасные интерпретаторы с ограниченными
- возможностями, в которых содержится набор предопределенных
- синонимов для команд source, load, file и exit и сохраняются
- возможности автозагрузки команд и пакетов. Безопасный интерпретатор не позволяет получить какую-либо
- информацию о структуре файловой системы, поскольку для доступа к
- файлам в безопасном интерпретаторе используются специальные
- метки. Когда безопасный интерпретатор запрашивает доступ к
- файлу, он использует метку как часть виртуального имени файла.
- Родительский интерпретатор заменяет метку на реальное имя
- каталога и выполняет требуемую операцию с файлом. С помощью
- опций команд, описанных ниже, можно выбрать требуемый уровень
- безопасности интерпретатора. Все команды для работы с безопасными интерпретаторами
- содержатся в пространстве имен safe. Команда ::safe::interpCreate
- создает безопасный интерпретатор. Возможные опции команды
- описаны ниже, см. "Опции". Команда возвращает имя созданного интерпретатора. Команда ::safe::interpInit
- аналогична, но ее первым аргументом должно быть имя
- интерпретатора, созданного с помощью команды interp. Команда ::safe::interpDelete
- удаляет интерпретатор, имя которого использовано в качестве
- аргумента. Команда ::safe::interpConfigure позволяет задать
- опции для безопасного интерпретатора или получить информацию
- об заданных ранее опциях. Подробно опции описаны ниже
- (см. "Опции"). Для каждого безопасного интерпретатора, созданного с помощью
- команды ::safe::interpCreate
- или инициированного с помощью команды ::safe::interpInit
- в родительском интерпретаторе создается список доступных
- каталогов - виртуальный путь. Каждый каталог в пути связывается
- с реальным каталогом локальной файловой системы и с меткой,
- доступной в безопасном интерпретаторе. В результате надежный
- интерпретатор обходится без сведений о реальной файловой системе
- на машине, на которой исполняется интерпретатор. Когда в
- надежном интерпретаторе используется метка для доступа к
- конкретному файлу (например, для выполнения команды source или load), метка заменяется в
- родительском интерпретаторе на настоящее имя каталога и
- необходимый файл ищется в файловой системе. Надежный
- интерпретатор не получает сведений о реальном имени файла в
- файловой системе. Для работы с виртуальными именами файлов
- предусмотрены специальные команды. Команда ::safe::interpConfigure
- позволяет задавать новый виртуальный путь для интерпретатора.
- Команда ::safe::interpAddToAccessPath позволяет
- добавлять каталоги к виртуальному пути указанного безопасного
- интерпретатора. Команда ::safe::interpFindInAccessPath позволяет
- найти каталог в виртуальном пути для безопасного интерпретатора
- и получить его метку. Если каталог не найден, выдается сообщение
- об ошибке. Команда ::safe::setLogCommand позволяет задать
- скрипт, который выполняется при каждом событии в безопасном
- интерпретаторе. Этот скрипт вызывается с одним аргументом -
- строкой, содержащей описание события. При создании безопасного интерпретатора в нем определяются
- следующие команды - синонимы: В родительском интерпретаторе для работы с безопасными
- интерпретаторами предусмотрены следующие команды: Эта команда позволяет задать скрипт, который будет
- выполняться при различных событиях, связанных с безопасными
- интерпретаторами. Если команда вызвана без аргументов, то
- она возвращает установленный ранее скрипт. Вызванная с одним
- аргументом - пустой строкой - команда удаляет установленный
- ранее скрипт и отменяет процесс журнализации. Установленный
- скрипт выполняется с одним дополнительным аргументом -
- строкой, описывающей событие. Основное назначение команды -
- использование при отладке скриптов, выполняемых в безопасных
- интерпретаторах. Используя ее, вы сможете получить полную
- информацию об ошибке, в то время как безопасный
- интерпретатор возвращает только обобщенное сообщение об
- ошибке (это позволяет избежать разглашения в сообщении об
- ошибке конфиденциальной информации, например, о реальных
- именах файлов). Пример использования: Ниже приведен журнал сессии, в которой безопасный
- интерпретатор пытается прочитать файл, который не найден в
- виртуальном пути. Обратите внимание, что сам безопасный
- интерпретатор получает при этом только сообщение о том, что
- файл не найден: Для команд ::safe::interpCreate,
- ::safe::interpInit, и :safe::interpConfigure
- определены перечисленные ниже опции. Имена опций могут быть
- сокращены до минимальных однозначных имен. Имена опций не
- чувствительны к регистру, в котором они набраны. Save Tcl не дает полной гарантии безопасности. В частности, он
- не защищает от атак на сервер, когда поглощаются все ресурсы
- процессора и пользователь не может использовать компьютер для
- полезной работы. Однако такие атаки считаются, как правило,
- менее опасными, чем несанкционированный доступ к информации и
- нарушение целостности, от которых безопасный интерпретатор
- защищает. В безопасном интерпретаторе, помимо безопасного набора
- команд, который описан в описании команды interp, имеются синонимы для команд source, load, exit и безопасное подмножество
- подкоманд команды file. В
- безопасном интерпретаторе возможна автозагрузка библиотек и
- пакетов. Поскольку эти команды имеют дело с локальной файловой
- системой, существует потенциальная опасность использования их
- для доступа к конфиденциальной информации. Чтобы предотвратить
- эту возможность, в безопасном интерпретаторе используются не
- настоящие имена каталогов, а специальные метки. Эти метки
- транслируются в реальные имена файлов только в родительском
- интерпретаторе. Чтобы исключить доступ к файлам, которые оказались в силу тех
- или иных причин в разрешенных для чтения в безопасном
- интерпретаторе каталогах, синоним команды source обеспечивает
- доступ только к файлам с расширением tcl, в именах которых
- содержится ровно одна точка, а общая длина имени не превышает
- четырнадцати символов. По умолчанию в Tcl переменной auto_path содержатся метки
- для каталогов, содержащихся в аналогичной переменной в
- родительском интерпретаторе и их непосредственных подкаталогов.
- Первая метка в списке присваивается также Tcl переменной
- tcl_library безопасного интерпретатора. Вы можете
- сократить этот список, в явном виде задав доступные каталоги для
- безопасного интерпретатора с помощью опции
- -accessPath. Safe Tcl - это механизм безопасного исполнения
- ненадежных Tcl скриптов и предоставления этим скриптам
- опосредованного доступа к потенциально опасным функциям. Safe Tcl служит для того, чтобы ненадежные скрипты не
- смогли нарушить работу вызывающего их приложения: он
- предотвращает покушения на несанкционированный доступ к
- информации и нарушение целостности вызывающего этот скрипт
- процесса. Safe Tcl позволяет интерпретатору-предку создавать
- безопасные интерпретаторы с ограниченными возможностями, в
- которых содержится набор предопределенных синонимов для команд
- source, load, file и exit и сохраняются возможности
- автозагрузки команд и пакетов. Безопасный интерпретатор не позволяет получить какую-либо
- информацию о структуре файловой системы, поскольку для доступа к
- файлам в безопасном интерпретаторе используются специальные
- метки. Когда безопасный интерпретатор запрашивает доступ к
- файлу, он использует метку как часть виртуального имени файла.
- Родительский интерпретатор заменяет метку на реальное имя
- каталога и выполняет требуемую операцию с файлом. С помощью
- опций команд, описанных ниже, можно выбрать требуемый уровень
- безопасности интерпретатора. Все команды для работы с безопасными интерпретаторами
- содержатся в пространстве имен safe. Команда
- ::safe::interpCreate создает безопасный интерпретатор.
- Возможные опции команды описаны ниже, см. "Опции". Команда возвращает имя созданного интерпретатора. Команда
- ::safe::interpInit аналогична, но ее первым аргументом
- должно быть имя интерпретатора, созданного с помощью команды
- interp. Команда ::safe::interpDelete удаляет интерпретатор, имя
- которого использовано в качестве аргумента. Команда
- ::safe::interpConfigure позволяет задать опции для
- безопасного интерпретатора или получить информацию об заданных
- ранее опциях. Подробно опции описаны ниже (см. Опции). Для каждого безопасного интерпретатора, созданного с помощью
- команды ::safe::interpCreate или инициированного с
- помощью команды ::safe::interpInit в родительском
- интерпретаторе создается список доступных каталогов -
- виртуальный путь. Каждый каталог в пути связывается с реальным
- каталогом локальной файловой системы и с меткой, доступной в
- безопасном интерпретаторе. В результате надежный интерпретатор
- обходится без сведений о реальной файловой системе на машине, на
- которой исполняется интерпретатор. Когда в надежном
- интерпретаторе используется метка для доступа к конкретному
- файлу (например, для выполнения команды source или load), метка заменяется в родительском
- интерпретаторе на настоящее имя каталога и необходимый файл
- ищется в файловой системе. Надежный интерпретатор не получает
- сведений о реальном имени файла в файловой системе. Для работы с
- виртуальными именами файлов предусмотрены специальные
- команды. Команда ::safe::interpConfigure позволяет
- задавать новый виртуальный путь для интерпретатора. Команда
- ::safe::interpAddToAccessPath позволяет добавлять
- каталоги к виртуальному пути указанного безопасного
- интерпретатора. Команда ::safe::interpFindInAccessPath
- позволяет найти каталог в виртуальном пути для безопасного
- интерпретатора и получить его метку. Если каталог не найден,
- выдается сообщение об ошибке. Команда ::safe::setLogCommand позволяет задать скрипт,
- который выполняется при каждом событии в безопасном
- интерпретаторе. Этот скрипт вызывается с одним аргументом -
- строкой, содержащей описание события. Основные правила синтаксиса команд. Синтаксис и семантика языка Tcl определены описанным ниже
- образом. Скрипт на Tcl представляет собой одну или более команд.
- Символы точки с запятой (;) и новой строки служат
- разделителями команд, если не находятся между символами
- кавычек. Закрывающие скобки служат окончанием тела команды при
- подстановках команд, если не находятся между символами
- кавычек. Команда обрабатывается за два прохода. При первом проходе
- интерпретатор Tcl разбивает команду на слова и выполняет
- подстановки, как рассказано ниже. Эти подстановки выполняются
- одинаково для всех команд. Первое слово считается именем
- процедуры, которая исполняет команду. Когда процедура найдена,
- ей передаются остальные слова команды. Процедура может
- интерпретировать каждое из слов произвольным образом, например,
- как число, имя переменной, список или Tcl скрипт. Разные
- командные процедуры интерпретируют свои слова по-разному. Слова команд разделяются пробельными символами (пробел,
- табуляция). Символ новой строки разделяет команды. Если первый символ слова есть двойные кавычки ("), то слово
- должно заканчиваться также на двойные кавычки. Если в промежутке
- между знаками кавычек находятся точка с запятой, закрывающая
- скобка или пробельные символы (включая символ новой строки), то
- они будут поняты как обычные символы в составе
- слова. Подстановки команд, переменных и подстановки с обратным
- слэшем в таком слове описаны ниже. Двойные кавычки не являются
- частью слова. Если слово начинается с открывающей фигурной скобки ({),
- то оно должно заканчиваться на парную ей закрывающую скобку
- (}). Внутри фигурных скобок могут также содержаться
- слова в фигурных скобках. При этом каждая открывающая фигурная
- скобка должна иметь парную ей закрывающую фигурную
- скобку. Однако, если открывающая или закрывающая фигурная скобка
- отмечена обратным слэшем, то она не учитывается при поиске
- парной скобки. Для символов между фигурными скобками не
- выполняется никаких подстановок, за исключением описанной ниже
- подстановки "обратный слэш - новая строка". Также не
- приписывается никакого специального смысла символам точки с
- запятой, новой строки, закрывающей скобки и пробела. Слово будет
- состоять из символов между скобками, за исключением самих
- скобок. Если слово содержит открывающую квадратную скобку ([),
- то Tcl выполняет подстановку команды. Для этого он рекурсивно
- вызывает интерпретатор Tcl, который обрабатывает символы,
- следующие за скобкой, как скрипт Tcl. Скрипт может иметь любое
- количество команд и должен оканчиваться закрывающей квадратной
- скобкой (]). Результат выполнения скрипта (т.е., результат его
- последней команды) подставляется в слово на место скобок и всех
- символов между ними. В слове может быть любое количество
- подстановок команд. Подстановки команд не выполняются в словах,
- заключенных в фигурные скобки. Если слово содержит символ доллара ($), тогда Tcl
- выполняет подстановку переменной: символ доллара и последующие
- символы заменяются в слове на значение этой переменной.
- Существует три способа подстановки переменной: Здесь name - имя скалярной переменной, оно заканчивается
- любым символом, за исключением буквы, цифры или символа
- подчеркивания. Здесь name есть имя массива данных, а index - имя
- элемента внутри этого массива. name должен состоять
- только из букв, цифр и символов подчеркивания. Все виды
- подстановок выполняются по отношению к символам
- index. Здесь name - имя скалярной переменной, оно может
- состоять из каких угодно символов, кроме закрывающей фигурной
- скобки. В слове может быть любое количество подстановок
- переменных. Подстановки переменных не выполняются для слов,
- заключенных в фигурные скобки. Если в слове есть символ обратного слэша, то выполняется
- подстановка с обратным слэшем. Во всех случаях, кроме
- перечисленных ниже, обратный слэш пропускается, а следующий за
- ним символ обрабатывается как обычный символ и включается в
- состав слова. Таким способом в слово можно включать такие
- символы, как двойные кавычки, закрывающие скобки и символ
- доллара без непреднамеренной специальной обработки. Ниже
- перечислены последовательности символов, для которых подстановка
- с обратным слэшем выполняется специальным образом, и
- соответствующие подставляемые значения. Подстановки с обратным слэшем не выполняются в словах,
- заключенных в фигурные скобки, кроме подстановки "обратный слэш
- - новая строка". Если символ "#" будет стоять в том месте, где Tcl
- предполагает первый символ первого слова команды, то этот символ
- и все последующие символы до следующего символа новой строки
- включительно истолковываются как комментарии и
- игнорируются. Символ комментария действителен только тогда,
- когда он стоит в начале команды. При воссоздании слов команды каждый символ обрабатывается
- интерпретатором Tcl только один раз. Например, если выполнялась
- подстановка переменной, то в значении переменной никаких
- подстановок не производится; значение вставляется в слово без
- изменений. Если выполнялась подстановка команды, то вставленная
- команда обрабатывается целиком посредством рекурсивного вызова
- интерпретатора Tcl; не делается никаких подстановок перед
- рекурсивным вызовом и не делается никаких дополнительных
- подстановок в результат исполнения вставленного скрипта. Подстановки не воздействуют на границы слов в команде.
- Например, при подстановке переменной все значение переменной
- становится частью одного слова, даже если это значение содержит
- пробелы. Команда after указывает, что некоторая команда должна
- быть выполнена с задержкой по времени. Команда используется для того, чтобы отложить выполнение
- программы или выполнить указанную команду в фоновом режиме в
- некоторый момент в будущем. У команды есть несколько форм,
- зависящих от ее первого аргумента. Команды after ms и after idle предполагают, что
- приложение управляется событиями. Отложенные команды не
- выполняются, если в приложении не активизирован цикл обработки
- событий. В приложениях, в которых он обычно не активизирован,
- таких как tclsh, цикл обработки событий может быть
- активизирован с помощью команд vwait и update. Команда дописывает значения аргументов к значению переменной. Команда append добавляет все аргументы value к
- значению переменной varName. Если такой переменной не
- было, она будет создана, и ее значение будет равно соединению
- значений аргументов value. Эта команда предоставляет
- удобный способ постепенного наращивания длинных переменных.
- Если переменная a содержит длинное значение, то команда
- append a выполняется значительно быстрее, чем
- set a .
- Эта команда предназначена для выполнения перечисленных ниже
- операций с массивами. Если иное не оговорено специально,
- arrayName должно быть именем существующего массива.
- Аргумент option определяет конкретную операцию. Для
- команды определены перечисленные ниже опции. СИНТАКСИС bell
-displayof window
- ОПИСАНИЕ
- Команда 'bell'
-подает сигнал
громкоговорителем дисплея для window.
-Если этот аргумент не
-задан, то по умолчанию используется дисплей главного окна приложения. В
-некоторых случаях команда гасит работающий в данный момент хранитель
-экрана (screen-saver), и окно снова становится видимым. ПРИМЕР
-
diff --git a/hlp/ru/tcl/bgerror.html b/hlp/ru/tcl/bgerror.html
deleted file mode 100644
index 8cc3698..0000000
--- a/hlp/ru/tcl/bgerror.html
+++ /dev/null
@@ -1,65 +0,0 @@
-
-
- Команда bgerror предназначена для обработки фоновых
- ошибок. В Tcl нет встроенной команды bgerror. Если в приложении
- тем не менее необходимо обрабатывать фоновые ошибки,
- пользователь может определить собственную команду
- bgerror, например, как Tcl-процедуру. Фоновые ошибки - это ошибки в командах, которые не вызваны
- непосредственно из приложения. Например, фоновыми являются
- ошибки в командах, вызванных с помощью конструкции
- after. Для нефоновых ошибок
- сообщение об ошибке возвращается через вложенные вызовы команд,
- пока не достигнет верхнего уровня приложения. После этого
- приложение выдает сообщение об ошибке в одной из команд верхнего
- уровня. При фоновой ошибке подобный процесс не достигает команд
- верхнего уровня и формирование сообщения об ошибке оказывается
- затруднительным. Когда Tcl обнаруживает фоновую ошибку, он сохраняет информацию
- об ошибке и вызывает команду bgerror с помощью
- обработчика событий. Перед вызовом bgerror
- восстанавливаются значения переменных errorInfo и errorCode, которые были при
- обнаружении ошибки. После этого вызывается команда
- bgerror с единственным аргументом - сообщением об ошибке.
- Предполагается, что в приложении определена команда
- bgerror и что она выдает сообщение об ошибке надлежащим
- образом. Если при выполнении команды bgerror не произошло
- новой ошибки, возвращаемый ею результат игнорируется. Если при исполнении команды bgerror произошла новая
- ошибка (например, если эта команда не существует), сообщение об
- ошибке поступает в канал вывода ошибок. Если до вызова обработчиком событий команды bgerror
- произошло несколько фоновых ошибок, то, как правило, команда
- будет вызвана для каждой из обнаруженных ошибок. Однако, если
- сама команда bgerror возвращает код break (см. описание
- команды return),
- последующие ее вызовы пропускаются. В чисто Tcl-приложениях команда bgerror не
- реализована. Однако, в Tk-приложениях определена процедура
- bgerror, которая выводит сообщение об ошибке в диалоговое
- окно и позволяет пользователю просмотреть стек, описывающий, где
- именно эта ошибка произошла. Команда вставляет и извлекает поля из двоичных строк. Команда binary предоставляет средства для
- манипулирования двоичными данными. Первая из форм команды
- конвертирует обычные Tcl-значения arg в двоичное
- число. Например, вызванная с аргументами 16 и 22,
- она вернет 8-байтовое двоичную строку, состоящую из двух
- 4-байтовых чисел, представляющих соответственно 16 и
- 22. Вторая форма команды выполняет обратное действие,
- она извлекает из двоичной строки данные и возвращает их как
- обычные Tcl строки. Команда binary format создает двоичную строку по
- правилам, заданным с помощью шаблона formatString.
- Содержание этой строки задается дополнительными аргументами
- arg. Команда возвращает сформированную двоичную
- строку. Шаблон formatString содержит последовательность из
- нуля или более спецификаторов преобразования, разделенных
- одним или более пробелами. Каждый спецификатор
- преобразования состоит из буквы, за которой может следовать
- число count. Как правило, спецификатор использует один из
- аргументов arg чтобы получить величину для
- форматирования. Буква в спецификаторе указывает тип
- преобразования (форматирования). Число count обычно
- указывает сколько объектов для форматирования выбирается из
- значения arg. Соответственно, count должно
- быть неотрицательным десятичным числом. Если значение count
- равно *, это обычно указывает, что надо использовать все
- значение аргумента. Если число аргументов arg не
- соответствует числу спецификаторов, требующих для себя
- дополнительного аргумента, выдается ошибка. Обычно результат каждого нового преобразования дописывается
- в конец возвращаемой строки. Однако, с помощью специальных
- спецификаторов точку ввода нового значения (курсор) можно
- передвигать по формируемой строке. Ниже приведены допустимые значения спецификаторов
- преобразований и описаны соответствующие преобразования. Передает в выходную строку count символов из
- соответствующего аргумента arg. Если в arg
- содержится меньше count байт, добавляются нулевые
- байты. Если в arg содержится больше count
- байт, "лишние" байты игнорируются. Если
- count равно *, используются все байты из
- arg. Если count отсутствует, используется
- один байт. Например, команда вернет строку, эквивалентную alpha
diff --git a/hlp/ru/tcl/break.html b/hlp/ru/tcl/break.html
deleted file mode 100644
index 1e9a6f7..0000000
--- a/hlp/ru/tcl/break.html
+++ /dev/null
@@ -1,31 +0,0 @@
-
-
-
- Команда прекращает выполнение цикла. Обычно данная команда помещается внутрь цикла, например
- созданного командами for, foreach или while. Команда возвращает код
- TCL_BREAK, который вызывает завершение исполнения наименьшего
- охватывающего ее цикла. Цикл завершается нормальным образом (без
- ошибки) как если бы он отработал до конца. Код TCL_BREAK
- обрабатывается также в некоторых других ситуация - при
- исполнении команды catch,
- при обработке событий и в скрипте самого верхнего уровня.
- Команда case исполняет один из нескольких скриптов в
- зависимости от полученного значения. Замечание. Команда case - устаревшая, она поддерживается
- только для совместимости с предыдущими версиями. В последующих
- версиях она может быть опущена. Поэтому предпочтительнее
- использование команды switch.
- Команда сравнивает string со всеми аргументами
- patList по очереди. Каждый аргумент patList
- представляет собой один или несколько (список) образцов. Если
- string соответствует одному из образцов, то case
- рекурсивно вызывает интерпретатор Tcl, передает ему следующий за
- этим списком образцов скрипт body для выполнения и
- возвращает результат этого выполнения. Каждый аргумент
- patList состоит из одного или нескольких образцов. Каждый
- образец может содержать спецсимволы, как в команде string match. Кроме
- того, есть специальный образец default. Соответствующий
- ему скрипт выполняется, если string не соответствует
- никакому другому образцу. Если string не соответствует ни одному из образцов, а
- образец default не используется, то case вернет
- пустую строку. У команды есть две формы записи для аргументов patList и
- body. Первая использует отдельные аргументы для каждого
- шаблона и команды. Эта форма более удобна, если в образцах или
- командах желательно выполнить какие-либо подстановки. Во второй
- форме все шаблоны и команды объединены в один аргумент, который
- должен быть списком, состоящим из шаблонов и команд. Вторая
- форма позволяет проще записывать многострочные команды,
- поскольку при этом фигурные скобки вокруг списка позволяют не
- ставить обратный слэш в конце каждой строки. Однако из-за этих
- фигурных скобок подстановки в шаблонах и командах не
- производятся. Поэтому одна и та же команда, записанная в
- различных формах, может работать по-разному.
-
-
-
-
diff --git a/hlp/ru/tcl/catch.html b/hlp/ru/tcl/catch.html
deleted file mode 100644
index 88282c8..0000000
--- a/hlp/ru/tcl/catch.html
+++ /dev/null
@@ -1,40 +0,0 @@
-
-
- Команда выполняет скрипт и обрабатывает ошибки, если они
- возникают. Данную команду можно использовать для того, чтобы не дать
- возникшим ошибкам прекратить процесс интерпретации команд. Для
- исполнения скрипта script команда catch рекурсивно
- вызывает интерпретатор Tcl и всегда возвращает код TCL_OK,
- независимо от возможно возникших при исполнении скрипта
- script ошибок. Команда catch возвращает десятичную строку, содержащую
- код, возвращаемый Tcl-интерпретатором по исполнению скрипта.
- Если при исполнении скрипта не возникло ошибок, возвращается код
- 0 (TCL_OK). В противном случае возвращается ненулевое значение,
- соответствующее коду прерывания (см. файл tcl.h). Если задан
- аргумент varName, он определяет имя переменной, которой
- присваивается значение, возвращаемое скриптом (результат
- выполнения или сообщение об ошибке). Команда catch
- обрабатывает все прерывания, в том числе от команд break и continue.
- Команда предназначена для перехода в другой каталог. Команда делает текущим каталогом каталог dirName, или,
- если параметр dirName не указан, каталог, заданный в
- переменной окружения HOME. Команда возвращает пустую строку. С помощью команды clock можно получить и преобразовать
- значение времени. Команда выполняет одно из перечисленных ниже действий, с
- помощью которых можно получить и преобразовать строки или
- значения, являющиеся той или иной формой записи времени.
- Параметр option определяет выполняемое командой действие,
- одно из следующего списка (параметр может быть сокращен):
- Переводит целое число, возвращаемое командами clock
- seconds, clock scan или командами file atime, file mtime и file
- ctime в удобочитаемую форму. Если в команде
- присутствует аргумент -format, следующий аргумент
- должен быть строкой, описывающей формат представления
- времени. Строка состоит из описаний полей, состоящих из
- символа % и буквы. Все остальные символы в строке
- просто копируются в результат. Ниже перечислены допустимые
- описания полей. Если аргумент -format не задан, используется
- формат %a %b %d %H:%M:%S %Z %Y. Если задан аргумент
- -gmt, следующий аргумент должен быть булевой
- величиной. Значение true означает, что используется время по
- Гринвичу, значение false означает, что используется время по
- локальному часовому поясу, который задан для операционной
- системы. Переводит дату dateString в целое число (см. clock seconds).
- Команда может перевести в число любую стандартную строку,
- содержащую время и/или дату, включая название часового
- пояса. Если строка содержит только время, предполагается
- текущая дата. Если название часового пояса не указано,
- предполагается локальный часовой пояс (если значение опции
- -gmt не равно true. В этом случае предполагается, что
- время задано по Гринвичу). Если в команде указан флаг -base, следующий аргумент
- должен содержать время в виде целого числа. По этому числу
- определяется дата и используется вместо указанной в строке
- или текущей. Такая возможность полезна при необходимости
- перевести в целое число время на заданную дату. Аргумент dateString должен состоять из одной или
- более спецификаций следующих видов: Реальная дата вычисляется в следующей последовательности.
- Сначала определяется абсолютная дата и/или время, которые
- переводятся в целое число. Это число используется как базис,
- к которому добавляется заданный день недели. Далее
- используется относительное время. Если задана дата, а время
- (абсолютное или относительное) отсутствует, считается, что
- это полночь. И последним шагом производится коррекция
- вычисленной даты, при которой учитываются летнее время и
- число дней в различных месяцах. Команда закрывает открытый канал. Команда close закрывает канал, идентификатор которого
- задан аргументом channelId. Идентификатор
- channelId возвращается командами open и socket при открытии
- канала. Команда отправляет все накопившиеся в выходном буфере данные на
- выходное устройство канала, удаляет все данные во входном
- буфере, закрывает назначенное каналу устройство или файл. Доступ
- к каналу прекращается. Для каналов в блокирующем и неблокирующем режимах действие
- команды несколько различно. Если канал находится в блокирующем
- режиме, команда завершается только после завершения вывода
- данных из буфера. В противном случае команда завершается
- немедленно, а вывод данных из буфера производится в фоновом
- режиме. Канал закрывается после завершения вывода. Если канал в блокирующем режиме открыт для конвейера, команда
- close завершается после завершения порожденного
- процесса. Если канал совместно используется несколькими
- интерпретаторами, то команда делает канал channelId
- недоступным в вызвавшем команду интерпретаторе, но не оказывает
- никакого другого действия на канал, пока все использующие канал
- интерпретаторы не закроют его. При выполнении команды в
- последнем из интерпретаторов, использовавших его, выполняются
- описанные выше действия. Подробности совместного использования
- канала несколькими интерпретаторами приведены в описании
- команды interp.
- Команда close возвращает пустую строку. Она может
- порождать ошибку, если при выводе данных произошла ошибка.
- Команда соединяет списки в один общий список. Аргументы arg считаются списками, команда concat
- объединяет их в один общий список. При этом она удаляет пробелы
- в начале и конце arg, и вставляет по одному пробелу между
- ними. Команда допускает произвольное число аргументов. Например,
- команда
- возвращает список Если не задано никаких аргументов, то команда возвращает
- пустую строку. Команда continue прекращает выполнение текущего шага
- цикла. Обычно данная команда помещается внутрь цикла, например,
- созданного командами for, foreach или while. Команда возвращает код
- TCL_CONTINUE, который вызывает завершение текущей
- итерации наименьшего охватывающего ее цикла. Управление
- возвращается команде цикла, которая начинает следующий шаг
- цикла. Код TCL_CONTINUE обрабатывается также в некоторых
- других ситуациях - при исполнении команды catch и в скрипте самого
- верхнего уровня.
- Команда проверяет в канале условие конца файла. Команда eof возвращает " 1 " если во время
- последней операции ввода в канале channelId произошло
- условие конца файла, и " 0 " в противном случае. Команда генерирует ошибку. Команда возвращает код TCL_ERROR, прерывающий
- интерпретацию команды. Строка message возвращается
- приложению, чтобы указать, что именно произошло. Если задан
- непустой аргумент info, его значение присваивается
- глобальной переменной errorInfo. Переменная
- errorInfo обычно используется для формирования сведений о
- вложениях команды, в которой произошла ошибка. Другими словами,
- как только оказывается, что невыполненная команда была вложена в
- другую команду, информацию об этой команде добавляется к
- errorInfo. Если же аргумент info был задан, этого
- не происходит. Эта особенность позволяет при использовании
- команды error совместно с командой catch выдать
- информацию о реальном месте ошибки (а не о месте вызова команды
- error). Для этого можно использовать следующую
- конструкцию: Если задан аргумент code, то его значение будет
- присвоено глобальной переменной errorCode. Эта переменная
- предназначена для хранения машинного описания ошибки в тех
- случаях, когда такое описание возможно. Форматы различных
- сообщений приведены в разделе tell. Если аргумент не задан,
- переменной errorCode в процессе обработки
- Tcl-интерпретатором ошибки, порожденной командой, присваивается
- значение "NONE". Команда исполняет Tcl-скрипт. Аргументы команды eval вместе образуют Tcl-скрипт,
- состоящий из одной или нескольких команд. Команда соединяет
- аргументы (подобно команде concat) и передает их рекурсивно
- запущенному интерпретатору Tcl. Команда возвращает результат
- работы интерпретатора (или обнаруженную им ошибку). Команда запускает подпроцессы. Аргументы команды определяют один или нескольких подпроцессов,
- которые необходимо выполнить. Аргументы принимают форму
- конвейера, в котором каждый arg задает одно слово
- команды, а каждая отдельная команда порождает подпроцесс. Если первые аргументы команды начинаются со знака
- "-", они считаются ключами команды, а не частью
- описания конвейера. Возможные ключи: Перечисленные ниже аргументы (пары аргументов) используют не
- для определения подпроцессов, а для перенаправления потоков
- ввода и вывода между ними. В выражения типа
- "<fileName" fileName может писаться
- как отдельно, так и слитно
- ("<fileName>"). Если стандартный вывод последней команды конвейера не был
- перенаправлен, то команда exec возвращает его
- значение. Если одна из команд конвейера вернула код ошибки, была
- прервана или приостановлена, то команда exec вернет код
- ошибки. При этом сообщение об ошибке будет включать стандартный
- вывод конвейера и сообщение об ошибке. В переменной
- errorCode будет записана
- дополнительная информация о последней встреченной ошибке. Если
- хотя бы одна из команд конвейера пишет информацию об ошибках в
- файл и стандартный вывод ошибок не перенаправлен, команда
- exec вернет ошибку, сообщение об ошибке будет включать в
- себя стандартный вывод конвейера, дополненный сообщениями об
- ошибках (если их было несколько) и стандартным выводом
- ошибок. Если последний символ результата исполнения конвейера или
- сообщения об ошибке - перевод каретки, то он будет удален из
- результата или сообщения соответственно. Это соответствует
- общему правилу Tcl, по которому возвращаемая величина, как
- правило, не оканчивается символом перевода каретки. Однако, если
- указана опция -keepnewline, символ перевода каретки в
- конце сохраняется. Если последним аргументом конвейера является "&",
- конвейер выполняется в фоновом режиме. В этом случае команда
- exec возвращает список идентификаторов всех процессов
- конвейера. Стандартный вывод последней команды конвейера, если
- он не перенаправлен, выводится на стандартный вывод
- приложения. Стандартный вывод ошибок, если он не перенаправлен,
- осуществляется в стандартный вывод ошибок приложения. Первое слово в каждой команде считается именем команды. В нем
- выполняются тильда - подстановки. Если получившийся при этом
- результат не содержит слэшей, соответствующая команда ищется в
- каталогах, перечисленных в переменной окружения PATH. Если имя
- команды после подстановок содержит слэши, оно должно указывать
- на исполняемый файл, доступный из текущего каталога. Никакие
- другие подстановки в командах, например, принятые в shell
- подстановки * и ?, не выполняются.
- Чтение и запись с использование @ fileId'' не
- работают. Исполнение 16- и 32-разрядных приложений
- различается между собой и отличается от описанного выше. Tk
- консоль не реализует всех стандартных возможностей
- ввода/вывода. В командах допускается использование как прямых, так и
- обратных слэшей при указании пути команды. Однако, если путь
- является аргументом команды, это может оказаться и не
- так. Двойной слэш в путях указывает на сетевой адрес. Команда exit прекращает исполнение приложения. Прекращает процесс и возвращает системе returnCode в
- качестве кода завершения. Если returnCode не определен,
- то команда использует значение по умолчанию 0. Проверяет, что предыдущая операция ввода исчерпала всю
- информацию для ввода. Команда fblocked возвращает "1" если последняя
- операция ввода по каналу channelId возвратила меньше
- информации, чем было запрошено, поскольку вся доступная
- информация уже исчерпана. Например, если команда gets вызвана, когда для ввода
- доступны только три символа без символов конца строки, команда
- gets вернет пустую строку,
- последующий вызов команды fblocked вернет 1. fconfigure - устанавливает и читает опции канала. Команда fconfigure устанавливает и читает опции
- каналов. Аргумент channelId определяет конкретный канал,
- с которым работает команда. Если аргументы name и
- value отсутствуют, команда возвращает список, содержащий
- поочередно имена опций и их значения для канала. Если имя опции
- указано, а значение - нет, команда возвращает текущее значение
- указанной опции. Если в команде указаны одна или больше пар имен
- и значений, то команда устанавливает каждой из перечисленных
- опций указанное значение. В этом случае команда возвращает
- пустую строку. Описанные ниже опции поддерживаются для всех типов каналов.
- Кроме того, каждый тип канала может иметь дополнительно
- собственные опции. Они приведены в описаниях команд создания
- каналов, например, в описании команды socket. Если аргумент newValue равен full, система
- ввода-вывода будет накапливать вывод в буфере, пока буфер не
- заполнится целиком. После этого буфер будет выдан в канал. Если аргумент newValue равен line, система
- ввода-вывода будет выдавать буфер в канал каждый раз при
- поступлении символа конца строки. Если аргумент newValue равен none, система
- ввода-вывода будет выводить каждый символ сразу после его
- поступления. Значение по умолчанию full для всех каналов, кроме
- устройств типа терминалов. Для них значение по умолчанию
- line. В Tcl-скриптах конец строки всегда представляется
- единственным символом новой строки (
-). Однако, в реальных
- файлах и устройствах конец строки может быть представлен
- разными символами или наборами символов в зависимости от
- используемой платформы или даже конкретного устройства.
- Например, на UNIX- платформах символ новой строки
- используется в файлах, в то время как для сетевых соединений
- используется последовательность "возврат каретки -
- новая строка". При вводе данных (например, при
- исполнении команд gets
- или read) система ввода -
- вывода Tcl сама автоматически преобразует внешнее
- представление конца строк во внутреннее представление
- (символ новой строки). При выводе (например, при команде puts) также происходит
- преобразование ко внешнему формату представления конца
- строки. Значение аргумента по умолчанию равно auto.
- При этом символы конца строки для большинства ситуаций
- правильно определяются автоматически. Однако, опция
- -translation позволяет при необходимости задать
- соответствующие символы в явном виде. Аргумент mode задает представление конца строки для
- каналов, открытых только на чтение или только на
- запись. Список {inMode outMode} определяет
- представление конца строки для каналов ввода - вывода.
- Пользователь может указать в списке единственный символ,
- который будет использоваться и для ввода, и для вывода.
- Однако, при запросе команда возвратит текущие установки в
- виде списка из двух одинаковых элементов. Поддерживаются следующие значения опции: См. также close(n), flush(n), gets(n), puts(n), read(n), socket(n)
- Копирует данные из одного канала в другой. Команда fcopy копирует данные из одного канала ввода -
- вывода, заданного идентификатором канала inchan, в другой
- канал ввода - вывода, заданный идентификатором канала
- outchan. Команда позволяет упростить буферизацию и
- избежать излишнего копирования в Tcl-системе ввода - вывода, а
- также избежать использования больших объемов памяти при
- копировании данных по таким медленным каналам, как сетевые
- соединения. Команда fcopy передает данные из канала inchan,
- пока не будет достигнут конец файла или не будет передано
- size байтов. Если аргумент -size не задан,
- передается весь файл. Если опция -command не задана,
- команда блокирует процесс до завершения копирования и возвращает
- число переданных байтов. При наличии аргумента -command команда fcopy
- работает в фоновом режиме. Она завершается немедленно, а команда
- callback вызывается позже, когда завершается процесс
- копирования. Команда callback вызывается с одним или
- двумя дополнительными аргументами, которые указывают число
- переданных байтов. Если при исполнении фонового процесса
- произошла ошибка, второй аргумент - строка описания ошибки. При
- фоновом выполнении копирования каналы inchan и
- outchan не обязательно открывать в неблокирующем режиме,
- команда fcopy выполнит это автоматически. Однако при
- этом необходимо организовать обработку событий, например, с
- помощью команды vwait или
- используя Tk. Не допускается выполнение других операций ввода - вывода с теми
- же каналами во время фонового копирования. Если один из каналов
- во время копирования будет закрыт, процесс копирования будет
- прерван и вызова команды callback не произойдет. Если
- будет закрыт канал ввода данных, то все полученные данные,
- хранящиеся в очереди, будут выданы в выходной канал. Необходимо отметить, что канал inchan может стать
- открытым на чтение во время копирования. Все обработчики
- файловых событий во время фонового копирования должны быть
- выключены, чтобы они не создавали помех копированию. Любые
- попытки ввода - вывода с помощью обработчиков файловых событий
- будут завершены с ошибкой "канал занят". Команда fcopy преобразует символы конца строк в
- соответствии со значениями опций -translation для
- соответствующих каналов (см. описание команды fconfigure). Преобразование
- означает, в частности, что число прочитанных и число переданных
- символов может отличаться. В синхронном режиме команда
- возвращает только число переданных в outchan канал
- символов. В фоновом режиме только это число подается на вход
- команды callback. Первый пример показывает, как в фоновом режиме получить число
- переданных байтов. Конечно, это показательный пример, поскольку
- то же самое может быть сделано проще без использования фонового
- режима. Второй пример показывает, как можно организовать копирование
- файла по фрагментам и проверять конец файла. См. также eof(n), fblocked(n), fconfigure(n). Команда для работы с файлами и их именами. Эта команда осуществляет различные действия с файлами, их
- именами или свойствами. Аргумент name содержит имя
- файла. Если он начинается с символа "~", то перед
- выполнением команды выполняются "тильда"-подстановки,
- как описано в filename.
- Опция команды указывает, какие действия необходимо выполнить с
- файлом. Ниже приведены возможные опции. В команде их имена могут
- быть сокращены до уровня, сохраняющего уникальность их имен. Эта подкоманда возвращает или устанавливает зависящие от
- платформы атрибуты файла. Первая форма возвращает список
- атрибутов и их значений, вторая возвращает значение
- указанного атрибута, а третья - позволяет установить
- значения одного или нескольких атрибутов. Возможные атрибуты
- перечислены ниже. На Windows-платформах поддерживаются атрибуты
- -archive, -hidden, -longname (атрибут
- не может быть установлен), -readonly,
- -shortname (атрибут не может быть установлен),
- -system. На Macintosh-платформах поддерживаются атрибуты
- -creator, -hidden, -readonly,
- -type. Возвращает имя, составленное из всех элементов
- name, кроме последнего. Если name - относительное имя
- файла и состоит из единственного элемента, возвращает
- "." (":" для Macintosh). Если имя
- указывает на корневой каталог, возвращается имя корневого
- каталога. Например: вернет c:/. "Тильда"-подстановки выполняются, только если они
- необходимы для формирования правильного результата. Например: вернет ~/src, тогда как вернет /home (или что-то подобное). Возвращает 1, если name - имя каталога,
- и 0 в противном случае. Возвращает 1, если файл name -
- регулярный файл, и 0 в противном случае. Соединяет аргументы name в одно имя с помощью
- разделителя, используемого на данной платформе. Если
- очередной аргумент name представляет собой
- относительное имя, он присоединяется к предыдущим, в
- противном случае предыдущие аргументы отбрасываются, и
- процесс формирования имени начинается заново с текущего
- аргумента. Например: вернет /foo/bar. Аргументы name могут содержать разделитель, это не
- помешает получить правильный результат для используемой
- платформы ("/" для Unix и Windows, ":"
- для Macintosh). Возвращает список элементов пути name. Первый элемент
- списка при этом имеет тот же тип пути, что и name. Все
- остальные элементы - относительные. Разделители удаляются,
- если только они не необходимы для указания на относительный
- тип элементов. Например, под Unix вернет / foo/~bar baz, чтобы гарантировать, что
- последующие команды не попытаются выполнить "тильда"-
- подстановку в третьем элементе. См. также filename. Исполняет скрипт, когда канал открывается на чтение или
- запись. Эта команда используется для создания обработчиков файловых
- событий. Обработчик файловых событий связывает канал и скрипт
- таким образом, что скрипт исполняется, когда канал открывается
- на чтение или запись. Обработчики файловых событий используются,
- чтобы получение данных от другого процесса управлялось
- событиями. При этом получающий процесс, ожидая поступление
- данных, сможет продолжать взаимодействовать с
- пользователем. Если приложение выполняет команду gets или read из блокирующего канала, оно
- не способно обслуживать другие события, поэтому оно кажется
- пользователю "замороженным". С использованием файловых
- событий процесс обратится к команде gets или read только когда информация
- поступит в канал.
- Аргумент channelId должен быть идентификатором
- открытого канала, который вернула предыдущая команда open или socket. Если в команде присутствует
- аргумент script, команда создает новый обработчик
- событий: скрипт script будет выполнен, когда канал
- channelId откроется на чтение или запись (в зависимости
- от второго аргумента команды). В такой форме команда возвращает
- пустую строку. Обработчики для обработки открытия файла на
- чтение или запись соответственно независимы и могут создаваться
- и удаляться по одному, независимо один от другого. Однако для
- каждого из событий может быть только один обработчик, так что
- если команда fileevent выполняется, когда соответствующий
- обработчик (в текущем интерпретаторе) уже задан, новый скрипт
- заменит старый.
- Если аргумент script не задан, команда fileevent
- возвратит скрипт, заданный для данного события для канала
- channelId, или пустую строку, если скрипт не
- задан. Обработчик событий удаляется автоматически при закрытии
- канала или удалении интерпретатора.
- Канал считается открытым на чтение, если на соответствующем
- устройстве есть непрочитанные данные. Также канал считается
- открытым на чтение, если есть непрочитанные данные во входном
- буфере, кроме того случая, когда команда gets не смогла найти в буфере
- законченную строку. Эта особенность позволяет читать файл
- построчно в неблокирующем режиме, используя обработчик
- событий. Канал также считается открытым на чтение, если
- достигнут конец соответствующего файла или на соответствующем
- устройстве сгенерирована ошибка. Поэтому скрипт должен уметь
- распознавать и корректно обрабатывать такие ситуации, чтобы не
- возникало зацикливаний, когда скрипт не может прочитать данные,
- завершается и тут же вызывается вновь.
- Канал считается открытым на запись, если по крайней мере один
- байт данных может быть записан в соответствующий файл или
- передан на соответствующее устройство, или на устройстве (в
- файле) сгенерирована ошибка.
- Событийно управляемый ввод - вывод лучше всего работает с
- каналами, переведенными в неблокирующий режим с помощью команды
- fconfigure. В
- блокирующем режиме команды puts, gets или read могут заблокировать
- процесс, если они не могут быть выполнены сразу (например, при
- попытке прочитать больше данных, чем доступно в настоящий
- момент). При этом никакой обработки событий не происходит. В
- неблокирующем режиме команды puts, gets или read никогда не блокируют
- процесс. Детальное описание работы команд с блокирующими и
- неблокирующими каналами приведено в описаниях соответствующих
- команд.
- Скрипт обработчика файловых событий выполняется на самом
- верхнем уровне вне контекста какой-либо процедуры в
- интерпретаторе, в котором обработчик событий был задан. Если при
- исполнении скрипта происходит ошибка, сообщение о ней выдается с
- помощью процедуры bgerror. Кроме того, при ошибке
- соответствующий обработчик событий удаляется. Это делается для
- того, чтобы избежать зацикливания из-за ошибок в обработчике.
- Правила именования файлов в Tcl. Все команды Tcl и процедуры С, использующие имена файлов в
- качестве аргументов, позволяют использовать имена в форме,
- установленной для данной платформы. Кроме того, на всех
- платформах Tcl поддерживается синтаксис UNIX с целью
- предоставления удобного способа составления простых имен
- файлов. Тем не менее, скрипты, предназначенные для переноса
- между платформами, не должны пользоваться конкретной формой имен
- файлов. Вместо этого такие скрипты должны использовать команды
- file split и file join для
- преобразования имен к нужной форме.
- Все имена файлов поделены на три типа, в зависимости от
- начальной точки для отсчета пути: абсолютные, относительные и
- имена внутри тома (volume-relative). Абсолютные имена являются самодостаточными, они содержат полный
- путь файла внутри тома и адрес корневого каталога
- тома. Относительные имена являются неполными, они указывают
- положение файла по отношению к текущему каталогу. Имена внутри
- тома занимают промежуточное положение между первыми двумя, они
- указывают положение файла относительно корневого каталога
- текущего тома или относительно текущего каталога указанного
- тома. Для определения типа указанного пути можно использовать команду
- file pathtype. Пути формируются различным образом для различных платформ.
- Текущая платформа определяется по значению переменной
- tcl_platform(platform): На Unix-платформах используются пути, которые содержат
- компоненты, разделенные символом слэш. Пути могут быть
- абсолютными или относительными, имена файлов могут содержать
- любые символы, кроме слэша. Имена файлов. и. являются
- специальными и обозначают текущий каталог и родительский
- каталог текущего каталога, соответственно. Несколько слэшей
- подряд понимаются как один разделитель. Ниже приведено несколько примеров различных типов путей:
- В дополнение к правилам, описанным выше, Tcl позволяет
- использовать "тильда"-подстановки в стиле cshell. Если
- имя файла начинается с ~, за которой сразу следует
- сепаратор, она заменяется на значение переменной окружения
- /home/svk. В противном случае символы от "тильды"
- до следующего разделителя интерпретируются как имя пользователя
- и заменяются на имя домашнего каталога пользователя.
- На Macintosh- и Windows-платформах
- "тильда"-подстановки с именем пользователя не
- поддерживаются. При попытке использовать такое имя файла
- выдается ошибка. Однако "тильда" без имени
- пользователя заменяется, как и на Unix-платформах, на значение
- переменной окружения /home/svk.
- При разработке переносимых приложений необходимо учитывать,
- что не все файловые системы различают заглавные и прописные
- буквы. Поэтому следует избегать использования имен файлов,
- различающихся только регистром букв. Кроме того, необходимо
- отказаться от использования символов, имеющих специальное
- назначение хотя бы на одной из платформ, например,
- <>:"/\|. А также, если предполагается
- использовать программу на Windows 3.1, необходимо учитывать, что
- имена файлов при этом должны быть ограничены восемью буквами, а
- расширения - тремя. Команда организует немедленную выдачу выходных данных в канал. Команда направляет накопленные в выходном буфере данные в
- канал с идентификатором channelId (значение
- идентификатора возвращается командами открытия канала open или socket), который должен быть
- открыт для записи. Если канал находится в блокирующем режиме, то
- команда будет оставаться незавершенной до тех пор, пока все
- содержимое буфера не будет отправлено в канал. Если канал
- находится в неблокирующем режиме, то команда может завершиться
- до окончания отправки выходных данных в канал. Остающиеся
- данные будут передаваться в канал в фоновом режиме с такой
- скоростью, с какой назначенный каналу файл или устройство сможет
- принимать их.
- Команда for организует цикл. Команда for является командой цикла. По структуре
- команда for похожа на аналогичную команду языка С. Здесь
- аргументы start, next и body должны быть
- командными строками Tcl, а test - строкой выражения.
- Сначала команда for запускает интерпретатор Tcl для
- выполнения start. Затем она вычисляет значение выражения
- test; если оно не равно нулю, то запускает
- Tcl-интерпретатор для выполнения body, затем
- next. Цикл повторяется до тех пор, пока test не
- станет равно 0. Если при выполнении body будет выполнена
- команда continue, то
- последующие команды в body пропускаются и начинает
- выполняться next, затем test и т.д. Если при
- исполнении body или next встретится команда
- break, исполнение команды
- for немедленно прекращается. Команда for
- возвращает пустую строку.
- Замечание. Строку test почти всегда следует
- помещать в фигурные скобки. В противном случае подстановки
- переменных будут выполнены до выполнения команды. Из-за этого
- измененное в ходе цикла значение переменной может перестать
- передаваться в выражение, что может породить бесконечный
- цикл. Если же строка test заключена в фигурные скобки,
- подстановка значения переменных выполняется в каждом цикле. Для
- примера можно выполнить следующий скрипт со скобками и без
- скобок вокруг выражения <10:
- Команда цикла по элементам одного или нескольких списков. Команда организует выполнение цикла, в котором переменные
- цикла последовательно принимают все значения из списков
- значений. В простейшем случае имеется одна переменная цикла
- varname и один список значений list для присвоения
- переменной цикла. Аргумент body есть скрипт Tcl. Для
- каждого элемента списка list, по очереди с первого до
- последнего, foreach присваивает содержимое очередного
- элемента списка переменной varname и затем вызывает
- интерпретатор Tcl для исполнения body.
- В общем случае в команде может быть указано несколько списков
- значений (например, list1 и list2), и каждый из
- них может быть связан с одной переменной или со списком
- переменных цикла (например, varlist1 и
- varlist2). Во время каждой итерации переменные каждого
- списка переменных принимают значения последовательных элементов
- соответствующего списка значений. Значения из списков значений
- используются последовательно от первого до последнего, и каждое
- значение используется только один раз. Общее число итераций
- выбирается таким, чтобы использовать все значения из всех
- списков значений. Если список значений не содержит достаточного
- числа значений для всех связанных с ним переменных цикла, вместо
- недостающих элементов используются пустые значения.
- Внутри скрипта body можно использовать команды break и continue, аналогично команде
- for.
- Команда foreach возвращает пустую строку. В цикле используются переменные цикла i и j для цикла по
- элементам одного списка В результате величина x равна "a d c f e". При вычислении цикла используются три итерации. В цикле переменные цикла i и j используются для различных
- списков значений. В результате величина x равна "a d b e c f {} g". При вычислении цикла используются четыре итерации. Обе предыдущие формы скомбинированы в следующем цикле В результате величина x равна "a d e b f g c {} {}". При вычислении цикла используются три итерации.
- sprintf.
- , ANSI C sprintf (
- ).
- sprintf, formatString
- ,
- ,
- .
- sprintf
- .
- formatString
- .
- , %
- .
- .
-
- arg ,
- .
- formatString
- ,
- .
- .
-
- : , ,
- , ,
- . , ,
- .
- .
- % $,
- %2$d,
- , ,
- (1
- arg).
- ( *),
- ,
- .
- ,
- .
-
- .
- ,
- .
- .
- ,
- . , ,
- 0 -
- .
- *, ,
- .
-
- .
- .
- . e, E f
-
- . g G -
- (,
- , #).
- (
- ). s
- ,
- . ,
- . *, ,
-
- .
-
-
- h l. h ,
- 16 .
- l ,
- .
- ,
- .
- .
- .
- ,
- . format
- sprintf :
- l . Команда читает строку из канала. Команда gets читает из канала channelId
- очередную строку символов. Если имя переменной varName не
- задано, тогда команда возвращает полученную строку за
- исключением символов конца строки. Если varName задано,
- тогда команда записывает полученную строку в переменную и
- возвращает количество символов в принятой строке.
- Если при поиске конца строки был обнаружен конец файла,
- команда возвращает всю полученную информацию вплоть до конца
- файла. Если канал находится в неблокирующем режиме и поступила
- неполная входная строка, то команда не использует поступившие
- данные и возвращает пустую строку. Если указана переменная varName и возвращается пустая
- строка из-за конца файла или из-за неполноты полученной строки,
- команда возвращает 1. Обратите внимание, что если аргумент varName не задан,
- конец файла и неполная строка приведут к тому же результату, что
- и строка, состоящая из символа конца строки. Команды eof и fblocked позволяют различить эти
- ситуации. Команда возвращает имена файлов, удовлетворяющих шаблону.
- Команда glob выполняет поиск имен файлов подобно тому,
- как это делает оболочка csh, и возвращает список имен,
- удовлетворяющих шаблону pattern. Аргументы, начинающиеся
- со знака -, являются управляющими ключами switches.
- Возможные ключи: Шаблоны могут включать следующие специальные символы: Как и в csh, символ . в начале имени файла или сразу
- после / должен соответствовать явно или с помощью
- конструкции {}. Если первый символ образца ~, то он указывает на
- домашний каталог пользователя, чье имя указано после
- ~. Если сразу после ~ идет /, то
- используется значение переменной окружения HOME. Действие команды glob отличается от работы в csh в
- следующем: В отличие от другихTcl-команд команда glob может
- работать с именами файлов только в нотации, поддерживаемой на
- той платформе, на которой она исполняется. Кроме того, на
- Windows-платформах специальные символы не допустимы в сетевых
- именах.
- Команда для объявления глобальных переменных. Данная команда выполняется только при выполнении процедуры, а
- в остальных случаях игнорируется. Команда объявляет
- переменные varname глобальными. Глобальные переменные -
- это переменные глобальной области имен.
- Только в течение работы данной процедуры и только при
- выполнении в данной процедуре любая ссылка на значение любого из
- аргументов varname будет указывать на одноименную
- глобальную переменную. См. также namespace(n),
- variable(n)
- Команда работает со списком выполнявшихся команд. Команда history выполняет действия по отношению к
- недавно выполненным командам, занесенным в журнал. Каждая из
- этих зарегистрированных команд обозначается термином
- "событие". Ссылаться на события в команде
- history можно одним из следующих способов: Команда history может принимать одну из следующих
- форм. До версии 8.0 Tcl имел весьма сложный механизм
- переформирования журнала. Новый механизм несколько сокращен за
- счет старых опций substitute и words. (Взамен
- добавлена новая опция clear).
-
- Опция redo позволяет переформировывать журнал
- значительно проще. При ее выполнении последнее событие
- изменяется таким образом, что удаляется "служебная"
- команда history, которая реально выполнялась, а вместо
- нее записывается та команда, которая необходима. Если вы хотите повторить прежнюю команду, не модифицируя
- журнал, выполните сначала команду history event, чтобы
- извлечь описание команды, а затем history add, чтобы
- выполнить ее. Команда if проверяет соблюдение условия в ходе
- выполнения скрипта. Команда вычисляет значение выражения expr1(Точно так,
- как это делает команда
- expr). Это и все остальные выражения expr
- должны быть булева типа (то есть это должна быть числовая
- величина, причем 0 соответствует false, а все остальные
- значения - true, либо строка со значениями true
- или yes для true и false или no для
- false). Если выражение равно true, то скрипт
- body1 передается на выполнение интерпретатору Tcl. Если
- нет, то вычисляется значение выражения expr2, и если оно
- равно true, то исполняется body2, и так
- далее. Если ни одно из выражений не равно true, тогда
- выполняется bodyN. Слова then и else необязательны и используются
- только для простоты понимания команды. Аргумент
- bodyNтакже может отсутствовать, если отсутствует
- else. Команда возвращает значение выполненного скрипта или пустую
- строку, если ни одно из выражений не было равно true, и
- bodyN отсутствовал. Команда увеличивает значение переменной на заданную
- величину. Команда incr увеличивает значение переменной
- varName на величину increment. И значение
- переменной, и increment должны быть целыми числами. По
- умолчанию increment равно 1. Новое значение переменной
- сохраняется в виде десятичной строки и одновременно возвращается
- командой. Данная команда увеличивает переменную variable на 3. Данная команда увеличивает переменную variable на 1. Команда сообщает сведения о состоянии интерпретатора Tcl. Эта команда обеспечивает доступ к внутренней информации
- Tcl-интерпретатора. Ниже перечислены поддерживаемые опции (имена
- которых могут быть сокращены).
- Команда создает и управляет Tcl-интерпретаторами. Эта команда позволяет создавать один или несколько новых
- Tcl-интерпретаторов, которые сосуществуют в одном приложении с
- создавшим их интерпретатором. Создавший интерпретатор называется
- мастер-интерпретатором, а созданные интерпретаторы называются
- подчиненными (slave) интерпретаторами.
- Мастер-интерпретатор может создавать произвольное число
- подчиненных интерпретаторов, а каждый из подчиненных может в
- свою очередь создавать подчиненные интерпретаторы, для которых
- он сам является мастер-интерпретатором. В результате в
- приложении может создаваться иерархия интерпретаторов.
- Каждый интерпретатор независим от остальных. Он имеет
- собственное пространство имен для команд, процедур и глобальных
- переменных. Мастер-интерпретатор может создавать связи между
- подчиненными интерпретаторами и собой, используя механизм
- алиасов. Алиас - это команда в подчиненном интерпретаторе,
- которая, при ее вызове, вызывает другую команду в
- мастер-интерпретаторе или в другом подчиненном
- интерпретаторе. Кроме механизма алиасов, связь между
- интерпретаторами поддерживается только через переменные
- окружения. Массив env>обычно является общим для
- всех интерпретаторов в приложении. Необходимо заметить, что
- идентификаторы каналов (например, идентификатор, возвращаемый
- командой open) больше не
- разделяются между интерпретаторами, как это было в предыдущих
- версиях Tcl. Чтобы обеспечить совместный доступ к каналам,
- необходимо использовать явные команды для передачи
- идентификаторов каналов из интерпретатора в интерпретатор.
- Команда interp позволяет также создавать надежные
- интерпретаторы. Надежный интерпретатор - это интерпретатор с
- существенно урезанной функциональностью, поэтому он может
- исполнять ненадежные скрипты без риска нарушить работу
- вызывающего их приложения. Например, из безопасных
- интерпретаторов недоступны команды создания каналов и
- подпроцессов. Более подробно см. Безопасные интерпретаторы. Опасная
- функциональность не удалена из безопасных интерпретаторов, но
- скрыта таким образом, что только надежные интерпретаторы могут
- получить к ней доступ. Более подробно см. Скрытые команды. Механизм
- алиасов может быть использован для безопасного взаимодействия
- между подчиненным интерпретатором и его
- мастер-интерпретатором. Более подробно этот вопрос обсуждается в
- разделе "Использование алиасов".
- Полное имя интерпретатора представляет собой список, содержащий
- имена его предков в иерархии интерпретаторов и заканчивающийся
- именем интерпретатора в его непосредственном предке. Имена
- интерпретаторов в списке - это их относительные имена в их
- непосредственных мастер-интерпретаторах. Например, если a
- есть подчиненный интерпретатор текущего интерпретатора и, в свою
- очередь, имеет подчиненный интерпретатор a1, а тот, в
- свою очередь, имеет подчиненный интерпретатор a11, то
- полное имя a11 в a есть список {a1 a11}.
- В качестве аргумента описанной ниже команды interp
- используется полное имя интерпретатора. Интерпретатор, в котором
- исполняется команда, всегда обозначается как {} (пустая
- строка). Обратите внимание, что в подчиненном интерпретаторе
- невозможно сослаться на мастер-интерпретатор кроме как через
- алиасы. Также нет никакого имени, под которому можно было бы
- сослаться на мастер-интерпретатор, первым созданный в
- приложении. Оба ограничения вызваны соображениями безопасности.
- Команда interp используется для создания, удаления и
- выполнения команд в подчиненном интерпретаторе, а также для
- разделения или передачи каналов между интерпретаторами. Она
- может иметь одну из перечисленных ниже форм в зависимости от
- значения аргумента option.
- Эта команда создает алиас между двумя подчиненными
- интерпретаторами (для создания алиаса между подчиненным
- интерпретатором и мастер-интерпретатором используется
- команда slave alias). Оба интерпретатора
- srcPath и targetPath должны быть в иерархии
- интерпретаторов ниже того интерпретатора, в котором
- выполняется команда. Аргументы srcPath и
- srcCmd задают интерпретатор, в котором будет создан
- алиас и его имя. Аргумент srcPath должен быть
- Tcl-списком, задающим имя существующего интерпретатора.
- Например, "a b" определяет интерпретатор
- b, который является подчиненным интерпретатором
- интерпретатора a, который в свою очередь является
- подчиненным интерпретатором текущего интерпретатора. Пустой
- список соответствует текущему интерпретатору (в котором
- исполняется команда). Аргумент srcCmd определяет имя
- новой команды-алиаса, которая будет создана в интерпретаторе
- srcPath. Аргументы targetPath и
- targetCmd определяют целевой интерпретатор и команду,
- а аргументы arg, если они есть, определяют
- дополнительные аргументы для команды targetCmd,
- которые будут вставлены перед аргументами, заданным при
- вызове srcCmd. Команда targetCmd может как
- существовать, так и не существовать в момент создания
- алиаса. В последнем случае она не создается командой
- interp alias. Алиас позволяет использовать команду targetCmd в
- интерпретаторе targetPath каждый раз, когда
- вызывается команда-алиасsrcCmd в интерпретаторе
- srcPath. Подробнее см. "Использование алиасов".
- Создает подчиненный интерпретатор с именем path и
- новую команду для работы с этим интерпретатором, называемую
- также подчиненной (slave) командой. Имя подчиненной команды
- совпадает с последним элементом списка path. Новый
- подчиненный интерпретатор и подчиненная команда создаются в
- интерпретаторе, имя которого состоит из всех элементов
- списка path, кроме последнего. Например, если
- аргумент path равен a b c, то в результате в
- интерпретаторе a b будет создан подчиненный
- интерпретатор c и подчиненная команда c.
- Синтаксис подчиненной команды описан ниже см. "Команда
- работы с интерпретатором". Если аргумент path
- отсутствует, Tcl создает уникальное имя в форме
- interpx, где x - целое число, и использует его
- для подчиненного интерпретатора и подчиненной команды. Если
- в команде указана опция -safe или если
- мастер-интерпретатор сам является безопасным
- интерпретатором, новый подчиненный интерпретатор будет
- безопасным, то есть с ограниченной функциональностью. В
- противном случае новый интерпретатор будет включать полный
- набор встроенных Tcl-команд и переменных. Аргумент -
- используется для того, чтобы обозначить конец опций.
- Следующий аргумент будет использоваться как имя
- интерпретатора, даже если он равен -safe. Команда interp create возвращает имя нового
- интерпретатора. Имя подчиненного интерпретатора должно быть
- уникальным среди подчиненных интерпретаторов его мастера.
- Если у мастер-идентификатора уже существует. Для каждого подчиненного интерпретатора, созданного с помощью
- команды interp, в мастер-интерпретаторе создается команда
- с тем же именем, что и подчиненный интерпретатор. Эта команда
- предназначена для выполнения различных операций в подчиненном
- интерпретаторе. В общем случае она имеет следующий вид:
- где slave - имя подчиненного интерпретатора, а
- аргументы command и arg arg... определяют
- конкретное назначение команды. Ниже перечислены возможные
- формы команды. Безопасный интерпретатор - это интерпретатор с ограниченной
- функциональностью. Поэтому в нем можно без опасений выполнять
- произвольные скрипты, даже написанные вашим злейшим врагом, не
- опасаясь нарушить выполнение вашего приложения или испортить
- содержимое дисков вашего компьютера. Чтобы обеспечить
- безопасность, из таких интерпретаторов удалены определенные
- команды и переменные. Например, команда создания файлов на диске
- и команда запуска подпроцессов. Тем не менее, в безопасном
- интерпретаторе можно обеспечить ограниченный доступ к подобным
- командам с помощью механизма алиасов. В результате при
- выполнении потенциально опасных команд будут вызываться
- специально написанные процедуры в мастер-интерпретаторе, которые
- могут тщательно проверять заданные аргументы и позволять
- использовать только ограниченный набор средств. Например,
- создание файлов может быть разрешено только в ограниченном
- наборе подкаталогов, а запуск подпроцессов разрешен только для
- ограниченного (и фиксированного) набора хорошо проверенных
- программ.
- Чтобы создаваемый интерпретатор был безопасным, необходимо при
- его создании указать опцию -safe. Кроме того, любой
- интерпретатор, созданный из безопасного интерпретатора, также
- будет безопасным.
- Безопасный интерпретатор создается со следующим набором
- команд: Следующие команды в безопасном интерпретаторе скрыты: Эти команды могут быть созданы заново как Tcl-процедуры или
- алиасы или разрешены к использованию с помощью команды interp expose. Сверх того, в безопасных интерпретаторах отсутствует массив
- env, содержащий обычно
- переменные окружения. Это связано с тем, что в переменных
- окружения может храниться конфиденциальная информация. Расширения, загружаемые в безопасный интерпретатор, также
- обладают ограниченной функциональностью. Более подробно эти
- вопросы обсуждаются в пп. SafeTcl и load.
- Механизм алиасов весьма тщательно спроектирован таким образом,
- чтобы он позволял без опасений выполнять ненадежные скрипты в
- безопасных подчиненных интерпретаторах, используя для алиасов
- проверенные команды в мастер-интерпретаторах. Для обеспечения
- безопасности принципиально важно, чтобы информация из
- подчиненного интерпретатора никогда не обрабатывалась (то есть
- скрипты не исполнялись, и в них не производились подстановки) в
- мастер-интерпретаторе. В противном случае всегда будет
- оставаться возможность написать такой скрипт для подчиненного
- интерпретатора, который выполнил бы произвольные действия в
- мастер-интерпретаторе и мог бы нарушить его безопасность. Когда в подчиненном интерпретаторе вызывается команда-алиас,
- необходимые Tcl-подстановки в аргументах выполняются там же, как
- для обычной Tcl-команды. После этого аргументы объединяются с
- целевой командой и ее аргументами, определенными при создании
- алиаса. Так, если команда вызова алиаса имела вид srcCmd
- arg1 arg2... argN'', то сформируется команда targetCmd
- arg arg... arg arg1 arg2... argN'', где arg
- arg... arg - аргументы, указанные при создании
- алиаса. После этого сформированная команда выполняется в целевом
- интерпретаторе (со сформированным набором аргументов). Если в
- целевом интерпретаторе нет команды targetCmd, будет
- сгенерирована ошибка. Перед выполнением команды в целевом
- интерпретаторе больше никаких подстановок в аргументах
- произведено не будет. Команда будет вызвана напрямую, а не через
- обычный механизм выполнения. Таким образом, подстановки в каждом
- слове команды оказываются выполненными ровно один раз: в
- targetCmd и arg... arg - при выполнении команды,
- с помощью которой был создан алиас, а в arg1 - argN - при
- анализе команды алиаса в соответствующем интерпретаторе. При написании процедуры targetCmd, которую
- предполагается использовать для алиаса в безопасном
- интерпретаторе, нужно придерживаться следующего правила.
- Недопустимо, чтобы в значениях ее аргументов в теле процедуры
- производились подстановки, либо чтобы аргументы были скриптами,
- исполняемыми в теле процедуры. Нарушение этого правила дает
- возможность подчиненному интерпретатору выполнить произвольный
- код в мастер-интерпретаторе и нарушить, таким образом,
- безопасность системы. Безопасные интерпретаторы существенно ограничивают
- функциональные возможности выполняемых в них Tcl-скриптов. С
- одной стороны, это позволяет избежать нежелательных последствий
- при их исполнении, но, с другой стороны, рано или поздно
- возникает насущная необходимость выполнить потенциально опасную
- команду в безопасном интерпретаторе. Например, прочитать
- дополнительный скрипт с помощью команды source. Или выполнить в
- Tk-приложении некоторые команды управления окнами. Команда interp обеспечивает решение этой проблемы с
- помощью механизма скрытых команд. Потенциально опасные команды
- не удаляются из безопасного интерпретатора, а становятся
- скрытыми. При этом их невозможно выполнить из скрипта,
- выполняемого "внутри" интерпретатора. Но их можно выполнить
- "извне" из любого надежного предка интерпретатора с помощью
- команды interp invoke. Скрытые и обычные (не скрытые)
- команды размещаются в различных пространствах имен. Это
- позволяет иметь в одном интерпретаторе скрытую и обычную команды
- с одним и тем же именем. Скрытые команды могут использоваться в теле процедуры,
- использованной при определении алиаса. Например, в подчиненном
- интерпретаторе можно создать алиас source. Вызываемая при этом
- процедура в мастер-интерпретаторе проверяет допустимость
- запрошенной операции (например, что запрошенный файл находится в
- соответствующем каталоге, к которому разрешен доступ из
- подчиненного интерпретатора) и вызывает в подчиненном
- интерпретаторе скрытую команду source. Обратите внимание, что
- в этом случае в подчиненном интерпретаторе существует две
- команды source: скрытая и
- алиас. Из мастер-интерпретатора возможен вызов скрытых команд
- подчиненного интерпретатора через механизм алиасов. Поэтому в
- теле процедур, предназначенных для создания алиаса, необходимо
- избегать подстановок и команд исполнения для
- аргументов. См. "Использование алиасов". Безопасные интерпретаторы не могут "изнутри" вызвать скрытую
- команду в себе или своих потомках. Множество скрытых команд может быть изменено из надежного
- интерпретатора с помощью команд interp
- expose и interp
- hide. Безопасный интерпретатор не может изменить набор
- скрытых команд в себе или своих потомках. В настоящее время имена скрытых команд не могут содержать имени
- пространства имен. Поэтому, прежде чем скрыть команду, ее надо
- перевести в глобальное пространство имен. Команды, которые
- необходимо скрыть, должны находиться в глобальном пространстве
- имен. Это позволяет избежать ошибочного скрытия одноименной
- команды из другого пространства имен. Команда соединяет элементы списка в одну строку. Команда возвращает строковое значение, состоящее из всех
- элементов спискаlist, отделенных друг от друга символом
- joinString. Список list должен быть Tcl-списком,
- joinString по умолчанию есть пробел. Команда дополняет переменную элементами списка. Команда добавляет в список varName каждый из аргументов
- value как новый элемент, отделенный пробелом. Если
- varName не существует, то он будет создан с элементами,
- заданными value. Команда lappend подобна команде
- append, за исключением того,
- что аргументы добавляются в качестве элементов списка, а не
- просто текста. С помощью этой команды можно эффективно создавать
- большие списки. Например, для больших списков команда намного эффективнее, чем Команды стандартной библиотеки процедур Tcl. Tcl содержит библиотеку Tcl-процедур общего назначения. Местонахождение библиотеки Tcl можно получить с помощью команды
- info
- library. Обычно, помимо этой библиотеки, приложения
- имеют собственные библиотеки служебных процедур. Местонахождение
- процедур приложения обычно содержит глобальная переменная
- , где app - имя приложения. Например,
- для Tk это переменная . Для того, чтобы использовать процедуры из Tcl-библиотеки,
- приложению необходимо прочитать файл init.tcl библиотеки,
- например, командой Если в приложении процедура Tcl_AppInit вызывает
- библиотечную процедуру Tcl_Init, то такая команда
- выполняется автоматически. Код в файле init.tcl определит
- процедуру unknown и
- позволит остальным процедурам загружаться по требованию при
- помощи механизма автозагрузки, описанного ниже. Библиотека Tcl предоставляет пользователю следующие
- процедуры: Эта команда загружает определение для Tcl-команды
- cmd. Для этого она просматривает путь автозагрузки,
- являющийся списком из одного или более каталогов. Он
- содержится в глобальной переменной auto_path, если
- она существует. В противном случае используется переменная
- окружения TCLLIBPATH. Если же и она не существует, список
- автозагрузки состоит из каталога, в котором находится
- Tcl-библиотека. В каждом из каталогов, входящих в путь автозагрузки, должен
- находиться файл tclIndex, список команд, определенных
- в этом каталоге, и скрипты для загрузки каждой команды. Файл
- tclIndex должен быть создан с помощью команды
- auto_mkindex. Если команда была успешно загружена, то auto_load
- возвращает 1. Команда возвращает 0, если
- нужная команда не была найдена в списках команд или
- указанная команда загрузки не позволила создать команду
- (например, если файл tclIndex устарел). Если при
- выполнении указанного загрузочного скрипта возникла ошибка,
- команда возвращает ошибку. Команда auto_load читает индексные файлы только один
- раз и сохраняет полученную информацию в массиве
- auto_index. При последующих обращениях к команде
- auto_load сначала проверяется массив и только если
- информация о процедуре не найдена, приступает к просмотру
- индексных файлов. Эта информация может быть удалена с
- помощью команды auto_reset. После команды
- auto_reset следующий вызов auto_load к
- повторному чтению индексных файлов. Команда создает индекс для использования его командой
- auto_load. Для этого команда просматривает каталог
- dir в поисках файлов с именами, удовлетворяющими
- аргументам pattern (сравнение выполняется командой glob), и создает индекс всех
- командных процедур Tcl, определенных в обнаруженных файлах,
- и сохраняет индекс в файле tclIndex в этой
- dir. Если не задано ни одного шаблона pattern,
- то по умолчанию принимается *.tcl. Например,
- команда просматривает все .tcl-файлы в каталоге foo и
- создает новый индексный файл foo/tclIndex. Команда auto_mkindex просматривает Tcl-скрипты очень
- простым способом: если в очередной строке, начиная с первого
- символа, написано слово proc, считается, что это
- определение процедуры, а следующее слово есть имя
- процедуры. Процедуры, определение которых не подходит под
- описанное (например, если перед словом proc стоят пробелы), не попадают в
- индексный файл. Процедуры Tcl используют или определяют следующие глобальные
- переменные. auto_execs - используется командой auto_execok
- для записи информации о том, существуют ли конкретная команда в
- виде исполняемого файла. auto_index - используется auto_load для
- сохранения индексной информации, считанной с диска. auto_noexec - если переменная задана с любым значением,
- то команда unknown не
- будет пытаться автоматически исполнить какую-либо команду. auto_noload - если переменная задана с любым значением,
- то команда unknown не
- будет пытаться автоматически загрузить какую-либо команду. auto_path - если переменная задана, то она должна
- содержать Tcl-список с каталогами для просмотра при операциях
- автозагрузки. env(TCL_LIBRARY) - если переменная задана, то она
- указывает местоположение каталога с библиотечными скриптами
- (команда info
- library возвращает значение этой переменной). Если
- переменная не определена, то используется значение по
- умолчанию. env(TCLLIBPATH) - если переменная задана, то она должна
- содержать действующий Tcl список каталогов для поиска при
- операциях автозагрузки. Эта переменная используется только
- тогда, когда не определена переменная auto_path. tcl_nonwordchars - переменная содержит регулярное
- выражение, используемое такими процедурами, как
- tcl_endOfWord для определения, является ли символ частью
- слова или нет. Если образец соответствует символу, то символ
- считается не принадлежащим к слову. В Unix такими символами
- являются все символы, кроме цифр, букв и символа
- подчеркивания. tcl_wordchars - переменная содержит регулярное
- выражение, используемое такими процедурами, как
- tcl_endOfWord для определения, является ли символ частью
- слова или нет. Если образец соответствует символу, то символ
- считается частью слова. В Unix слова состоят из цифр, букв и
- символа подчеркивания. unknown_active - эта переменная служит флагом для
- индикации активности команды unknown: команда сама
- устанавливает ее. Переменная используется для выявления ошибок,
- при которых unknown
- бесконечно рекурсивно обращается к себе. Перед окончанием работы
- unknown переменная
- сбрасывается. Команда извлекает элемент списка. Команда lindex считает list Tcl списком и
- возвращает index-ный элемент этого списка. Для
- index значение 0 соответствует первому элементу
- списка, а значение end - последнему. При выполнении
- команды соблюдаются общие правила интерпретатора Tcl
- относительно фигурных скобок, двойных кавычек и обратного слэша,
- хотя подстановки переменных и команд не происходят. Если
- index отрицательное число или больше или равно числу
- элементов, команда возвращает пустое значение. Если значение
- аргумента index равно end, команда возвращает
- последний элемент списка. Команда служит для вставки элементов в список. Данная команда создает из listNameновый список при
- помощи вставки аргументов element непосредственно перед
- index-ным элементом списка list. Каждый из
- аргументов element станет отдельным элементом нового
- списка. Если индекс index меньше или равен нулю, новые
- элементы вставляются в начало списка. Если индекс index
- больше или равен числу элементов в списке или равен end,
- новые элементы вставляются в конец списка. Команда создает список. Команда list возвращает новый список из всех элементов
- arg или пустой список, если аргументы не указаны. При
- формировании списка по необходимости используются фигурные
- скобки и обратные слэши, что позволяет потом использовать
- команду index для извлечения исходных аргументов, а также
- использовать команду eval для
- исполнения результирующего списка, с arg1, содержащим имя
- команды, и остальными arg в качестве ее
- аргументов. Команда list несколько отличается от команды
- concat: тем, что команда concat удаляет один уровень
- группирования перед образованием списка, тогда как команда
- list работает непосредственно с исходными
- аргументами. Например, команда вернет Тогда как команда concat с
- теми же аргументами вернет Команда подсчитывает количество элементов в списке. Аргумент list истолковывается как список; команда
- возвращает строку с десятичным числом, равным количеству
- элементов в этом списке. Команда загружает машинный код и инициализирует новые команды. Эта команда загружает двоичный код из файла в адресное
- пространство приложения и вызывает инициализирующую процедуру
- библиотеки, чтобы включить ее в интерпретатор. Аргумент
- fileName есть имя файла, содержащего код. Конкретная
- форма кода различна на разных платформах, но чаще всего он
- должен быть разделяемой библиотекой, такой как .so-файлы
- для Solaris и .dll-файлы для Windows. Аргумент
- packageName есть имя библиотеки. Оно используется для
- определения имени инициализационной процедуры. Аргумент
- interp содержит имя интерпретатора (см. описание команды
- interp). Если аргумент
- interp не указан явно, то по умолчанию библиотека
- загружается в текущий интерпретатор. Как только файл загружен в адресное пространство приложения,
- вызывается одна из двух процедур инициализации нового
- кода. Обычно процедура инициализации добавляет в интерпретатор
- новые Tcl-команды. Имя процедуры определяется исходя из имени
- библиотеки и из того, является интерпретатор, в который будут
- добавляться команды, безопасным (см. команду interp). Для обычного
- интерпретатора имя процедуры pkg_Init, где pkg -
- имя библиотеки, преобразованное следующим образом: Первая буква
- переведена в верхний регистр, а все остальные - в
- нижний. Например, если имя библиотеки Foo, то имя
- инициализационной процедуры должно быть Foo_Init. Для безопасного интерпретатора имя процедуры должно быть
- pkg_SafeInit. Эта функция должна быть написана очень
- тщательно, чтобы позволить включить в безопасный интерпретатор
- только те команды библиотеки, которые безопасны при
- использовании в ненадежном коде. Дополнительная информация
- приведена в п. Safe. Процедура инициализации должна соответствовать следующему
- прототипу: Аргумент interp определяет интерпретатор, в который
- библиотека будет загружена. Процедура инициализации должна
- вернуть код TCL_OK или TCL_ERROR чтобы указать,
- была ли она завершена успешно. В случае ошибки она должна
- присвоить переменной interp->result значение указателя
- на сообщение об ошибке. Результат процедуры инициализации будет
- возвращен командой load как ее результат. Реально каждый файл загружается в приложение только один
- раз. Если команда load вызывается несколько раз, чтобы
- загрузить один и тот же файл в различные интерпретаторы, то
- реально загрузка кода выполняется только в первый раз. При
- последующих вызовах будет выполняться только процедура
- инициализации библиотеки в соответствующем интерпретаторе.
- Выгрузить или повторно загрузить библиотеку невозможно. Команда load также поддерживает библиотеки, статически
- связанные с приложением, если они зарегистрированы с
- использованием процедуры Tcl_StaticPackage. Если аргумент
- fileName есть пустая строка, то необходимо указывать имя
- библиотеки. Если аргумент packageName отсутствует или равен пустой
- строке, Tcl пытается сам сформировать имя библиотеки. На разных
- платформах это выполняется по-разному. На Unix-платформах обычно
- для этого берется последний элемент имени файла. Если первые три
- буквы в нем - lib, то они отбрасываются. После чего
- берутся все последовательные символы, которые являются буквами
- или символом подчеркивания. Например, если имя файла
- libxyz4.2.so, то в качестве имени библиотеки будет
- сформировано xyz, а при исполнении команды сформируется имя библиотеки last. Если аргумент
- fileName равен пустой строке, то должен быть задан
- аргумент packageName. Команда load в таком случае
- ищет сначала статически загружаемую библиотеку (то есть,
- библиотеку, зарегистрированную с помощью процедуры
- Tcl_StaticPackage) с указанным именем. Если такая будет
- найдена, то она используется в команде. В противном случае
- ищется динамически загружаемая процедура с этим именем. Если
- загружено несколько версий одной и той же библиотеки, то Tcl
- выбирает ту, которая была загружена первой. Если одна и та же библиотека загружается несколько раз из
- различных файлов, на некоторых платформах она будет загружена в
- адресное пространство несколько раз.
- Команда возвращает один или несколько последовательных
- элементов списка. Команда возвращает новый список - подмножество Tcl-списка
- list, начиная с элемента first и заканчивая
- элементом last включительно. Для обозначения последнего
- элемента списка list в аргументе first или
- last можно использовать значение end. Если аргумент
- first меньше нуля, он считается равным нулю. Если
- аргумент last больше или равен числу элементов в списке,
- он считается равным end. Если аргумент first
- больше, чем last, то команда возвращает пустой список.
- Команда не всегда возвращает тот же результат, что и (хотя это обычно так при простых элементах списка, которые не
- заключены в фигурные скобки). Но она всегда возвращает тот же
- результат, что и команда Команда замещает элементы списка новыми элементами. Команда lreplace возвращает новый список, образованный
- из списка list путем замены его элементов, начиная с
- first до last, на аргументы element. Если
- аргумент first меньше нуля, он считается равным
- нулю. Если аргумент last больше или равен числу элементов
- в списке, он считается равным end. Если last
- меньше, чем first, тогда не будет удалено ни одного
- прежнего элемента, и новые элементы будут просто вставлены перед
- first. Для аргументов first и last можно
- использовать значение end для ссылки на последний элемент
- списка. Каждый аргумент element становится отдельным
- элементом списка. Если не было задано ни одного аргумента
- element, тогда прежние элементы списка с first по
- last будут просто удалены. Команда проверяет наличие заданного элемента в списке. Данная команда просматривает по очереди элементы
- спискаlist с целью найти первый из них, совпадающий с
- заданным образцом pattern. Команда возвращает индекс
- первого найденного такого элемента или "-1" если такой
- элемент не найден. Аргумент mode указывает конкретный
- способ сравнения элементов списка и образца. Возможные значения
- аргумента: По умолчанию аргумент mode имеет занчение
- -glob. Команда сортирует элементы списка. Данная команда сортирует элементы списка list и
- возвращает новый список с уже упорядоченными элементами. По
- умолчанию используется упорядочивание в порядке возрастания
- символов в таблице ASCII. Кроме того, для управления процессом
- сортировки в команде можно указать произвольные из перечисленных
- ниже опций (допускаются уникальные сокращения). Словарный режим. Тоже, что и -ascii, но со
- следующими отличиями: Например, bigBoy окажется между bigbang и
- bigboy, а x10y между x9y и
- x11y. Эта опция может использоваться, если каждый из элементов
- списка сам есть список (то есть list есть список
- списков). Опция позволяет отсортировать список по "одной
- из колонок", то есть по элементам подсписков с
- фиксированным индексом index. Значение аргумента
- index, равное end, означает генерацию по
- последнему элементу подсписков. Например, команда вернет {Second 18} {First 24} {Third 30}. Эта опция значительно более эффективна для данной задачи,
- чем опция -command с соответствующей процедурой
- сравнения. Команда предназначена для создания и управления областями имен
- для команд и переменных. Команда позволяет создавать, обращаться и уничтожать отдельные
- области имен для команд и переменных. Более детально назначение
- и использование команды описаны ниже см.
- Пространства имен.
- Действия, выполняемые командой,
- зависят от значения аргумента option. Ниже приведены
- возможные опции команды. Позволяет захватить контекст текущей области имен для
- скрипта script с тем, чтобы потом использовать этот
- контекст при выполнении данного скрипта. Команда возвращает
- новый скрипт, в котором старый скрипт завернут в
- команду namespace code. Новый скрипт имеет две важные
- особенности: во-первых, он может быть вызван в произвольном
- пространстве имен, при этом реально он будет выполняться в
- текущем пространстве имен (том, в котором выполнялась команда
- namespace code). Во-вторых, к созданному таким образом
- скрипту можно дописывать произвольные аргументы и они
- действительно будут использоваться как дополнительные
- аргументы. Например, предположим, что команда выполняется в пространстве имен ::a::b. Тогда
- команда может быть выполнена в любом пространстве имен и будет
- иметь тот же эффект, что и команда Эта команда необходима потому, что расширения Tcl,
- например, Tk, обычно выполняют вызванные по событиям скрипты в
- глобальном пространстве имен. Обертывающая команда захватывает
- необходимую команду вместе с ее пространством имен и позволяет
- корректно выполнить ее позже по соответствующему
- вызову. Примеры использования данного механизма приведены ниже
- см. Правила
- видимости имен. Выполняет скрипт в контексте пространства имен
- namespace. Эта команда не предназначена для
- непосредственного исполнения программистом. Ее вызовы
- создаются автоматически при использовании команды
- namespace code для создания скриптов, выполняемых в
- фоновом режиме, например, для Tk-виджетов. Команда
- namespace inscope похожа на команду namespace
- eval, но отличается от нее наличием возможности
- указывать дополнительные аргументы и тем, что пространство
- имен namespace должно существовать в момент
- выполнения команды. При выполнении команды первый аргумент
- рассматривается как список, к которому остальные аргументы
- добавляются как элементы списка. Так команда эквивалентна Такая семантика весьма удобна при формировании скриптов,
- выполняемых в фоновом режиме. Пространство имен - это обособленный набор команд и
- переменных. Содержащиеся в нем команды и переменные не
- взаимодействуют с командами и переменными в других пространствах
- имен. В Tcl всегда был один такой набор, который мы будем
- называть глобальным пространством имен. В нем содержатся все
- глобальные переменные и команды. Команда namespace eval
- позволяет создавать другие пространства имен, например, команда
-
- создает новое пространство имен, содержащее переменную
- num и процедуру Bump. Команды и переменные в этом
- пространстве имен изолированы от других команд и имен в той же
- программе. Например, в глобальном пространстве имен может
- существовать другая команда Bump. Переменные пространства имен напоминают глобальные
- переменные. Они существуют вне процедур, но могут использоваться
- в процедурах с помощью команды variable, как показано в
- предыдущем примере. Пространства имен - динамические образования. В них можно
- в любой момент добавлять команды и переменные с помощью
- дополнительных команд namespace eval. Например, то же
- пространство имен, что и в предыдущем примере, можно было
- создать с помощью последовательности команд: Обратите внимание, что процедура test создана в
- пространстве имен Counter, а затем удалена с помощью
- команды rename.
-
- Пространства имен могут иметь собственные вложенные
- пространства имен и образовывать иерархию пространств имен.
- Вложенное пространство имен содержится в своем предке и не может
- взаимодействовать с другими пространствами имен. Каждое пространство имен имеет собственное имя, например history или
- ::safe::interp. Полные имена используются для указания
- команд, переменных или подпространств имен, содержащихся в
- соответствующем пространстве имен. Полные имена напоминают
- полные имена файлов в Unix или виджетов в Tk, но в качестве
- разделителей в них используется не слэш или точка, а двойное
- двоеточие "::". Самое верхнее или глобальное
- пространство имен имеет имя "" (пустая строка) и
- :: как синоним. Как пример, имя
- ::safe::interp::create ссылается на команду create
- в пространстве имен interp,
- которое является подпространством пространства имен
- ::safe, которое в свою очередь является подпространством
- глобального пространства имен ::. Если вы хотите указать команду или переменную в другом
- пространстве имен, вы можете указать имя пространства имен, в
- котором она содержится. Например, из глобального пространства
- имен вызвать процедуру из пространства имен Counter
- можно следующим образом: А вывести текущее значение переменной count можно с
- помощью команды Если одно пространство имен содержит другое, может понадобиться
- более длинное имя. Если пространство имен Foo содержит
- пространство имен Counter, то чтобы вызвать процедуру
- Bump в последнем из глобального пространства имен, нужно
- воспользоваться именем Полное имя может использоваться при создании или переименовании
- команд. Например, можно добавить процедуру в пространство имен
- Foo следующей командой: А переопределить ее в другом пространстве имен командой: Дополнительные замечания. Имена пространств имен, за
- исключением глобального, не могут быть пустой строкой.
- Сочетание :: запрещено в именах простых команд,
- переменных и пространств имен кроме как в роли разделителя имен
- пространств имен. Дополнительные символы : в полных
- именах игнорируются, то есть два или больше символов :
- подряд считаются одним разделителем. Сочетание :: в
- конце имени команды или переменной указывает на команду или
- переменную с именем {} (пустая строка). Однако в полном
- имени пространства имен :: на конце игнорируется. Все Tcl-команды, которые работают с именами переменных и
- команд, поддерживают полные имена. Это значит, что можно
- использовать полные имена в таких командах, как set, proc, rename, или interp alias. Если вы
- используете абсолютное имя, начинающееся с ::, то такое
- имя всегда интерпретируется однозначно. Однако, если вы
- используете относительное имя, не начинающееся с ::,
- поиск объекта с соответствующим именем происходит по следующим
- правилам: команды и переменные сначала ищутся в текущем
- пространстве имен, а затем (если не найдены) - в
- глобальном. Имена пространств имен ищутся только в текущем
- пространстве имен. В следующем примере Tcl ищет переменную traceLevel в пространстве имен
- Debug и затем в глобальном пространстве имен. Аналогично
- ищется и процедура printTrace. Чтобы не оставлять
- неясностей, рассмотрим еще один пример: Здесь Tcl ищет переменную traceLevel в пространстве имен
- Foo::Debug. Поскольку там ее нет, он продолжает поиск в
- глобальном пространстве имен. Переменная Foo::traceLevel
- в процессе поиска полностью игнорируется. Чтобы разобраться в сложных ситуациях, можно использовать
- команду namespace which. Например, следующая команда: вернет ::traceLevel. С другой стороны, команда: вернет ::Foo::traceLevel. Как уже упоминалось, относительные имена пространств имен
- ищутся иначе, чем имена команд и переменных. Они ищутся только в
- текущем пространстве имен. Это значит, что, например, команда
- namespace eval всегда создает потомка текущего
- пространства имен, если только имя нового пространства не
- начинается с ::. Tcl не ограничивает доступ к командам, переменным или
- пространствам имен. Если вы указали имя, которое в соответствие
- с перечисленными выше правилами ссылается на нужный вам элемент,
- вы можете использовать этот элемент. Переменные, определенные в данном пространстве имен, можно
- использовать в процедурах в этом же пространстве имен с помощью
- команды variable. Похожая на
- команду global, эта команда
- создает связь между локальной переменной в процедуре и
- одноименной переменной в пространстве имен. Если необходимо, эта
- команда также создает и инициализирует эту переменную (команда
- global только создает связь
- с переменной в глобальном пространстве имен). Команду variable можно не
- использовать, если вы всегда используете полное имя
- переменной. Пространств имен часто используются для создания
- библиотек. Некоторые библиотечные команды могут использоваться
- так часто, что необходимость использования полных имен станет
- раздражать. Например, если все команды в такой библиотеке, как
- BLT, содержатся в пространстве имен Blt. Тогда вы смогли
- бы использовать их только следующим образом: Если Вы используете команды graph и table
- регулярно, предпочтительнее использовать их без префикса
- Blt::. Для этого достаточно импортировать эти команды в
- текущее пространство имен, например, следующим образом: В результате выполнения этой команды все команды из
- пространства имен Blt будут экспортированы в текущее
- пространство имен, и вы сможете использовать их без
- соответствующего префикса: Команда namespace import импортирует только те команды,
- экспорт которых разрешен с помощью команды namespace
- export. Как правило, не стоит импортировать все команды из пространства
- имен, так как при этом может быть сложно отследить все команды,
- которые вы получите. Лучше указать явно, какие именно команды
- вам нужны. Например, команда импортирует только команды graph и table. Если вы попытаетесь импортировать команду, которая уже
- существует в текущем пространстве имен, то вы получите
- ошибку. Это предупредит, например, попытки скопировать одну и ту
- же команду из двух разных библиотек. Однако время от времени
- (например, при отладке) у вас может появиться желание преодолеть
- данное ограничение. Для этого нужно указать в команде опцию
- -force, и тогда существующая команда будет заменена на
- импортируемую команду без сообщения об ошибке: Если вам почему-либо надо прекратить использование библиотечной
- команды, это можно сделать следующим образом: Эта команда ищет в текущем пространстве имен все команды,
- импортированные из Blt, и удаляет их. Если таких
- команд не оказалось, команда ничего не делает. После
- исполнения команды namespace forget Blt::* команды из
- пространства имен Blt можно использовать только с
- префиксом Blt::. Если вы удаляете команду из того пространства имен, где она
- была создана, например: то она будет удалена из всех пространств имен, в которые она
- была импортирована. Вы можете разрешить экспорт команд из определенного
- пространства имен: После этого процедуры Bump и Reset можно
- импортировать, например, с помощью команды: Но экспорт процедуры check не разрешен, и она не будет
- импортирована этой командой. Команда namespace import позволяет импортировать
- только те команды, которые разрешено экспортировать из их
- пространства имен с помощью команды namespace export.
- Если в команде namespace import указана команда,
- которую нельзя экспортировать, она не будет импортирована в
- соответствующее пространство имен. Открывает канал для связи с файлом или программой. Эта команда открывает файл, последовательный порт или командный
- конвейер и возвращает идентификатор канала, который может
- использоваться в дальнейшем в таких командах, как read, puts и close. Если первый символ
- атрибута fileName не равен |, то команда отрывает
- файл fileName, соответственно значение аргумента fileName
- должно соответствовать обычным соглашениям, описанным в п. filename. Аргумент access, если он используется, указывает
- разрешенные режимы доступа к файлу. Аргумент access может
- указываться в одной из двух нотаций. В первой он может иметь
- следующие значения: Во второй нотации аргумент access может содержать набор
- из флагов, описанных ниже. Среди флагов обязательно должен быть
- один из следующих: RDONLY, WRONLY или
- RDWR. Если файл создается при выполнении команды open, то
- аргумент permissions (целое число) используется для
- установки прав доступа к вновь созданному файлу. Значение по
- умолчанию 0666. Если первый символ в fileName |'', то
- считается, что остальные символы описывают командный конвейер,
- который запускается так же, как командой exec. В этом случае идентификатор
- открытого канала может использоваться для ввода информации в
- стандартный ввод запущенного конвейера или для чтения его
- стандартного вывода в зависимости от значения аргумента
- access. Если канал открыть только на запись, то
- стандартный вывод конвейера направляется на текущий стандартный
- вывод (если он не перенаправлен в конвейере). Если канал открыт
- только на чтение, стандартный ввод для конвейера берется из
- текущего стандартного ввода (если он не перенаправлен в
- конвейере). Если аргумент fileName указывает на параллельный порт,
- то соответствующий порт открывается и инициализируется (реальные
- действия в зависимости от платформы). Допустимые значения
- fileName для различных платформ см.
- Особенности реализации на различных платформах. Команда fconfigure может
- быть использована для определения и изменения текущей
- конфигурации канала. Для последовательного порта можно
- использовать следующие опции. -mode
- baud,parity,data,stop Эта опция включает 4 величины, записанные через запятую. baud - число, скорость передачи данных в Бодах (бит
- в секунду); parity - четность, может принимать одно из значений
- n (none), o (odd), e (even), m
- (mark), s (space); data - число бит данных (целое от 5 до 8); stop - число стоп битов (целое 1 или 2). Сложности при работе с 16-битовыми DOS-приложениями. Также проблемы могут возникать при интерактивном выполнении
- Tcl, поскольку в этом случае консоль используется и для Tcl,
- и для порожденного подпроцесса. Открытие последовательного порта не поддерживается. Открытие командного конвейера также не поддерживается. Обычно для открытия последовательного порта используется
- значение fileName /dev/ttyX, где X
- равно a или b, но можно также использовать
- любой псевдофайл, назначенный на соответствующий порт. Проблемы могут возникать при интерактивном выполнении Tcl,
- поскольку в этом случае консоль используется и для Tcl, и
- для порожденного подпроцесса. Команда загрузки пакетов библиотек и контроля версий. Команда поддерживает простую базу данных со сведениями о том,
- какие пакеты библиотечных функций доступны для использования в
- данном интерпретаторе, и как их загрузить в интерпретатор. Она
- поддерживает многоверсионность пакетов и гарантирует загрузку в
- приложение необходимой версии пакета. При этом она обеспечивает
- контроль непротиворечивости версий. Обычно в Tcl-скриптах
- достаточно использовать команды package require и
- package provide. Остальные команды предназначены в
- первую очередь для системных скриптов, которые поддерживают базу
- данных пакетов. Поведение команды package определяется ее первым
- аргументом. Ниже описаны возможные формы команды. Команда используется, если для выполнения дальнейшего
- кода необходим библиотечный пакет package версии
- version. Команда возвращает номер загруженной версии или
- ошибку. Если присутствуют оба аргумента -exact и
- version, то команда загружает именно указанную версию
- (или выдает ошибку, если эта версия недоступна). Если
- присутствует номер версии, а -exact опущено, то команда
- загружает указанную версию или более позднюю, но с тем же
- старшим номером версии (2.7, но не 3.1, когда указана версия
- 2.5). Если база данных не содержит необходимой версии, а в
- интерпретаторе определена команда для packageunknown
- (см. ниже), то она исполняется, после чего повторно
- проверяется доступность необходимой версии. Если версия
- по-прежнему недоступна, команда возвращает ошибку. Команда последней надежды при поиске необходимой
- версии пакета. Если аргумент command указан, то он
- дополняется именем пакета и версии и полученный скрипт
- выполняется. Если версия не указана, подставляется пустая
- строка. Если аргумент command не указан, возвращает текущий
- скрипт, заданный для команды package
- unknown. Рекомендованный способ работы с пакетами в Tcl состоит в том,
- чтобы включать в скрипты команды package require и package
- provide и использовать процедуру pkg_mkIndex (см.
- соответствующие пункты) для создания индексных файлов для
- пакетов. Это обеспечивает автоматическую загрузку необходимых
- пакетов. См.также close(n), filename(n), gets(n), read(n), puts(n), exec(n). Команда сообщает идентификаторы процессов. Если задан аргумент fileId, то он должен указывать на
- конвейер процессов (process pipeline), открытый командой open. В этом случае команда представит
- список идентификаторов всех процессов в конвейере, по порядку.
- Если fileId указывает на открытый файл, не являющийся
- конвейером процессов, то список будет пустой. Если аргумент
- fileId не задан, то будет возвращен идентификатор текущего
- процесса. Все идентификаторы представлены десятичными
- строками. Создает индексный файл для автоматической загрузки пакета. Процедура pkg_mkIndex представляет собой утилиту для
- работы с Tcl-библиотеками. Она обеспечивает создание индексных
- файлов, необходимых для автоматической загрузки пакетов, когда в
- приложении встречается команда package require. Для создания
- автоматически загружаемых пакетов необходимо выполнить следующие
- действия: Если перечисленные выше шаги выполнены, то для
- использования необходимого пакета достаточно выполнить в
- приложении команду
- package require. Если, например, версии 2.1, 2.3 и
- 3.1 пакета Test проиндексированы и хранятся в
- соответствующих каталогах, то команда загрузит версию 3.1. А команда загрузит версию 2.1. В различных каталогах могут храниться
- много версий одного и того же пакета, но в данный
- интерпретатор может быть загружена только одна из них - та,
- которая будет затребована первой. Однако, в различных
- интерпретаторах одного приложения могут быть загружены
- различные версии одного и того же пакета. Автозагрузчик и загрузчик пакетов во многом имеют сходные
- возможности, поскольку и тот, и другой предназначены для
- загрузки файлов по требованию. Однако загрузчик файлов
- представляет собой механизм более высокого уровня, который
- использует автозагрузчик на последнем шаге процесса загрузки.
- Как правило, предпочтительнее индексировать пакеты с помощью
- команды pkg_mkIndex,
- чем с помощью команды auto_mkindex, поскольку это
- обеспечивает подключение механизма версий. Вы можете иметь
- несколько версий одного и того же пакета и, более того,
- использовать в различных приложениях различные версии. Напротив,
- auto_mkindex позволяет работать с единственной версией
- пакета. Скорее всего, не стоит создавать индексы для пакета с
- помощью и pkg_mkIndex,
- и auto_mkindex, поскольку в этом случае трудно
- контролировать, какой из механизмов загрузки пакета сработает
- первым, и, соответственно, какая версия пакета будет загружена.
- При первом вызове команды package require
- исполняется скрипт package
- unknown. При инициализации Tcl-скрипт package unknown
- задается таким образом, что он выполняет все файлы
- pkgIndex.tcl в каталогах auto_path. Эти файлы
- содержат команды package
- ifneeded для каждой доступной версии каждого
- доступного пакета. Эти команды в свою очередь вызывают команды
- package provide,
- которые объявляют данные версии доступными. Кроме того, они
- формируют необходимую исходную информацию для
- автозагрузчика. Данный файл данной версии данного пакета реально
- загружается только тогда, когда вызывается первая из
- содержащихся в нем команд. Таким образом, после выполнения
- команды package
- require вы не увидите команд пакета в интерпретаторе,
- но, тем не менее, вы сможете их вызвать и при этом они
- загрузятся автоматически. Создает Tcl-процедуры. Команда proc создает новую Tcl-процедуру с именем
- name, если такой процедуры ранее не было, и замещает
- ранее существовавшую процедуру или команду с таким именем, если
- она была. При вызове новой процедуры скрипт body
- передается на выполнение Tcl-интерпретатору. Обычно имя
- процедуры указывается без указания имени пространства имен. При
- этом новая процедура создается в текущем пространстве
- имен. Однако, если пространство имен указано явно, она создается
- в указанном пространстве. Аргумент args определяет
- формальные аргументы процедуры и представляет собой список
- (возможно, пустой), каждый элемент которого представляет
- описание одного формального параметра. Каждое такое описание
- само является списком из одного или двух элементов. Первый
- элемент списка определяет имя формального параметра. Второй
- элемент списка, если он указан, определяет значение по умолчанию
- для данного параметра. При выполнении процедуры для каждого формального параметра
- создается локальная переменная. Ей присваивается значение
- соответствующего аргумента, указанного при вызове процедуры, или
- значение по умолчанию. Аргумент, для которого при определении
- процедуры указано значение по умолчанию, может не присутствовать
- в вызове процедуры. Однако общее количество указанных параметров
- должно быть достаточным для аргументов, не имеющих значения по
- умолчанию, но не больше общего числа формальных параметров. Если
- это условие выполнено, все аргументы процедуры собираются в один
- список (как при исполнении команды list). Эта комбинированная величина
- присваивается локальной переменной args. При исполнении тела процедуры имена переменных обычно считаются
- именами локальных переменных, которые создаются автоматически по
- мере необходимости и удаляются после завершения процедуры. По
- одной локальной переменной создается также для каждого аргумента
- процедуры. Для использования глобальных переменных необходимо
- использовать команду global или
- upvar. Для использования
- переменных из пространства имен необходимо использовать команду
- variable или
- upvar. Команда proc возвращает пустую строку. При вызове
- процедуры возвращается величина, заданная в команде return. Если в процедуре не выполнялась
- явная команда return, она возвращает результат выполнения
- последней команды, выполнявшейся в теле процедуры. Если при
- выполнении процедуры произошла ошибка, то процедура в целом
- возвращает эту ошибку. Команда записывает данные в канал. Записывает символы из аргумента string в канал
- channelId. Значение channelId должно быть
- идентификатором канала, который вернула предыдущая команда open или socket. Соответствующий канал
- должен быть открыт на запись. Если аргумент channelId не
- указан, значение по умолчанию соответствует стандартному
- выводу. Команда puts обычно выдает после string
- символ новой строки, однако, если указана опция
- -nonewline, этого не происходит. Символы новой строки при выводе заменяются на
- последовательность, используемую на данной платформе (например,
- cr lf на Windows-платформах) в соответствии со
- значением опции канала -translation. Опция может быть
- изменена с помощью команды fconfigure. Tcl осуществляет вывод через буфер. Поэтому символы, выданные
- командой puts, могут и не появиться сразу в выходном
- устройстве или в файле. Обычно вывод откладывается до заполнения
- буфера или закрытия канала. Чтобы обеспечить немедленную выдачу
- данных, можно использовать команду flush. Когда буфер заполнится, команда puts обычно блокирует
- процесс до тех пор, пока все данные не будут переданы
- операционной системе для дальнейшего вывода. Если канал
- channelId открыт в неблокирующем режиме, процесс не
- блокируется, даже если операционная система еще не приняла
- данные. Tcl в этом случае продолжает складывать данные в буфер и
- в фоновом режиме передает их в соответствующий файл или
- устройство с той скоростью, с которой они могут принять
- данные. Чтобы работа в неблокирующем режиме была возможна,
- необходимо, чтобы был запущен обработчик событий. При работе в неблокирующем режиме возможен рост буфера, под
- который будет выделен неоправданно большой объем памяти. Чтобы
- избежать этого, неблокирующие операции ввода/вывода лучше делать
- управляемыми по событиям. При этом новая порция данных не будет
- передаваться в буфер, пока канал не будет готов к ее приему. Команда pwd возвращает путь к текущему каталогу. Команда pwd возвращает полный путь к текущему
- каталогу. Команда выполняет чтение данных из канала. Команда read зачитывает из канала channelId либо
- весь файл до символа конца файла (при первой форме записи), либо
- заданное параметром numBytes количество байтов (вторая
- форма). Если во втором случае в файле оказалось меньше байтов,
- чем задано numBytes, тогда возвращаются все байты, что
- остались. Если указана опция -nonewline, при выполнении команды
- отбрасывается символ новой строки в конце файла. Если канал открыт в неблокирующем режиме, команда может
- прочитать не указанное количество байтов, а только все
- доступные. После чего она не заблокирует процесс, дожидаясь
- дополнительных данных, а завершится. Если команда завершилась до
- конца файла, то опция -nonewline игнорируется. Команда read изменяет во входных данных
- последовательность, задающую конец строки, в соответствии с
- опцией канала -translation option.Опция может быть
- изменена с помощью команды fconfigure. Сравнивает строку и регулярное выражение. Команда определяет, соответствует ли регулярное
- выражениеexp какой-либо части строки string или
- всей строке, и возвращает 1, если соответствует, и
- 0 - в противном случае. Если в команде указаны дополнительные аргументы после
- string, они считаются именами переменных, в которые
- возвращается информация о том, какие именно части строки
- соответствуют регулярным выражениям. Переменной присваивается
- значение, состоящее из части строки, соответствующей всему
- регулярному выражению. Самой левой в списке переменной
- subMatchVar присваивается значение, состоящее из части
- строки, которая соответствует самому левому заключенному в
- скобки выражению в составе exp. Следующей переменной
- subMatchVar присваивается значение, соответствующее следующему
- заключенному в скобки выражению, и так далее. Если первые аргументы команды начинаются с -, они
- считаются опциями команды. Ниже перечислены возможные опции. Если в команде указано больше переменных subMatchVar,
- чем выражений в скобках в exp, или если для одного из
- выражений не удалось найти соответствующую ему часть строки, то
- соответствующей переменной будет присвоено значение -1
- или пустая строка, в зависимости от того, была ли задана опция
- -indices. Регулярное выражение состоит из ни одной или более
- ветвей (branch), разделенных символом '|'. Строка
- соответствует выражению, если она соответствует одной из его
- ветвей. Ветвь состоит из одной или более частей (piece),
- соединенных друг с другом. строка соответствует ветви, если ее
- можно разбить на подстроки таким образом, что начальная
- подстрока соответствует первой части ветви, следующая подстрока
- - следующей части ветви и так далее. Часть состоит из атома со следующим за ним необязательным
- символом '*', '+' или '?'. Атом с последующим
- символом * соответствует любой последовательности из нуля
- или более подстрок, каждая из которых соответствует атому. Атом
- с символом '+' после него соответствует любой
- последовательности из одной или более подстрок, каждая из
- которых соответствует атому. Атом с символом '?' после
- него соответствует подстроке, которая соответствует атому, или
- пустой строке. Атом может быть регулярным выражением в скобках (в этом случае
- он соответствует любой строке, которая соответствует этому
- регулярному выражению), интервалом (см. ниже), символом
- '.' (соответствует ровно одному произвольному символу),
- '^' (соответствует нулевой строке в начале
- string), '$' (соответствует нулевой строке в конце
- string), '\' с последующим одним символом
- (соответствует этому символу), или одним символом без
- какого-либо иного смысла (соответствует этому символу). Интервал есть последовательность символов, заключенная в
- квадратные скобки. Он обычно соответствует любому символу из
- этого интервала. Если последовательность начинается с символа
- '^', то она соответствует любому символу, кроме символов,
- стоящих далее в последовательности. Если два символа в
- последовательности разделены символом '-', то это краткая
- форма для обозначения всех ASCII символов между этими двумя
- (например, '[0-9]' соответствует любой десятичной цифре). Для
- того, чтобы включить в последовательность символ ']',
- следует поставить его на место первого в последовательности
- (следом за возможным символом '^'). Для включения в
- последовательность символа '-' следует сделать его первым
- или последним символом. Вообще говоря, регулярное выражение может соответствовать
- строке несколькими различными способами. Например, рассмотрим
- выражение В соответствии с описанными выше правилами переменные x
- и y могут принять значение aabb и aa,
- aaab и aaa, ab и a или одну из еще
- нескольких возможных комбинаций. Чтобы избежать этой
- потенциальной неопределенности команда regexp выбирает
- между возможными вариантами по правилу "первый и самый
- длинный". Другими словами, строка и регулярное выражение
- просматриваются слева направо, при этом выбирается часть строки
- максимально возможной длины. Говоря точнее, при выборе
- используются следующие правила в порядке убывания
- приоритета. В приведенном выше примере (a*)b* соответствует
- aab, так как для (a*) выбирается первый
- соответствующий ему фрагмент, то есть начальные aa, а
- затем для b* выбирается следующий символ
- b. Рассмотрим еще один пример: После выполнения команды переменная x будет содержать
- значение abc, переменная y - ab и
- переменная z будет содержать пустую строку. Правило [4] определяет, что поиск начнется с выражения
- (ab|a), а правило [2], что поиск начнется с подвыражения
- ab. Поэтому символ b в строке будет использован, и
- выражение (b*) будет соответствовать пустой строке. Команда выполняет подстановки, используя регулярные выражения. Команда сравнивает регулярное выражение exp и строку
- string и копирует string в переменную, заданную
- именем varName. Если совпадение найдено, то при
- копировании часть строки string, соответствующая
- exp, замещается на subSpec. Если subSpec
- содержит один из символов & or
diff --git a/hlp/ru/tcl/rename.html b/hlp/ru/tcl/rename.html
deleted file mode 100644
index d5e6956..0000000
--- a/hlp/ru/tcl/rename.html
+++ /dev/null
@@ -1,32 +0,0 @@
-
-
-
- Команда rename переименовывает или удаляет команду. Данная команда переименовывает команду по имени oldName
- в newName. Если newName отсутствует (равно пустой
- строке), тогда команда oldName удаляется. Имена oldName и newName могут содержать
- квалификаторы областей имен (указатели на имена областей имен).
- Если команда переименовывается в другую область имен, то
- последующие вызовы этой команды будут происходить в новой
- области имен. Команда rename возвращает пустую
- строку. Команда осуществляет возврат из процедуры. Команда немедленно осуществляет возврат из текущей процедуры
- (или команды верхнего уровня, или команды source) со значением, заданным
- string. Если аргумент string не задан, возвращает
- пустую строку. Обычно опция -code не используется, и процедура
- завершается успешно (с кодом завершения TCL_OK). Однако, ее
- можно использовать для генерации других кодов возврата. Ниже
- перечислены возможные коды. Опция -code используется относительно редко. Она
- предусмотрена для того, чтобы процедуры, реализующие новые
- управляющие команды, могли вернуть вызывающим их процедурам
- исключительные условия. Опции -errorinfo и -errorcode могут
- использоваться совместно с code error, чтобы вернуть
- дополнительную информацию о сгенерированной ошибке. В остальных
- случаях они игнорируются. Опция -errorinfo используется для того, чтобы задать
- исходное значение переменной errorInfo. Если она не будет
- задана, то в переменную errorInfo будет включена
- информация о вызове процедуры, вернувшей ошибку, и о более
- высоких уровнях стека, но не информация непосредственно об
- ошибке внутри процедуры. Чаще всего для формирования переменной
- info используется сообщение команды catch, обнаружившей ошибку в
- процедуре. Если опция -errorcode указана, она позволяет задать
- значение переменной
- errorCode. В противном случае ей будет присвоено
- значение NONE. Производит разбор строки в стиле процедуры sscanf. Данная команда, подобно ANSI C процедуре sscanf,
- просматривает строку string, выбирает поля и преобразует
- их в соответствии с очередным спецификатором преобразования в
- строке format. Выбранные значения преобразуются обратно в
- строковый вид и последовательно записываются в переменные
- varName. Команда scan просматривает одновременно строки
- string и format. Если очередной символ в строке
- format пробел или табуляция, то он соответствует любому
- числу (включая ноль) пробельных символов (пробел, табуляция,
- новая строка) в строке string. Если в строке
- format встретился символ %, он означает начало
- очередного спецификатора преобразования. Спецификатор
- преобразования включает в себя до трех полей после символа
- %: первое поле может содержать символ *,
- означающий, что преобразуемая величина будет удалена, а не
- записана в очередную переменную, второе поле может содержать
- число, указывающее максимальную ширину поля, и третье поле
- содержит букву, определяющую тип преобразования. Обязательным
- является только третье поле. Когда команда scan находит спецификатор
- преобразования в строке format, она пропускает
- пробельные символы в строке string. Затем она выбирает
- следующую группу непробельных символов и преобразует их в
- соответствии со спецификатором преобразования и записывает
- результат в переменную, соответствующую следующему аргументу
- команды. Поддерживаются следующие типы преобразований,
- задаваемые соответствующими символами: Число символов, которое выбирается для преобразования, это
- максимально возможное число символов для соответствующего
- преобразования (например, так много десятичных цифр, как это
- возможно для %d, или так много восьмеричных цифр, как это
- возможно для %o). Поле, выбираемое для очередного
- преобразования, закрывается, как только в строке string
- встречается пробельный символ или как только поле достигает
- указанного максимального размера (в зависимости от того, что
- происходит раньше). Если в спецификаторе преобразования для
- очередного поля присутствует символ *, то выбранное
- значение не присваивает никакой переменной, а очередной аргумент
- команды scan по-прежнему считается неиспользованным. Поведение команды scan не отличается от поведения ANSI
- C процедуры sscanf за исключением следующих моментов: Команда изменяет позицию доступа открытого канала. Команда изменяет текущую позицию доступа канала, заданного
- параметром channelId. Значение channelId должно
- быть идентификатором канала, который вернула предыдущая команда
- open или socket. Аргументы origin и
- offset задают новую позицию, в которой будет выполняться
- следующая операция чтения или записи. Аргумент offset
- должен быть целым числом (возможно, отрицательным), а аргумент
- origin может принимать одно из перечисленных ниже
- значений. Значение по умолчанию для аргумента origin равно
- start. Выполнение команды влечет немедленную передачу всех данных из
- выходного буфера в файл или на выходное устройство. Команда не
- будет завершена до тех пор, пока все данные не будут переданы,
- даже если канал находится в неблокирующем режиме. Кроме того,
- будут удалены все не прочитанные данные из входного
- буфера. Команда возвращает пустую строку. Если команда
- используется для файла или канала, для которого не
- поддерживается произвольный доступ, она вернет ошибку. Если первые аргументы команды начинаются
- с дефиса -, то они интерепретируются как параметры. В настоящее время
- допустимы следующие параметры:
- -async
- Команда читает и записывает значения переменных. Команда set возвращает значение переменной
- varName. Если задан параметр value, то команда
- присваивает переменной varName значение value и
- возвращает значение value. Если такой переменной не
- существовало, тогда она создается вновь. Если varName содержит открывающую скобку и
- заканчивается закрывающей скобкой, тогда это элемент массива.
- Символы до открывающей скобки являются именем массива, символы
- между скобками есть индекс этого элемента в массиве. В
- противном случае команда адресуется к скалярной
- переменной. Обычно имя переменной указывается без указания пространства
- имен, в котором она содержится. При этом соответствующая
- переменная для чтения или записи ищется в текущем пространстве
- имен. Если же в имени переменной присутствуют имя пространства
- имен, то она ищется в указанном пространстве имен. Если команда используется вне тела процедуры, то
- varName есть имя глобальной переменной (если текущее
- пространство имен есть глобальное пространство) или переменной
- текущего пространства имен. В теле процедуры varName
- есть имя параметра или локальной переменной процедуры, если
- она не объявлена глобальной переменной или переменной
- пространства имен с помощью команды
- global или
- variable соответственно. Команда открывает сетевое TCP-соединение.
-
- Эта команда открывает сетевое соединение и возвращает
- идентификатор канала, который может использоваться в
- последующих командах read,
- puts или
- flush. В настоящее время
- поддерживается только протокол TCP. Команда может
- использоваться для открытия соединения как со стороны
- сервера, так и со стороны клиента. Если опция -server не указана, то канал открывается со
- стороны клиента, и возвращаемый идентификатор канала может быть
- использован для операции чтения и записи. Аргументы port
- и host задают порт для соединения. По данному порту
- должен быть сервер, обслуживающий соединение. Аргумент
- port должен быть целым числом, а host - адресом
- машины в доменном стиле (например, www.sunlabs.com) или
- числовым IP-адресом (например, 127.0.0.1). Для ссылки на
- локальную машину, на которой выполняется команда, можно
- использовать значение localhost. Для задания дополнительной информации о соединении можно
- использовать следующие опции. Если в команде присутствует опция -server, то новый
- сокет будет сервером для порта port. Tcl будет
- автоматически устанавливать соединения по данному порту. Для
- каждого соединения будет создаваться новый канал, который может
- быть использован для связи с клиентом. При этом Tcl выполняет
- команду command с тремя дополнительными аргументами: имя
- нового канала, адрес клиентской машины в сетевой нотации и номер
- порта клиента. В команде можно использовать следующие опции: Канал сервера не может быть использован для приема или выдачи
- данных. Его единственное назначение - принимать новые клиентские
- подсоединения. Каналы, открываемые для каждого клиентского
- соединения, открываются на чтение и запись. Закрытие серверного
- канала вызывает отключение сервера, так что никаких новых
- соединений не может быть выполнено. Однако существующие
- соединения сохраняются. Сокет сервера не может обнаружить новое соединение при
- незапущенном обработчике событий. Поэтому в приложении должен
- быть запущен обработчик событий, например, командой vwait. Команда fconfigure может
- получить значения нескольких неизменяемых опций для сокетов:
-
- Команда source исполняет скрипт, содержащийся в
- файле. Данная команда передает интерпретатору Tcl содержимое
- названного файла в качестве исполняемого скрипта. Команда
- возвращает результат выполнения последней выполненной команды
- скрипта. Если при выполнении скрипта возникла ошибка, то команда
- source возвратит эту ошибку. Если при выполнении скрипта
- была вызвана команда return, то
- выполнение скрипта прекращается, и команда завершается. При этом
- она возвращает результат выполнения команды return. Для Macintosh-платформ существуют дополнительные варианты
- команды, предназначенные для работы с ресурсами. Команда разделяет строку на части и создает из них правильный
- Tcl-список. Команда делит строку string в каждом месте, где есть
- символ, содержащийся в splitChars. Каждый элемент списка
- образован частью исходной строки, заключенной между двумя
- последовательными вхождениями символов из splitChars в
- строку. В списке формируется пустой элемент, если два символа из
- splitChars встречаются подряд или если первый или
- последний символ string содержится в splitChars.
- Если splitChars есть пустая строка, то строка разбивается
- на отдельные символы. По умолчанию splitChars содержит
- пробельные символы (пробел, табуляция, новая строка). Команда вернет comp unix misc, а команда вернет H e l l o { } w o r l d. Команда для работы со строками. Выполняет одну из перечисленных ниже строковых операций в
- зависимости от заданной опции option. Проверяет, соответствует ли строка образцу. Возвращает
- 1, если соответствует, и 0 - в противном
- случае. Соответствие проверяется примерно так же, как в
- C-shell. Строка соответствует шаблону, если они совпадают
- посимвольно, за исключением перечисленных ниже специальных
- случаев: , .
-
- subst -nobackslashes -nocommands -novariables string
-
- subst , string . Tcl . string : - Tcl - subst.
- -nobackslashes, -nocommands -novariables, .
- ! subst .
-
-
- set a 44
- "xyz {44}" "xyz {$a}".
diff --git a/hlp/ru/tcl/switch.html b/hlp/ru/tcl/switch.html
deleted file mode 100644
index 75c000d..0000000
--- a/hlp/ru/tcl/switch.html
+++ /dev/null
@@ -1,117 +0,0 @@
-
-
- Команда выполняет один из нескольких скриптов в зависимости
- от полученного значения. Команда switch сравнивает аргумент string по
- очереди с каждым из образцов, заданных аргументами
- pattern. Если строка string соответствует
- очередному образцу, выполняется соответствующий скрипт
- body и команда возвращает результат его выполнения. Если
- последний из образцов равен default, то ему соответствует
- любая строка. Если строка не соответствует ни одному из образцов
- (что значит, в частности, что образец default
- отсутствует), то никакой скрипт не выполняется и команда
- возвращает пустое значение. Если один или несколько первых аргументов команды начинаются с
- -, они считаются опциями команды. Возможные опции
- перечислены ниже. Команда предполагает использование одной из двух синтаксических
- форм для задания образцов и скриптов. Первая использует
- отдельные аргументы для каждого образца и скрипта. Эта форма
- удобна при необходимости выполнить подстановки в образцах и/или
- скриптах. Во второй форме все они помещаются в один аргумент,
- который должен быть списком. Элементами этого списка должны
- быть, соответственно, образцы и скрипты. Эта форма более удобна
- для длинных команд, не размещающихся в одной строке, поскольку
- она не требует использовать обратный слэш в конце каждой
- строки. Но при ее использовании необходимо учитывать, что,
- поскольку список содержится в фигурных скобках, подстановки
- команд и переменных в образцах и скриптах не
- производятся. Вследствие этого результат выполнения команды,
- записанной в различных формах, может различаться. Если один из аргументов body равен -, это
- означает, что при совпадении строки с данным образцом будет
- выполняться скрипт body для следующего образца. Если для
- следующего образца скрипт также равен -, то будет
- использован скрипт для следующего за ним образца и т.д. Ниже приведены примеры использования команды
- switch. Команда вернет значение 2. Команда вернет значение 1. А команда вернет значение 3.
-
-
-
diff --git a/hlp/ru/tcl/tcl.toc.html b/hlp/ru/tcl/tcl.toc.html
deleted file mode 100644
index 019eafa..0000000
--- a/hlp/ru/tcl/tcl.toc.html
+++ /dev/null
@@ -1,91 +0,0 @@
- Переменные, используемые Tcl. Следующие глобальные переменные автоматически создаются при
- запуске программ. Как правило, они ведутся автоматически и в
- пользовательском приложении их значения не изменяются. Эта переменная представляет собой массив, элементы
- которого соответствуют переменным окружения. Присвоение
- значения элементу массива приводит к изменению значения (или
- созданию) соответствующей переменной окружения. Удаление
- элемента массива с помощью команды unset удаляет соответствующую
- переменную окружения. Модифицированное состояние массива
- используется для процессов - потомков, запущенных командой
- exec.
- На Windows-платформах переменные PATH,
- COMSPEC и WINDIR всегда пишутся в верхнем
- регистре. Все остальные переменные оставляются в том виде, в
- каком они заданы в операционной системе. На Macintosh-платформах, на которых нет переменных
- окружения, автоматически формируемый массив env, тем
- не менее, содержит следующие элементы: LOGIN, USER, SYS_FOLDER, APPLE_M_FOLDER, CP_FOLDER,
- DESK_FOLDER, EXT_FOLDER, PREF_FOLDER, PRINT_MON_FOLDER,
- SHARED_TRASH_FOLDER, TRASH_FOLDER, START_UP_FOLDER, PWD
- При возникновении ошибки эта переменная содержит
- дополнительную информацию об ошибке в форме, удобной для
- автоматической обработки. Эта информация содержится в виде
- списка из одного или более элементов. Первый элемент списка
- содержит имя класса ошибки. Его значение определяет формат
- остальной части списка. Стандартно используются следующие
- классы ошибок (в приложении могут определяться и
- дополнительные классы): Переменная управляет числом цифр при переводе десятичных
- чисел в строки. Значение по умолчанию 12. Максимальное
- значение 17 позволяет переводить числа из двоичного
- представления в строковое и обратно без потери точности.
- Однако при этом отключается округление. В результате команда
- вернет значение 1.3999999999999999, если tcl_precision
- равна 17, и значение. 1.4 если tcl_precision равна
- 12. Все интерпретаторы в процессе используют одно и тоже
- значение tcl_precision. Изменение точности представления
- чисел в одном из интерпретаторов ведет к его синхронному
- изменению во всех остальных. Однако, в надежных
- интерпретаторах изменять точность нельзя. Команда возвращает текущую позицию поиска открытого
- канала. Команда tell возвращает десятичную строку, указывающую
- текущую позицию доступа в канале channelId. Если канал
- не поддерживает прямой доступ, то возвращается значение
- "-1". Команда выполняет скрипт заданное количество раз. Команда time вызовет интерпретатор Tcl count раз
- для выполнения скрипта script или только один раз, если
- аргумент count не задан. Команда возвратит строку вида отображающую среднее
- время в микросекундах, израсходованное на одну итерацию. В
- строке указывается прошедшее время, а не время работы
- процессора. Команда отслеживает работу с переменными. Эта команда вызывает выполнение указанных Tcl команда при
- определенных действиях с переменной. Ниже перечислены возможные
- опции команды (допускаются сокращения). Обеспечивает выполнение команды command при
- определенных действиях с переменной name. Ниже
- перечислены возможные значения аргумента ops и какие
- действия с переменной при этом отслеживаются. Аргумент
- name может содержать имя простой переменной, имя
- элемента массива или имя массива. Если name содержит
- имя массива, то команда command выполняется при
- соответствующих действиях с любым элементом массива. Аргумент ops состоит из одной или больше букв,
- перечисленных ниже. Когда срабатывает команда trace, то исполняемая
- команда command дополняется тремя аргументами, как
- указано ниже Здесь name1 это имя переменной, действия с которой
- вызвали срабатывание команды. Если это элемент массива, то
- name1 это имя массива, а name2 - имя
- конкретного элемента массива. В противном случае
- name2 - пустая строка. Если в команде trace
- было указано имя массива и он удаляется, то name2
- также будет пустой строкой. Имена в переменных name1
- и name2 не обязано совпадать с теми, что были заданы
- в команде trace variable, поскольку команда upvar позволяет процедуре
- обращаться к переменной по различным именам. Аргумент
- op указывает какое именно действие выполнялось с
- переменной и может принимать значения r, w или
- u как указано выше.
- Команда command исполняется в том же контексте, что
- и код, вызвавший срабатывание trace. То есть если
- действие с переменной выполнялось в процедуре, то команда
- command может обращаться к локальным переменным этой
- процедуры. Этот контекст может отличаться от контекста, в
- котором выполнялась сама команда trace. Если команда
- conmmand есть вызов процедуры (как обычно и бывает),
- то в процедуре необходимо использовать команду upvar или uplevel чтобы получить доступ к
- контролируемой переменной. Как уже говорилось, имена в
- переменных name1 и name2не обязано совпадать с
- теми, что были заданы в команде trace variable,
- поскольку команда upvar
- позволяет процедуре обращаться к переменной по различным
- именам. Если команда trace контролирует чтение и запись в
- переменную, команда command может изменить результат
- отслеживаемой операции. Если команда command изменяет
- значение отслеживаемой переменной, то новое значение будет
- возвращено как результат отслеживаемой операции. Величина,
- возвращаемая командой command, игнорируется, если
- только это не ошибка. Тогда отслеживаемая операция также
- возвращает ошибку с тем же самым сообщением об ошибке,
- которое было сформировано в команде command, не
- поясняя, что ошибка произошла в результате отслеживания
- переменной. Это может приводить к определенным трудностям в
- определении истиной операции, при выполнении которой
- возникла ошибка. При отслеживании записи в переменную команда command
- вызывается после того, как значение переменной
- изменено. Поэтому с ее помощью можно изменить присвоенное
- значение. Если при этом возвращать исходное значение,
- переменная окажется доступной только для чтения. При выполнении команды command при отслеживании
- чтения или записи в переменную механизм слежения временно
- отключается. То есть выполнение этих операций в
- command не приведет к новых вызовам command.
- Однако, если в command выполняется удаление
- переменной, это приводит к соответствующему вызову. Когда срабатывает команда trace на удаление переменной,
- переменная уже удалена. Если удаление переменной произошло
- вследствие завершения процедуры, команда command
- вызывается в контексте вызывающей процедуры, поскольку
- контекст вызвавшейся процедуры уже не существует.
- Отслеживание не отключается при выполнении command в
- случае удаления переменной. Поэтому если в command
- выполняется новая команда trace и удаляется
- соответствующая переменная, выполнится и соответствующая
- команда command. Ошибки при отслеживании удаления
- игнорируются. Если одна и та же переменная отслеживается с помощью
- нескольких команда trace, то выполняться все
- соответствующие команды command с учетом порядка
- выполнения соответствующих команд trace. Чем позднее
- она выполнялась, тем раньше будет выполнена соответствующая
- команда command. Если одна из команд command
- при этом возвратит ошибку, остальные команды выполняться не
- будут. Если одна команда используется для отслеживания
- элемента массива, а другая - для массива в целом, первой
- выполняется команда отслеживания массива в целом, а затем
- уже команда отслеживания элемента. Однажды выполненная команда trace остается активной
- пока она не удалена с помощью описанной ниже команды
- trace vdelete, пока не удалена переменная или
- пока не удален интерпретатор. Удаление элемента массива
- приведет к прекращению отслеживания этого элемента, но не
- отслеживания массива в целом. Команда trace variable возвращает пустую строку. Если задано отслеживание переменной name с
- перечнем действий ops и командой command, то
- оно будет удалено. Соответственно команда command
- никогда не будет вызвана. Команда trace vdelete
- возвращает пустую строку. Возвращает список, содержащий по одному элементу для
- каждого заданного отслеживания для переменной name. Каждый
- элемент списка содержит два элемента, содержащие значения
- ops и command из команды trace, которой
- было задано соответствующее отслеживание. Если переменная
- name не существует или для нее не задано отслеживания,
- команда возвращает пустую строку. Команда unknown обрабатывает попытки обратиться к
- несуществующей команде. Интерпретатор Tcl выполняет эту команду каждый раз, когда
- скрипт пытается обратиться к несуществующей команде. Исходный
- вариант unknown не является функцией ядра Tcl;
- напротив, это библиотечная процедура, определяемая по
- умолчанию при запуске Tcl. Разработчик может переопределить
- ее функциональность так, как ему нужно. Когда Tcl находит имя команды, которому не соответствует ни
- одной из существующих команд, тогда он проверяет наличие команды
- unknown. Если команды unknown нет, то он
- возвращает ошибку. Если такая команда обнаружена, то она будет
- вызвана с аргументами, состоящими из имени и аргументов исходной
- несуществующей команды, в которых выполнены все необходимые
- подстановки. Команда unknown обычно выполняет поиск по библиотечным
- каталогам процедуры с именем cmdName, или поиск полного
- имени команды, к которой обратились по сокращенному имени, или
- автоматический запуск неизвестной команды как подпроцесса. При
- успешном поиске полного имени команды команда unknown
- заменяет имя на полное и вызывает команду с полным
- именем. Результат работы команды unknown используется
- вместо результата неопределенной команды. Создаваемая по умолчанию процедура unknown выполняет
- следующие действия. Сначала она вызывает библиотечную процедуру auto_load
- чтобы найти и загрузить соответствующую процедуру. Если это
- удалось, то выполняется исходная команда с ее исходными
- аргументами. В противном случае вызывается процедура auto_execok
- чтобы найти исполняемый файл с именем cmdName. Если файл
- удалось найти, выполняется команда exec с именем команды и ее
- аргументами в качестве аргументов. В противном случае проверяется, была ли неизвестная команда
- вызвана на самом верхнем уровне вне какого-либо скрипта. Если
- это было так, процедура unknown выполняет следующие
- дополнительные действия: проверяется не имеет ли команда одну из
- следующих форм:!!, !event, или
- ^old^new?^? и если да, то процедура
- unknown выполняет для них подстановки по тем же правилам, что и
- csh. И при неудаче всех предыдущих попыток процедура unknown
- проверяет, не является ли cmdName сокращением для
- известной Tcl процедуры. Если так, то cmdName заменяется
- на полное имя процедуры и она вызывается с исходными
- аргументами. Если же ни одна из попыток не привела к успеху, процедура
- возвращает ошибку. Если определена глобальная переменная auto_noload,
- попытка загрузить процедуру с помощью auto_load не
- производится. Если определена глобальная переменная auto_noexec,
- попытка загрузить процедуру с помощью auto_execok не
- производится. Если команду удалось найти, то процедура unknown
- возвращает результат выполнения найденной команды. Команда удаляет переменные. Команда unset удаляет переменные name. Правила
- именования переменных точно такие же, как для команды set. Если в команде указано имя
- элемента массива, то этот элемент будет удален из массива, не
- влияя на остальную часть массива. Если указано имя массива без
- индекса в скобках, то будет удален весь массив. Команда возвращает пустую строку. Если одна из переменных не
- существует, команда вернет ошибку, а последующие переменные не
- будут удалены. Команда update обрабатывает события, находящиеся в состоянии ожидания, и обратные вызовы (idle callbacks).
- СИНТАКСИС
- update idletasks
- ОПИСАНИЕ
- С помощью этой команды обновляется состояние приложения, поскольку при ее вызове обрабатываются все необработанные события и выполняются все асинхронные вызовы (idle callbacks).
- Если в команде задана опция idletasks, то новые события и ошибки не обрабатываются, но выполняются все асинхронные вызовы. Команду update idletasks удобно использовать тогда, когда нужно выполнить немедленно действия, которые обычно откладываются, например, обновить отображаемые на дисплее данные или окна. Большинство обновлений изображений на дисплее выполняются в виде фоновых вызовов, и эта команда обеспечит их выполнение. Однако, если изменения были вызваны событиями, они не будут выполнены немедленно.
- Команда update без опций полезна в тех случаях, когда во время долго выполняющихся вычислений необходимо обеспечить оперативную реакцию приложения на события, например, на действия пользователя. Вызов команды update и обеспечивает обработку таких событий.
-
diff --git a/hlp/ru/tcl/uplevel.html b/hlp/ru/tcl/uplevel.html
deleted file mode 100644
index 1262c5c..0000000
--- a/hlp/ru/tcl/uplevel.html
+++ /dev/null
@@ -1,93 +0,0 @@
-
-
- Команда выполняет скрипт в контексте, отличном от текущего. Все аргументы команды объединяются как при выполнении команды
- concat. Получившийся скрипт
- выполняется в контексте, указанном level. Команда
- возвращает результат выполнения скрипта. Если аргумент level задан как целое число, он указывает
- на сколько уровней выше уровня контекста текущей процедуры надо
- подняться в стеке вызовов перед выполнением скрипта. Если
- аргумент level задан как символ # с последующим
- целым числом, то он задает абсолютный уровень контекста в
- стеке. Если аргумент level отсутствует, то используется
- значение по умолчанию 1. Аргумент level должен
- быть указан, если первый из аргументов arg начинается с цифры
- или символа #. Например, предположим, что на самом верхнем уровне вызвана
- процедура a из нее вызвана процедура b, а из b вызвана процедура
- c. Предположим также, что в процедуре c есть вызов команды
- uplevel. Тогда если аргумент level равен 1
- или #2 или отсутствует, то указанный в команде скрипт
- будет выполнен в контексте процедуры b. Если аргумент
- level равен 2 или #1, то указанный в
- команде скрипт будет выполнен в контексте процедуры a. Если
- аргумент level равен 3 или #0, то указанный
- в команде скрипт будет выполнен на вернем уровне (уровень
- глобальных переменных). При выполнении команды uplevel контекст вызывающей
- процедуры временно удаляется из стека вызовов процедур. Так,
- если в приведенном выше примере команда uplevel имеет
- вид где d имя другой Tcl процедуры, то команда set изменит переменную x в контексте
- процедуры b, а процедура d будет выполняться на третьем уровне
- стека, как если бы она была вызвана непосредственно из b. Если в
- процедуре d в свою очередь содержится команда то команда set изменит
- значение той же переменной x в контексте процедуры b. Процедура
- c во время выполнения процедуры d не будет видна в
- стеке. Соответственно команда
- info level возвратит уровень текущей процедуры.
-
- Команда uplevel позволяет создавать новые управляющие
- конструкции как Tcl-процедуры. Команда namespace eval
- так же, как и вызовы процедур, изменяет контекст, в котором
- выполняются команды. Соответственно, для каждой команды namespace eval создается
- дополнительный уровень в стеке. Поэтому при указании уровня
- контекста в стеке каждую вложенную команду namespace eval надо
- считать наравне с вызовом процедуры. Это относится также к
- командам upvar и info level. Например, команда вернет список, описывающий самую верхнюю выполняемую команду,
- которая является либо вызовом процедуры, либо командой namespace
- eval. Независимо от использования команда namespace eval команда
- uplevel #0 выполнит соответствующий скрипт на
- уровне глобальных переменных (в глобальном пространстве
- имен). Команда создает связи между переменными различных уровней
- стека. Команда позволяет одной или больше локальным переменным текущей
- процедуры ссылаться на переменные процедуры, стоящей выше в
- стеке, или на глобальные переменные. Аргумент level может
- иметь те же формы, что и в команде uplevel, или быть опущен, если
- первый символ в первой из otherVar отличен от цифры и от
- # (значение по умолчанию 1). Для каждой пары аргументов
- otherVar myVar команда позволяет сделать
- переменную с именем otherVar из указанного уровня стека
- (локальную переменную одной из вызывающих процедур или
- глобальную переменную, если level равно #0) видимой в
- исполняемой процедуре под именем myVar. Переменная с
- именем otherVar не обязана существовать в момент
- исполнения команды. При необходимости она будет создана при
- первом использовании переменной myVar. В момент
- исполнения команды не должно быть доступной переменной myVar.
- Переменная myVar всегда считается простой переменной (не
- массивом и не переменной массива). Даже если значение
- myVar выглядит как имя элемента массива, например, a(b),
- создается простая переменная. Значение otherVar может
- быть именем простой переменной, массива или элемента массива.
- Команда upvar всегда возвращает пустую строку. Команда upvar позволяет упростить передачу параметра по ссылке,
- а также упрощает создание новых управляющий
- конструкций. Например, рассмотрим следующую процедуру: Процедура add2 вызывается с аргументом, содержащим имя
- переменной и увеличивает значение этой переменной на два. Хотя
- тот же результат мог быть получен с помощью команды uplevel,
- команда upvar позволяет легче работать с переменными из
- стека вызывающей процедуры. Команда namespace eval
- так же, как и вызовы процедур, изменяет контекст, в котором
- выполняются команды. Для каждой команды namespace eval создается
- дополнительный уровень в стеке. Соответственно, при указании
- уровня контекста в стеке каждую вложенную команду namespace eval надо
- считать наравне с вызовом процедуры. Это относится также к
- командам uplevel и info level. Например,
- команда info level 1
- вернет список, описывающий самую верхнюю выполняемую команду,
- которая является либо вызовом процедуры, либо командой namespace eval.
- Независимо от использования команда namespace eval команда
- uplevel #0 выполнит соответствующий скрипт на уровне
- глобальных переменных (в глобальном пространстве имен). Если переменная, созданная с помощью команды upvar,
- удаляется (например, если добавить в процедуру add2
- строку unset x), то реально будет удалена переменная,
- связанная с x, а не сама переменная x. Нет никакого способа
- удалить созданные таким образом переменные, кроме как выйти из
- процедуры, в которой они были созданы. Тем не менее, возможно
- связать переменную верхнего уровня с другой локальной
- переменной, выполнив еще одну команду upvar. Если otherVar есть элемент массива, то отслеживание
- массива в целом, заданной командой trace, не сработает при действиях с
- myVar (однако, если отслеживание было задано на
- отдельный элемент массива, оно сработает). В частности,
- изменения, сделанные с помощью myVar в массиве env, не будут корректно
- переданы подпроцессу.
- Команда создает и запускает переменные области имен. Обычно команду variable выполняют внутри команды namespace eval для
- создания одной или нескольких переменных в области имен. Каждая
- переменная name получает начальное значение
- value. Значение для последней переменной можно не
- указывать. Если переменная name не существует, она будет
- создана. Если указан аргумент value, то переменной
- присвоится его значение. Если аргумент не указан, то новая
- переменная останется неопределенной. Если же переменная уже
- существовала, она сохранит свое значение. Обычно имя создаваемой
- переменной - это простое имя, не содержащее имя пространств
- имен. Соответственно переменная создается в текущем пространстве
- имен. Если имя содержит имена пространств имен, переменная
- создается в указанном пространстве имен. Если команда variable выполняется внутри Tcl процедуры,
- она создает локальную переменную, связанную с соответствующей
- переменной пространства имен. В этом случае команда
- variable напоминает команду global, которая, однако,
- только связывает локальную переменную с глобальной. Если
- аргумент value задан, то он используется для изменения
- значения соответствующей переменной в пространстве имен. Если
- переменная в пространстве имен не существует, она создается и,
- при необходимости, инициализируется. Параметр name не может указывать на элемент массива. В
- команде variable можно указать только массив в целом, а
- затем присвоить значения его элементам командами set или array. Команда задает обработку событий до тех пор, пока не будет
- записано значение переменной. Команда vwait активизирует обработчик событий (event
- loop), блокируя приложение до тех пор, пока не в результате
- какого-либо события не будет присвоено новое значение переменной
- varName. После присвоения значения переменной
- varName команда vwait завершит работу сразу после
- выполнения скрипта, вызванного обработчиком событий. В некоторых ситуациях команда не завершается сразу после
- присвоения значения переменной varName. Это происходит,
- например, если вызванный по события скрипт, присвоивший новое
- значение переменной varName, не завершается сразу.
- Например, если в нем в свою очередь выполняется команда
- vwait, устанавливающая режим ожидания изменения другой
- переменной. Во время этого ожидания вышестоящая команда
- vwait блокируется как и приложение до выполнения
- соответствующего события. Команда выполняет скрипт до тех пор, пока не будет выполнено
- условие. Команда while вычисляет значение выражения test
- подобно команде expr. Значение
- должно быть булевого типа. Если результат есть "истина", то
- скрипт body передается на выполнение Tcl
- интерпретатору. После этого выражение test снова
- вычисляется, и процесс повторяется до тех пор, пока его значение
- не станет "ложь". В тексте скрипта body можно
- использовать команду continue
- для завершения текущего цикла и команду break для немедленного
- завершения команды while. Команда while всегда возвращает пустую строку. Выражение test почти всегда лучше заключать в фигурные
- скобки, иначе подстановки команд и переменных в нем будут
- выполнены до исполнения команды и никакие изменения значений
- переменных в скрипте body не изменят значения выражения
- test. Это может привести к возникновению бесконечного
- цикла. Если же выражение test помещено в фигурные скобки,
- подстановки в нем выполняются при каждом вычислении (перед
- каждым выполнением body). Например, если выполнить следующий
- скрипт с и без скобок вокруг <10, то без скобок
- возникнет бесконечный цикл. Команда загружает Tk в безопасный ИНТЕРПРЕТАТОР. Режим Safe Tk основан на режиме Safe Tcl,
- обеспечивающем ограниченный и опосредованный доступ к
- автозагрузке и пакетам для безопасных
- интерпретаторов. Safe Tk добавляет
- способность конфигурирования интерпретатора для безопасных Tk
- операций и загрузки Tk в безопасные интерпретаторы. Команда ::safe:: запускает необходимые
- структуры данных в безопасном интерпретаторе и загружает в него
- Tk. Команда возвращает имя безопасного интерпретатора. При работе с Tk в безопасном интерпретаторе необходимо
- следовать правилам поддержания безопасности, а также специальным
- рекомендациям для работы с Tk. safe,
- interp,
- library,
- load,
- package,
- source,
- unknowni
- СИНТАКСИС bell
-displayof window
- ОПИСАНИЕ
- Команда 'bell'
-подает сигнал
громкоговорителем дисплея для window.
-Если этот аргумент не
-задан, то по умолчанию используется дисплей главного окна приложения. В
-некоторых случаях команда гасит работающий в данный момент хранитель
-экрана (screen-saver), и окно снова становится видимым. ПРИМЕР
-
diff --git a/hlp/ru/tk/bind.html b/hlp/ru/tk/bind.html
deleted file mode 100644
index 225584c..0000000
--- a/hlp/ru/tk/bind.html
+++ /dev/null
@@ -1,607 +0,0 @@
-
-
- Команда bind позволяет привязать выполнение
- скриптов Tcl к X событиям. Команда назначает событиям ввода от
- "Мыши" и клавиатуры (Х событиям) исполнение скрипта
- Tcl. Команда bind привязывает Tcl скрипты к X
- событиям. Если заданы все три аргумента команды, то при каждом
- наступлении события последовательность в окне (окнах),
- описанных тегом, будет выполняться скрипт
- (скрипт Tcl). Если аргументу скрипт предшествует знак
- +, то скрипт добавляется к уже существующим привязкам к
- последовательности; в противном случае он замещает все
- имеющиеся привязки. Если аргумент скрипт пуст, то все
- имеющиеся привязки к последовательности отменяются, и
- последовательность становится несвязанной. Если
- аргумент скрипт присутствует, то команда
- bind возвращает пустую строку. Если при отсутствии аргумента скрипт аргумент
- последовательность задан, то команда возвращает скрипт,
- привязанный к данной последовательности, или, в случае
- отсутствия такого скрипта, пустую строку. Если не задан ни один
- из аргументов последовательность и скрипт, то
- команда возвращает список, элементами которого служат все
- последовательности, имеющие привязки к окну тег. Аргумент тег перечисляет окна, к которым выполняется
- привязка. Если значение аргумента начинается с точки, скажем
- ".a.b.c", то оно должно представлять собой путь к
- окну; в противном случае оно может быть произвольной
- строкой. Каждому окну приписан некоторый список тегов, и
- привязка к данному окну осуществляется, если значение аргумента
- тег присутствует в этом списке. Команда bindtags позволяет
- приписать окну произвольный набор тегов привязки; кроме того, по
- умолчанию окнам приписаны следующие теги: Аргумент последовательность представляет собой
- последовательность одного или нескольких образцов
- событий. Каждый образец может быть записан в одном из трех
- видов. В простейшем случае это символ ASCII, скажем
- a или |. Этот символ не может
- быть пробелом или знаком <. Этот вид образцов соответствует
- событию KeyPress для конкретной
- клавиши. Образцы второго вида длиннее, однако, этот вид носит
- более общий характер. Его синтаксис выглядит следующим
- образом: Образец события целиком заключен в угловые скобки. Внутри
- угловых скобок располагаются несколько модификаторов (быть
- может, ни одного), тип события и дополнительная порция
- информации (детализация), указывающая конкретную кнопку
- или комбинацию клавиш. Одно из полей тип или
- детализация должно обязательно присутствовать,
- остальные могут быть опущены. Поля разделяются пробелами или
- дефисами. Третья форма образца используется для задания поименованного
- виртуального события, определенного пользователем. У нее
- следующий синтаксис: Образец события целиком заключен в двойные угловые скобки.
- Внутри этих скобок содержится определенное пользователем имя
- виртуального события. С виртуальным событием нельзя
- комбинировать модификаторы, такие как Shiftили
- Control. Привязки к виртуальному событию можно
- создавать до описания самого события; при динамическом изменении
- этого описания все окна, привязанные к событию, будут обращаться
- к новому описанию. Модификаторы могут быть следующими: Если в строке приведено несколько элементов, разделенных
- запятыми, то они взаимозаменяемы. У большинства модификаторов
- есть очевидное X значение. Например, модификатор
- Button1 требует нажатия кнопки 1 для
- наступления события. Чтобы привязка соответствовала данному
- событию, среди модификаторов события должны содержаться все
- модификаторы, заданные в образце события. Кроме того событие
- может содержать и другие модификаторы, не приведенные в описании
- привязки. Например, при нажатии кнопки 1 одновременно с нажатием
- клавиш Shift и Ctrl событие
- подойдет под образец <Control-Button-1>,
- но не подойдет под образец
- <Mod1-Button-1>. Если ни один из
- модификаторов не был задан, то в событии может присутствовать
- любая комбинация модификаторов. Модификаторы Meta и M
- заменяют любой из идентификаторов от M1 до
- M5, ассоциированный с метаклавишами на
- клавиатуре (коды клавиш Meta_R и
- Meta_L). При отсутствии метаклавиш или в
- случае, если они не ассоциированы ни с каким модификатором,
- модификаторы Meta и M не будут
- соответствовать никакому событию. Аналогично модификатор
- Alt заменяет любой из модификаторов,
- ассоциированных с alt-клавишами на клавиатуре (коды клавиш
- Alt_L и Alt_R). Модификаторы Doubleи Triple
- обеспечивают удобную обработку двойного щелчка .Мыши. и других
- повторяющихся событий. Они требуют, чтобы данное событие
- повторилось дважды или трижды, и накладывают ограничения на
- время и место его повторения: для того, чтобы последовательность
- событий подходила под образец Double или
- Triple, промежуток времени между событиями
- должен быть коротким, а "Мышь" не должна сдвигаться. Например,
- комбинация <Double-Button-1> эквивалентна
- паре <Button-1><Button-1>
- с дополнительными временными и пространственными
- ограничениями. Значением поля тип может быть любой из стандартных
- типов X событий, а также некоторые дополнительные
- сокращения. Ниже приведен список всех допустимых значений. Два
- имени, составляющие пару, синонимичны. Последней частью длинной спецификации события является
- детализация. Для типов ButtonPress и
- ButtonRelease это номер кнопки (1-5). Если
- номер кнопки задан, то под образец подойдет только событие на
- указанной кнопке; если номер кнопки не задан, то под образец
- подойдет событие на любой из кнопок. Замечание: задание номера
- кнопки отличается от задания модификатора кнопки: в первом
- случае требуется, чтобы кнопка была нажата или отжата; во втором
- чтобы какая-то другая кнопка была отжата при наступлении
- события. Если номер кнопки задан, то поле тип можно
- опустить: по умолчанию оно будет иметь значение
- ButtonPress. Например, спецификатор
- <1> эквивалентен спецификатору
- <ButtonPress-1>.
-
- Для типов KeyPress и
- KeyRelease детализацию можно указать в виде
- описателя X клавиши. В их число входят все алфавитно-цифровые
- символы ASCII (например, описатель a служит для
- описания символа ASCII "a"), а также описатели для
- неалфавитно-цифровых символов (описатель comma
- для запятой) и описатели для всех не ASCII-клавиш клавиатуры
- (Shift_L для левой клавиши верхнего регистра,
- F1 для первой функциональной клавиши при ее
- наличии). Мы не приводим здесь полный список клавиш. Он меняется
- от системы к системе, и его можно найти в других частях X
- документации. При необходимости можно получить описатель клавиши
- с помощью обозначения %K, описанного ниже. Если
- приведена детализация описателя клавиши, то поле
- тип может отсутствовать, по умолчанию принимается
- значение KeyPress. Например, спецификатор
- <Control-comma> эквивалентен
- спецификатору <Control-KeyPress-comma>. Аргумент скрипт команды bind должен
- быть скриптом Tcl; при каждом наступлении события происходит
- выполнение этого скрипта. Команда выполняется тем же
- интерпретатором, что и команда bind, причем
- интерпретация происходит на верхнем уровне (доступны только
- значения глобальных переменных). Если в скрипте есть
- символы %, то его исполнение не будет
- осуществляться непосредственно. Каждый символ %
- и символ, следующий за ним, заменяются данными о происшедшем
- событии, в результате чего генерируется новый
- скрипт. Подстановка осуществляется в соответствии с приводимым
- ниже списком символов. Если не оговорено противное, то
- подставляемая строка представляет собой десятичное содержимое
- указанного поля события. Некоторые подстановки допустимы только
- для событий определенных типов: при использовании их с событиями
- других типов результат подстановки не определен. Для прочих событий подставляемая строка не определена. Строка подстановки для %-замещения форматируется как обычный
- элемент списка Tcl. Это означает, что при наличии в строке
- пробелов она заключается в фигурные скобки, а специальным
- символам, таким как `$' и `{' может предшествовать обратная
- косая черта. Такая строка нормально обрабатывается
- синтаксическим анализатором Tcl при выполнении скрипта. Строки
- подстановки по большей части являются числами или корректно
- определенными строками как, например, Above;
- такие строки не нуждаются ни в каком специальном
- форматировании. Чаще всего форматирования требуют строки,
- замещающие %A. Если, например, скрипт имеет
- вид и вводимым символом является открывающая квадратная скобка, то
- реально исполняемым скриптом будет т.е. в качестве первого аргумента insert
- получит исходную строку подстановки (открывающую квадратную
- скобку). Если бы обратная косая черта не была добавлена, Tcl не
- смог бы правильно обработать скрипт. Данному X событию может отвечать несколько привязок. Если эти
- привязки соответствуют различным тегам, то все они
- выполняются по очереди. По умолчанию сначала исполняется
- привязка для примитива, затем привязка класса, затем привязка
- верхнего уровня и привязка all. Этот порядок
- для конкретного окна можно поменять с помощью команды bindtags, которая
- позволяет также выполнить дополнительные привязки к окну. Управление обработкой скриптов, отвечающих образцу,
- осуществляется командами continue и break в
- привязанном скрипте. При выполнении команды continue
- выполнение текущего привязанного скрипта прерывается и Tk
- переходит к выполнению скриптов, соответствующих остальным
- тегам. При выполнении команды break выполнение
- текущего привязанного скрипта прерывается и никакие другие
- скрипты не выполняются. Если данному событию соответствует несколько привязок с одним и
- тем же тегом, то из них выбирается наиболее конкретная привязка
- и выполняется ее скрипт. Выбор наиболее конкретной привязки
- осуществляется по следующим критериям: если последовательность отвечает двум или более
- виртуальным событиям, то из них выбирается какое-нибудь
- одно, однако порядок выбора не определен. Если в подходящей последовательности событий больше одного
- события, то критерии 1 - 5 применяются ко всем событиям,
- начиная с самого последнего и до самого первого события
- последовательности. Если критерии не позволяют определить
- победителя, то победителем становится событие,
- зарегистрированное последним. Если одна и та же последовательность осуществляет переключение
- к двум (или более) виртуальным событиям, и теги окон этих
- виртуальных событий совпадают, то переключение произойдет лишь к
- одному из этих виртуальных событий, выбранному случайным
- образом: При нажатии Control-y будет выполнена привязка
- <<Paste>>, а при нажатии кнопки 2
- одна из привязок <<Paste>> или
- <<Scroll>>, причем определить какой
- именно будет эта привязка, невозможно. Если X событие не подходит ни под одну из существующих
- привязок, то событие игнорируется. Наступление не привязанного
- события не считается ошибкой. Если аргумент последовательность в команде
- bind состоит из нескольких образцов событий, то
- скрипт выполняется в случае, если последние события (включая
- самое последнее) подходят под данную последовательность. Это
- означает, например, что при неоднократном последовательном
- нажатии кнопки 1 каждое из нажатий, за исключением самого
- первого, отвечает образцу
- <Doudble-ButtonPress-1>. Если в
- последовательности событий происходят посторонние события, то
- они игнорируются, за исключением событий
- KeyPress и ButtonPress.
- Например, нажатия на кнопку 1 будут соответствовать образцу
- <Doudble-ButtonPress-1>, даже если их
- перемежают события ButtonRelease или
- Motion. Кроме того событию
- KeyPressможет предшествовать произвольная
- последовательность событий KeyPress для
- модификаторов, среди которых нет модификаторов, нарушающих
- соответствие образцу. Например, последовательности событий
- aB отвечает нажатие на клавишу
- a, отпускание клавиши a,
- нажатие на клавишу Shift и нажатие на клавишу
- b, так как нажатие на клавишу модификатора
- Shift игнорируется. И, наконец, если
- последовательно происходит несколько событий
- Motion, то для установления соответствия
- привязке берется последнее из них. При возникновении ошибки в процессе исполнения привязанного
- скрипта для выдачи сообщения об ошибке используется механизм bgerror. Команда
- bgerror
- исполняется на верхнем уровне (вне контекста любой из процедур
- Tcl). Команда определяет, какие привязки относятся к окну и порядок
- обработки. Когда с помощью команды bind создается привязка,
- ей ставятся в соответствие имя окна, имя класса, ключевое слово
- или какая-нибудь строка. Все эти формы называются тегами
- привязки (binding tag). Каждое окно имеет список тегов привязки,
- определяющих, каким образом обрабатываются события для данного
- окна. Когда в окне происходит событие, оно по очереди сличается
- с каждым из тегов окна, и для каждого тега исполняется та
- привязка, которая более всех соответствует событию и тегу. Команда позволяет получать сведения о привязках окна и
- модифицировать их: добавлять новые, удалять и замещать
- существующие. Встроенный тип изображений Tk, имеющих только два цвета. В терминах языка Tcl/Tk, bitmap - это двухцветное изображение,
- пиксели которого могут отображать один из двух заданных цветов
- или быть прозрачными. Такое изображение имеет четыре аргумента:
- два цвета (переднего плана и фона) и два двоичных файла,
- называемых source (источник) и mask
- (маска). Оба файла задают значения "0" или
- "1" для пикселей прямоугольной области, оба файла
- должны быть одной размерности. Пиксели, для которых в маске
- задано значение "0", не отображают ничего (получается
- эффект прозрачности). Остальные пиксели имеют либо цвет
- переднего плана, если значение в source для пикселя
- равно "1", либо фоновый цвет в обратном случае. Подобно всем прочим изображениям, двухцветные изображения
- создаются при помощи команды image create. При
- создании нового bitmap Tk также создает команду
- с именем этого изображения. Команда может использоваться для
- выполнения различных операций над данным изображением. Создание примитива кнопки и управление им. Подробное описание этих параметров приведено в разделе
- options. Ассоциирует с кнопкой команду Tk. Обычно команда выполняется
- при отпускании клавиши 1 "Мыши". Задает одно из трех состояний изображения ободка кнопки:
- normal, active или
- disabled. В активном состоянии кнопка имеет
- изображение по умолчанию для данной платформы. В нормальном
- состоянии кнопка изображается в виде, предусмотренном данной
- платформой для кнопок не по умолчанию; при этом остается
- достаточно места для изображения кнопки по умолчанию. Нормальное
- и активное состояние приводят к появлению кнопок одинакового
- размера. Отключенное состояние приводит к выводу кнопки не по
- умолчанию, не оставляя при этом места для кнопки по умолчанию.
- Кнопка в отключенном состоянии может быть меньше кнопки в
- активном состоянии. Задает желаемую высоту кнопки. Если в кнопке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселях (т.е., в любом виде, приемлемом для
- Tk_GetPixels); высота текстовой кнопки задается числом
- строчек текста. Если параметр не задан, то высота кнопки
- вычисляется по ее содержимому. Задает одно из трех состояний кнопки: normal,
- active или disabled. В
- нормальном состоянии кнопка изображается с использованием
- значений параметров foreground и
- background. В активном состоянии кнопка обычно
- находится, если на ней расположен курсор. Кнопка в активном
- состоянии изображается с использованием значений параметров
- activeForeground и
- activeBackground. Отключенное состояние
- указывает на то, что кнопка должна быть нечувствительной:
- привязки по умолчанию не приводят к запуску примитива и нажатия
- на кнопку "Мыши" игнорируются. В этом состоянии
- изображение кнопки определяется значениями параметров
- disabledForeground и
- background.
- Задает желаемую ширину кнопки. Если в кнопке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселях (т.е., в любом виде, приемлемом для
- Tk_GetPixels); ширина текстовой кнопки задается
- числом символов. Если параметр не задан, то ширина кнопки
- вычисляется по ее содержимому. Команда button создает новое окно (задаваемое
- аргументом имяПути) и превращает его в примитив кнопки.
- Детали изображения кнопки, такие, как ее цвета, шрифт, текст и
- объемный вид задаются с помощью описанных выше дополнительных
- параметров. Команда button возвращает аргумент
- имяПути. В момент выполнения этой команды не должно
- существовать окна с именем имяПути, но должен
- существовать его предок. Кнопка представляет собой примитив, в котором выводится
- текстовая строка, изображение или двуцветное изображение. Весь
- выводимый текст должен быть записан одним шрифтом, однако он
- может занимать несколько строчек на экране (если в нем есть
- символы перевода строки или задан параметр
- wrapLength). Один из символов текста может
- быть подчеркнут (в соответствии со значением параметра
- underline). В зависимости от значения параметра
- button кнопка имеет три разных вида; кнопка
- может выглядеть выпуклой, вдавленной или плоской, кроме того,
- она может мигать. При инициации кнопки (нажатием на клавишу 1
- "Мыши", когда курсор "Мыши" находится на
- кнопке) выполняется команда Tcl, указанная в параметре
- -command. Команда button создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид. Параметр и аргументы уточняют поведение команды.
- Примитивы кнопки допускают следующие формы команды: Возвращает текущее значение параметра конфигурации с именем
- параметр. Параметр может быть любым из параметров команды
- button. Запрашивает значения параметров конфигурации примитива или
- изменяет их. Если параметр не указан, то возвращает список,
- содержащий значения всех допустимых в имениПути
- параметров (формат списка описан в
- Tk_ConfigureInfo). Если параметр
- задан, а его новое значение - нет, то команда возвращает часть
- полного списка, относящуюся к указанному параметру. Если заданы
- одна или несколько пар параметр-значение, то указанным
- параметрам примитива присваиваются новые значения, а команда
- возвращает пустую строку. Параметр может быть любым из
- параметров команды button. Заставляет кнопку мигать. Этот эффект достигается путем
- многократного вывода изображения кнопки поочередно в активном и
- нормальном состоянии. По окончании работы команды кнопка
- остается в том же состоянии (активном или нормальном), что и
- перед началом ее выполнения. Если перед началом выполнения
- команды кнопка находится в состоянии disabled,
- то команда игнорируется. Выполняет команду Tcl, ассоциированную с кнопкой (при наличии
- такой команды). Возвращаемое значение совпадает с возвращаемым
- значением команды Tcl (или является пустой строкой, если с
- кнопкой никакой команды не ассоциировано). Если перед началом
- выполнения команды кнопка находится в состоянии
- disabled, то команда игнорируется. При создании кнопки Tk, в соответствии с типом кнопки,
- автоматически создает привязки к ней, определяющие ее поведение
- по умолчанию: Кнопка становится активной при появлении над ней курсора
- "Мыши" и дезактивируется, когда курсор ее покидает. В
- системе Windows привязка активизируется только при нажатии
- клавиши "1" "Мыши" на кнопке. При нажатии клавиши "1" "Мыши" на кнопке
- кнопка "вдавливается", а при отпускании клавиши она
- восстанавливает свой первоначальный вид. Если на кнопке клавиша "1" "Мыши" была
- нажата, а затем отпущена, то выполняется команда, привязанная к
- данной кнопке. Этого, однако, не происходит, если в момент
- отпускания клавиши "Мыши" курсор "Мыши"
- находился вне поля кнопки. Если кнопка находится в фокусе ввода, то нажатие на клавишу
- пробела приводит к выполнению команды, привязанной к этой
- кнопке. Если кнопка находится в состоянии disabled, то
- все описанные выше действия не приводят ни к какому результату:
- кнопка остается неактивной. Поведение кнопки можно изменить с помощью новых привязок к
- конкретным примитивам или путем переопределения привязок данного
- класса. Создание примитивов канвы и работа с ними. Подробное описание параметров приведено в разделе options. Задает значение с плавающей точкой, указывающее расстояние от
- курсора до объекта на экране, при котором курсор считается
- находящимся внутри объекта. По умолчанию имеет значение 1.0 Булевское значение, указывающее, допустимо ли устанавливать вид
- канвы вне области, заданной аргументом
- scrollRegion. По умолчанию имеет значение
- истина, т.е. такая установка запрещена. Задает желаемую высоту окна, которое примитив канвы должен
- запросить у своего графического менеджера. Значение может иметь
- любой вид из описанных ниже (см. "Координаты"). Задает список из четырех величин, описывающих координаты левой,
- верхней, правой и нижней границы прямоугольной области. Эта
- область используется для прокрутки и считается границей
- информации в канве. Каждая из координат может иметь любой вид из
- описанных ниже в (см. "Координаты"). Задает желаемую ширину окна, которое примитив канвы должен
- запросить у своего графического менеджера. Значение может иметь
- любой вид из описанных ниже (см. Координаты). Задает шаг горизонтальной прокрутки в любом из принятых видов
- для расстояний на экране. Если указанная величина положительна,
- то x-координата левой границы будет выбрана
- пропорциональной значению xScrollincrement с
- четным коэффициентом пропорциональности. Кроме того, шаг
- прокрутки (при нажатии на стрелки влево и вправо полосы
- прокрутки) также принимает значение
- xScrollincrement. Если значение параметра
- не положительно, то прокрутка выполняется без ограничений. Задает шаг вертикальной прокрутки в любом из принятых видов для
- расстояний на экране. Если указанная величина положительна, то
- y-координата верхней границы будет выбрана
- пропорциональной значению yScrollincrement с
- четным коэффициентом пропорциональности. Кроме того, шаг
- прокрутки (при нажатии на стрелки вверх и вниз полосы прокрутки)
- также принимает значение yScrollincrement. Если
- значение параметра не положительно, то прокрутка выполняется без
- ограничений. Команда canvas создает новое окно (заданное
- аргументом имяПути) и преобразует его в примитив
- канвы. С помощью описанных выше дополнительных аргументов в
- строке команды или в базе данных параметров можно задать такие
- характеристики канвы, как цвета или трехмерное
- представление. Команда canvas возвращает свой
- аргумент имяПути. В момент исполнения команды окно с
- именем имяПути должно отсутствовать, однако его
- родительское должно существовать.
-
- Примитивы канвы реализуют структурную графику. Канва изображает
- некоторый набор элементов, таких как прямоугольники,
- окружности, линии или текстовые элементы. Над элементами можно
- выполнять различные действия (например, передвигать или
- перекрашивать их), и к ним можно приписывать команды способом,
- аналогичным тому, как команда bind привязывает команды к
- примитивам. Можно, например, приписать некоторую команду
- событию <Button-1>, и эта команда будет
- выполняться всякий раз при нажатии кнопки 1 на данном
- элементе. Таким образом, поведение элементов канвы может
- определяться привязанным к ним скриптам Tcl. Элементы канвы упорядочены, так что при выводе на экран
- сначала выводится первый элемент, за ним второй и так
- далее. Очередные выводимые элементы заслоняют элементы, уже
- выведенные на экран; иногда про них говорят, что они выводятся
- поверх первых. При создании нового элемента он заносится на
- последнее место в списке, поверх всех элементов, созданных
- ранее. Порядок элементов в списке можно поменять с помощью
- команд примитивов. Элементы-окна представляют собой исключение из приведенного
- правила. Базовая система управления окнами предполагает, что
- новое окно всегда выводится поверх всех предыдущих. Кроме того,
- команды примитивов канвы не влияют на порядок в стеке окон;
- вместо них надо использовать команды Tk raise и lower. Есть два способа обращаться к элементам примитивов канвы по
- идентификатору и по тегу. У каждого элемента есть свой
- уникальный идентификационный номер, присваиваемый при создании
- элемента. Идентификатор элемента никогда не изменяется, и ни
- один идентификатор не используется дважды на протяжении
- существования данного примитива канвы. Кроме того, каждому элементу канвы можно приписать несколько
- тегов. Тег это просто строка символов, и он может быть
- иметь любой вид кроме числового. Например, "x123"
- годится, а "123" нет. Один и тот же тег можно
- приписывать нескольким элементам. Обычно это свойство
- используется для объединения элементов по характерным
- признакам. Например, всем выбранным элементам можно приписать
- тег "selected". Тег all приписан по умолчанию всем элементам
- канвы; с его помощью выполняются операции на всех элементах
- канвы. Тегом current автоматически управляет Tk. Он
- относится к текущему элементу, находящемуся поверх всех
- остальных из тех, чья область покрывает положение курсора. Если
- курсор .Мыши. расположен вне примитива канвы или если он не
- накрывается никаким элементом, то тег current
- не приписывается никакому элементу. При указании элемента в командах примитивов канвы реализован
- следующий подход: если описатель является числом, то это число
- интерпретируется как идентификатор элемента. В противном случае
- описатель относится ко всем элементам с таким
- тегом. Используемый ниже символ тегИлиИд указывает на
- то, что соответствующий аргумент может быть тегом, которому
- отвечает несколько (быть может, ни одного) элемента, или
- идентификатором, которому отвечает единственный
- элемент. Некоторые команды примитивов могут работать
- одновременно только с одним элементом; если символу
- тегИлиИд соответствует несколько элементов, то такая
- команда обычно обрабатывает первый (самый нижний) элемент списка
- вывода, к которому она применима. Исключения приведены ниже в
- описаниях команд примитивов. Все координаты канвы записываются в форме чисел с плавающей
- точкой. Координаты и расстояния на экране задаются в виде чисел
- с плавающей точкой, за которыми может следовать одна или
- несколько букв. Если буквы нет, то единицей измерения расстояния
- является пиксель. Буква m указывает на
- измерение расстояний в миллиметрах; буква c в
- сантиметрах; i в дюймах; p в
- точках принтера (1/72 дюйма). При перемещении по экрану вниз
- y-координата увеличивается; x-координата
- возрастает при перемещении по экрану вправо. Обычно начало системы координат канвы расположено в верхнем
- левом углу окна, содержащего канву. Положение начала координат
- относительно окна можно изменить с помощью команд
- xview и yview. Обычно этой
- возможностью пользуются при прокрутке. Канва не позволяет
- растягивать систему координат или поворачивать ее по отношению к
- системе координат окна. Отдельные элементы канвы можно сдвигать с помощью описываемых
- ниже команд примитивов; их можно также растянуть или сжать, но
- нельзя повернуть. Для указания на отдельные части текста в текстовых элементах
- поддерживаются индексы. Индексы используются в командах
- вставки текста, удаления части текста, установки курсора ввода.
- Индекс можно определить одним из нескольких возможных способов;
- различные типы элементов поддерживают индексы различных типов.
- Ниже приведено описание видов индексов; при введении новых типов
- текстовых элементов имеет смысл обеспечить поддержку разумного
- подмножества видов индекса. Отметим, что можно ссылаться на
- символ, следующий непосредственно за последним символом
- текстового элемента; эта возможность полезна, например, при
- вводе нового текста в конец элемента. Команда canvas создает новую команду Tcl с
- именем имяПути. С помощью этой новой команды можно
- выполнять различные операции над примитивами. Она имеет
- следующий общий вид: Параметр и аргументы уточняют поведение команды. В примитивах
- канвы могут встречаться следующие команды примитивов: Добавляет тег к списку тегов, связанному с
- каждым элементом, удовлетворяющим ограничениям, заданным
- спец_поиска и аргументами (если такого тега в
- списке еще нет). Если ни один элемент не удовлетворяет
- наложенным ограничениям, то команда не производит никаких
- действий. Результатом выполнения команды является пустая
- строка. Спец_поиска и аргументы могут принимать
- следующие значения: Эта команда привязывает ко всем элементам, заданным
- аргументом тегИлиИд, команду, которая выполняется
- всякий раз при наступлении события, описываемого
- последовательностью, на одном из этих элементов. Эта команда
- похожа на команду bind,
- за исключением того, что она действует на элементах канвы, а
- не на целых примитивах. Синтаксис последовательности и
- подстановки, выполняемые в команде перед ее выполнением,
- подробно описаны в bind. Если в команде
- заданы все аргументы, то создаваемая привязка замещает все
- предыдущие привязки для той же последовательности и
- тегИлиИд (если первый символ в команде +, то новая
- привязка присоединяется к уже существующим, а не замещает
- их). В этом случае команда возвращает пустую строку. Если
- аргумент команда опущен, то возвращается строка команды,
- связанной с тегИлиИд и последовательностью
- (если такой команды нет, то возникает ошибка). Если опущены
- оба аргумента команда и последовательность, то результатом
- выполнения служит список всех последовательностей, для
- которых определена привязка к тегИлиИд. Привязки можно задавать только для событий, связанных с
- клавиатурой или "Мышью" (таких как
- Enter, Leave,
- ButtonPress, Motion и
- KeyPress), а также для виртуальных событий.
- При работе с событиями в канве используется текущий элемент,
- определенный выше (см. "Идентификаторы и теги
- элементов"). События Enter и
- Leave наступают, когда элемент становится
- или перестает быть текущим; обратите внимание на отличие
- этих событий от событий Enter и
- Leave для окон. События, связанные с
- "Мышью", наступают только для текущего элемента
- (если таковой имеется; подробности см. ниже в описании
- команды примитива focus). При использовании в
- привязке виртуального события привязка может подключиться
- только, если в определении этого виртуального события
- участвует событие, связанное с "Мышью" или
- клавиатурой. Данному событию может соответствовать несколько привязок.
- Такое может произойти, например, если одна привязка
- осуществляется к идентификатору события, а другая к одному
- из его тегов. В подобном случае выполняются все привязанные
- события. Первым идет скрипт, привязанный к тегу
- all, затем поочередно выполняются скрипты,
- привязанные к каждому из тегов элемента (в порядке их
- следования), последней идет привязка к идентификатору
- элемента. Если несколько привязок соответствует одному тегу,
- то выполняется лишь самая конкретная из них. Команда continue в
- скрипте прекращает его выполнение, команда break
- прекращает выполнение скрипта и всех последующих скриптов
- для события, как и в случае команды bind. Если с помощью команды bind к окну канвы были
- выполнены дополнительные привязки, то они выполняются после
- привязок к элементам канвы, выполненных командой примитива
- bind. Устанавливает фокус клавиатуры для примитива канвы на
- элементе, заданном аргументом тегИлиИд. Если под
- описание подходят несколько элементов, то фокус
- устанавливается на тот из них, который идет первым в списке
- вывода из элементов, поддерживающих курсор ввода. Если под
- описание не подходит ни один из элементов или если ни один
- из подходящих элементов не поддерживает курсор ввода, то
- фокусировка не меняется. Если тегИлиИд представляет
- собой пустую строку, то ни один из элементов не оказывается
- в фокусе. Если аргумент тегИлиИд не задан, то
- команда возвращает идентификатор элемента, находящегося в
- фокусе или пустую строку, если такого элемента нет. После установки фокуса на элемент в этом элементе будет
- отображаться курсор ввода и все клавиатурные события будут
- направлены на этот элемент. Элемент фокусировки канвы и окно
- фокусировки на экране (установленное командой focus)
- совершенно независимы: элемент находится в фокусе ввода
- только если (а) его канва является окном фокусировки и (б)
- сам элемент является элементом фокусировки канвы. В
- большинстве случаев полезно вслед за командой focus примитива выполнять
- команду focus, чтобы
- установить фокус на канве (если такая установка еще не была
- произведена). Генерирует Postscript-представление для каждой канвы или для
- некоторых из них. Если параметр имеет вид
- -file, то Postscript-представление
- записывается в указанный файл, а команда возвращает пустую
- строку; в противном случае возвращается сгенерированное
- Postscript-представление. Если интерпретатор, владеющий
- канвой, помечен как безопасный, то операция закончится
- неудачно, так как безопасным интерпретаторам не разрешается
- записывать файлы. Если задан параметр
- -channel, то аргументом является имя канала,
- открытого на вывод. Postscript-представление записывает в этот
- канал; по окончании выполнения команды канал остается открытым
- для последующих операций вывода. Postscript-представление
- создается в форме Encapsulated Postscript в соответствии с
- соглашением Documentation Structuring Conventions,
- v. 3.0. Замечание: по умолчанию Postscript-представление
- создается только для информации, выводимой в окно канвы на
- экране. Только что созданная канва имеет размер 1x1 пиксель,
- поэтому в Postscript ничего выведено не будет. Чтобы
- преодолеть эту трудность, необходимо либо выполнить команду
- update и дождаться пока окно достигнет своего нормального
- размера, либо задать размеры канвы для печати параметрами
- -width и -height. Пары
- аргументов параметр-значения используются для
- дополнительного управления характеристиками печати. Команда
- поддерживает следующие параметры: Используется для запроса горизонтального положения
- информации, выведенной в окне канвы, и изменения этого
- положения. Команда может иметь одну из следующих форм: Используется для запроса вертикального положения
- информации, выведенной в окне канвы, и изменения этого положения.
- Команда может иметь одну из следующих форм: Ниже описываются различные типы элементов, поддерживаемые
- примитивами канвы. Каждый тип характеризуется, во-первых, формой
- команды create, посредством которой создаются
- элементы этого типа, и, во-вторых, набором параметров
- конфигурации элементов этого типа, которые можно использовать в
- командах примитива create и
- itemconfigure. Большинство типов не
- поддерживают выделение и индексирование и связанные с этими
- операциями команды, такие как index или
- insert. Для типов, поддерживающих указанные
- возможности, они описаны явно (пока речь идет только о текстовых
- элементах). Элементы типа arc выводятся на экран в виде
- отрезка дуги. Дуга представляет собой отрезок овала,
- заключенный между двумя радиусами (заданными параметрами
- -start и -extent); она
- изображается на экране в одном из нескольких возможных видов в
- зависимости от значения параметра -style. Дуги
- создаются командами примитива. Аргументы x1 y1 x2 y2 задают координаты
- противоположных углов прямоугольной области, в которую вписан
- овал. За координатами следует несколько пар
- параметр-значение, каждая из которых устанавливает
- значение одного из параметров конфигурации элемента. Такие же
- пары параметр-значение используются командами
- примитива itemconfigure для изменения
- параметров конфигурации. Команда поддерживает следующие
- параметры: Элементы типа bitmap изображаются на экране с
- помощью двух цветов: цвета фона и цвета переднего плана,
- Двуцветные изображения создаются командой примитива Аргументы x и y задают координаты опорной
- точки двуцветного изображения на экране (подробнее процедура
- размещения изображения описана ниже при описании параметра
- -anchor). За координатами следует несколько
- пар параметр-значение, каждая из которых
- устанавливает значение одного из параметров конфигурации
- элемента. Такие же пары параметр-значение
- используются для изменения значений параметров с помощью
- команды примитива itemconfigure. Для
- двуцветных изображений допустимы следующие параметры: Элементы типа line выводятся на экран в виде
- прямо- или криволинейной ломаной. Линии создаются командой
- примитива Аргументы от x1 до yn задают координаты
- последовательности из двух или более точек, соединенных
- отрезками. За координатами может следовать произвольный набор
- пар параметр-значение, каждая из которых
- устанавливает значение одного из параметров элемента. С
- помощью тех же пар параметр-значения можно задать
- новые значения параметров командами примитива
- itemconfigure. Команда поддерживает
- следующие параметры: Элементы типа oval появляются на экране в виде
- овальных или круглых областей. Каждый овал может быть
- закрашенным и иметь контур. Овалы создаются командой примитива Аргументы x1, y1, x2 и
- y2 задают координаты двух диагонально противоположных
- углов прямоугольника, заключающего овал. Овал включает в себя
- верхнюю и левую стороны прямоугольника, но не его нижнюю и
- правую сторону. Если прямоугольник представляет собой квадрат,
- то овал будет кругом, в противном случае он вытянут в одном из
- направлений. За координатами может следовать произвольный
- набор пар параметр-значение, каждая пара
- устанавливает значение одного из параметров. Такие же пары
- используются командами примитива
- itemconfigure для изменения конфигурации
- элемента. Команда поддерживает следующие параметры: Элементы типа polygon выводятся на экран в
- виде закрашенных многоугольных (возможно, криволинейных)
- областей. Многоугольники задаются командами примитива Аргументы с x1 до yn задают координаты не
- менее чем трех точек, определяющих замкнутый
- многоугольник. Первая и последняя точки могут совпадать; вне
- зависимости от того, так это или нет, Tk изображает замкнутый
- многоугольник. За координатами может следовать несколько пар
- параметр-значение, каждая из которых устанавливает
- один из параметров конфигурации элемента. Те же пары
- параметр-значение могут быть использованы в команде
- примитива itemconfigure для изменения
- конфигурации элемента. Команда поддерживает следующие
- параметры: Многоугольные элементы отличаются от других прямоугольников,
- овалов и дуг в том отношении, что их внутренние точки считаются
- находящимися "внутри" многоугольника (например, в
- смысле команд примитива find closest и
- find overlapping), даже если он и не
- закрашен. Для большинства остальных типов элементов внутренние
- точки считаются находящимися внутри элемента, только если
- элемент закрашен или если он не закрашен и не имеет контура.
- Если Вам нужен незакрашенный многоугольник, внутренние точки
- которого не считаются находящимися внутри него, то пользуйтесь
- вместо этого элементом line. Элементы типа rectangle появляются на экране в
- виде прямоугольных областей. Каждый прямоугольник может быть
- закрашенным и иметь контур. Прямоугольники создаются командой
- примитива Аргументы x1, y1, x2 и y2 задают
- координаты двух диагонально противоположных углов
- прямоугольника (верхняя и левая стороны прямоугольника входят
- в него, а нижняя и правая сторона нет). За координатами может
- следовать произвольный набор пар параметр-значение,
- каждая пара устанавливает значение одного из параметров. Такие
- же пары используются командами примитива
- itemconfigure для изменения конфигурации
- элемента. Команда поддерживает следующие параметры: Текстовый элемент предназначен для вывода на экран строки
- символов в одну или несколько строчек. Текстовые элементы
- поддерживают индексы и выделение, и на них могут быть выполнены
- команды примитива канвы dchars,
- focus, icursor,
- index, insert,
- select. Текстовые элементы создаются командой
- примитива Аргументы x и y задают координаты точки,
- используемой для размещения текста на экране (подробнее
- размещение текста описано ниже при описании параметров). За
- координатами могут следовать несколько пар
- параметр-значение, каждая из которых устанавливает
- значение одного из параметров конфигурации элемента. Такие же
- пары используются командами примитива
- itemconfigure для изменения конфигурации
- элемента. Команда поддерживает следующие параметры: Элементы типа window предназначены для вывода
- окна в указанное положение на канве. Окна создаются командой Аргументы x и y задают координаты точки,
- используемой для размещения окна на экране (подробнее
- размещение текста описано ниже при описании параметра
- -anchor). За координатами могут следовать
- несколько пар параметр-значение, каждая из которых
- устанавливает значение одного из параметров конфигурации
- элемента. Такие же наборы параметр-значение
- используются для изменения значений параметров с помощью
- команды примитива itemconfigure. Окна
- поддерживают следующие параметры: Замечание. Ограничения на управление окнами не
- позволяют выводить графические элементы (такие, как кривые и
- двуцветные изображения) поверх окон. В конкретных приложениях можно определять новые типы элементов
- для примитивов канвы с помощью C кода. Описание этой возможности
- приведено в документации для Tk_CreateItem. В текущей реализации новая канва не имеет никакого поведения
- по умолчанию; для определения этого поведения необходимо явно
- выполнить команды Tcl. Создание примитива защелкивающейся кнопки и управление им. Подробное описание этих параметров приведено в разделе options. Ассоциирует с кнопкой команду Tk. Обычно команда выполняется
- при отпускании клавиши 1 "Мыши" на кнопке. Перед
- выполнением этой команды обновляется значение глобальной
- переменной (параметр -variable). Задает желаемую высоту кнопки. Если в кнопке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселях (т.е., в любом виде, приемлемом для
- Tk_GetPixels); высота текстовой кнопки задается числом
- строчек текста. Если параметр не задан, то высота кнопки
- вычисляется по ее содержимому. Указывает, следует ли выводить индикатор. Значение параметра
- должно быть булевским. Если значением является "ложь", то
- параметр relief игнорируется и примитив всегда
- изображается вдавленным, если он выделен, и выпуклым в противном
- случае. Задает значение, которое нужно сохранять в переменной кнопки
- всякий раз при прекращении выделения кнопки. По умолчанию
- сохраняемое значение равно 0. Задает значение, которое нужно сохранять в переменной кнопки всякий раз
- при выделении кнопки. По умолчанию сохраняемое значение равно 1. Задает цвет фона для изображения выделенной кнопки. Если параметр
- IndicatorOn имеет значение истина, то указанный цвет
- применяется для изображения индикатора. В системе Windows тот же цвет
- используется в качестве фона изображения индикатора вне зависимости от
- состояния выделения. Если значением параметра IndicatorOn
- является ложь, то указанный цвет используется в качестве фона для всего
- примитива, когда он выделен, вместо значений параметров
- background и activeBackground. Задает одно из трех состояний защелкивающейся кнопки:
- normal, active или
- disabled. В нормальном состоянии
- защелкивающаяся кнопка изображается с использованием значений
- параметров foreground и
- background. В активном состоянии
- защелкивающаяся кнопка обычно находится, если на ней расположен
- курсор. Защелкивающаяся кнопка в активном состоянии изображается
- с использованием значений параметров activeForeground и
- activeBackground. Отключенное состояние указывает на то,
- что кнопка должна быть нечувствительной: привязки по умолчанию
- не приводят к запуску примитива и нажатия на кнопку
- "Мыши" игнорируются. В этом состоянии изображение кнопки
- определяется значениями параметров disabledForeground и
- background. Задает имя глобальной переменной, в которой хранится информация
- о том, выделена или нет данная кнопка. По умолчанию совпадает с
- именем кнопки (т.е. с последним элементом имени пути окна
- кнопки). Задает желаемую ширину кнопки. Если в кнопке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселях (т.е., в любом виде, приемлемом для
- Tk_GetPixels); ширина текстовой кнопки задается числом
- символов. Если параметр не задан, то ширина кнопки вычисляется по
- ее содержимому. Команда checkbutton создает новое окно (задаваемое
- аргументом имяПути) и превращает его в примитив
- защелкивающейся кнопки. Детали изображения защелкивающейся
- кнопки, такие как ее цвета, шрифт, текст и объемный вид задаются
- с помощью описанных выше дополнительных параметров. Команда
- button возвращает аргумент имяПути. В момент
- выполнения этой команды не должно существовать окна с именем
- имяПути, но должен существовать его предок. Защелкивающаяся кнопка представляет собой примитив, в котором
- выводится текстовая строка, изображение или двуцветное
- изображение, а также квадратик, называемый индикатором.
- Весь выводимый текст должен быть записан одним шрифтом, однако
- он может занимать несколько строчек на экране (если в нем есть
- символы перевода строки или задан параметр wrapLength).
- Один из символов текста может быть подчеркнут (в соответствии со
- значением параметра underline). Защелкивающаяся кнопка
- обладает всеми характеристиками обычной кнопки, включая
- следующие: в зависимости от значения параметра button
- кнопка имеет три разных вида; кнопка может выглядеть выпуклой,
- вдавленной или плоской, кроме того, она может мигать. При
- инициации защелкивающейся кнопки (нажатием на клавишу 1 "Мыши",
- когда курсор "Мыши" находится на кнопке) выполняется команда
- Tcl, указанная в параметре -command. Кроме того, защелкивающиеся кнопки можно выделять. Если
- защелкивающаяся кнопка выделена, то индикатор обычно
- изображается как выделенный, а переменная Tcl, ассоциированная с
- данной кнопкой, имеет предписанное значение (обычно 1). В ОС
- Unix индикатор изображается вдавленным и имеет специальный
- цвет. В системе Windows вместо этого в индикаторе стоит
- галочка. Если защелкивающаяся кнопка не выделена, то индикатор
- имеет невыделенный вид, а ассоциированная переменная имеет
- другое значение (обычно 0). В ОС Unix такой индикатор
- изображается выпуклым и не имеет специального цвета. В системе
- Windows в невыделенном индикаторе отсутствует галочка. По
- умолчанию имя переменной, ассоциированной с защелкивающейся
- кнопкой, совпадает с именем, использующимся при создании самой
- кнопки. Имя переменной и записываемые в ней значения
- выделенная/невыделенная можно поменять с помощью параметров
- командной строки или в базе данных параметров. С помощью
- параметров конфигурации можно также поменять вид индикатора (или
- даже отменить саму необходимость его вывода). По умолчанию
- выделение защелкивающейся кнопки меняется при последовательных
- щелчках кнопки. Кроме того, каждая защелкивающаяся кнопка
- отслеживает значение своей глобальной переменной и изменяет свое
- состояние всякий раз при перемене этого значения с .выделенная.
- на невыделенная и обратно. Команда checkbutton создает новую команду Tcl с именем
- имяПути. С помощью этой команды можно выполнять различные
- операции над примитивом. Ее общий вид: Параметр и аргументы уточняют
- поведение команды. Примитивы защелкивающейся кнопки допускают
- следующие формы команды: При создании защелкивающейся кнопки Tk, в соответствии с типом
- кнопки, автоматически формирует параметры, определяющие ее
- поведение по умолчанию: Управление буфером временного хранения Tk. Команда обеспечивает Tcl интерфейс с буфером временного
- хранения Tk, в котором хранятся данные для последующего
- использования с помощью механизма выделения. Для копирования
- данных в буфер необходимо вызвать очистку буфера, а затем одну
- или несколько команд добавления данных в буфер. Полное
- обновление буфера достигается, если все добавления произведены
- до завершения события. Первый аргумент определяет формат
- последующих аргументов и поведение команды. В настоящее время
- поддерживаются следующие формы команды: Добавляет данные к содержимому буфера окна в
- виде, заданном параметром тип, и представлении,
- заданном параметром формат, а также заявляет права на
- буфер в окне. Параметр тип задает вид, в котором должно
- возвращаться выделение; его значение должно быть именем
- атома, например, STRING или FILE_NAME; детали описания см. в
- (1). Параметр тип по умолчанию имеет значение
- STRING. Аргумент формат задает представление, в котором
- выделение передается по запросу (см (1). второй столбец в
- Таблице 2); по умолчанию его значение STRING. В
- формате STRING выделение передается в виде строки
- 8-битовых символов ASCII. В формате ATOM данные
- разделяются на поля, отделенные друг от друга пробелами;
- каждое поле преобразуется в значение своего атома, а вместо
- имени атома передается его 32-битовое значение. Во всех
- других форматах данные делятся на поля,
- отделенные друг от друга пробелами, каждое поле
- преобразуется в 32-битовое целое число; затем массив целых
- чисел передается тому, кто запросил выделение. При этом
- передаваемые в буфер строки объединяются перед
- преобразованием, поэтому необходимо позаботиться заранее о
- соответствующем обрамлении их пробелами. Все добавки в
- буфер одного типа должны иметь одинаковый формат. Аргумент формат необходим исключительно для
- обеспечения совместимости пользователям буфера, не
- использующим Tk. При выводе результатов поиска в выделении
- CLIPBOARD с помощью инструментов Tk значение буфера
- переводится в строковый формат, поэтому значение аргумента
- формат не играет роли. С помощью аргумента указывается конец списка параметров:
- следующий за ним аргумент всегда интерпретируется как
- данные. Такая возможность полезна, например, если
- данные начинаются символом "-". Команда удаляет окна. Команда удаляет одно или несколько заданных аргументами
- window окон и всех их потомков. Окна удаляются в порядке
- перечисления, и если при удалении очередного окна произойдет
- ошибка, то команда прекращает работу без удаления оставшихся
- окон. Если удалить окно ., то будет разрушено все
- приложение. Создание примитива поля ввода текста и управление им. Подробное описание этих параметров приведено в options. Если этот параметр задан, то истинное содержимое поля не
- выводится на экране. Вместо этого каждый символ текста
- заменяется первым символом значения параметра
- -show, скажем *. Такая возможность полезна,
- например, при вводе в поле пароля. Если символы поля ввода были
- выделены и скопированы в другом месте, то выводиться будет
- скопированная информация, а не истинное содержимое поля
- ввода. Задает одно из двух состояний поля ввода:
- normal или
- disabled. Отключенное состояние указывает на
- то, что значение поля ввода нельзя изменить с помощью команд
- примитива. При этом курсор ввода в поле не отображается, даже
- если этот примитив оказался в фокусе ввода. Задает желаемую ширину окна поля ввода в виде целого
- числа. Если введенное значение не положительно, то ширина поля
- устанавливается такой, чтобы в него в точности помещался текст
- его текущего значения. Команда entry создает новое окно (задаваемое
- аргументом имяПути) и превращает его в примитив поля
- ввода. Детали изображения кнопки, такие как ее цвета, шрифт и
- объемный вид, задаются с помощью описанных выше дополнительных
- параметров. Команда entry возвращает аргумент
- имяПути. В момент выполнения этой команды не должно
- существовать окна с именем имяПути, но должно
- существовать его родительское окно. Поле ввода представляет собой примитив, предназначенный для
- вывода одной строки текста и редактирования ее с помощью
- описываемых ниже команд примитива, которые по большей части
- сводятся к нажатию клавиш на клавиатуре и действиям с
- "Мышью". При создании поля ввода его строка текста
- пуста. Часть содержимого поля можно выделить, совершив действия,
- описываемые ниже. Экспорт выделенного текста (см. описание
- параметра exportSelection) осуществляется по
- стандартному протоколу X11 для выделений; выделения в поле ввода
- имеют тип STRING. Поля ввода также подчиняются
- стандартным правилам Tk обращения с фокусом ввода. Когда поле
- ввода находится в фокусе ввода, в нем изображается курсор
- ввода , который указывает, где будут вставляться вводимые
- символы. Поля ввода могут работать и с длинными строками, которые не
- помещаются полностью в окне примитива. С помощью описываемых
- ниже команд содержимое окна можно изменить. Поля ввода
- взаимодействуют с полосами прокрутки с помощью стандартного
- механизма xScrollCommand (подробно механизм
- взаимодействия описан при описании параметра
- xScrollCommand). Кроме того, они обеспечивают
- возможность сканирования (см. описание ниже). Команда entry создает новую команду Tcl с именем
- имяПути. С помощью этой команды можно выполнять различные
- операции над примитивом. Ее общий вид Параметр и аргументы уточняют поведение
- команды. Аргументами многих команд примитива поля ввода служат
- индексы. Индекс задает положение конкретного символа в строке
- поля ввода. Он может иметь один из следующих видов:
-
- Вместо любой из указанных форм можно использовать ее
- сокращение, например, "e" или
- "sel.f". Как правило, значения
- индексов, выходящие за пределы допустимых, заменяются ближайшими
- допустимыми значениями. Примитивы поля ввода допускают следующие команды: Осуществляет сканирование поля ввода. В зависимости от
- значения параметра может иметь две различные формы: Производит размещение выделения в поле ввода. Команда может
- иметь одну из описанных ниже форм. Используется для запроса горизонтального положения
- информации, выведенной в поле ввода, и изменения этого
- положения. Команда может иметь одну из следующих форм: При создании поля ввода Tk автоматически создает привязки
- класса, определяющие поведение примитива по умолчанию. В
- приводимом ниже описании .слово. есть произвольная непрерывная
- группа букв, цифр и символов "_" или любой другой
- одиночный символ.
-
- Щелчок клавишей 1 "Мыши" устанавливает курсор ввода
- непосредственно перед символом, расположенным под курсором
- "Мыши", устанавливает фокус ввода на данном примитиве
- и отменяет выделение в нем. Перетаскивание курсора "Мыши" приводит к выделению
- символов между курсором ввода и конечным положением курсора
- "Мыши". Двойной щелчок клавишей 1
- "Мыши" приводит к выделению слова под курсором
- "Мыши" и устанавливает курсор ввода перед первым
- символом этого слова. Перетаскивание "Мыши" после
- двойного щелчка приводит к выделению группы, состоящей из целых
- слов. Тройной щелчок клавишей 1 "Мыши" приводит к выделению
- всего текста в поле ввода и устанавливает курсор ввода перед
- первым символом текста. Края выделения можно выровнять, если тащить .Мышь. с нажатой
- клавишей 1 при нажатой клавише Shift; в этом
- случае выравнивается край, ближайший к положению курсора
- "Мыши" в момент нажатия ее клавиши 1. Если по кнопке
- щелкнули дважды перед тем, как тащить "Мышь", то
- выделение выравнивается относительно концов полных слов. Щелчок по клавише 1 "Мыши" при нажатой клавише
- Control приводит к установке курсора ввода в поле ввода без
- изменения текущего выделения. Обычные печатные символы вводятся в месте расположения курсора
- ввода. Содержимое поле ввода можно перемещать с помощью клавиши 2
- "Мыши". Щелчок по клавише 2 "Мыши" и без ее
- перемещения приводит к копированию выделения в поле ввода в
- место расположения курсора "Мыши". Если тащить .Мышь. слева или справа от окна поля ввода по
- направлению от окна при нажатой клавише 1, то в окне
- автоматически появляется невидимый ранее текст (если в поле со
- стороны, где .Мышь. покинула окно, есть текст, невидимый в
- окне). Нажатие на клавиши Left или
- Right приводит к перемещению курсора ввода на
- один символ влево или вправо; при этом текущее выделение
- отменяется и устанавливается новая опорная точка выделения. Если
- нажатие на клавиши Left или
- Right происходит при нажатой клавише
- Shift, то курсор ввода перемещается и
- пройденный им символ добавляется к выделению. Нажатие на клавиши
- Control-Left и Control-Right
- приводит к перемещению курсора ввода на полное слово, сочетания
- Control-Shift-Left и
- Control-Shift-Right еще и расширяют
- выделение. Сочетания Control-b и
- Control-f играют ту же роль, что и
- Left и Right, а сочетания
- Meta-b и Meta-f соответственно
- ту же роль, что и Control-Shift-Left и
- Control-Shift-Right. Нажатие на клавишу Home (или
- Control-a) приводит к перемещению курсора к
- началу текста с отменой существующих
- выделений. Shift-Home перемещает курсор к
- началу текста и доводит до этого места выделение. Нажатие на клавишу End (или
- Control-e) приводит к перемещению курсора в
- конец текста с отменой существующих
- выделений. Shift-End перемещает курсор в конец
- текста и доводит до этого места выделение. Нажатие на клавишу Select (или
- Control-Space) устанавливает опорную точку
- выделения в положение курсора ввода. Текущее выделение при этом
- не изменяется. Нажатие на клавиши t-Select (или
- Control-Shift-Space) доводит выделение до
- текущего положения курсора ввода (или устанавливает выделение
- между опорной точкой выделения и текущим положением курсора
- ввода, если текущее выделение отсутствовало). Control-/ выделяет весь текст в окне. {Control-\} приводит к отмене текущего
- выделения. Клавиша F16, на многих станциях Sun
- обозначенная py, (или
- Meta-w) копирует выделение в примитиве в
- карман. Клавиша F20, на многих станциях Sun
- обозначенная Cut, (или
- Control-w) копирует выделение в примитиве в
- карман и удаляет выделение. Если выделение в примитиве
- отсутствует, то нажатие на эти клавиши не приводит ни к каким
- действиям. Клавиша F18, на многих станциях Sun
- обозначенная te, (или
- Control-y) копирует содержимое кармана в место
- расположения курсора ввода. Нажатие на клавишу Delete приводит к удалению
- выделения. Если выделение отсутствует, то удаляется символ,
- непосредственно примыкающий к курсору ввода справа. Нажатие на клавишу BackSpace (или
- Control-h) приводит к удалению выделения. Если
- выделение отсутствует, то удаляется символ, непосредственно
- примыкающий к курсору ввода слева. Control-d удаляет символ, непосредственно
- примыкающий к курсору ввода справа. Meta-d удаляет слово, непосредственно
- примыкающее к курсору ввода справа. Control-k удаляет все символы справа от
- курсора ввода. Если поле ввода отключено указанием значения
- disabled параметра -state, то
- в окне поля по-прежнему можно перемещать текст и производить
- выделение, однако курсор ввода в окне не появляется и
- редактирование текста невозможно. Определяя новые привязки к отдельным примитивам или
- переопределяя привязки класса, поведение полей ввода можно
- изменить. Определение виртуальных событий и генерация событий Команда event обеспечивает различные
- возможности работы с событиями, включая определение виртуальных
- событий и синтезирование событий. У команды есть несколько
- различных форм, которые задаются первым аргументом. В настоящее
- время поддерживаются следующие формы команды: Команда event generate поддерживает следующие
- параметры, которые соответствуют расширению % в
- скриптах привязки для команды bind. Параметр задает значение поля detail для
- события и может принимать следующие значения: Имеет смысл для событий Enter,
- Leave, FocusIn и
- FocusOut. Параметр соответствует
- подстановке %d для скриптов привязки. Параметр когда задает момент обработки события;
- должен принимать одно из следующих значений: Значением всякого параметра, не указанного при генерации
- события, становится 0, за исключением параметра
- serial, которому присваивается серийный номер
- очередного X события. Для обращения к привязке к виртуальному событию необходимо
- выполнение двух условий. Во-первых, это виртуальное событие
- должно быть определено командой event
- add. Во-вторых, к этому виртуальному событию должна
- быть создана привязка с помощью команды bind. Рассмотрим следующие определения виртуальных событий: В команде bind привязка к виртуальным событиям
- осуществляется так же, как и ко встроенным типам событий: Двойные угловые скобки показывают, что выполняется привязка к
- виртуальному событию. При нажатии клавиш
- Control-y или кнопки 2 .Мыши. или при
- синтезировании виртуального события
- <<Paste>> командой event
- generate будет выполнена привязка
- <<Paste>>. Если последовательность в виртуальном событии в точности
- совпадает с последовательностью в другом физическом событии, то
- преимуществом пользуется физическое событие. Рассмотрим
- следующий пример:
- event add <<Paste>> <Control-y> <Meta-Control-y>
- bind Entry <Control-y> {puts Control-y}
- bind Entry <<Paste>> {puts Paste}
-
- При нажатии на клавиши Control-y будет
- выполнена привязка <Control-y>, так как
- физическое событие считается более конкретным, чем виртуальное,
- а в остальном все одинаково. Однако при нажатии клавиш
- Meta-Control-y будет выполнена привязка
- <<Paste>>, так как модификатор
- Meta в физическом образце, связанном с
- виртуальной привязкой, более конкретен, чем последовательность
- <Control-y> для физического события. Привязки к виртуальному событию можно создавать и до
- определения самого события. На самом деле определение
- виртуального события не является необходимым, например, на
- платформах, где конкретное виртуальное событие может оказаться
- бессмысленным или не генерируемым. При изменении определения виртуального события в процессе
- выполнения все окна немедленно переключаются на новое
- определение. Если, в условиях предыдущего примера, выполнить
- команды то поведение события изменится в двух направлениях. Во-первых,
- всплывет подавленная привязка
- <<Paste>>. Нажатие на клавиши
- Control-y приведет теперь не к выполнению
- привязки <Control-y>, а к выполнению
- виртуального события <<Paste>>.
- Во-вторых, нажатие на клавишу F6 также приведет
- к выполнению привязки <<Paste>>.
-
- Если последовательность не связана с данным
- виртуальным событием в текущий момент, то она
- игнорируется. Если аргумент последовательность
- отсутствует, то из списка удаляются все последовательности
- физических событий и данное виртуальное событие не
- может быть более осуществлено. Генерирует событие в окне и обеспечивает его обработку таким
- образом, как если бы оно поступило из менеджера окон. Аргумент
- окно задает имя пути окна, в котором будет
- генерироваться событие; его значением может быть и идентификатор
- окна (такой же, какой служит результатом команды winfo
- id), если он относится к окну в текущем
- приложении. Аргумент событие задает описание события,
- например, в виде <Shift-Button-2> или
- <<Paste>>. Аргумент
- событие может принимать любое значение, допустимое для
- аргумента последовательность команды
- bind, за исключением того, что он должен
- состоять из одного, а не из нескольких событий. Пары
- параметр-значение можно использовать для установки
- значений дополнительных параметров события, например, координат
- курсора "Мыши" ниже (см. "ПОЛЯ СОБЫТИЯ"). Если
- параметр -when не задан, то событие
- обрабатывается немедленно; все программы обработки события будут
- выполнены до завершения команды event
- generate. В противном случае момент обработки
- определяется значением параметра -when.
-
- Возвращает информацию о виртуальных событиях. Если аргумент
- <<виртуальное>>
- опущен, то возвращается список всех виртуальных событий,
- определенных в текущий момент. Если аргумент
- <<виртуальное>>
- задан, то возвращаемое значение представляет собой список,
- элементы которого являются последовательностями физических
- событий, связанными с данным виртуальным событием; если
- указанное виртуальное событие не определено, то команда
- возвращает пустую строку. Управление фокусом ввода. Команда focus используется для управления
- фокусом ввода Tk. В любой момент времени одно из окон на каждом
- экране находится в фокусе ввода; всякое событие нажатия или
- отпускания клавиши интерпретируются в этом окне. Обычно
- переключение фокуса между окнами верхнего уровня на экране
- осуществляется менеджером окон. Например, некоторые менеджеры
- окон автоматически переключают фокус на окно верхнего уровня,
- как только на него попадает курсор Мыши; другие устанавливают
- фокус только при щелчке на окне. Обычно менеджер окон
- устанавливает фокус только на окнах верхнего уровня, а
- переключением фокуса между подчиненными окнами занимается
- конкретное приложение. Для каждого верхнего уровня Tk запоминает одно окно в фокусе
- (последнего наследника данного верхнего уровня, в которое попал
- фокус); когда менеджер окон переключает фокус на данный верхний
- уровень, Tk автоматически устанавливает его на запомненное
- окно. Внутри конкретного верхнего уровня Tk использует явное
- моделирование фокуса по умолчанию. Обычно перемещение курсора
- "Мыши" без изменения верхнего уровня не приводит к переключению
- фокуса; переключение происходит, лишь если его запросил примитив
- (например, в результате щелчка по кнопке "Мыши" ) или если
- пользователь нажал, например, клавишу Tab.
- Неявная модель фокусировки создается процедурой Tcl
- tk_focusFollowsMouse; она меняет параметры конфигурации
- Tk таким образом, чтобы фокус устанавливался на окно при
- попадании на него курсора "Мыши".Процедуры
- Tcl tk_focusNext и
- tk_focusPrev устанавливают порядок переключения фокуса
- между окнами верхнего уровня. Эти процедуры определяют, помимо
- прочего, привязки по умолчанию к клавишам Tab и
- Shift-Tab. Команда focus может принимать одну из
- следующих форм: При получении фокуса ввода внутренним окном Tk фактически не
- устанавливает X фокус на это окно. X ведет себя таким образом,
- что фокус сохранится на окне верхнего уровня, которому
- подчиняется окно с фокусом. Однако Tk создает события FocusIn и
- FocusOut в точности, как если бы X фокус был на внутреннем
- окне. Такой подход порождает ряд трудностей при фактическом
- переключении X фокуса; то, что X фокус установлен на данный
- верхний уровень, незаметно, если не запрашивать X сервер
- непосредственно из C программы.
- Создание шрифтов и контроль за ними. Команда font обеспечивает работу со шрифтами:
- определение поименованных шрифтов и запрос фактических
- параметров шрифтов. У команды несколько различных форм, которые
- задаются первым аргументом. В настоящее время поддерживаются
- следующие формы команды: В качестве описателя шрифта в любой из приведенных выше команд
- принимаются следующие данные; те же самые форматы допустимы и в
- качестве значения параметра -font в описателе
- примитива. Имя шрифта для Unix-машин, представленное в виде: -заливка-семейство-шрифт-наклон-устширина-добстиль-пиксель-точка-разрешx-разрешy-промежуток-ширина-наборсимволов-кодирование -foundry-family-weight-slant-setwidth-addstyle-pixel-point-resx-resy-spacing-width-charset-encoding. Поля, содержимое которых пользователю безразлично, можно
- пропустить, заменив символом " * ". Каждому
- пропущенному полю должен соответствовать ровно один символ
- " * ", а символ " * " в конце XLFD
- приводит к пропуску всех оставшихся полей; кратчайшая форма
- имеет вид просто " * ", что означает, что значения
- всех полей берутся по умолчанию. Всем пропущенным полям
- присваиваются значения по умолчанию. В целях совместимости
- XLFD всегда выбирает шрифт заданного размера в пикселах (а
- не в точках). Несмотря на некоторую некорректность
- выбранного подхода, все приложения, использующие XLFD,
- предполагают, что "точка" в действительности
- совпадает с одним пикселем, и при использовании корректного
- размера шрифта могут привести к неправильному выводу шрифта
- (обычно с более крупными символами). Команда font metrics использует следующие
- параметры для запроса данных, определяемых при создании
- шрифта. Это характеристики шрифта в целом, а не отдельных его
- символов. В нижеследующих определениях "основа шрифта"
- это горизонтальная прямая, на которой располагается нижняя часть
- большинства букв, некоторые буквы, например, " g "
- опускаются ниже основы. Следующие параметры поддерживаются на всех платформах и
- используются для конструирования поименованного шрифта или при
- задании шрифта с помощью стиля [5] выше: Различные платформы поддерживают следующие поименованные
- системные шрифты: См. также options. Команда создает и управляет примитивами рамок (frames). Описание этих параметров приведено в разделе options. Этот параметр играет ту же роль, что и стандартный параметр
- background, однако его значение может быть и
- пустой строкой. В последнем случае в примитиве не выводится ни
- фон, ни бордюр (и никакие цвета из цветовой схемы примитива не
- задействованы на фон или бордюр). Параметр задает класс окна. Этот класс используется при запросе
- значений других параметров окна в базе параметров, а также для
- других целей (например, при задании привязок). Значение
- параметра class нельзя поменять с помощью
- команды примитива configure. Задает цветовую схему окна. Может либо принимать значение
- new (в этом случае для окна и его потомков
- создается новая цветовая схема), либо быть именем другого окна
- на том же экране с тем же именемПути (в этом случае
- новое окно берет цветовую схему указанного окна). Если параметр
- colormap не задан, то новое окно наследует
- цветовую схему своего предка. Значение параметра
- colormap нельзя поменять с помощью команды
- примитива configure. Значение параметра должно быть булевским. Если оно истинно, то
- окно предназначено для включения какого-то другого приложения
- (например приложение Tk верхнего уровня может быть включено с
- помощью параметра -use). В этом случае окно
- способно поддерживать соответствующие протоколы управления
- окнами (например, обеспечивать исполнение геометрических
- запросов). В данном приложении не должно быть собственных
- потомков окна. Значение параметра container
- нельзя поменять с помощью команды примитива
- configure. Задает визуальную информацию для нового окна в любой из форм,
- поддерживаемых Tk_GetVisual. Если параметр не
- задан, то окно будет использовать ту же визуальную информацию,
- что и его непосредственный предок. Значение параметра
- visual нельзя поменять с помощью команды
- примитива configure. Задает желаемую ширину окна в любой из форм,
- поддерживаемыхTk_GetPixels. Если значение
- параметра не положительно, то окно вообще не запрашивает
- места. Команда frame создает новое окно (заданное аргументом
- имяПути) и превращает его в примитив рамки. Детали
- изображения рамки, такие как ее цвет фона и объемный вид,
- задаются с помощью описанных выше дополнительных
- параметров. Команда frame возвращает имя пути нового окна. Рамка представляет собой простой примитив. Она предназначена в
- первую очередь для размещения внутри нее окон сложным
- образом. Единственными характеристиками рамки являются цвет ее
- фона и (необязательно) способ изображения трехмерного бордюра
- выпуклым или вдавленным. Команда frame создает новую команду Tcl с
- именем пути окна рамки. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид. ИмяПути это имя команды, совпадающее с именем пути
- примитива. Параметр и аргументы уточняют поведение
- команды. Примитивы кнопки допускают следующие формы команды: При создании новой рамки она не имеет привязок по умолчанию:
- рамки не предполагаются интерактивными. Направляет события, исходящие из клавиатуры и указателя
- "Мыши" в модальное окно и его поддерево. Команда реализует простые перехватчики событий ввода с
- клавиатуры и "Мыши". Перехватчики Tk отличаются от
- перехватчиков, описанных в документации Xlib. Когда для
- некоторого окна задан перехватчик, Tk ограничивает все события,
- исходящие от курсора, границами модального окна и его потомков в
- иерархии окон Tk. Если курсор находится в пределах поддерева
- модального окна, то курсор будет вести себя так, будто нет
- никакого перехватчика вообще. Если курсор находится вне
- поддерева модального окна, то события нажатия и освобождения
- кнопок "Мыши" будут передаваться в окно, а
- события входа в окно и выхода из окна будут
- игнорироваться. Поддерево окон перехватчика "владеет"
- курсором: прочие окна будут видны на экране, но будут
- нечувствительны к нажатиям кнопок "Мыши" до тех пор,
- пока не будет прекращен перехват. В поддерево модального окна
- могут входить окна верхнего уровня; в этом случае все эти окна
- верхнего уровня и их потомки обрабатывают события курсора
- "Мыши" при перехвате обычным образом. С помощью команды grab можно запустить или
- прекратить перехват для указанного окна и получить сведения об
- установленном для указанного окна перехватчике. Есть два типа перехватчиков: локальные и глобальные. Локальный
- перехватчик влияет только на перехватывающее приложение, остальные
- приложения ведут себя таким образом, как если бы никакого перехвата
- не было. По умолчанию перехватчики локальные. Глобальный
- перехватчик блокирует все приложения на экране; чувствительность к
- событиям указателя (нажатия и отпускания клавиши "Мыши",
- движения указателя, входы в окно и выходы из него) сохраняют только
- окна поддерева модального окна. При действии глобального
- перехватчика менеджер окон также нечувствителен к событиям
- указателя. При действии локальных перехватчиков события клавиатуры
- (нажатие и отпускание клавиш) передаются обычным образом:
- менеджер окон следит за тем, какое из приложений получает
- событие клавиатуры, и всякое такое событие, относящееся к
- перехватывающему приложению, перенаправляется в окно в
- фокусе. При действии глобального перехватчика Tk перенаправляет
- все события клавиатуры в перехватывающее приложение. Какое окно
- приложения получает событие клавиатуры, по-прежнему определяется
- командой focus. Перехват событий
- клавиатуры отменяется при прекращении действия перехватчика. Перехватчики применяются к конкретным дисплеям. Если у
- приложения есть окна на различных дисплеях, то оно может запустить
- отдельный перехватчик на каждом дисплее. Перехватчик на конкретном
- дисплее воздействует только на окно на этом дисплее. Несколько
- приложений могут запустить на одном дисплее локальные перехватчики,
- но глобальный перехватчик на дисплее может быть только один. Команда grab может иметь одну из следующих
- форм: Реализация описанного выше эффекта простого перехватчика
- оказалась чрезвычайно сложной и громоздкой. В текущей реализации
- прямое использование приложениями перехватчиков Xlib небезопасно;
- это нужно делать через процедуры Tk. Если несколько приложений Tk управляются одним процессом, то на
- данном дисплее только одно из этих приложений может иметь
- локального перехватчика в каждый конкретный момент. Этого
- ограничения нет для приложений, управляемых различными
- процессами. Геометрический менеджер, который размещает виджеты в ячейках
- сетки. Команда grid используется для управления
- соответствующим геометрическим менеджером, размещающим виджеты по
- ячейкам сетки, и для получения от него справочной информации.
- Команда может иметь перечисленные ниже формы в зависимости от
- значения аргумента option. Запрашивает или устанавливает свойства колонки для колонки
- сетки номер index. Допустимые опции
- -minsize, -weight и
- -pad. Если одна или более опций указаны,
- index может быть списком номеров колонок, для которых
- соответствующие значения опций должны быть установлены. Опция -minsize устанавливает минимальный
- размер колонки на экране. Опция -weight (допустимые значения целые
- числа) устанавливает относительный вес, используемый при
- распределении свободного пространства между
- колонками. Нулевой вес указывает, что колонка не будет
- расширяться. Колонка с весом 2 будет расти вдвое быстрее,
- чем колонка с весом 1. Опция -pad определяет размер полей,
- которые будут добавлены к размерам максимального окна в
- колонке при определении необходимой ширины колонки. Если в команде указана опция, а ее величина отсутствует,
- команда возвращает установленное значение данной опции. Если
- не указана ни одна опция, команда возвращает список опций и
- их значений в той же форме, в какой они задаются. Аргумент(ы) slave представляют собой имена
- виджетов, которые размещаются в ячейках сетки. За ними следуют
- пары аргументов, состоящие из имен опций и их значений,
- которые управляют размещением виджетов. Символы "-",
- "x" и "^" могут использоваться вместо имен
- виджетов, чтобы изменить их типовое размещение (детально
- правила использования этих символов описано ниже (см. "Относительное
- размещение"). Допустимые имена опций: Если какой-либо из виджетов, перечисленных в команде, уже
- размещен в сетке, а в команде для него указаны не все
- возможные опции, для остальных опций используются предыдущие
- значения, а не значения по умолчанию. Запрашивает или устанавливает свойства строки для строки
- сетки номер index. Допустимые опции
- -minsize, -weight и
- -pad. Если одна или более опций указаны,
- index может быть списком номеров строк, для которых
- соответствующие значения опций должны быть установлены. Опция -minsize устанавливает минимальный
- размер строки на экране. Опция -weight (допустимые значения целые
- числа) устанавливает относительный вес, используемый при
- распределении свободного пространства между
- строками. Нулевой вес указывает, что строка не будет
- расширяться. Строка с весом 2 будет расти вдвое быстрее, чем
- строка с весом 1. Опция -pad определяет размер полей,
- которые будут добавлены к размерам максимального окна в
- строке при определении необходимой ширины колонки. Если в команде указана опция, а ее величина отсутствует,
- команда возвращает установленное значение данной опции. Если
- не указана ни одна опция, команда возвращает список опций и
- их значений в той же форме, в какой они задаются. Команда grid содержит ограниченный набор
- возможностей для размещения виджетов без явного указания строк и
- колонок для каждого. Если номер строки или колонки не указан
- явно, он рассчитывается в момент размещения виджета исходя из
- текущего заполнения сетки, позиции виджета относительно других
- виджетов и наличия в команде специальных символов "-",
- "x" и "^" вместо имен виджетов. Геометрический менеджер grid размещает виджеты
- в окне в три шага. На первом шаге определяются минимальные
- размеры, необходимые для размещения всех виджетов и (если
- распространение размеров разрешено) формируется запрос на
- изменение размеров мастер-окна. На втором шаге необходимые
- размеры сравниваются с реальными размерами мастер-окна. Если они
- не совпадают, то размеры виджетов пересчитываются
- соответствующим образом. На третьем шаге каждый виджет
- размещается в своей колонке (колонках) и строке (строках) в
- соответствии со значением опции -sticky. Чтобы определить минимальные размеры, необходимые для колонок и
- строк, геометрический менеджер сначала рассматривает те виджеты,
- у которых значения обеих опций -columnspan и
- -rowspan равны "1", рассчитывает их
- размер и определяет минимальный размер колонок и строк как
- максимум из соответствующих размеров размещаемых в них виджетов
- (включая поля) и значения соответствующей опции
- -minsize. После этого рассматриваются виджеты
- со значением опции -columnspan или
- -rowspan больше единицы. Если отведенная группа
- колонок или строк мала для такого виджета, тогда дополнительный
- размер распределяется между членами группы пропорционально
- значениям их опций -weight. Если все члены
- группы имеют нулевой вес, они получают одинаковое приращение
- размеров. Для мастер окон, размер которых оказался больше необходимого,
- дополнительное пространство распределяется пропорционально весам
- колонок и строк соответственно. Если все веса нулевые, виджеты
- размещаются в центре мастер-окна. Если размер мастер-окна меньше
- необходимого, то размеры колонок и строк уменьшаются
- пропорционально их весам. Однако, если размер колонки или строки
- уменьшился до значения соответствующей опции
- -minsize, ее вес считается равным нулю. Если
- все строки или колонки уменьшены до размеров, равных значениям
- опций -minsize, и требуется дальнейшее
- уменьшение размеров, группа виджетов обрезается справа и
- снизу. Обычно менеджер рассчитывает размеры мастер-окна, необходимые
- для размещения виджетов, и, при необходимости, устанавливает
- размеры мастер окна таким образом, чтобы в нем в точности
- поместились все необходимые виджеты. Это приводит к тому, что
- информация о размерах виджетов распространяется по
- иерархическому дереву виджетов, в результате чего целое
- поддерево изменяет свои размеры при изменении одного из
- листьевых элементов. Однако, команда grid
- propagate может быть использована для отключения этого
- механизма для одного или нескольких мастер-окон. Если
- распространение размеров отключено, информация о необходимых
- размерах не передается мастер-окну. Это может оказаться
- полезным, если вы хотите, чтобы мастер-окно сохраняло те
- размеры, которые вы определили. Мастер-окно для каждого размещаемого виджета должно быть его
- непосредственным предком (по умолчанию) или одним из потомков
- его предка. Это ограничение гарантирует разумное поведение
- виджетов при удалении toplevel-окон. Если мастер-окно для виджета не является его непосредственным
- предком, необходимо быть уверенным, что виджет лежит в стеке
- окон выше, чем мастер-окно. В противном случае мастер-окно
- закроет собой виджет и создастся впечатление, что виджет не
- упакован правильным образом. Простейший способ избежать подобных
- проблем следить, чтобы мастер-окно было создано раньше, чем
- виджет: чем позже создано окно, тем выше оно в стеке. Если это
- почему-либо неудобно, можно использовать команды raise и lower для изменения
- порядка окон в стеке. Создание изображений и манипулирование ими. Команда image предназначена для создания и
- удаления изображений, а также для получения информации о них. В
- зависимости от значения параметра она может иметь различные
- формы. Допустимы следующие формы команды:
-
- Следующие типы изображений определены непосредственно в Tk они
- будут доступны в любом приложении. Отдельные приложения или
- расширения могут определять дополнительные типы. Команда создает и управляет примитивами ярлыков. Подробное описание этих параметров приведено в разделе oрtions. Задает желаемую высоту ярлыка. Если в ярлыке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселях (т.е., в любом виде, приемлемом для
- Tk_GetPixels); высота текстового ярлыка
- задается числом строчек текста. Если параметр не задан, то
- высота ярлыка вычисляется по его содержимому. Задает желаемую ширину ярлыка. Если в ярлыке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселях (т.е., в любом виде, приемлемом для
- Tk_GetPixels); ширина текстового ярлыка
- задается числом символов. Если параметр не задан, то ширина
- ярлыка вычисляется по его содержимому. Команда label создает новое окно (задаваемое
- аргументом имяПути) и превращает его в примитив
- ярлыка. Детали изображения ярлыка, такие как его цвета, шрифт,
- текст и исходный объемный вид задаются с помощью описанных выше
- дополнительных параметров. Команда label
- возвращает аргумент имяПути. В момент выполнения этой
- команды не должно существовать окна с именем имяПути,
- но должен существовать его предок. Ярлык представляет собой примитив, в котором выводится
- текстовая строка, изображение или двуцветное изображение. Весь
- выводимый текст должен быть записан одним шрифтом, однако он
- может занимать несколько строчек на экране (если в нем есть
- символы перевода строки или задан параметр
- wrapLength). Один из символов текста может быть
- подчеркнут (в соответствии со значением параметра
- underline). Есть несколько простых способов
- управления ярлыком (например, изменения его формы или
- редактирования текста в нем), они описаны ниже. Команда label создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид Параметр и аргументы уточняют поведение
- команды. Примитивы ярлыка допускают следующие формы команды: При создании нового ярлыка он не имеет привязок по умолчанию:
- ярлыки не предполагаются интерактивными. Команда создает и управляет примитивами окон со списками. Подробное описание этих параметров приведено в разделе options. Задает желаемую высоту окна (число строчек текста в нем). Если
- значение параметра неположительно, то высота окна выбирается
- таким образом, чтобы в нем помещались все элементы списка. Задает один из нескольких стилей управления выделением. Параметр может принимать произвольное значение, однако привязки по умолчанию предполагают, что его значение является одним из следующих: single, browse, multiple или listbox. По умолчанию параметр имеет значение browse. Задает желаемую ширину окна (число символов в строчке текста в
- нем). Если ширина символа в данном шрифте непостоянна, то для
- перевода числа символов в единицы экрана используется ширина
- символа "0". Если значение параметра неположительно, то ширина
- окна выбирается таким образом, чтобы в нем помещались все
- элементы списка. Команда listbox создает новое окно (задаваемое
- аргументом имяПути) и превращает его в примитив окна со
- списком. Детали изображения кнопки, такие как ее цвет, шрифт,
- текст и объемный вид, задаются с помощью описанных выше
- дополнительных параметров. Команда listbox
- возвращает аргумент имяПути. В момент выполнения этой
- команды не должно существовать окна с именем имяПути,
- но должен существовать его предок. Окно со списком представляет собой примитив, в котором
- выводятся строки элементы списка по одному на строчку окна. С
- помощью описываемых ниже команд примитива в список можно
- добавлять новые элементы или удалять элементы оттуда. Кроме
- того, можно выделить один или несколько элементов, как описано
- ниже. Экспорт выделенного текста (см. описание параметра
- exportSelection) осуществляется по стандартному
- протоколу X11 для выделений; выделения в поле ввода имеют тип
- STRING. Значение строки выделения составляется
- из выделенных элементов, разделенных символами перехода на новую
- строчку. Все элементы списка не обязательно выводятся в окне со списком
- одновременно. Содержимое окна можно поменять с помощью
- описываемых ниже команд. Окна со списком поддерживают прокрутку
- в обоих направлениях с помощью стандартных параметров
- xScrollCommand и
- yScrollCommand. Кроме того, возможно
- сканирование окон (см. описание ниже). Аргументами многих команд примитива окна со списком служат
- индексы. Индекс задает положение конкретного элемента в окне со
- списком. Он может иметь один из следующих видов: Аргументы с именами индекс, первый и
- последний в описываемых ниже командах примитива
- представляют собой индексы в одной из описанных выше форм. Команда listbox создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид Параметр и аргументы уточняют поведение
- команды. Примитивы окна со списком допускает следующие формы
- команды: Осуществляет сканирование окна со списком. В зависимости от
- значения параметра может иметь две различные формы: Производит размещение выделения в окне со
- списком. Команда может иметь одну из описанных ниже
- форм. Используется для запроса горизонтального положения
- информации, выведенной в окне примитива, и изменения этого
- положения. Команда может иметь одну из следующих форм: Используется для запроса вертикального положения
- информации, выведенной в окне примитива, и изменения этого
- положения. Команда может иметь одну из следующих форм: При создании окна со списком Tk автоматически создает параметры
- класса, определяющие его поведение по умолчанию. Поведение окна
- со списком в значительной степени определяется значением
- параметра selectMode, задающим один из четырех
- режимов работы с выделением. В режиме выделения single или
- browse допустимо выделение не более одного
- элемента. В обоих режимах щелчок клавишей 1 "Мыши" на
- элементе приводит к его выделению и отмене всех остальных
- выделений. В режиме browse выделенный элемент
- можно также перетащить с помощью клавиши 1 "Мыши". В режимах выделения multiple или extended можно одновременно
- выделить несколько элементов, не обязательно идущих в списке
- подряд. В режиме multiple щелчок клавиши 1 "Мыши" на
- элементе переключает состояние его выделенности, не влияя на
- выделение остальных элементов. В режиме extended нажатие клавиши
- на элементе выделяет его, отменяет выделение всех остальных
- элементов и устанавливает опорную точку выделения на элемент под
- курсором "Мыши"; если при этом тащить "Мышь"
- с нажатой клавишей 1, то выделение
- распространится на все элементы между опорным и элементом,
- находящимся под сдвинувшимся курсором "Мыши". В большинстве случаев для одиночных выделений используется режим browse, а для кратных режим extended; остальные режимы оказываются полезными в некоторых особых ситуациях. Помимо описанного выше поведения привязки по умолчанию задают следующие дополнительные характеристики поведения примитива: В режиме extended выделенную область можно
- изменить нажатием клавиши 1 при нажатой клавише
- Shift; при этом выделенной становится вся
- область между опорной точкой и элементом под курсором
- "Мыши". В режиме extended нажатие клавиши 1 при
- нажатой клавише Control начинает выполнение
- операции переключения: опорная точка устанавливается на элемент
- под курсором "Мыши", а состояние его выделения
- меняется на противоположное. Выделение остальных элементов не
- изменяется. Если тащить "Мышь" с нажатой клавишей 1,
- то состояние выделения всех элементов между опорной точкой и
- курсором "Мыши" меняется на состояние выделения
- опорного элемента; выделение остальных элементов не
- изменяется. Если "Мышь" сдвигается с окна со списком при нажатой
- клавише 1, то информация в окне прокручивается в противоположном
- направлении. Прокрутка продолжается до тех пор, пока либо
- "Мышь" не вернется в область окна, либо будет
- достигнут конец списка. Для прокрутки можно использовать клавишу 2
- "Мыши". Если ее нажать и протащить "Мышь" по
- списку, то содержимое списка будет прокручиваться в направлении
- движения "Мыши". При нажатии на клавиши Up или
- Down курсор окна (активный элемент)
- передвигается на одну строчку вверх или вниз. В режиме
- browse или extended новый
- активный элемент оказывается выделенным, а выделение всех
- остальных элементов отменяется. В режиме
- extended новый активный элемент становится
- опорной точкой выделения. В режиме extended клавиши
- Shift-Up и Shift-Down
- передвигают курсор окна на одну строчку вверх или вниз и
- расширяют область выделения новым активным элементом подобно
- тому, как это делает клавиша 1 "Мыши". Нажатие на клавиши Left или
- Right приводит к перемещению курсора ввода на
- ширину символа 0 влево или вправо. Нажатие на клавиши Control-Left и
- Control-Right приводит к прокрутке списка на
- ширину окна, также, как и нажатие на клавиши
- Control-Prior и
- Control-Next. Нажатие
- на клавиши Prior и Next
- приводит к прокрутке списка на одну страницу (на высоту окна)
- вверх или вниз. Нажатие на клавиши Home и End
- прокручивает список горизонтально до его левого или правого края
- соответственно. Нажатие на клавиши Control-Home устанавливает
- курсор окна на первый элемент списка, выделяет этот элемент и
- отменяет выделение всех остальных элементов. Нажатие на клавиши Control-End устанавливает
- курсор окна на последний элемент списка, выделяет этот элемент и
- отменяет выделение всех остальных элементов. В режиме extended нажатие на клавиши
- Control-Shift-Home расширяет выделение до
- первого элемента в списке, а на клавиши
- Control-Shift-End до последнего элемента в
- списке. В режиме multiple нажатие на клавиши
- Control-Shift-Home устанавливает курсор окна на
- первый элемента в списке, а на клавиши
- Control-Shift-End на последний элемент в
- списке. Клавиши пробела и Select
- выделяют активный элемент (курсор окна), как если бы на этом
- элементе была нажата клавиша1 "Мыши". В режиме
- extended нажатие на клавиши
- Control-Shift-пробел и
- Shift-Select расширяет выделение до активного
- элемента, как если бы на этом элементе была нажата клавиша
- 1 "Мыши" при нажатой клавише
- Shift. В режиме extended нажатие на клавиши
- Escape отменяет самое последнее выделение и
- восстанавливает предыдущее состояние выделение всех элементов в
- области выделения. Control-/ выделяет все элементы окна. Control-\ приводит к отмене текущего
- выделения (за исключением режима browse, где
- эта команда не приводит ни к какому результату). Клавиша F16, на многих станциях Sun
- обозначенная Copy, (или
- Meta-w) копирует выделение в примитиве в
- карман. Определяя новые параметры для отдельных примитивов или
- переопределяя параметры класса, поведение окна со списком можно
- изменить. Команда изменяет положение окна в очереди стека. Команда lower перемещает окно window
- в очереди стека либо ниже всех окон, имеющих одинаковый с
- window уровень иерархии, либо после одного из них,
- заданного аргументом belowThis. Окна, оказавшиеся выше
- данного окна, заслоняют его. Создание примитива меню и управление им. Подробное описание этих параметров приведено в разделе options. Задает команду Tcl, которая должна выполняться при каждом
- выводе меню. Эта команда выполняется командой примитива
- post непосредственно перед выводом меню. В
- версии 8.0 операционной системы Macintosh и в Windows все
- команды системы меню выполняются перед выводом меню. Это
- объясняется ограничениями, накладываемыми конкретными системами
- управления меню данных платформ. Задает цвет индикатора при выделении входа меню,
- представляющего собой защелкивающуюся кнопку или
- переключатель. Принимает булевское значение, указывающее, должен ли вверху
- меню быть ключ отрыва. Если значение параметра истина, то ключ
- отрыва имеет номер ноль, а нумерация последующих входов в меню
- начинается с единицы. Если значение этого параметра не пустая строка, то оно задает
- команду, которая должна выполняться при каждом отрыве от меню. В
- действительности выполняемая команда состоит из указанной
- строки, за которой следуют имя меню и имя окна меню отрыва
- (отделенные от строки команды и друг от друга пробелами). Если,
- например, параметр имеет значение "a
- b" и в результате отрыва от меню
- .x.y должно быть создано новое меню
- .x.tearoff1, то будет выполнена команда
- ".a b .x.y .x.tearoff1". Строка значение параметра задает имя окна, создаваемого при
- отрыве от данного меню. Если значением параметра служит NULL, то
- именем окна станет либо имя кнопки меню, либо содержимое
- элемента каскада, из которого выполняется данное меню. Параметр может принимать одно из значений
- menubar, tearoff или
- normal; это значение устанавливается при
- создании меню. При изменении значения меняется строка,
- возвращаемая конфигурационной базой данных, однако это не
- оказывает влияния на поведение примитива меню. Это свойство
- используется механизмом клонирования и обычно не применяется за
- пределами библиотеки Tk. Команда menu создает новое окно (заданное
- аргументом имяПути) и превращает его в примитив
- меню. Детали изображения меню, такие как его цвета и шрифты,
- задаются с помощью описанных выше дополнительных параметров в
- командной строке или в базе данных параметров. Команда
- menu возвращает имя пути нового окна. В момент
- выполнения команды не должно быть окна с именем
- имяПути, однако его непосредственный предок должен
- существовать.
-
- Меню представляет собой примитив, предназначенный для вывода
- совокупности однострочных входов, разбитых на несколько колонок
- (быть может, одну). Входы бывают различных типов и имеют
- соответственно различные свойства. Входы различных типов могут
- содержаться в одном и том же меню. Вход меню (menu entry) совсем
- не то же самое, что примитив поля ввода (entry). Более того,
- вход меню не является отдельным примитивом все вместе они
- образуют примитив меню. При выводе вход меню может содержать до трех различных
- полей. Главное поле представляет собой метку входа; оно содержит
- строку текста, изображение или двуцветное изображение в
- зависимости от значения параметров входа
- -label, -bitmap и
- -image. Если для данного входа задан параметр
- -accelerator, то справа от метки появляется
- второе текстовое поле. Этот параметр обычно описывает
- совокупность клавиш, нажатие на которые приводит к тому же
- результату, что и выбор данного входа в меню. Третье поле
- представляет собой индикатор. Индикатор применяется
- только для защелкивающихся входов или переключателей. Он
- указывает, выделен или нет данный вход, и располагается слева от
- строки входа. При обычном использовании вход становится активным (при этом
- меняется вид строки), если на нем расположен курсор Мыши. Если
- клавишу .Мыши. в таком положении отпустить, то вход будет
- выполнен. Результат выполнения зависит от типа входа. Подробное
- описание результатов приведено ниже при описании конкретных
- типов входов. Входы могут быть отключены (disabled); изображение такого входа
- тускнеет. Привязки меню по умолчанию блокируют активизацию и
- выполнение команды для отключенного входа. Отключенный вход
- может быть снова подключен, после чего его вновь можно
- активизировать и выполнять соответствующую команду. При изменении активного входа в меню в нем происходит
- виртуальное событие
- <<MenuSelect>>. В результате из
- меню можно запросить активный вход и предпринять какие-либо
- действия (например, вывести соответствующую контекстно-зависимую
- подсказку). Наиболее распространенным типом входа в меню является командный
- вход, который ведет себя подобно примитиву кнопки. При запуске
- командного входа выполняется команда Tcl, заданная параметром
- -command. Разделитель представляет собой вход, предназначенный для вывода
- горизонтальной разделительной черты. Разделитель нельзя сделать
- активным или выполнить, никакого поведения разделителя,
- отличного от вывода черты не предусмотрено. Защелкивающийся вход ведет себя подобно защелкивающейся
- кнопке. При щелчке на таком входе происходит переключение из
- выделенного состояния в невыделенное и обратно. В выделенном
- состоянии в некоторую глобальную переменную (указанную
- параметром -variable) заносится значение,
- фиксированное параметром -onvalue; при отмене
- выделения в эту глобальную переменную заносится другое значение,
- фиксированное параметром -offvalue. Слева от
- метки защелкивающегося входа изображается
- квадратик-индикатор. Если вход выделен, то центральная часть
- индикатора окрашивается в цвет, указанный параметром
- -selectcolor для входа; в противном случае цвет
- индикатора совпадает с цветом фона меню. Если для данного входа
- задано значение параметра -command, то это
- значение интерпретируется как команда Tcl всякий раз при
- выделении входа. Вход-переключатель ведет себя подобно примитиву
- переключателя. Входы переключателя разбиты на группы, причем в
- каждой группе выделенным может оказаться только один вход. При
- выделении конкретного входа в некоторую глобальную переменную
- (указанную параметром -variable) заносится
- значение, фиксированное параметром -value. В
- результате этого действия автоматически отменяется предыдущее
- выделение в той же группе. Любое изменение значения переменной,
- связанной с входом, автоматически приводит к отмене
- существующего выделения. Разбиение входов-переключателей на
- группы задается значениями связанных с ними переменных: два
- входа с одинаковыми значениями переменной принадлежат одной
- группе. Слева от метки входа-переключателя изображается ромб
- индикатора. Если вход выделен, то центральная часть индикатора
- окрашивается в цвет, указанный параметром
- -selectcolor для входа; в противном случае цвет
- индикатора совпадает с цветом фона меню. Если для данного входа
- задано значение параметра -command, то это
- значение интерпретируется как команда Tcl всякий раз при
- выделении входа. Каскадному входу отвечает новое меню (заданное параметром
- -menu). Каскадные входы позволяют строить
- ниспадающие меню. Команда примитива postcascade
- позволяет изобразить ассоциированное меню непосредственно рядом
- с каскадным входом или удалить выведенное меню. Для обеспечения
- корректности переключения меню необходимо, чтобы меню,
- ассоциированное с входом, было непосредственным потомком того
- меню, элементом которого данный вход является. Каскадный вход выводит ассоциированное меню с помощью команды
- Tcl вида: Если для данного входа задано значение параметра
- -command, то это значение интерпретируется как
- команда Tcl всякий раз при выделении входа. В системе Windows
- данная возможность не поддерживается. Ключ отрыва появляется в верхней части меню, если параметр
- tearOff имеет значение истина. В отличие от
- входов других типов его нельзя создать командой примитива
- add или удалить командой примитива
- delete. При создании ключа отрыва он
- изображается в виде пунктирной горизонтальной черты в верхней
- части окна. Привязки по умолчанию создают при щелчке на ключе
- отрыва оторванную копию меню и всех подчиненных ему меню. Любое меню можно использовать в качестве полосы меню для окна
- верхнего уровня (синтаксис см. в описании команды
- toplevel ). В системе Macintosh каскадные
- элементы меню появляются в полосе меню в верхней части окна, как
- только соответствующее окно верхнего уровня оказывается поверх
- остальных окон. В системах Windows и Unix эти элементы меню
- изображаются в полосе меню в верхней части окна. Поведение меню
- определяется особенностями интерфейса каждой из платформ. Для
- каждого меню, используемого в качестве полосы меню, создается
- его копия (clone menu). Подробное описание приведено ниже (см.
- "Клоны"). Некоторые меню в полосе меню будут обрабатываться особым
- образом. В системе Macintosh обеспечен доступ к специальным меню
- Apple и Help. В каждом окне системы Windows обеспечен доступ к
- меню Windows System. В системе X Windows предоставляется
- специальное меню подсказки, выравненное вправо. Во всех случаях
- эти меню создаются посредством команды, имя которой состоит из
- имени команды меню в полосе меню, к которому приписывается имя
- специального меню. Так, для полосы меню с именем .menubar на
- Macintosh именами специальных меню будут
- .menubar.apple и
- .menubar.help; в Windows
- .menubar.system; в X Windows именем меню
- подсказки будет .menubar.help. Встречая меню Apple в системе Macintosh, Tk выводит его первые
- элементы на экран всякий раз, когда окно, содержащее полосу меню
- оказывается поверх остальных окон. Это меню является первым,
- которое видит пользователь, а его заголовком служит логотип
- Apple. После всех Tk-определенных элементов следует разделитель,
- за которым идут все элементы из папки пользователя Apple Menu
- Items. Так как используемая System процедура определения меню
- отлична от используемой в Tk и API системы не поддерживают всех
- возможностей меню Tk, в заголовке меню выводится только текст
- заголовка. Никаких дополнительных сведений, изображений,
- двуцветных изображений или цветов не выводится. Кроме того, ключ
- отрыва имеет вид "TearOff". Встречая меню Help в системе Macintosh, Tk добавляет содержимое
- этого меню к стандартному меню подсказки в правой части
- пользовательской полосы меню всякий раз, когда пользовательская
- полоса меню оказывается поверх остальных окон. Первые элементы
- меню берутся из Apple. Аналогично меню Apple возможности вывода
- элементов меню ограничены системой. Встречая меню System в системе Windows, Tk добавляет содержимое
- этого меню к системному меню, к которому привязана данная полоса
- меню. В этом меню имеется картинка, изображающая клавишу
- пробела; ее можно запустить с помощью "Мыши" или нажав
- клавиши Alt+Spacebar. Ограничения Windows API
- не позволяют вывести в системном меню различные шрифты, цвета,
- изображения или двуцветные изображения, а также ключи
- отрыва. Встречая меню Help в системе X Windows, Tk делает его последним
- в полосе меню и выравнивает по правому краю. При использовании меню в качестве полосы меню в окне верхнего
- уровня, а также при отрыве меню создается его копия. Копия сама
- является примитивом меню, но она непосредственный потомок
- исходного меню. Изменения конфигурации исходного меню
- распространяются и на копию. Кроме того, все каскады, на которые
- есть указатели, также копируются, что обеспечивает корректное
- переключение меню. Копии уничтожаются, если удаляется ключ
- отрыва или полоса меню, а также при уничтожении оригинала. Команда menu создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид: Параметр и аргументы уточняют поведение команды. Одним из аргументов многих команд примитива меню служит
- указатель входа в меню, над которым следует произвести данную
- операцию. Такие указатели называются индексами; они
- могут иметь один из следующих видов: Примитивы меню допускают следующие команды: Добавляет новый вход на верхушку меню. Аргумент
- тип задает вид нового входа; он может
- принимать значения cascade,
- checkbutton, command,
- radiobutton (эти значения допускают
- однозначные сокращения). Дополнительные аргументы могут
- задавать значения следующих параметров: Команда примитива add возвращает
- пустую строку. Привязки по умолчанию обеспечивают четыре различных способа
- использования меню: При создании меню Tk автоматически создает параметры класса,
- определяющие следующее поведение примитива по умолчанию: При попадании курсора "Мыши" в меню вход, на котором
- находится курсор, становится активным; при перемещении курсора
- по меню соответственно меняется и активный вход. Если курсор "Мыши" покидает меню, то все входы в нем
- деактивизируются за исключением случая, когда курсор
- перемещается в каскадное подменю. При отпускании клавиши "Мыши" на меню активный вход
- (если таковой имеется) исполняется. При этом меню стирается за
- исключением случая, когда это оторванное меню. Нажатие на клавиши Space или
- Return приводят к исполнению активного входа и
- стиранию меню. Если одна из букв в поле входа подчеркнута с помощью параметра
- -underline, то нажатие на эту букву (или ее
- эквивалент на верхнем или нижнем регистре) приводит к исполнению
- входа и стиранию меню. Нажатие на клавишу Escape приводит к отмене
- текущего выделения. Меню при этом стирается, если только это не
- оторванное меню. Нажатие на клавиши Up или
- Down приводит к активизации входа, примыкающего
- к текущему активному входу сверху или снизу. Если достигнут
- конец меню, то происходит перескок на противоположный его
- конец. Нажатие на клавишу Left приводит к переходу на
- соседнее слева меню. Если текущее меню представляет собой
- каскадное подменю, то это каскадное подменю стирается и текущим
- входом в меню становится каскадный вход в его непосредственном
- предке. Если текущее меню представляет собой меню верхнего
- уровня, выведенное кнопкой меню, то текущая кнопка меню
- стирается и выводится соседняя слева кнопка меню. В остальных
- случаях нажатие на эту клавишу не приводит ни к какому
- результату. Порядок кнопок меню слева направо определяется их
- порядком в стеке: Tk считает нижнюю кнопку меню (первой попавшую
- в стек) самой левой. Нажатие на клавишу Right приводит к переходу
- на соседнее справа меню. Если текущим является каскадный вход,
- то выводится соответствующее каскадное подменю и текущий вход
- становится первым в этом подменю. В противном случае, если
- текущее меню было выведено кнопкой меню, то текущая кнопка меню
- стирается, а вместо нее выводится соседняя с ней справа кнопка
- меню. Отключенные входы меню остаются безответными: их нельзя сделать
- активными и они не реагируют на нажатие и отпускание клавиш
- "Мыши". Определяя новые привязки к отдельным примитивам или
- переопределяя привязки класса, поведение меню можно
- изменить. В настоящее время использование базы данных параметров для
- задания значений параметров входов не допускается.
-A menubutton is a widget that displays a textual string, bitmap, or image
-and is associated with a menu widget.
-If text is displayed, it must all be in a single font, but it
-can occupy multiple lines on the screen (if it contains newlines
-or if wrapping occurs because of the wrapLength option) and
-one of the characters may optionally be underlined using the
-underline option. In normal usage, pressing
-mouse button 1 over the menubutton causes the associated menu to
-be posted just underneath the menubutton. If the mouse is moved over
-the menu before releasing the mouse button, the button release
-causes the underlying menu entry to be invoked. When the button
-is released, the menu is unposted.
-
-Menubuttons are typically organized into groups called menu bars
-that allow scanning:
-if the mouse button is pressed over one menubutton (causing it
-to post its menu) and the mouse is moved over another menubutton
-in the same menu bar without releasing the mouse button, then the
-menu of the first menubutton is unposted and the menu of the
-new menubutton is posted instead.
-
-There are several interactions between menubuttons and menus; see
-the menu manual entry for information on various menu configurations,
-such as pulldown menus and option menus.
-
-
-
-
-If the menubutton's state is disabled then none of the above
-actions occur: the menubutton is completely non-responsive.
-
-The behavior of menubuttons can be changed by defining new bindings for
-individual widgets or by redefining the class bindings.
-
-
-A menubutton is a widget that displays a textual string, bitmap, or image
-and is associated with a menu widget.
-If text is displayed, it must all be in a single font, but it
-can occupy multiple lines on the screen (if it contains newlines
-or if wrapping occurs because of the wrapLength option) and
-one of the characters may optionally be underlined using the
-underline option. In normal usage, pressing
-mouse button 1 over the menubutton causes the associated menu to
-be posted just underneath the menubutton. If the mouse is moved over
-the menu before releasing the mouse button, the button release
-causes the underlying menu entry to be invoked. When the button
-is released, the menu is unposted.
-
-Menubuttons are typically organized into groups called menu bars
-that allow scanning:
-if the mouse button is pressed over one menubutton (causing it
-to post its menu) and the mouse is moved over another menubutton
-in the same menu bar without releasing the mouse button, then the
-menu of the first menubutton is unposted and the menu of the
-new menubutton is posted instead.
-
-There are several interactions between menubuttons and menus; see
-the menu manual entry for information on various menu configurations,
-such as pulldown menus and option menus.
-
-
-
-
-If the menubutton's state is disabled then none of the above
-actions occur: the menubutton is completely non-responsive.
-
-The behavior of menubuttons can be changed by defining new bindings for
-individual widgets or by redefining the class bindings.
-
- Создание примитива сообщения и управление им. Подробное описание этих параметров приведено в разделе options. Целое число, указывающее желаемые пропорции текста. Его
- значение равно 100*ширина/высота. Значение "100" -
- означает, что ширина текста должна равняться его высоте,
- значение "200" - что текст должен быть вдвое шире по
- сравнению с высотой, значение "50" - что его высота
- должна быть вдвое больше ширины и т.д. Используется для
- определения длины строки, если не задан параметр width. Значение
- по умолчанию равно "150". Задает желаемую ширину окна (в любом виде, приемлемом для
- Tk_GetPixels). Если значение параметра
- положительно, то параметр aspect игнорируется,
- а параметр width задает длину строки. Если
- значение параметра неположительно, то длина строки определяется
- параметром aspect. Команда messageсозадает новое окно (задаваемое
- аргументом имяПути) и превращает его в примитив
- сообщения. Детали изображения сообщения, такие как его цвета,
- шрифт, текст и объемный вид задаются с помощью описанных выше
- дополнительных параметров. Команда message
- возвращает аргумент имяПути. В момент
- выполнения этой команды не должно существовать окна с именем
- имяПути, но должен существовать его предок. Сообщение представляет собой примитив, предназначенный для
- вывода строки текста. У примитива сообщения есть три специальных
- свойства. Во-первых, он разбивает строку сообщения на строчки,
- чтобы обеспечить заданные пропорции окна. Перевод строки
- осуществляется, по возможности, на границах слов (если в строку
- не помещается ни одного целого слова, то слово разбивается на
- несколько строк). Для переноса строки в нее вставляются символы
- перевода строки; их можно использовать, например, для вывода
- пустых строчек на экран. Вторым свойством примитива сообщения является возможность
- выравнивания. Строчки сообщения могут быть выровнены влево
- (каждая строка начинается от левого края окна), по центру или
- вправо (каждая строка кончается у правого края окна). Третье свойство примитива сообщения состоит в том, что он
- специальным образом обрабатывает управляющие символы и
- непечатные символы. Символы табуляции заменяются пробелами,
- число которых равно расстоянию до ближайшего кратного 8-ми
- символам. Символы перевода строки вызывают переход на новую
- строку. Другие управляющие символы (код ASCII которых меньше
- 0x20) и символы, не определенные в шрифте сообщения, выводятся в
- виде последовательности из четырех символов \xhh, где hh это две
- шестнадцатиричные цифры, представляющие собой ASCII код данного
- символа. В том редком случае, когда в шрифте отсутствуют
- некоторые из символов "0123456789abcdef\x" управляющие
- символы и неопределенные символы вообще не выводятся. Команда message создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид Параметр и аргументы уточняют поведение
- команды. Примитивы сообщения допускают следующие формы команды При создании сообщения параметры по умолчанию отсутствуют:
- сообщения предназначены только для вывода текста. Команда добавляет/получает параметры окон в/из базы данных
- параметров окон. Команда позволяет добавить в базу данных параметров окон новые
- значения, считать из нее значения указанных параметров, очистить
- базу или добавить в базу данные из указанного файла стандартного
- формата. Аргумент patternзадает конкретный параметр и
- состоит из имен параметров и/или классов. Аргумент
- value содержит значение параметра. Аргумент
- fileName задает файл со значениями
- параметров. Необязательный аргумент priority указывает
- уровень приоритета для ввода параметра. Приведено описание стандартных параметров примитивов. Здесь приводится описание всех стандартных параметров
- примитивов. Не все параметры используются примитивами, но если
- примитив использует некоторый параметр, то действие этого
- параметра будет именно таким, как оно описано. options стандартные параметры, поддерживаемые
- примитивами. В этом разделе руководства описываются общие параметры
- конфигурации, поддерживаемые примитивами (виджетами) языка
- Tk. Не каждый примитив поддерживает все параметры (список
- стандартных параметров примитива приведен в описании этого
- примитива), однако если примитив поддерживает параметр, имя
- которого приведено в нижеследующем списке, то результат его
- указания совпадает с описанным ниже. В приводимом ниже описании строка .Имя Параметра. указывает имя
- переключателя в командах класса и командах примитивов configure,
- предназначенных для установки значения параметра. Если,
- например, в строке. Имя параметра. указано имя
- -foreground и имеется примитив .a.b.c, то с
- помощью команды можно присвоить значение black параметру
- -foreground примитива .a.b.c.
- Для имен параметров можно использовать сокращения, сохраняющие
- однозначность интерпретации имени. В поле "Имя в
- Базе" приводится имя параметра в базе X-ресурсов (например, в
- файле .Xdefaults). В поле "Класс в Базе" приводится имя класса
- базы в файле X-ресурсов (например, в файле .Xdefaults). Задает цвет фона при изображении активных элементов. Элемент
- (примитив или его часть) активен, если на нем находится курсор
- "Мыши" и нажатие на клавишу "Мыши" вызывает
- некоторое действие. Если установлено значение переменной
- tk_strictMotif, то значение указанного
- параметра игнорируется и используется обычный цвет фона. Для
- некоторых элементов в системах Windows и Macintosh установленный
- цвет активизируется только при щелчке клавиши 1 на элементе. Задает неотрицательное значение ширины трехмерного бордюра,
- окружающего активные элементы. Определение активных элементов
- приведено выше. Значение может быть задано в любом
- виде,воспринимаемом командой Tk
- GetPixels. Обычно этот параметр доступен только для
- примитивов, отображающих более одного элемента одновременно
- (меню, а не кнопки). Задает цвет изображения активного элемента. Определение
- активных элементов приведено выше. Задает способ отображения информации (типа текст или bitmap) в
- примитиве. Должен принимать одно из значений
- n, ne, e,
- se, s,
- sw, w, nw
- или center, которые указывают на стороны
- света. Например, значение nw указывает на необходимость
- такого отображения информации, что ее левый верхний угол
- совпадает с левым верхним уровнем примитива. Задает нормальный цвет фона при отображении примитива. Задает информацию типа bitmap в любом виде,
- приемлемом для TkGetBitMap для отображения в
- примитиве. Другие параметры, вроде anchor и
- justify, уточняют способ отображения
- информации типа bitmap. Обычно при
- задании этого параметра значения остальных параметров,
- задающих способ отображения текстовой информации,
- игнорируются. Для восстановления возможности вывода текстовой
- информации в примитиве следует задать значение параметра
- bitmap в виде пустой строки. Задание параметра image подавляет параметр bitmap в примитивах,
- использующих оба эти параметра. Задает неотрицательное значение ширины трехмерного бордюра,
- окружающего изображение примитива (при выводе такого бордюра;
- необходимость его вывода обычно указывается параметром
- relief). То же значение может быть использовано
- при имитации трехмерной графики внутри примитива. Значение
- параметра может быть любым из тех, что приемлемы для
- TkGetPixels. Задает форму курсора .Мыши. на примитиве. Значение параметра
- должно быть одним из значений, которые перечислены в файле
- /usr/X11R6/unclude/X11/cursorfont.h, например,
- X_cursor, arrow,
- boat, clock,
- cross, то есть можно указывать любое значение
- их данного файла, в котором нужно опустить первые три символа
- XC_. Задает цвет переднего плана для изображения недоступного
- элемента. При вводе пустой строки (типичная ситуация для
- монохромного дисплея) недоступные элементы изображаются обычным
- цветом, однако их изображение делается более тусклым за счет
- штриховки. Указывает, должен ли выбранный элемент в примитиве входить
- также и в X-выборку. Значение параметра должно быть допустимым
- аргументом функции TclGetBoolean, скажем
- true, false,
- 0, 1, yes или
- no. При экспорте выбранного элемента выборка в
- примитиве отменяет текущую X-выборку; выборка за пределами
- примитива отменяет текущую выборку в примитиве. При наличии в
- примитиве выбранного элемента примитив отзывается на запросы
- поиска выбранных элементов. По умолчанию примитивы обычно
- экспортируют выбранные элементы. Задает шрифт для отображения текста внутри примитива. Синтаксис
- имени шрифта описан в команде font. Список доступных
- шрифтов можно получить командой xlsfonts. Задает нормальный цвет переднего плана примитива. Задает цвет яркого прямоугольника обрамляющего примитив,
- находящийся вне фокуса ввода. Задает цвет яркого прямоугольника обрамляющего примитив,
- находящийся в фокусе ввода. Задает неотрицательное значение ширины яркого прямоугольника
- вокруг примитива, находящегося в фокусе ввода. Значение
- параметра должно быть допустимым аргументом функции
- Tk_GetPixels. При значении, равном нулю, яркая
- рамочка вокруг примитива не выводится. Задает изображение, которое должно быть выведено в примитиве,
- созданном командой image
- create. Обычно при задании параметра image значения других
- параметров, задающих текстовые или bitmap данные для вывода
- в примитиве, подавляются. Для восстановления возможности вывода
- текстовых или bitmap данных следует задать пустое значение
- параметра image. Задает цвет фона поля, на котором установлен курсор ввода. Этот
- параметр подавляет цвет нормального фона примитива (или фона
- выбранного элемента, если курсор ввода оказался на выбранном
- элементе). Задает неотрицательное значение ширины трехмерного бордюра
- вокруг курсора ввода. Значение параметра должно быть допустимым
- аргументом функции Tk_GetPixels. Задает длину промежутка времени, в течение которого курсор
- ввода находится в режиме "off"
- (неотрицательное целое значение в миллисекундах) на протяжении
- одного цикла мигания. Если введенное значение равно нулю, то
- курсор не мигает: он всегда находится в режиме
- "on". Задает длину промежутка времени, в течение которого курсор
- ввода находится в режиме "on" (неотрицательное целое
- значение в миллисекундах) на протяжении одного цикла мигания. Задает полную ширину курсора ввода. Значение параметра должно
- быть допустимым аргументом функции
- Tk_GetPixels. Если (с помощью параметра
- insertBorderWidth) задана ширина бордюра, то
- бордюр будет располагаться внутри отведенной ширины курсора. Задает тип изменения значения примитива для примитивов,
- поддерживающих полосу прокрутки. Значение параметра должно быть
- допустимым булевским аргументом функции
- Tk_GetBoolean. При значении параметра
- false значения примитива изменяются
- непрерывно. При значении параметра true значение примитива не
- меняется до окончания движения бегунка и отпускания клавиши
- "Мыши". В этот момент происходит установка нового
- значения ("скачок", в отличие от непрерывного
- изменения). Описывает способ выравнивания текста, состоящего из нескольких
- строк, в окне примитива. Может принимать значения
- left, center или
- right. Leftозначает, что
- выравниваются левые концы строк, center их
- середины, right правые концы. Указывает ориентацию примитива, допускающего различные
- ориентации (так, полоса прокрутки может быть расположена
- горизонтально или вертикально). Может принимать значения
- horizontal или vertical, а
- также их сокращения. Неотрицательное значение, указывающее размер запрашиваемого
- дополнительного пространства для примитива в
- X-направлении. Значение параметра должно быть допустимым
- аргументом функции Tk_GetPixels. При подсчете
- необходимого размера окна эта величина добавляется к обычному
- размеру, определяемому суммированием всех размеров всех его
- деталей. Если программа вывода в состоянии удовлетворить
- выданный запрос, то в правой и/или левой части окна примитива
- появляется дополнительное пространство. В большинстве случаев
- это пространство используется только для расположения там
- текста; при выводе bitmap-данных или изображений оно
- игнорируется. Неотрицательное значение, указывающее размер запрашиваемого
- дополнительного пространства для примитива в
- Y-направлении. Значение параметра должно быть допустимым
- аргументом функции Tk_GetPixels. При подсчете
- необходимого размера окна эта величина добавляется к обычному
- размеру, определяемому суммированием всех размеров всех его
- деталей. Если программа вывода в состоянии удовлетворить
- выданный запрос, то в правой и/или левой части окна примитива
- появляется дополнительное пространство. В большинстве случаев
- это пространство используется только для расположения там
- текста; при выводе bitmap-данных или изображений оно
- игнорируется. Задает тип трехмерной графики в примитиве. Допустимы значения
- raised, sunken,
- flat, ridge,
- solid или groove. Значение
- указывает на способ размещения внутренней части окна по
- отношению к фону. Например, значение raised
- указывает, что внутренняя часть окна должна выступать из
- экрана. Указывает продолжительность нажатия на кнопку или клавишу (в
- миллисекундах), необходимую для установления режима
- автоматического повторения. Используется, например, при работе
- со стрелками полосы прокрутки. Используется в паре с repeatDelay: при
- установлении режима автоматического повторения этот параметр
- задает длину промежутка времени между автоматическими
- повторениями. Задает цвет фона при отображении выбранных элементов. Задает ширину трехмерного бордюра вокруг выбранных
- элементов. Допустимы любые значения, воспринимаемые командой
- Tk_GetPixels. Задает цвет переднего плана для изображения выбранных элементов. Задает булевское значение, определяющее, управляет ли данный
- примитив масштабирующей сеткой своего окна верхнего
- уровня. Обычно этот параметр используется в текстовых примитивах
- с естественным размером отображаемой информации (размером
- символа) и размеры окна осмысленно выбирать пропорциональными
- этому стандартному размеру. Эти разумные размеры окон образуют
- сетку. Если задано значение true параметра
- setGrid, то примитив установит связь с
- менеджером окон. В этом случае при интерактивном запросе
- пользователя на изменение размеров окна верхнего уровня,
- содержащего примитив, возможный список размеров окна будет
- передан пользователю в единицах сетки, и значения его длины и
- ширины должны быть пропорциональны сторонам ячейки сетки. Более
- подробно этот процесс описан ниже (см. "УПРАВЛЕНИЕ
- ГЕОМЕТРИЕЙ СЕТОК" в описании команды wm).
-
- Указывает, допустима ли установка фокуса на окне с помощью
- клавиатуры (клавишами Tab и
- Shift-Tab). Перед установкой фокуса на окне
- скрипты перевода фокуса проверяют значение параметра
- takeFocus. Значение "0" указывает на
- необходимость пропускать окно при клавиатурном переключении
- фокуса. Значение "1" указывает на то, что при видимом
- окне (и всех его наследниках) фокус должен устанавливаться на
- нем. Пустое значение указывает на то, что скрипт переключения
- сам принимает решение, следует ли устанавливать фокус на данном
- окне: в текущем варианте окно пропускается, если оно отключено
- или в нем нет ключевых связок, или оно невидимо. При любом
- другом значении параметра скрипт переключения добавляет к этому
- значению имя окна (через разделяющий пробел) и интерпретирует
- получившуюся строку как скрипт Tcl. Скрипт должен возвращать
- значение "0", "1" или пустую
- строку. Значения "0" и "1" указывают, должен
- ли фокус ввода установиться на окно, пустая строка вызывает
- обработку по умолчанию, описанную выше. Замечание: подобная
- обработка параметра целиком определяется скриптами переключения
- Tcl; реализация примитивов полностью игнорирует рассматриваемый
- параметр. Задает строку, выводимую в примитиве. Способ вывода строки
- зависит от конкретного примитива и определяется значениями
- других параметров, таких как anchor или
- justify. Задает имя переменной. Значением переменной является текстовая
- строка, которая должна быть выведена в примитиве. При изменении
- значения переменной выведенная строка тут же изменяется. Способ
- вывода строки зависит от конкретного примитива и определяется
- значениями других параметров, таких как anchor
- или justify. Задает цвет обрамляющих прямоугольников полосы прокрутки, поля
- масштабов и т.д. в примитиве Задает номер подчеркиваемого символа в примитиве. Этот параметр
- используется связками по умолчанию для клавиатурного
- переключения кнопок меню и полей меню. "0"
- соответствует первому символу, "1" второму, и т.д. Для примитивов, способных выполнять перенос строк этот
- параметр задает максимальную длину строки. Строки, длина которых
- превосходит установленную, переносятся на следующую строку. Это
- значение может быть задано в любом виде, в котором могут
- задаваться экранные расстояния. Если это значение
- неположительно, то переноса не происходит: он выполняется только
- при появлении символа переноса строки. Задает префикс команды, используемой для связи с горизонтальной
- полосой прокрутки. При изменении содержимого окна примитива (или
- любом другом событии, которое может повлечь за собой изменение
- вида полосы прокрутки, скажем изменении размера содержимого
- примитива) примитив генерирует команду Tcl путем конкатенации
- значения параметра и двух чисел, каждое из которых представляет
- собой дробь между нулем и единицей. Числа указывают положение
- текста в документе. "0" указывает на начало документа,
- "1" на его конец, ".333" на одну треть от
- начала документа и т.д. Первое число обозначает начало видимой
- части документа, второе на позицию, непосредственно следующую за
- концом видимой части. Затем команда передается интерпретатору
- Tcl для выполнения. Обычно значение параметра
- xScrollCommand состоит из имени пути к
- примитиву полосы прокрутки, за которым следует слово
- "set", например, .x.scrollbar
- set: в результате состояние полосы будет изменяться
- всякий раз при изменении содержимого окна. Если параметр не
- задан, то никакая команда не будет исполняться. Задает префикс команды, используемой для связи с вертикальной
- полосой прокрутки. Этот параметр интерпретируется так же, как и
- параметр xScrollCommand, за исключением того,
- что он относится к вертикальной полосе прокрутки и используется
- в примитивах, которые такую полосу поддерживают. Подробное
- описание см. выше. Устаревшая команда для геометрического менеджера упаковки
- окон. Замечание. Ниже описан синтаксис команды
- pack, употреблявшейся в версиях Tk до 3.3. Хотя
- в целях совместимости поддержка команды в системе сохранена,
- команда является устаревшей и использовать ее не
- следует. Возможно, в будущем ее поддержка
- прекратится. Упаковщик представляет собой геометрический менеджер,
- предназначенный для размещения непосредственных потомков
- примитива по сторонам примитива в порядке их появления. Первый
- потомок размещается вдоль одной стороны примитива, занимая всю
- протяженность окна вдоль этой стороны. В результате, для
- следующих потомков остается усеченное окно, как если бы
- выбранная сторона сдвинулась внутрь на размер первого
- потомка. Вдоль одной из сторон оставшейся области размещается
- второй потомок, и так далее до тех пор, пока не будут размещены
- все потомки или пока не исчерпается свободное место. Формы before, after и
- append команды pack
- используются для вставки одного или нескольких непосредственных
- потомков в очередь упаковки их родителя. В форме
- before команда вставляет окно-потомка перед
- родственными узлами; все остальные окна должны быть узлами
- одного уровня. В форме after окна вставляются
- после родственных узлов, а в форме append
- добавляет одно или несколько окон к очереди упаковки их
- родителя. Если окно, указанное в любой из этих
- команд уже упаковано в родительское окно, то оно удаляется со
- своего текущего положения в порядке упаковки и перемещается в
- соответствии с командой. Все эти команды возвращают в качестве
- результата пустую строку. Форма unpack команды pack
- command удаляет окно из очереди упаковки его
- родителя и стирает его с экрана. После выполнения этой команды
- упаковщик более не управляет геометрией окна. На самом деле, размещение каждого потомка представляет собой
- четырехступенчатую процедуру; значение параметра,
- следующего за окном, представляет собой список из
- одного или нескольких полей, управляющих размещением окна. В
- нижеследующем обсуждении термин полость (cavity)
- обозначает место в окне-родителе, оставшееся после размещения
- конкретного потомка (т.е. все то место, которое не было
- запрошено при размещении предыдущих потомков в очереди). Термин
- доля (parcel) обозначает количество места,
- отведенного конкретному потомку; это количество не обязательно
- соответствует окончательной геометрии окна-потомка. Первый шаг в размещении потомка состоит в выборе стороны
- полости, вдоль которой он будет располагаться. Для указания
- стороны можно пользоваться любым из следующих параметров: Для каждого окна следует задать ровно один из этих
- параметров. Значением стороны по умолчанию является
- top. Второй шаг состоит в определении доли
- потомка. Для верхнего и
- нижнего окон желательная ширина доли обычно
- совпадает с шириной полости, а желательная высота совпадает с
- запрошенной высотой доли, которая передается команде
- Tk_GeometryRequest. Для левого и
- правого окон желательная высота доли обычно
- совпадает с высотой полости, а желательная ширина совпадает с
- запрошенной шириной доли. Однако с помощью каждого из описанных
- ниже параметров для окна можно запросить дополнительное
- место: Если желаемая ширина или высота превосходит соответствующую
- протяженность полости, то вместо нее используется эта размер
- этой протяженности. На третьем шаге размещения окна следует принять решение о его
- ширине и высоте. По умолчанию окно получает либо запрошенные
- ширину и высоту, либо ширину и высоту доли в зависимости от
- того, что из них меньше. Если доля больше, чем запрошенный
- размер окна, то окно можно расширить так, чтобы оно полностью
- или частично покрывало долю, с помощью следующих параметров: На последнем этапе происходит размещение окна внутри его
- доли. Если размеры окна и доли совпадают, то окно просто целиком
- заполняет долю. Если доля больше окна, то положение окна
- определяется с помощью одного из следующих параметров: Упаковщик управляет состоянием размещенный/неразмещенный всех
- упакованных непосредственных окон-потомков. При упаковке окон
- упаковщик автоматически выводит их на экран; кроме того, он
- стирает окна, для которых в полости остается недостаточно
- места. Упаковщик посылает геометрические запросы от имени родителя
- размещаемых окон. Для каждого окна-родителя он запрашивает
- размер, достаточный для размещения всех упакованных потомков в
- соответствии с указанными параметрами, так что на расширение
- остается нулевой остаток. Геометрический менеджер, который упаковывает виджеты по
- сторонам внутреннего пространства окна. Команда pack используется для управления
- соответствующим геометрическим менеджером, размещающим виджеты
- по различным сторонам родительского окна, и для получения от
- него справочной информации. Команда может иметь перечисленные
- ниже формы в зависимости от значения аргумента
- option. Аргумент команды состоит из имени одного или нескольких
- размещаемых виджетов, после которых идут пары аргументов,
- состоящих из имени опции и ее значения. Подробное описание
- действий, выполняемых при размещении виджетов приведено ниже
- (см. "Алгоритм
- упаковки pack"). Ниже перечислены
- возможные опции команды. Если в мастер-окне для slave имеется свободное
- пространство, управляет растяжением виджета slave. Аргумент style может иметь одно из следующих
- значений: Если никакая из опций -in,
- -after или -before не
- указана, каждый из slave будет внесен в конец
- списка размещения своего непосредственного родителя (если
- только он не был внесен туда ранее, в этом случае он
- останется на своем прежнем месте). Если же одна из
- перечисленных опций указана, все slave будут
- внесены в соответствующий список в указанное место. Если какие-либо из slave окон ранее уже
- обрабатывались геометрическим менеджером, то для не
- определенных в команде опций будут использоваться старые
- значения, а не значения по умолчанию. Для каждого мастер-окна менеджер pack формирует список
- упаковки. Место каждого виджета в нем может задаваться с помощью
- опций -in, -after и
- -before. Если эти опции не использовались,
- каждый новый виджет добавляется в конец списка своего
- непосредственного предка. Менеджер размещает виджеты в окне, последовательно просматривая
- список упаковки. В момент обработки каждого из размещаемых
- виджетов внутри мастера есть прямоугольная незаполненная
- область. Эта область называется "полость". Для первого
- обрабатываемого виджета "полость" совпадает со всей
- внутренностью мастер-окна. Для каждого из размещаемых виджетов выполняются следующие
- действия: После того, как очередной виджет размещен, выделенная ему
- область (см. 1)) вычитается из полости. Полость
- для следующего виджета остается прямоугольной, но меньшей по
- размеру. Если виджет не занял полностью выделенную ему область,
- ее оставшиеся свободными части не используются при размещении
- последующих виджетов. Если полость оказывается мала для
- очередного виджета, он получает столько пространства, сколько
- осталось. Если полость сокращается до нуля, все оставшиеся
- виджеты в списке упаковки удаляются с экрана. Если размеры окна
- будут увеличены, они появятся на экране. Если мастер-окно оказалось больше, чем необходимо для
- размещения всех виджетов, оставшееся пространство распределяется
- равномерно между теми виджетами, для которых установлена опция
- -expand. Дополнительное горизонтальное
- пространство распределяется между теми виджетами, у которых
- опция -side равна left или
- right. Вертикальное пространство распределяется
- между виджетами, у которых опция -side равна
- top или bottom. Обычно менеджер рассчитывает размеры мастер-окна, необходимые
- для размещения виджетов, и, при необходимости, устанавливает
- размеры мастер-окна таким образом, чтобы в нем в точности
- поместились все виджеты из списка. Это приводит к тому, что
- информация о размерах виджетов распространяется по
- иерархическому дереву виджетов, в результате чего целое
- поддерево изменяет свои размеры при изменении одного из
- листьевых элементов. Однако команда pack
- propagate может быть использована для отключения этого
- механизма для одного или нескольких мастер-окон. Если
- распространение размеров отключено, информация о необходимых
- размерах не передается мастер-окну. Это может оказаться
- полезным, если вы хотите, чтобы мастер-окно сохраняло те
- размеры, которые вы определили. Мастер-окно для каждого размещаемого виджета должно быть его
- непосредственным предком (по умолчанию) или одним из потомков
- его предка. Это ограничение гарантирует разумное поведение
- виджетов при удалении toplevel-окон. Если мастер-окно для виджета не является его непосредственным
- предком, необходимо быть уверенным, что виджет лежит в стеке
- окон выше, чем мастер-окно. В противном случае мастер-окно
- закроет собой виджет и создастся впечатление, что виджет не
- упакован правильным образом. Простейший способ избежать подобных
- проблем следить, чтобы -окно было создано раньше, чем виджет
- (чем позже создано окно, тем выше оно в стеке). Если это
- почему-либо неудобно, можно использовать команды
- raise и lower для изменения
- порядка окон в стеке. Встроенный тип полноцветных изображений Tk. Пиксели изображения типа photo могут быть
- любого цвета, а также могут быть прозрачными. При сохранении
- изображений этого типа каждый пиксель кодируется 24 битами; при
- выводе пиксела при необходимости используется приближение
- (dithering). Закодированные данные могут быть представлены в
- виде файла или строки, а также в виде C кода через процедурный
- интерфейс. В настоящее время поддерживаются только форматы GIF и
- PPM/PGM; однако в системе имеется интерфейс, облегчающий
- добавление новых форматов изображений. Области, данные для
- которых не представлены, при выводе изображения оказываются
- прозрачными. Как и все остальные изображения, изображения типа photo
- создаются командой image
- create. Команда поддерживает следующие параметры:
-
- При создании изображения типа photo
- Tk создает также новую команду, имя которой совпадает с именем
- вновь созданного изображения. С помощью этой команды можно
- выполнять различные операции над изображением. Она имеет
- следующий общий вид: Параметр и аргументы уточняют поведение
- команды. Параметры, приводящие к дописыванию данных в изображение,
- обычно приводят к увеличению размеров изображения, за
- исключением случаев, когда пользователь задал ненулевые значения
- параметров конфигурации -width и/или
- -height; в последнем случае ширина и/или высота
- изображения не изменяются. Изображения типа photo поддерживают следующие команды: Копирует область изображения с именем исхИзобр
- (которое должно быть изображением типа photo) в
- изображение с именем имяИзображения, возможно с
- растяжением пикселей и/или subsampling. Если параметры не
- заданы, то команда копирует в имяИзображения все
- исходное изображение, начиная с точки с координатами (0,0) в
- изображении имяИзображения. В команде могут быть
- заданы следующие параметры: Читает данные из файла с именем имяфайла в
- изображение с именем имяИзображения. Выполнение
- команды начинается с просмотра списка программ обработки
- форматов файлов изображений в поисках программы, способной
- интерпретировать данные в указанном файле; затем эти данные
- читаются из файла в изображение с именем
- имяИзображения. Команда может иметь следующие
- параметры: Записывает изображение имяИзображения в файл с
- именем имяфайла. Может иметь следующие параметры: При создании программ обработки изображений типа photo
- предусмотрена возможность легкого добавления новых форматов
- файлов изображений. Все программы занесены в список. Добавление
- программы в список происходит в результате выполнения команды
- Tk_CreatePhotoImageFormat. В стандартном
- дистрибутиве Tk содержатся программы обработки для форматов
- PPM/PGM и GIF, которые автоматически заносятся в список при
- инициализации. При чтении файла изображения или обработке строки данных,
- заданной в параметре конфигурации -data,
- команда photo image просматривает программы
- обработки одну за другой, пока не найдется такая, которая
- утверждает, что она способна читать данные из файла или
- строки. Результатом поиска обычно бывает правильная программа
- обработки. В противном случае пользователь может задать имя
- программы обработки с помощью параметра
- -format. На самом деле команда photo image
- просматривает только те программы обработки, имена которых
- начинаются со строки, заданной параметром
- -format (при сравнении регистр не
- учитывается). Если, например, пользователь указал
- -format gif, то могут выполняться программы
- обработки GIF87 или GIF89, но не программа JPEG (если такие
- программы были внесены в список). При записи изображения в файл параметр -format
- обрабатывается несколько другим способом: строка, являющаяся его
- значением, должна начинаться с полного имени запрашиваемой
- программы обработки, за которым может следовать дополнительная
- информация. Эта дополнительная информация может, например,
- сообщать программе, какую из версий формата следует
- использовать. При выводе изображения типа photo в окно команда
- photo image отводит цвета и,
- при необходимости, возмущает изображение, заменяя отсутствующие
- цвета доступными. Выделяемые цвета образуют куб: число возможных
- составных цветов представляет собой произведение чисел оттенков
- красного, зеленого и голубого цветов. Обычно выбор числа цветов определяется глубиной окна. Например,
- в 8-битовом окне PseudoColor команда photo
- image пытается отвести семь оттенков красного, семь
- оттенков зеленого и четыре оттенка голубого, всего 198 составных
- цветов. Для 1-битового окна StaticGray (монохромного) команда
- отводит два цвета, белый и черный. Для 24-битовых окон
- DirectColor или TrueColor команда отводит по 256 оттенков
- каждого из трех цветов. Если не удается отвести все цвета, то
- команда photo image уменьшает число оттенков
- каждого простого цвета и производит новую попытку
- размещения. Пользователь может частично управлять выбором числа цветов с
- помощью параметра конфигурации -palette. При
- использовании этого параметра в нем задается максимальное число
- используемых оттенков каждого из простых цветов. Кроме того с
- помощью этого параметра можно потребовать представления
- изображения оттенками серого цвета даже в цветном окне, задав
- одно число вместо трех, разделенных наклонными чертами. Создает индексный файл для автоматической загрузки пакета. Процедура pkg_mkIndex представляет собой
- утилиту для работы с Tcl-библиотеками. Она обеспечивает создание
- индексных файлов, необходимых для автоматической загрузки
- пакетов, когда в приложении встречается команда package require. Для
- создания автоматически загружаемых пакетов необходимо выполнить
- следующие действия: Если перечисленные выше шаги выполнены, то для использования
- необходимого пакета достаточно выполнить в приложении команду package
- require. Если, например, версии 2.1, 2.3 и 3.1
- пакета Test проиндексированы и хранятся в
- соответствующих каталогах, то команда загрузит версию 3.1. А команда загрузит версию 2.1. В различных каталогах могут храниться
- много версий одного и того же пакета, но в данный интерпретатор
- может быть загружена только одна из них . та, которая будет
- затребована первой. Однако, в различных интерпретаторах одного
- приложения могут быть загружены различные версии одного и того
- же пакета. Автозагрузчик и загрузчик пакетов во многом имеют сходные
- возможности, поскольку и тот, и другой предназначены для
- загрузки файлов по требованию. Однако загрузчик файлов
- представляет собой механизм более высокого уровня, который
- использует автозагрузчик на последнем шаге процесса
- загрузки. Как правило, предпочтительнее индексировать пакеты с
- помощью команды pkg_mkIndex, чем с
- помощью команды auto_mkindex, поскольку это
- обеспечивает подключение механизма версий. Вы можете иметь
- несколько версий одного и того же пакета и, более того,
- использовать в различных приложениях различные версии. Напротив,
- auto_mkindex позволяет работать с единственной
- версией пакета. Скорее всего, не стоит создавать индексы для
- пакета с помощью и pkg_mkIndex, и auto_mkindex, поскольку в этом
- случае трудно контролировать, какой из механизмов загрузки
- пакета сработает первым, и, соответственно, какая версия пакета
- будет загружена. При первом вызове команды package require
- исполняется скрипт package
- unknown. При инициализации Tcl-скрипт package unknown
- задается таким образом, что он выполняет все файлы
- pkgIndex.tcl в каталогах auto_path. Эти файлы содержат
- команды package
- ifneeded для каждой доступной версии каждого
- доступного пакета. Эти команды в свою очередь вызывают команды
- package
- provide, которые объявляют данные версии
- доступными. Кроме того, они формируют необходимую исходную
- информацию для автозагрузчика. Данный файл данной версии
- данного пакета реально загружается только тогда, когда
- вызывается первая из содержащихся в нем команд. Таким образом,
- после выполнения команды package require вы
- не увидите команд пакета в интерпретаторе, но, тем не менее,
- вы сможете их вызвать и при этом они загрузятся
- автоматически. Геометрический менеджер, обеспечивающий размещение виджетов в
- абсолютных или относительных координатах. Геометрический менеджер place позволяет
- размещать виджеты в их мастер-окнах, используя прямые указания о
- размерах и размещении виджета. Кроме того, с его помощью можно
- добиваться режима "резинового листа", указывая размеры и
- размещение виджета в долях размера мастер-окна. При этом виджеты
- изменяют свои размеры при изменении размеров мастер окна. И,
- наконец, менеджер place позволяет сочетать оба этих метода,
- размещая, например, виджет определенного размера в центре
- мастер-окна. Команда place используется для управления
- соответствующим геометрическим менеджером и для получения от
- него справочной информации. Команда может иметь перечисленные
- ниже формы. Аргумент команды состоит из имени размещаемого виджета,
- после которого идут пары аргументов, состоящих из имени
- опции и ее значения. Если виджет уже обрабатывался с помощью
- команды place, то для не определенных в
- команде опций будут использоваться старые значения, а не
- значения по умолчанию. Команда возвращает пустую строку Ниже перечислены возможные опции. Аргумент location определяет
- x-координату в мастер-окне для якорной точки
- виджета. Координата указывается на экране в одной из
- следующих форм: Якорная точка не обязана находиться внутри мастер-окна. Аргумент location определяет y-координату в
- мастер-окне для якорной точки виджета. Координата
- указывается на экране в одной из следующих форм: Якорная точка не обязана находиться
- внутри мастер-окна. Аргумент mode определяет, используются ли
- границы мастер-окна при определении положения
- размещаемого виджета. Значение по умолчанию, которое используется наиболее
- часто, inside. Оно означает, что
- менеджер рассматривает в качестве мастер-окна его
- внутреннюю часть без границы. Опция -x
- 0 означает при этом точку внутри границы
- мастер-окна. А опция -relwidth 1.0
- означает, что виджет будет размещен внутри
- соответствующих границ мастер-окна. Значение outside означает, что
- менеджер включает границу мастер-окна в его состав. Это
- значение используется обычно, когда нужно разместить
- виджет вне его мастер-окна (но в пределах границы
- мастер-окна), например, как при опциях -x 0 -y 0
- -anchor ne. Значение ignore означает, что менеджер
- включает в состав окна все внутренние границы, но не
- внешние границы (его официальное X-определение). Это
- значение используется, вероятно, реже остальных. Если значение одной и той же величины определено дважды с
- использованием различных опций, например, если x-координата
- виджета определена сначала с использованием опции
- -x, а позднее повторно определена с
- использованием опции -relx, то используется
- только более позднее определение. Эта команда возвращает список всех виджетов,
- размещенных в мастер-окне. Если в нем не размещены виджеты,
- команда возвращает пустой список. Окно window больше не управляется менеджером
- place. Как следствие, оно удаляется с
- экрана. Если окно не управлялось менеджером
- place, команда не имеет никакого эффекта. Команда возвращает пустую строку. Возвращает список опций и их значений для окна window
- в той же форме, в какой они задаются в команде place
- configure. Если конфигурацию виджета, полученную с
- помощью этой команды, предполагается впоследствии восстановить,
- то перед этим необходимо будет использовать команду
- place forget, чтобы удалить текущую
- конфигурацию, а затем place configure с
- сохраненной конфигурацией. В отличие от многих других геометрических менеджеров
- place не пытается манипулировать геометрией
- мастер-окна (например, переустанавливать их размер "по
- потребности"). Чтобы управлять размерами этих окон, для них
- желательно использовать такие виджеты, как frame или canvas. Создание примитива кнопки-переключателя и управление им. Подробное описание этих параметров приведено в разделе options. Ассоциирует с кнопкой команду Tk. Обычно команда выполняется
- при отпускании клавиши 1 "Мыши" на окне
- кнопки-переключателя. Перед выполнением команды обновляется
- значение глобальной переменной переключателя (параметр
- -variable). Задает желаемую высоту кнопки. Если в кнопке выводится
- изображение или двуцветное изображение, то значение параметра
- задается в пикселах (т.е., в любом виде, приемлемом для
- Tk_GetPixels); высота текстовой кнопки задается
- числом строчек текста. Если параметр не задан, то высота кнопки
- вычисляется по ее содержимому. Указывает, следует ли выводить индикатор. Значение параметра
- должно быть булевским. Если значением является ложь, то параметр
- relief игнорируется и примитив всегда
- изображается вдавленным, если он выделен, и выпуклым в противном
- случае. Задает цвет фона для изображения выделенной кнопки. Если
- параметр IndicatorOn имеет значение истина, то
- указанный цвет применяется для изображения индикатора. В системе
- Windows тот же цвет используется в качестве фона изображения
- индикатора вне зависимости от состояния выделения. Если
- значением параметра IndicatorOn является ложь,
- то указанный цвет используется в качестве фона для всего
- примитива, когда он выделен, вместо значений параметров
- background и
- activeBackground. Задает изображение, выводимое в кнопке при выделении
- кнопки-переключателя (вместо изображения, заданного параметром
- -image). Если параметр -image
- отсутствует, то значение параметра -selectimage
- игнорируется. Задает одно из трех состояний кнопки-переключателя:
- normal, active или
- disabled. В нормальном состоянии
- кнопка-переключатель изображается с использованием значений
- параметров foreground и
- background. В активном состоянии
- кнопка-переключатель обычно находится, если на ней расположен
- курсор. Кнопка-переключатель в активном состоянии изображается с
- использованием значений параметров
- activeForeground и
- activeBackground. Недоступное состояние
- указывает на то, что кнопка должна быть нечувствительной:
- привязки по умолчанию не приводят к запуску примитива и нажатия
- на кнопку "Мыши:" игнорируются. В этом состоянии
- изображение кнопки-переключателя определяется значениями
- параметров disabledForeground и
- background.
- Задает значение, которое следует заносить в переменную
- кнопки-переключателя при выделении этой кнопки. Задает имя глобальной переменной, значение которой нужно
- устанавливать при выделении кнопки. Изменение значения этой
- переменной также приводит к изменению состояния выделения
- кнопки. По умолчанию параметр имеет значение
- selectedButton. Задает желаемую ширину кнопки-переключателя. Если в кнопке
- выводится изображение или двуцветное изображение, то значение
- параметра задается в пикселах (т.е., в любом виде, приемлемом
- для Tk_GetPixels); ширина текстовой кнопки задается числом
- символов. Если параметр не задан, то ширина кнопки вычисляется
- по ее содержимому. Команда radiobutton создает новое окно
- (задаваемое аргументом имяПути) и превращает его в
- примитив кнопки-переключателя. Детали изображения
- кнопки-переключателя, такие как ее цвета, шрифт, текст и
- исходный объемный вид задаются с помощью описанных выше
- дополнительных параметров. Команда radiobutton
- возвращает аргумент имяПути. В момент выполнения этой
- команды не должно существовать окна с именем имяПути,
- но должен существовать его предок. Кнопка-переключатель представляет собой примитив, в котором
- выводится текстовая строка, изображение или двуцветное
- изображение, а также ромб или кружок, называемый
- индикатором. Весь выводимый текст должен быть записан
- одним шрифтом, однако он может занимать несколько строчек на
- экране (если в нем есть символы перевода строки или задан
- параметр wrapLength). Один из символов текста
- может быть подчеркнут (в соответствии со значением параметра
- underline). Кнопка-переключатель обладает всеми
- характеристиками обычной кнопки, включая следующие: в
- зависимости от значения параметра state кнопка
- имеет три разных вида; кнопка может выглядеть выпуклой,
- вдавленной или плоской, кроме того, она может мигать. При
- инициации кнопки-переключателя (нажатием на клавишу 1
- "Мыши", когда курсор "Мыши" находится на
- кнопке) выполняется команда Tcl. Кроме того, кнопки-переключатели можно выделять. Если
- кнопка выделена, то индикатор обычно изображается как
- выделенный, а переменная Tcl, ассоциированная с данной кнопкой,
- имеет предписанное значение (обычно 1). В ОС Unix индикатор
- изображается вдавленным и имеет специальный цвет. В системе
- Windows вместо этого в индикаторе появляется круглая метка. Если
- кнопка-переключатель не выделена, то индикатор имеет
- невыделенный вид, а ассоциированная переменная имеет другое
- значение (обычно "0"). В ОС Unix такой индикатор
- изображается выпуклым и не имеет специального цвета. В системе
- Windows в невыделенном индикаторе отсутствует круглая
- метка. Обычно одна переменная обслуживает несколько
- кнопок-переключателей, а ее значение указывает, какая из них
- должна быть выделена. При выделении кнопки происходит изменение
- значения ассоциированной переменной. Кроме того, каждая
- кнопка-переключатель отслеживает значение ассоциированной
- переменной и при его изменении состояние выделения кнопки
- меняется. По умолчанию используется переменная
- selectedButton; ее значением является имя
- выделенной кнопки или пустая строка, если ни одна из кнопок,
- ассоциированных с данной переменной, не выделена. Имя переменной
- и записываемые в ней значения
- "выделенная"/"невыделенная" можно поменять с
- помощью параметров командной строки или в базе данных
- параметров. С помощью параметров конфигурации можно также
- поменять вид индикатора (или даже отменить саму необходимость
- его вывода). По умолчанию выделение кнопки-переключателя
- происходит при щелчке на кнопке. Команда radiobutton создает новую команду Tcl
- с именем имяПути. С помощью этой команды можно
- выполнять различные операции над примитивом. Ее общий вид Параметр и аргументы уточняют поведение
- команды. Примитивы кнопки-переключателя допускают следующие
- формы команды: При создании кнопки-переключателя Tk автоматически создает
- привязки к ней, определяющие ее поведение по умолчанию: Поведение кнопки-переключателя можно изменить с помощью новых
- привязок к конкретным примитивам или путем переопределения
- привязок данного класса. Команда изменяет положение окна в очереди стека. Команда raise перемещает окно window в
- очереди стека либо выше всех окон, имеющих одинаковый с
- window уровень иерархии, либо перед одним из них,
- заданного аргументом aboveThis. Данное окно будет
- заслонять окна, оказавшиеся ниже его. Управляет Macintosh-ресурсами. Команда resource позволяет управлять ресурсами
- на платформах Macintosh. На остальных платформах не
- поддерживается. Создание примитива линейной шкалы и управление им. Подробное описание этих параметров приведено в разделе options. Некоторые способы обращения со шкалой требуют использования
- "больших" шагов. Этот параметр задает величину
- большого шага. Если его значение равно 0 (как, например, по
- умолчанию), то большой шаг считается равным 1/10 интервала
- шкалы. Задает префикс команды Tcl, исполняемой при всяком изменении
- показателя шкалы какой-либо командой примитива. Сама команда Tcl
- состоит из этого префикса, за которым следует пробел и
- вещественное число, равное новому значению показателя шкалы.
-
- Целое число, указывающее, сколько значащих цифр следует
- сохранить при преобразовании показателя шкалы в строку
- текста. Если это число неположительно, то выбирается наименьшее
- число, обеспечивающее различное представление всех возможных
- положений движка шкалы. Вещественное число левая или верхняя граница шкалы. Строка текста, выводимая в качестве названия шкалы. Для
- вертикальной шкалы выводится непосредственно справа от верхнего
- конца шкалы. Для горизонтальной шкалы название выводится
- непосредственно выше левого конца шкалы. Если значением
- параметра служит пустая строка, то никакого названия не
- выводится. Задает желаемую длину шкалы на экране в пикселах (т.е. в любой
- форме, приемлемой для Tk_GetPixels). Это высота
- вертикальной шкалы или ширина горизонтальной. Вещественное число, задающее цену деления шкалы. Если это
- значение положительно, то показатель шкалы будет всегда
- округляться к целому кратному этой величины (такими будут, в
- частности, метки шкалы и границы ее интервала). Если это
- значение неположительно, то округления не происходит. Значение
- параметра по умолчанию равно "1" (т.е. показатели
- должны быть целыми). Булевское значение, указывающее, следует или нет выводить
- текущий показатель шкалы. Задает размер движка шкалы (вдоль его длинной стороны) в
- пикселах (т.е. в любой форме, приемлемой для
- Tk_GetPixels). Задает вид движка шкалы, например, raised или
- sunken. Задает одно из трех состояний шкалы:
- normal,active или
- disabled. Если шкала недоступна, то значение ее
- показателя нельзя изменить и шкалу нельзя активизировать. Движок
- на активной шкале изображается цветом, заданным параметром
- activeBackground. Вещественное число, определяющее величину промежутка между
- числовыми метками снизу или слева от движка. Если значение
- параметра равно "0", то метки не выводятся. Вещественное число правая или нижняя граница шкалы. Может быть
- как меньше, так и больше значения, задаваемого параметром
- from. Задает имя глобальной переменной, ассоциированной со
- шкалой. При изменении значения переменной шкала обновляется и
- показывает новое значение. При интерактивном изменении
- показателя шкалы происходит соответствующее изменение значения
- переменной. Задает желаемую толщину полосы шкалы (в любой форме, приемлемой
- для Tk_GetPixels). Для вертикальной шкалы это
- ее ширина, для горизонтальной высота. Команда scale создает новое
- окно (задаваемое аргументом имяПути) и превращает его в
- примитив линейной шкалы. Детали изображения шкалы, такие как ее
- цвета, ориентация и объемный вид задаются с помощью описанных
- выше дополнительных параметров. Команда scale возвращает
- аргумент имяПути. В момент выполнения этой команды не
- должно существовать окна с именем имяПути, но должен
- существовать его предок. Шкала представляет собой примитив, который выводит на экран
- прямоугольную полоску шкалы и маленький
- движок. Полоска отображает интервал вещественных чисел
- (определенный параметрами from,
- to и resolution), а положение
- движка задает некоторое конкретное число на этом
- интервале. Положение движка (а значит, и показатель шкалы) можно
- менять с помощью "Мыши" или клавиатуры, как описано
- ниже (см. "ПРИВЯЗКИ"). При
- каждом изменении показателя шкалы исполняется команда Tcl
- (заданная параметром command), и другие примитивы получают
- доступ к результатам выполненного изменения. Кроме того
- показатель шкалы можно (с помощью параметра variable) связать с
- некоторой переменной, так что изменения значений показателя или
- переменной немедленно отзываются друг на друге. В примитиве шкалы можно вывести также три внешних атрибута: имя
- шкалы справа сверху (или слева сверху, если шкала
- горизонтальна), число непосредственно слева от движка
- (непосредственно сверху, если шкала горизонтальна) и набор
- числовых меток непосредственно слева от текущего значения
- (непосредственно снизу, если шкала горизонтальна). Вывод любого
- из этих атрибутов можно отменить с помощью параметров
- конфигурации. Команда scale создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид. Параметр и аргументы уточняют поведение
- команды. Примитивы линейной шкалы допускают следующие формы
- команды: При создании линейной шкалы Tk автоматически создает привязки
- класса, определяющие следующее поведение примитива по
- умолчанию. В случае, если имеются различия в поведении
- вертикальной и горизонтальной шкалы, описание поведения
- горизонтальной приводится в скобках. При нажатии клавиши 1 "Мыши" на полосе шкалы движок
- сдвигается в направлении курсора на величину, заданную
- параметром resolution. Если клавишу не
- отпускать, то сдвиг автоматически повторяется. Если нажать клавишу 1 на движке, то движок можно тащить. Если нажать клавишу 1 на полосе шкалы при нажатой клавише
- Control. то движок пробежит до конца полосы в
- направлении курсора "Мыши". Если нажать клавишу 2, то показатель шкалы будет установлен в
- положение курсора "Мыши". Если тащить "Мышь"
- с нажатой клавишей 2, то показатель шкалы будет соответственно
- меняться. Нажатие на клавиши Up и Left
- приводит к перемещению движка вверх (влево) на величину,
- указанную параметромresolution. Нажатие на клавиши Down и
- Right приводит к перемещению движка вниз
- (вправо) на величину, указанную параметром
- resolution. Нажатие на клавиши Control-Up и
- Control-Left приводит к перемещению движка
- вверх (влево) на величину, указанную параметром
- bigIncrement. Нажатие на клавиши Control-Down и
- Control-Right приводит к перемещению движка
- вниз (вправо) на величину, указанную параметром
- bigIncrement. Нажатие на клавишу Home приводит к перемещению
- движка вверх (влево) до конца полосы. Нажатие на клавишу End приводит к перемещению
- движка вниз (вправо) до конца полосы. Если шкала сделана недоступной с помощью параметра
- state, то ни одна из описанных выше привязок не
- оказывает какого-либо действия. Определяя новые привязки к отдельным примитивам или
- переопределяя привязки класса, поведение линейной шкалы можно
- изменить. Создание примитива линейки прокрутки и управление им. Подробное описание этих параметров приведено в разделе options. Задает объемный вид изображения активного элемента. Все
- неактивные элементы изображаются выпуклыми. Задает префикс команды Tcl, исполняемой при всяком изменении
- состоянии линейки прокрутки пользователем. Сама команда Tcl
- состоит из этого префикса, за которым следует дополнительная
- информация, описанная ниже. Значением этого параметра обычно
- является что-нибудь вроде .t xview или
- .t yview имя примитива, за которым следует
- xview (для горизонтальной линейки) или
- yview (для вертикальной). У каждого примитива
- линейки прокрутки есть команды xview и
- yview, аргументы которых описаны ниже (см.
- "Команды
- прокрутки"). Задает ширину окантовки каждого из внутренних элементов линейки
- (обеих стрелок и движка). Значение может быть представлено в
- любом виде, приемлемом для Tk_GetPixels. Если
- заданное значение отрицательно, то вместо него используется
- значение параметра borderWidth. Задает желаемую толщину окна линейки (не включая трехмерной
- окантовки, если она имеется) в любой форме, приемлемой для
- Tk_GetPixels. Для вертикальной шкалы это ее
- ширина, для горизонтальной высота. Команда scrollbar создает новое окно
- (задаваемое аргументом имяПути) и превращает его в
- примитив линейки прокрутки. Детали изображения линейки, такие
- как ее цвета, ориентация и объемный вид, задаются с помощью
- описанных выше дополнительных параметров. Команда возвращает
- аргумент имяПути. В момент выполнения этой команды не
- должно существовать окна с именем имяПути, но должен
- существовать его предок.
-
- Линейка прокрутки представляет собой примитив, который выводит
- на экран две стрелки (по одной на каждом конце линейки) и
- движок в средней части линейки. Линейка дает информацию
- о том, что видно в ассоциированном окне линейки. Это
- окно содержит какой-нибудь документ например, редактируемый
- текст или рисунок. Размер и положение движка указывают, какая
- часть документа видна в окне. Если, например, движок покрывает
- верхнюю треть вертикальной линейки, то в ассоциированном окне
- выведена верхняя треть документа. Линейки прокрутки используются для перемещения видимой части
- документа в ассоциированном окне с помощью
- "Мыши". Подробности описаны ниже (см. "Привязки"). Линейка прокрутки состоит из пяти элементов, на которые
- ссылаются команды примитива: Команда scrollbar создает новую команду Tcl с
- именем имяПути. С помощью этой команды можно выполнять
- различные операции над примитивом. Ее общий вид Параметр и аргументы уточняют поведение
- команды. Примитивы линейки прокрутки допускают следующие формы
- команды: Когда пользователь взаимодействует с линейкой прокрутки
- (например, тащит движок), линейка требует от ассоциированного
- примитива изменения его состояния. Это требование осуществляется
- за счет исполнения команды Tcl, которая генерируется исходя из
- значения параметра -command примитива
- линейки. Команда может иметь один из следующих видов, где
- префикс это значение параметра
- -command (обычно что-нибудь вроде .t
- yview). В младших версиях Tk (до 4.0) команды примитива
- set и get имели другой вид. В
- целях совместимости эта форма команд поддерживается и до сих
- пор, однако использовать ее не стоит. Вот старый вид команды: Значения всех аргументов команды должны быть целыми
- числами. Аргумент числоЕдин задает общее число единиц в
- документе. Единицы это порции документа, имеющие смысл
- для документа данного типа (например, строчки для текстового
- примитива). Аргумент окноЕдин указывает число единиц,
- одновременно помещающихся в окно ассоциированного
- примитива. Аргументы первЕдин и последЕдин
- указывают индексы первой и последней единиц, находящихся в окне
- в текущий момент (ноль указывает на первую единицу объекта). В старом синтаксисе команда get
- возвращала список из четырех целых чисел значений аргументов
- последней выполненной команды примитива set. В старом синтаксисе команды, генерируемые примитивом линейки,
- также имеют другой вид: Аргумент единица представляет собой целое число,
- указывающее, что должно появляться вверху или слева в окне
- ассоциированного примитива. Этот аргумент интерпретируется так
- же, как и аргументы первЕдин и последЕдин
- команды примитива set. Последняя выполненная команда примитива set определяет, следует
- ли использовать старый синтаксис. Если ее аргументы два
- вещественных числа, то в дальнейшем будет использоваться новый
- синтаксис, а если четыре целых то старый. При создании линейки прокрутки Tk автоматически создает
- привязки класса, определяющие следующее поведение примитива по
- умолчанию. В случае, если имеются различия в поведении
- вертикальной и горизонтальной линеек, описание поведения
- горизонтальной приводится в скобках. Управление X выделением Команда предоставляет интерфейс Tcl для механизма Х выделения и
- реализует полный набор функций выделения, описанный в
- (1). Аргумент параметр определяет формат последующих
- аргументов и поведение команды. В настоящее время поддерживаются
- следующие формы команды: Создает программу обработки запросов на поиск выделения:
- при каждой попытке поиска выделения указанного типа в окне
- (например, командой selection get) будет
- выполняться команда . По умолчанию значением
- параметра выделение является PRIMARY, параметра
- тип STRING, и параметра формат тоже
- STRING. Если значением параметра команда является
- пустая строка, то все программы обработки для указанного
- окна , типа и выделения
- удаляются. Если при запросе выделения окно является его владельцем и
- выделение имеет указанный тип, то к команде
- добавляется два числа (отделенных пробелами от имени команды
- и друг от друга) и она исполняется как команда Tcl. Эти два
- дополнительных числа представляют собой смещение и максБайт:
- смещение задает положение первого символа в выделении, а
- максБайт максимальное количество байтов для
- поиска. Возвращаемое командой значение должно начинаться с
- указанного символа в выделении и должно быть не длиннее
- максБайт. Для очень больших выделений (длина которых
- превышает максБайт) поиск будет повторяться многократно с
- возрастающими смещениями. Если длина строки, возвращаемой
- командой, меньше максБайт, то предполагается, что
- возвращенное значение включает в себя весь остаток
- выделения; если длина результата совпадает с максБайт, то
- команда будет выполняться повторно пока она не возвратит,
- наконец, строку, более короткую, чем указано параметром
- максБайт. Значение максБайт всегда довольно велико (порядка
- нескольких тысяч байтов). Если в результате работы команды возникает ошибка, то
- запрос на поиск отвергается, как если бы никакого выделения
- вообще не существовало. Аргумент формат задает представление, используемое
- для передачи выделения автору запроса (см. (1), второй
- столбец в Таблице 2), его значение по умолчанию STRING. Если
- значением аргумента формат является STRING, то
- выделение передается в виде 8-битовых символов
- ASCII (т.е. в том же виде, в каком его возвращает
- команда). Если его значение ATOM, то возвращаемое значение
- разбивается на поля, отделенные друг от друга пробелами;
- каждое поле преобразуется в свое атомарное значение и вместо
- имени атома передается 32-битовое атомарное значение. В
- любом другом формате возвращаемое командой значение
- разбивается на поля, отделенные друг от друга пробелами, и
- каждое поле преобразуется в целое 32-битовое число;
- полученный массив целых чисел передается автору запроса. Аргумент формат необходим лишь для обеспечения
- совместимости пользователям, не использующим Tk. Если для
- поиска выделения используется Tk, то на выходе из запроса
- результат преобразуется назад в строку, поэтому аргумент
- формат не играет роли. Первая форма команды selection own
- возвращает имя пути окна в данном приложении, владеющего
- выделением на дисплее, содержащем окно;
- если таких окон нет, то команда возвращает пустую строку. По
- умолчанию значением параметра выделение является
- PRIMARY, а параметра окно ".". Вторая форма команды selection own делает
- окно новым владельцем выделения на дисплее
- окна; она возвращает пустую строку. Текущий владелец
- выделения (если такой существует) получает
- сообщение о том, что он потерял выделение. Если задан
- параметр команда, то его значением является скрипт
- Tcl, который должен исполняться при попытке какого-либо
- другого окна заявить права на выделение вне данного окна. По
- умолчанию значением параметра выделение является
- PRIMARY. .
- Tktable2.3 : , , , . 0.
-
- , , ( -resizeborders). crosshair (). , , . -command, . , -command -variable . -cache -variable, . . , . . "0". . .10.. , . , tcl-. :
-
- none unset
-
- all
-
- fill ( rowstretch, currently)
-
- last
-
- :-coltagcommand , , , . , , , tag col. , , . . . , . . ( ), , , . `10..
-
- , . -usecommand , variable. . %-, Š
- . : slow compatible
-
- fast
-
- single
-
- : -flashmode , , , . flash , -flashtime. 0. , . -flashmode on. 2. . , , . -maxheight. , sel, . 0 ( sel). . 600.
-
- . 800.
-
-
- -multiline. `1'.
-
- . row col, both ( ) none.
-
- . (, ), , , . `1'. , . . "0".
-
- :-rows . `10'
-
- , . , tcl.
-
-
- . , colstretchmode.
-
- , , , . . . . coltagcommand , .
-
- :-selectioncommand or -selcmd , (, .selection get.). . %-, Š
- .
- , Tcl .
-
- . , : single, browse, multiple extended; browse. Tk listbox, , .
-
- , . .0. ( ).
-
- . : row, col, cell, both ( row && col); cell. , ( ) () .
-
- : . , , . .
-
- , . "0".
-
- , . 0.
-
- , , . "0".
-
- , . . true, , . , . , Tcl . %-,
- .
-
- Tcl ( ), , . , . row,col . active, . Tcl ( , ). , , Tcl .
-
- . , , . maxwidth, .
-
- . "0".
-
- , . ( -exportselection), X11 . (. ..). , ; . .. , -xscrollcommand -yscrollcommand. , . , , Tk-. , tkTableInit , . , env(TK_TABLE_LIBRARY) , $env(TK_TABLE_LIBRARY_FILE). , active
-
- anchor
-
- bottomright
-
- end
-
- origin
-
- topleft
-
- @x,y
-
- , , , index, first last . active flash
-
- sel
-
- title
-
- , . , , -background, -font, foreground . ,
-
- , . :
- -anchor anchor -background -bg color
- -font fontName
- -justify justify
- left, right, center; -image imageName
- -multiline boolean
- -relief relief
- -showtext boolean
- -state state
- -wrap boolean
-
- . , . , , . , , flash, active, sel, title, celltag, rowtag, coltag, default.
-
- , . , . . , , . . , , , -showtext. . , , , , . window configure, , window configure. : -create script -background -bg color
- -padx pixels
- -pady pixels
- -relief relief
- -sticky sticky
- -window pathName
- %c SelectionCommand . , . %c %i
- Command `0. (get) `1. (set).
- . %R , .
- %S SelectionCommand . %S BrowseCommand .
- %W pathName option arg arg ... pathName . . pathName activate index pathName bbox first ?last?
-
- pathName border optionargs
-
- pathName border mark x y row|col
-
- pathName border dragto x y
-
- pathName cget option
-
- pathName clear option ?first? ?last?
-
- pathName clear cache first last
-
- pathName clear sizes ?first? ?last?
-
- pathName clear tags first last
- pathName clear all first last
-
- pathName configure option value option value ..
-
- pathName curselection set value
-
- pathName curvalue value
-
- pathName deleteoptionarg?arg?
-
- pathName deleteactive index index
-
- pathName deletecolsswitches index count
-
- -cols value
-
- -holddimensions
-
- -holdtags
-
- -keeptitles
-
- -rows value
-
- --
-
- pathName delete rows switches index count
-
- pathName flushfirst last
-
- pathName getfirst last
-
- pathName height rowvalue row value ...
-
- pathName icursor arg
-
- pathName index index row|col
-
- pathName insertoptionarg arg
-
- pathName insert active index value
-
- pathName insert cols switches index count
-
- pathName insert rows switches index count
-
- pathName reread
-
- pathName scan option args
-
- pathName scan mark x y
-
- pathName scan dragto x y
-
- pathName seeindex
-
- pathName selectionoptionarg
-
- pathName selectionanchorinde
-
- pathName selection clear first last
-
-
- pathName selection includesindex
-
- pathName selection set first last
-
- pathName set row|colindex value index value ...
-
- 3 , 2,3 2,5. pathName tag option arg arg ...
-
- pathName tag cell tagName index ...
-
- pathName tag cget tagNameoption
-
- pathName tag col tagName col ...
-
- pathName tag configure tagName option value option value ...
-
- pathName tag delete tagName
- pathName tag exists tagName
-
- pathName tag includes tagNameindex
-
- pathName tag names pattern
-
- pathName tag row tagName row ...
-
- pathName validateindex
-
- pathName width col value col value ...
-
- pathName window option arg arg ...
-
- pathName window cget index option
-
- pathName window configureindex option value option value ...
-
- pathName window deleteindex index ...
- pathName window move indexFrom indexTo
- pathName window names pattern
- pathName xview args
- pathName xview pathName xview index pathName xview moveto fraction pathName xview scroll numberwhat
-
- pathName yviewargs
-
- pathName xview
-
- pathName yview index
-
- pathName yview moveto fraction
-
- pathName yview scroll number what
-
- [1] .. . .. . [2] .., , . , .., . [3] .., "", . [4] Home . [5] End . [6] Control-Home . [7] Control-End . [8] Shift-Control-Home . [9] Shift-Control-End . [10] . [11] Shift-<arrow> , . [12] Control-leftarrow
-Control-rightarrow . [13] Control-slash . [14] Control-backslash clears . [15] Backspace . [16] Delete . [17] Escape , , . [18] Control-a . [19] Control-e . [20] Control-minus Control-equals , . [21] .. / , (
-resizeborders). -selectionmode. -state, , - , . . tkTable.tcl. Создание текстового примитива и управление им. Подробное описание этих параметров приведено в разделе
- options. Задает желаемую высоту окна в символах; размер символа
- определяется шрифтом, который задан параметром -font. Значение параметра должно быть не меньше
- единицы. Запрашивает дополнительный промежуток перед каждой строкой
- текста в примитиве (в любой из разрешенных форм для расстояний
- на экране). При переносе строки заданное значение относится
- только к первой строчке на экране. Параметр
- -spacing1 в тегах подавляет данный. Задает величину дополнительного промежутка между двумя
- последовательными строчками на экране, полученными в результате
- переноса одной строки текста (в любой из разрешенных форм для
- расстояний на экране). Параметр spacing2 в
- тегах подавляет данный. Запрашивает дополнительный промежуток после каждой строкой
- текста в примитиве (в любой из разрешенных форм для расстояний
- на экране). При переносе строки заданное значение относится
- только к последней строчке на экране. Параметр
- -spacing3 в тегах подавляет данный. Задает одно из двух состояний текста: нормальное
- (normal) или недоступное
- (disabled). Текст, находящийся в недоступном
- состоянии, нельзя редактировать и в нем не отображается курсор
- ввода, даже если данный примитив находится в фокусе ввода. Задает набор положений табулятора в окне. Значение параметра
- представляет собой список расстояний на экране, задающих эти
- положения. Элемент списка, следующий за элементом, который
- указывает очередное положение табулятора, может описывать способ
- расположения текста относительно этого положения с помощью
- ключевых слов left, right,
- center или numeric. Значение
- по умолчанию равно left; в этом случае левый
- край текста, следующего за символом табуляции, располагается в
- позиции табуляции. Right означает, что в
- позиции табуляции располагается правый край текста, следующего
- за символом табуляции, а center указывает на
- необходимость центрировать текст относительно позиции
- табуляции. Numeric означает, что в позиции
- табуляции следует располагать десятичную точку текста; если в
- тексте нет десятичной точки, то младшая значащая цифра числа
- располагается непосредственно слева от позиции табуляции; если в
- тексте нет чисел, то он выравнивается вправо по позиции
- табуляции. Например, задание параметра -tabs {2c left
- 4c 6c center} приводит к созданию трех позиций
- табулятора с двухсантиметровым интервалом, первые два из которых
- используют выравнивание влево, а третья выравнивание по
- центру. Если в списке положений табулятора их оказывается
- недостаточно, чтобы обеспечить все символы табуляции в строке
- текста, то Tk создает дополнительные позиции табуляции,
- экстраполируя промежуток и способ выравнивания текста, указанные
- последним элементом списка. Параметр -tabs в
- тегах подавляет данный. Если параметр -tabs не
- задан или его значением является пустая строка, то Tk использует
- табуляцию по умолчанию с шагом, равным восьми символам среднего
- размера. Задает желаемую ширину окна в символах; размер символа
- определяется шрифтом, который задан параметром -font. Если
- ширина символа в шрифте непостоянна, то для перевода числа
- символов в единицы экрана используется ширина символа "0".
- Задает способ обращения с чересчур длинными строками, которые
- не помещаются в одной строчке экрана. Может принимать одно из
- значений none, char или
- word. Значение none указывает
- на то, что каждая строка текста отображается в единственной
- строчке экрана не поместившиеся символы не выводятся. В
- остальных двух режимах при необходимости осуществляется перенос
- каждой строки текста, чтобы все ее содержимое отображалось на
- экране. В режиме char переход на новую строчку
- можно осуществлять после любого символа; в режиме
- word перенос строки выполняется только после
- конца слова. Команда text создает новое окно (задаваемое
- аргументом имяПути) и превращает его в текстовый
- примитив. Детали изображения текста, такие как цвет фона по
- умолчанию и объемный вид, задаются с помощью описанных выше
- дополнительных параметров. Команда text
- возвращает имя пути нового окна. Текстовый примитив предназначен для вывода одной или нескольких
- строк текста и для редактирования этого текста. Текстовые
- примитивы поддерживают четыре способа отметить часть текста так
- называемые теги, метки, вставленные окна и вставленные
- изображения. Теги позволяют выводить различные части текста
- различными шрифтами и цветом. Кроме того с тегами можно связать
- команды Tcl, которые будут выполняться каждый раз при совершении
- определенных действий, например, при нажатиях на клавиши
- клавиатуры и "Мыши", если курсор находится в определенной части
- текста. Подробно эти возможности описаны ниже (см. "Теги"). Метки представляют собой другой способ отметить часть
- текста. Они предназначены для указания на различные интересные
- места в тексте, возникающие в процессе его
- редактирования. Подробно эти возможности описаны ниже
- (см. "Метки"). Третий способ обеспечивает возможность вставки в текст
- произвольных окон. Подробно эти возможности описаны ниже
- (см. "Вставленные
- окна"). Четвертый способ обеспечивает возможность вставки в текст
- изображений Tk. Подробно эти возможности описаны ниже
- (см. "Вставленные
- изображения".) Аргументами многих команд примитива являются один или несколько
- индексов. Индекс представляет собой строку, указывающую
- конкретное место в тексте например, место вставки текста или
- один из граничных символов удаляемого участка текста. Индексы
- имеют следующий синтаксис: База это указатель начальной точки, а
- модификаторы указывают сдвиг от начальной точки
- (например, на один символ влево или вправо от базы). База
- является обязательной частью индекса, а модификаторы
- необязательной. База индекса должна быть представлена в одном из
- следующих видов: Если вид базы не определяется однозначно (так, например, если
- метка и имяИзобр имеют одинаковое значение, то
- их нельзя различить), то предпочтение отдается виду,
- встречающемуся в приведенном списке раньше. Если за индексом
- базы идут модификаторы, то каждый из них должен быть представлен
- в одном из описанных ниже видов. Ключевые слова, например,
- chars или wordend, можно
- сокращать, если результат сокращения позволяет однозначно
- восстановить слово. Если в команде задано несколько модификаторов, то они
- применяются слева направо. Так, например, индекс
- "end-1 chars" указывает на
- предпоследний символ в тексте, а индекс "insert
- wordstart-1 c" указывает на символ,
- непосредственно предшествующий первому символу в слове,
- содержащем символ с текущим значением индекса. Участки текста можно помечать с помощью тегов. Тег представляет
- собой символьную строку, которая привязана к некоторым символам
- текста. В принципе теги могут содержать любые символы, однако
- использования символов " " (пробел), "+"
- и "-" лучше избегать: это специальные символы
- индексов и использование тега, в котором присутствуют такие
- символы, в качестве индекса невозможно. С символами данного
- текста можно связать произвольное количество тегов. Каждый тег
- может относиться к одному символу, последовательности символов
- или к нескольким последовательностям символов. С отдельным
- символом может быть связано произвольное количество тегов. Все теги упорядочены; на этот порядок опираются некоторые из
- описываемых ниже функций работы с тегами. При определении тега
- (путем связывания его с символами, или при установке параметров
- его представления на экране, или при привязке к нему команд) он
- получает более высокий приоритет, чем все существующие
- теги. Приоритетный порядок тегов можно изменить с помощью команд
- примитива "имяПути tag
- raise" и "имяПути tag
- lower". В текстовых примитивах теги служат для достижения трех
- целей. Во-первых, они управляют отображением информации на
- экране. По умолчанию способ отображения текста определяется
- значениями параметров background,
- font и foreground текстового
- примитива. Однако команда примитива "имяПути
- tag configure" позволяет связать с каждым тегом
- свои значения параметров отображения. Если с символом связан
- тег, то значения параметров отображения для этого тега подавляют
- значения по умолчанию. В настоящее время для тегов можно
- пользоваться следующими параметрами: Если с символом связано несколько тегов, причем задаваемые ими
- параметры вывода противоречат друг другу, то используются
- значения параметров тегов с наивысшим приоритетом. Если
- некоторый параметр вывода для конкретного тега не задан или если
- его значением является пустая строка, то этот параметр при
- выводе не используется; вместо него берется параметр тега со
- следующим приоритетом. Если ни один из тегов не определяет
- параметра вывода, то используется стиль, принятый для данного
- примитива по умолчанию. Во-вторых, теги служат для привязки событий. Привязки к тегу
-осуществляются практически таким же образом, как и привязки к
- классу примитива: заданная команда Tcl исполняется всякий раз,
- когда на символе с данным тегом происходит указанное событие. С
- помощью привязок к тегам можно задать поведение групп символов;
- помимо прочего таким образом можно реализовать некоторые
- свойства гипертекста. Подробное описание этих возможностей
- см. ниже в описании команды примитива tag
- bind. Третья задача тегов обеспечивать управление выделениями
- (См. "Выделение" ). Метки представляют собой другой способ отмечать части
- текста. Они служат для запоминания фиксированных мест в
- тексте. Метки похожи на теги в том, что они поименованы и
- ссылаются на определенные места в тексте, однако они не связаны
- ни с какими конкретными символами. Напротив, метка указывает на
- промежуток между двумя символами. В каждый момент времени метка
- указывает в точности на одно положение. При удалении символов,
- окружающих положение метки, сама метка сохраняется, меняются
- лишь ее соседи. Теги же теряют привязку к символам при удалении
- этих символов. Для работы с метками предназначена команда
- примитива "имяПути mark";
- имя метки можно использовать в качестве индекса в командах
- примитива этот индекс указывает на текущее положение метки. Каждой метке приписывается притяжение, которое может
- принимать значения left и
- right. Притяжение определяет поведение метка
- при вводе текста в положении метки. При левом притяжении метка
- ведет себя, как если бы она была приписана к символу слева от
- нее; такая метка будет оставаться слева от вновь вводимого
- текста. Для метки с правым притяжением вновь вводимый текст
- окажется слева от нее. По умолчанию притяжение имеет значение
- right. Пространства имен меток и тегов различны: одинаковые имена
- могут использоваться для метки и тега; при этом они будут
- ссылаться на различные объекты. У двух меток есть особый смысл. Метка insert
- связана с курсором ввода; см. описание ниже (см. "Курсор ввода"). Метка
- current связана с символом, ближайшим к курсору
- "Мыши", ее положение меняется автоматически при
- изменении позиции курсора и любых изменениях текста в примитиве
- (с одним исключением: метка current не
- обновляется в ответ на изменение положения курсора при нажатой
- клавише "Мыши"; обновление откладывается до момента,
- когда все клавиши "Мыши" будут отпущены). Ни одну из
- этих двух специальных меток нельзя удалить. Вставленное окно это третий тип ссылок в текстовом
- примитиве. Ссылка на вставленное окно приводит к появлению окна
- в заданном месте текста. В текстовом примитиве может быть любое
- количество вставленных окон; в качестве вставленного окна может
- быть использован любой примитив (при соблюдении обычных
- ограничений управления геометрией, согласно которым текстовое
- окно должно быть непосредственным предком вставленного окна или
- потомком этого предка). Положение вставленного окна меняется
- при редактировании или прокрутке текста; окно выводится или
- стирается в зависимости от того, попадает ли оно в видимую часть
- текста. Вставленное окно считается одним символом в индексном
- пространстве текстового примитива; на него можно сослаться либо
- по имени текстового окна, либо по значению индекса в индексном
- пространстве. При удалении области текста, содержащей
- вставленное окно, оно разрушается. При добавлении в текстовый примитив вставленного окна с помощью
- команды примитива window create с ним можно
- связать несколько параметров конфигурации. Значения этих
- параметров можно впоследствии изменить командой примитива
- window configure. В настоящее время
- поддерживаются следующие параметры: Последним видом пометок в текстовых примитивах являются
- вставленные изображения. Такая пометка приводит к выводу
- изображения в заданном месте текста. В текстовом примитиве может
- присутствовать произвольное количество вставленных изображений,
- а одно и то же изображение может вставляться в произвольном
- количестве мест в тексте. Положение вставленного изображения
- меняется при редактировании или прокрутке текста. Вставленное
- изображение считается одним символом в индексном пространстве
- текстового примитива; на него можно сослаться либо по значению
- индекса в индексном пространстве, либо по имени, которое оно
- получает при создании командой image create. При
- удалении области текста, содержащей вставленное изображение,
- данная его копия стирается с экрана. При добавлении в текстовый примитив вставленного изображения с
- помощью команды примитива image create
- команда возвращает уникальное имя данного вхождения изображения
- в текст. Это имя в дальнейшем можно использовать для ссылок на
- вхождение изображения. Имя совпадает со значением параметра
- -name (см. ниже). Если параметр
- -name не задан, то вместо него используется имя
- -image. Если значение имяИзобр уже
- использовано в примитиве, то к нему дописываются символы
- #nn, где nn произвольное целое число. Таким
- образом обеспечивается уникальность имени. После присвоения
- имени данному вхождению изображения это имя в дальнейшем не
- меняется, несмотря на то, что значения параметров
- -image и -name можно поменять
- с помощью команды image
- configure. При добавлении в текстовый примитив вставленного изображения с
- помощью команды примитива image create с ним
- можно связать несколько параметров конфигурации. Значения этих
- параметров можно впоследствии изменить командой примитива image
- configure. В настоящее время поддерживаются
- следующие параметры: Выделение реализуется с помощью тегов. Если параметр
- exportSelection текстового примитива имеет
- значение истина, то с выделением ассоциируется тег
- sel:
-
- Тег sel определяется автоматически при
- создании текстового примитива; его нельзя удалить командой
- примитива "имяПути tag
- delete". Кроме того параметры
- selectBackground,
- selectBorderWidth и
- selectForeground текстового примитива связаны с
- параметрами -background,
- -borderwidth и -foreground
- тега sel: изменение одного из этих параметров
- примитива автоматически вызывает изменение соответствующего
- параметра тега и наоборот. Метка с именем insert имеет в текстовых
- примитивах специальное значение. Она определяется автоматически
- при создании примитива и ее нельзя отменить командой примитива
- "имяПутиmark unset". Метка
- insert задает положение курсора ввода; курсор
- ввода отображается в этом положении всякий раз, когда текстовый
- примитив попадает в фокус ввода. Команда text создает новую команду Tcl, имя
- которой совпадает с именем текстового окна. С помощью этой
- команды можно выполнять различные операции над примитивом. Ее
- общий вид имяПути является именем команды; оно совпадает с
- именем пути текстового примитива. Параметр и аргументы уточняют
- поведение команды. Текстовые примитивы допускают следующие формы
- команды: Возвращает содержимое текстового примитива от символа с
- индексом индекс1 до символа с индексом
- индекс2 (не включая последний), включая сам текст,
- а также информацию о метках, тегах и вставленных окнах. Если
- параметр индекс2 не задан, то по умолчанию
- описывается символ с индексом индекс1. Возвращаемая
- информация имеет следующий формат: Ключи могут принимать значения text,
- mark, tagon,
- tagoff и
- window. Соответствующими возвращаемыми
- значениями будут текст, имя метки, имя тега или имя
- окна. Возвращаемыми значениями индекса будут индекс начала
- текста, метки, тегового перехода или окна. Для управления
- результатом можно использовать один или несколько из
- следующих переключателей (или их аббревиатур): Команда предназначена для управления вставленными
- изображениями. Поведение команды определяется значением
- аргумента параметр. В настоящее время поддерживаются
- следующие формы команды: Эта команда предназначена для работы с
- метками. Поведение команды определяется значением
- аргумента параметр. В настоящее время
- поддерживаются следующие формы команды: Команда используется для сканирования текстов. Она
- может иметь один из двух видов в зависимости от значения
- параметра: Ищет в примитиве с именем имяПути текст
- подходящий под образец, начиная с символа с индексом
- индекс. Если подходящая последовательность символов найдена,
- то команда возвращает в качестве результата индекс первого
- символа в этой последовательности; в противном случае
- возвращает пустую строку. Для управления поиском можно
- задать один или несколько из описываемых ниже переключателей
- (или их аббревиатур): Вся подходящая последовательность должна содержаться в
- одной строке текста. Перед сопоставлении с регулярным
- выражением из текста удаляются все символы перевода
- строки. Для поиска соответствия такому символу можно
- воспользоваться служебным символом .$. в регулярных
- выражениях. Для точных соответствий переводы строк
- сохраняются. Если задан аргумент индексСтоп, то
- поиск прекращается по достижении символа с этим индексом:
- для поиска вперед не будут рассматриваться соответствия,
- начинающиеся на символе с этим индексом или позднее, для
- поиска назад не рассматриваются соответствия, начинающиеся
- раньше указанного индекса. Если аргумент
- индексСтоп опущен, то поиск осуществляется по
- всему тексту: по достижении одного из краев текста поиск
- продолжается, начиная с другого края, до тех пор пока не
- будет снова достигнуто исходное положение. Если аргумент
- индексСтоп задан, то перескакивания на
- противоположный край текста не происходит. Эта команда используется для работы с тегами. Ее поведение
- определяется значением аргумента параметр. В
- настоящее время поддерживаются следующие формы команды: Эта команда приписывает скрипт к тегу с именем
- имяТега. При наступлении последовательности
- событий, заданной аргументом послед, на
- символе, к которому приписан тег с именем
- имяТега , выполняется указанный
- скрипт. Эта команда примитива похожа на
- команду bind; единственное ее
- отличие состоит в том, что она действует на символах,
- а не на всем примитиве. Полное описание синтаксиса
- последовательности и подстановок, производимых в
- скрипте перед его выполнением, см. в п. 1.3. Если
- указаны все аргументы, то создается новая привязка,
- заменяющая все предыдущие привязки данной
- последовательности к тегу имяТега (если
- первым символом аргумента скрипт является
- "+", то скрипт присоединяется к текущей
- привязке, а не замещает ее). В этом случае команда
- возвращает пустую строку. Если аргумент
- скрипт опущен, то команда возвращает скрипт,
- привязанный к тегу имяТега (при отсутствии
- такого скрипта возникает ошибка). Если опущены и
- аргумент скрипт, и аргумент послед,
- то команда возвращает список всех последовательностей,
- привязки к которым определены для тега с именем
- имяТега. Привязки можно определять только для событий,
- связанных с "Мышью" и клавиатурой (например,
- Enter, Leave,
- ButtonPress, Motion
- и KeyPress), или для виртуальных
- событий. Привязки событий для текстового примитива
- используют текущую метку (см. "Метки"). Событие
- Enter наступает для тега при первом
- появлении этого тега на текущем символе, а событие
- Leave наступает, когда текущий символ
- оказывается несвязанным с данным тегом. События
- Enter и Leave могут
- наступить либо в результате перемещения текущей метки,
- либо как следствие изменения символа в позиции текущей
- метки. Обратите внимание на то, что эти события
- отличаются от событий Enter и
- Leave для окон. События, связанные с
- "Мышью" и клавиатурой, направлены на текущий
- символ. Если в привязке используется виртуальное
- событие, то оно может наступить только в случае если
- для его определения был использован выход с
- подчеркиванием, связанный с "Мышью" или
- клавиатурой. К текущему символу может быть приписано много тегов,
- причем каждый из этих тегов может иметь привязку для
- одной и той же последовательности событий. В таком
- случае исполняется по одной привязке к каждому из
- тегов в порядке от наименьшего приоритета к
- наибольшему. Если к одному тегу подходят несколько
- образцов привязок, то выбирается самая конкретная из
- них (подробности приведены в п. 1.3). Команды continue
- и break в скрипте привязки обрабатываются так же, как
- и в случае привязок, созданных командой bind. Если есть привязки и к примитиву в целом (созданные с
- помощью команды bind), то они
- служат дополнением привязок к тегам. Сначала
- выполняются привязки к тегам, а затем привязки ко
- всему примитиву. Команда используется для работы со вставленными
- окнами. Поведение команды зависит от значения аргумента
- параметр. В настоящее время поддерживаются
- следующие формы команды: Команда используется для запроса горизонтального положения
- текста в окне примитива и изменения этого положения. Она
- может принимать одну из следующих форм: Команда используется для запроса вертикального положения
- текста в окне примитива и изменения этого положения. Она
- может принимать одну из следующих форм: Сдвигает содержимое окна примитива таким образом,
- чтобы сделать видимым символ с индексом
- индекс. Если аргумент
- -pickplace не задан, то символ с
- указанным индексом появляется в верхней строчке
- экрана. Если же этот аргумент задан, то примитив
- определяет место появления символа на экране по
- следующему правилу: Параметр -pickplace устарел после
- введения команды примитива see,
- которая управляет движениями как в горизонтальном, так
- и в вертикальном направлении, в то время, как
- -pickplace влияет только на движение
- по вертикали. Tk автоматически создает привязки класса, которые определяют
- следующее поведение текстовых примитивов по умолчанию. В
- приводимом ниже описании "слово" это непрерывная
- последовательность символов, состоящая из букв, цифр и символов
- подчеркивания "_", либо из любого другого одиночного
- символа. Текстовые примитивы должны обрабатываться эффективно при самых
- разнообразных условиях. В них используется 2-3 байта основной
- памяти на каждый символ текста, поэтому текст длиной 1 Мегабайт
- и более вполне может эффективно обрабатываться на большинстве
- рабочих станций. Внутреннее представление текста имеет вид
- модифицированного B-дерева, поэтому обработка даже длинных
- текстов довольно эффективна. Реализация меток также позволяет
- использовать много меток. В большинстве случаев удобно
- пользоваться большим числом уникальных тегов или тегом,
- приписанным к большому числу различных частей текста. Проблема эффективности может возникнуть при использовании
- сотен или тысяч различных тегов со следующими характеристиками:
- первая часть текста, приписанная к каждому тегу, начинается
- вблизи начала текста, а последняя кончается вблизи его конца или
- имеется единственная такая часть, включающая в себя почти весь
- текст. Цена добавления или удаления таких тегов пропорциональна
- числу тегов с такими свойствами. Напротив, тысячи различных
- тегов обрабатываются эффективно, если области их действия
- невелики и равномерно распределены по всему тексту. Эффективность может понижаться при наличии очень длинных
- строк текста, содержащих большое число меток и тегов. При каждом мигании курсора ввода строчка экрана, на которой он
- находится, перерисовывается целиком, что приводит к постоянному
- потоку графической информации. Для устранения этого эффекта
- установите атрибут insertOffTime в
- "0". Управляет внутренним состоянием Tk. Команда tk обеспечивает доступ к различным
- элементам внутреннего состояния Tk. Большая часть информации, с
- которой работает команда, относится к приложению в целом или к
- экрану или дисплею, а не к конкретному окну. Команда может
- принимать одну из нескольких форм в зависимости от значения
- аргумента параметр. Допустимы следующие формы: Устанавливает коэффициент масштабирования, используемый
- Tk, при переводе физических единиц (например, точки, дюймы
- или миллиметры) в пиксели, и запрашивает текущее значение
- коэффициента. Аргумент число представляет собой
- число с плавающей точкой, которое задает число пикселей в
- точке на экране. Если аргумент окно опущен, то его
- значением по умолчанию является главное окно. Если опущен
- аргумент число, то команда возвращает текущее
- значение коэффициента масштабирования. "Точка" это единица измерения, равная 1/72
- дюйма. Коэффициент масштабирования 1.0 соответствует одному
- пикселу на точку стандартному 72 dpi (точек на дюйм)
- монитору. Коэффициент масштабирования 1.25 соответствует
- 1.25 пикселю на точку, т.е. стандартному значению для
- монитора 90 dpi; установка коэффициента 1.25 для 72 dpi
- монитора увеличивает изображение всех элементов приложения в
- 1.25 раз по сравнению с нормальным. Исходное значение
- коэффициента устанавливается при запуске приложения на
- основании характеристик монитора, однако его можно изменить
- в любой момент. Все измерения, выполняемые после установки
- коэффициента, будут использовать его новое значение, однако
- будут ли существующие примитивы динамически меняться,
- подстраиваясь под новое значение коэффициента, предсказать
- нельзя. Модифицирует цветовую палитру Tk. Процедура tk_setPalette изменяет цветовую
- схему Tk. Это происходит за счет изменения цветов в существующих
- примитивах и внесения изменений в базу данных параметров, в
- результате чего будущие примитивы будут пользоваться новой
- цветовой схемой. При выполнении команды
- tk_setPalette с единственным аргументом, этим
- аргументом является имя цвета, который становится нормальным
- цветом фона; процедура tk_setPalette вычисляет
- всю палитру цветов на основе этого цвета фона. Если же аргументы
- команды tk_setPalette включают несколько пар
- имя-значение, то имя это имя параметра, а второй
- элемент пары представляет собой новое значение параметра. В
- настоящее время поддерживаются следующие имена параметров в базе
- данных: Процедура tk_setPalette пытается вычислить
- разумные значения по умолчанию для любого незаданного
- параметра. Можно указать и параметры, отличные от приведенных
- выше, и Tk изменит значения и этих параметров. Такая возможность
- полезна при использовании специальных примитивов с
- дополнительными цветовыми параметрами. После того, как новое значение каждого из цветовых параметров
- вычислено, tk_setPalette просматривает иерархию
- примитивов, чтобы изменить значения параметров всех существующих
- примитивов. Для каждого примитива она проверяет, определен ли
- для него какой-либо из заданных параметров. Если это так и если
- текущее значение параметра совпадает со значением по умолчанию,
- то это значение заменяется новым; если же текущее значение
- отлично от значения по умолчанию, то
- tk_setPalette не изменяет его. Значением
- параметра по умолчанию является то, которое порождено примитивом
- ([lindex [ configure ] 3]) или, если
- процедура tk_setPalette выполнялась и раньше,
- то значение, установленное ее предыдущим выполнением. После модификации всех примитивов в приложении
- tk_setPalette добавляет параметры в базу данных
- параметров, изменяя значения по умолчанию для будущих
- примитивов. Новые параметры добавляются с приоритетом
- widgetDefault, поэтому они будут подавлены параметрами из файла
- .Xdefaults или параметрами, заданными в
- командной строке, создающей примитив. Процедура tk_bisque обеспечивает совместимость
- с предыдущими версиями: она задает схему "bisque" на
- основе светло-коричневого (бисквитного) цвета, которая
- использовалась в Tk 3.6 и более ранних версиях. Открывает диалоговое окно для выбора цвета пользователем. Процедура tk_chooseColor открывает диалоговое
- окно для выбора цвета пользователем. В строке аргументов
- допустимы следующие пары параметр-значение: При выборе пользователем цвета tk_chooseColor
- возвращает имя цвета в виде, приемлемом для
- Tk_GetColor. Если пользователь прерывает
- операцию, то обе команды возвращают пустую строку. tk_chooseDirectory - команда выводит
- стандартный диалог выбора директории. Процедура tk_chooseDirectory открывает
- диалоговое окно для выбора пользователем директории. В качестве аргументов допустимы следующие значения: tk_getOpenFile,
- tk_getSaveFile
- Создает окно модального диалога и ожидает ответа. Эта процедура является частью библиотеки скриптов Tk. Ее
- аргументы описывают диалоговое окно: После создания диалогового окна процедура
- tk_dialog ожидает, пока пользователь выберет
- одну из кнопок либо щелкнув по ней .Мышью., либо нажав на
- клавишу Return, чтобы выбрать значение по
- умолчанию (если такое есть). Затем процедура возвращает номер
- выбранной кнопки: 0 для самой левой кнопки, 1 для соседней с
- ней и т.д. Если окно диалога уничтожено до того, как
- пользователь выбрал одну из кнопок, то процедура возвращает
- -1. В ожидании ответа пользователя tk_dialog
- производит локальный захват. В результате пользователь может
- взаимодействовать только с окном диалога. Утилиты служат для управления фокусом ввода. Процедура tk_focusNext возвращает имя
- следующего после window окна в очередности фокусов,
- который определяется очередью стека окон и структурой иерархии
- окон. Процедура tk_focusPrev противоположна по
- действию процедуре tk_focusNext: она возвращает
- имя предыдущего окна. Утилита tk_focusFollowsMouse переводит фокус в
- то окно, над которым в данный момент находится курсор
- "Мыши". Открывает окно диалога, в котором пользователь должен выбрать
- файл для того, чтобы открыть его. Процедура tk_getOpenFile открывает окно
- диалога, в котором пользователь должен выбрать файл для того,
- чтобы открыть его. Команда tk_getOpenFile обычно выполняется при
- вызове команды Open из меню
- File. Она позволяет лишь выбрать один из
- существующих файлов. Если пользователь вводит имя
- несуществующего файла, то окно диалога информирует его об ошибке
- и предлагает сделать другой выбор. Если приложение позволяет
- пользователю создавать файлы, то для этой цели должна быть
- предназначена специальная команда меню New. В качестве пар аргумент-значение в командной строке
- этих двух команд допускаются следующие варианты: После того, как пользователь выбрал файл, команда
- tk_getSaveFile возвращают полное имя пути к этому
- файлу. Если пользователь прерывает выполнение операции, то обе
- команды возвращают пустую строку. Значение списокТиповФайлов параметра
- -filetypes представляет собой список образцов
- типов файлов. Каждый из образцов это список вида
-
- имяТипа это имя типа файлов; его значение это
- текстовая строка, которая попадает в список типов
- файлов. расширение это одно из расширений для файлов данного
- типа. макТип это четырехсимвольный тип файлов на
- платформе Макинтош. Список макТипов необязателен, и для
- приложений, которые не планируется использовать на платформе
- Макинтош, его можно опустить. Одно и то же имяТипа может встречаться в нескольких
- образцах; в этом случае все они описывают файлы одного типа и им
- соответствует одна строка в списке типов. При выборе такой
- строки в списке выводится список всех файлов, имена которых
- подходят хотя бы под один образец. Обычно каждому типу файлов
- соответствует в точности один образец. Использование нескольких
- образцов необходимо лишь для платформы Макинтош. На платформе Макинтош файл подходит под образец, если
- расширение его имени совпадает по крайней мере с одним из
- расширений И оно имеется по крайней мере в одном из значений
- параметра макТип в образце. Например, под образец
- исходных файлов на языке C подходят файлы с расширением
- .c И с макТипом TEXT. Для того, чтобы заменить
- конъюнкцию И дизъюнкцией ИЛИ, нужно вместо одной строки
- образца завести две строки, в одной из которых есть только
- расширения, а в другой только макТипы. Под образец
- файлового типа GIF подходят файлы с расширением
- .gif ИЛИ имеющие макТип GIFF. На платформах Unix и Windows файл подходит под образец
- файлового типа, если расширение его имени соответствует одному
- из расширений в образце. макТипы игнорируются. На платформах Unix и Macintosh соответствие образцам
- устанавливается обычным образом. На платформах Windows
- соответствие образцам устанавливается операционной
- системой. Возможными расширениями могут быть: Ввиду того, что на различных платформах используются различные
- правила соответствия, появление символов маски в расширениях не
- допускается, за исключением специального расширения
- "*". Расширения, в которых нет точки (например,
- "~"), допустимы, но они могут работать не на всех
- платформах. Открывает окно диалога, в котором пользователь должен выбрать
- файл для того, чтобы открыть или сохранить его. Процедура tk_getSaveFile открывает окно
- диалога, в котором пользователь должен выбрать файл для того,
- чтобы сохранить его. Команда tk_getSaveFile обычно связана с
- командой SaveAs меню File. При
- входе пользователя в уже существующий файл окно диалога
- предлагает пользователю подтвердить, что старый файл следует
- затереть. В качестве пар аргумент-значение в командной строке
- этих двух команд допускаются следующие варианты: После того, как пользователь выбрал файл, команда
- tk_getSaveFile возвращают полное имя пути к
- этому файлу. Если пользователь прерывает выполнение операции, то
- обе команды возвращают пустую строку. Значение списокТиповФайлов параметра
- -filetypes представляет собой список образцов
- типов файлов. Каждый из образцов это список вида имяТипа это имя типа файлов; его значение это
- текстовая строка, которая попадает в список типов
- файлов. расширение это одно из расширений для файлов данного
- типа. макТип это четырехсимвольный тип файлов на
- платформе Макинтош. Список макТипов необязателен, и для
- приложений, которые не планируется использовать на платформе
- Макинтош, его можно опустить. Одно и то же имяТипа может встречаться в нескольких
- образцах; в этом случае все они описывают файлы одного типа и им
- соответствует одна строка в списке типов. При выборе такой
- строки в списке выводится список всех файлов, имена которых
- подходят хотя бы под один образец. Обычно каждому типу файлов
- соответствует в точности один образец. Использование нескольких
- образцов необходимо лишь для платформы Макинтош. На платформе Макинтош файл подходит под образец, если
- расширение его имени совпадает по крайней мере с одним из
- расширений И оно имеется по крайней мере в одном из значений
- параметра макТип в образце. Например, под образец
- исходных файлов на языке C подходят файлы с расширением
- .c И с макТипом TEXT. Для того, чтобы заменить
- конъюнкцию И дизъюнкцией ИЛИ, нужно вместо одной строки
- образца завести две строки, в одной из которых есть только
- расширения, а в другой только макТипы. Под образец
- файлового типа GIF подходят файлы с расширением
- .gif ИЛИ имеющие макТип GIFF. На платформах Unix и Windows файл подходит под образец
- файлового типа, если расширение его имени соответствует одному из
- расширений в образце. макТипы игнорируются. На платформах Unix и Macintosh соответствие образцам
- устанавливается обычным образом. На платформах Windows
- соответствие образцам устанавливается операционной
- системой. Возможными расширениями могут быть: Ввиду того, что на различных платформах используются различные
- правила соответствия, появление символов маски в расширениях не
- допускается, за исключением специального расширения
- "*". Расширения, в которых нет точки (например,
- "~"), допустимы, но они могут работать не на всех
- платформах. Устаревшие команды для управления меню. Команды использовались в Tk версии 3.6, и более ранних, для
- управления ниспадающими меню взаимодействия с ними при помощи
- клавиатуры. В настоящий момент команды остаются только для
- обеспечения совместимости с ранними версиями, и их не следует
- использовать в новых разработках. Выводит окно сообщения и ждет ответа пользователя. Эта процедура создает и выводит на экран окно сообщения, в
- котором находится определяемое приложением сообщение,
- пиктограмма и набор кнопок. Каждая из кнопок в окне сообщения
- отождествляется с уникальным символическим именем (см. параметры
- -type). После появления окна сообщения команда
- tk_messageBox ожидает, пока пользователь не
- выберет одну из кнопок. После того, как выбор сделан, команда
- возвращает символическое имя выбранной кнопки. Команда
- поддерживает следующие пары параметр-значение: Процедура создает меню-кнопку с защелкиванием (option
- menubutton) и ее меню. Команда создает меню-кнопку с защелкиванием по имени w и
- связанное с ней меню. Такое меню позволяет пользователю выбрать
- одно из значений, заданных аргументами value. Текущее
- выбранное значение присваивается глобальной переменной
- varName, а также отображается на кнопке в виде
- ярлыка. Для выбора нового значения следует щелкнуть .Мышью. на кнопке и
- в открывшемся меню выбрать значение. Также текущее значение
- можно изменить, присвоив переменной varName новое
- значение. Процедура открывает всплывающее меню. ОПИСАНИЕ
-
- Процедура выводит на дисплей всплывающее меню при помощи
- примитива меню menu в позиции, заданной аргументами
- x и y. Необязательный аргумент entry
- указывает индекс некоторой команды (входа) меню menu, к
- которой будет относиться выводимое меню. Команда обрабатывает фоновые ошибки. Данная команда обрабатывает фоновые ошибки и предназначена для
- обеспечения совместимости с ранними версиями Tk. В настоящей
- версии Tk ее функции исполняет команда bgerror. Поддержка
- команды tkerror может быть вскоре прекращена,
- поэтому рекомендуется в приложениях заменять эту команду на bgerror. Переменные, используемые или задаваемые Tk. Нижеследующие переменные используются Tk в разные моменты
- работы, или задаются им. Команда организует паузу до момента изменения значения переменной
- или закрытия окна. Команда ожидает наступления одного из нескольких событий, после
- этого она завершает работу без выполнения каких-либо
- действий. Если первый аргумент команды есть
- variable, то name есть имя глобальной
- переменной, и команда ожидает изменения значения этой
- переменной. Если первый аргумент команды есть
- visibility, то name есть имя окна, и
- команда ожидает изменения его состояния внешних параметров
- (visibility). Если первый аргумент команды есть
- window, то name есть имя окна, и
- команда ожидает закрытия этого окна. Создание примитива верхнего уровня и управление им. Подробное описание этих параметров приведено в разделе options. Этот параметр по смыслу совпадает со стандартным параметром
- background за исключением того, что его
- значением может являться и пустая строка. В последнем случае при
- выводе примитива не появляется ни фона, ни бордюра, и для них не
- используется ни одна из красок его палитры. Задает класс окна. Этот класс используется при запросах базы
- данных параметров о значениях других параметров примитива; а
- также при определении привязок. Параметр -class
- нельзя переопределить командой примитива
- configure. Задает палитру, используемую в окне. Значением параметра может
- быть либо new (и в этом случае для данного окна
- и его потомков создается новая палитра), либо имя другого окна
- (которое должно находиться на том же экране и иметь то же
- значение параметра -visual, что и
- имяПути). Если параметр -colormap не
- задан, то новое окно использует палитру экрана по
- умолчанию. Параметр -colormap нельзя
- переопределить командой примитива
- configure. Значение параметра должно быть булевским. Если его значение
- истина, то окно будет использоваться в качестве контейнера, в
- который будет вставляться некоторое другое приложение (например,
- можно вставить примитив верхнего уровня Tk с помощью параметра
- -use). Окно будет поддерживать соответствующие протоколы
- управления окнами, например, для обработки геометрических
- запросов. Параметр -container нельзя
- переопределить командой примитива
- configure. Задает желаемую высоту окна в любом виде, приемлемом для
- Tk_GetPixels. Если введенное значение
- неположительно, то место для окна вообще не запрашивается. Задает примитив меню, используемый в качестве полосы меню. На
- Macintosh полоса меню будет выведена вверху основного
- монитора. В Microsoft Windows и на всех платформах UNIX меню
- выводится поверх окна верхнего уровня как деталь оформления окна
- менеджером окон. Задает экран, на котором следует разместить новое окно. Может
- быть использовано произвольное допустимое имя экрана, в том
- числе и отличное от текущего. По умолчанию значением является
- имя текущего экрана. Параметр -screen является
- специальным и его нельзя переопределить командой примитива
- configure. Используется для вставки. Если значение параметра отлично от
- пустой строки, то оно должно быть идентификатором
- окна-контейнера, заданным в виде шестнадцатиричной строки, в том
- виде, в котором возвращает результат команда window
- id. Примитив верхнего уровня будет создаваться как
- непосредственный потомок указанного контейнера, а не корневого
- окна экрана. Если окно-контейнер содержится в приложении Tk, то
- оно должно быть либо рамкой, либо примитивом верхнего уровня,
- для которого задан параметр
- -container. Параметр -use
- нельзя переопределить командой примитива
- configure. Задает внешний вид окна в любом виде, приемлемом для
- Tk_GetVisual. Если параметр не задан, то
- используется его значение по умолчанию для экрана. Параметр
- -visual нельзя переопределить командой примитива
- configure. Задает желаемую ширину окна в любом виде, приемлемом для
- Tk_GetPixels. Если введенное значение
- неположительно, то место для окна вообще не запрашивается. Команда toplevel создает новый примитив
- верхнего уровня (задаваемый аргументом имяПути). Детали
- изображения примитива верхнего уровня, такие как цвет его фона и
- объемный вид, задаются с помощью описанных выше дополнительных
- параметров. Команда toplevel возвращает
- аргумент имяПути. Примитив верхнего уровня похож на рамку; отличие состоит в том,
- что он создается как окно верхнего уровня: его непосредственным
- X предком является корневое окна экрана, а не логический предок,
- определяемый именем пути. Основная задача примитива верхнего
- уровня служить контейнером для диалоговых окон и других наборов
- примитивов. Единственными параметрами вывода примитива верхнего
- уровня являются цвет его фона и необязательный трехмерный
- бордюр, который позволяет примитиву выглядеть выпуклым или
- вдавленным. Команда toplevel создает новую команду Tcl,
- имя которой совпадает с именем окна примитива верхнего уровня. С
- помощью этой команды можно выполнять различные операции над
- примитивом. Ее общий вид имяПути является именем команды, которое совпадает с
- именем пути примитива верхнего уровня. Параметр и
- аргументы уточняют поведение команды. Примитивы верхнего уровня допускают следующие команды: При создании примитива верхнего уровня никаких привязок не
- создается: эти примитивы не предполагаются интерактивными. Команда update обрабатывает события, находящиеся в
- состоянии ожидания, и обратные вызовы (idle callbacks). С помощью этой команды обновляется состояние приложения,
- поскольку при ее вызове обрабатываются все необработанные
- события и выполняются все асинхронные вызовы (idle
- callbacks). Если в команде задана опция idletasks, то новые события
- и ошибки не обрабатываются, но выполняются все асинхронные
- вызовы. Команду update idletasks удобно использовать
- тогда, когда нужно выполнить немедленно действия, которые обычно
- откладываются, например, обновить отображаемые на дисплее данные
- или окна. Большинство обновлений изображений на дисплее
- выполняются в виде фоновых вызовов, и эта команда обеспечит их
- выполнение. Однако, если изменения были вызваны событиями, они
- не будут выполнены немедленно. Команда update без опций полезна в тех случаях, когда во
- время долго выполняющихся вычислений необходимо обеспечить
- оперативную реакцию приложения на события, например, на действия
- пользователя. Вызов команды update и обеспечивает обработку
- таких событий. winfo -возвращает информацию об
- окне. Команда winfo позволяет получать информацию об
- окнах, созданных с помощью Tk. Команда имеет несколько
- допустимых форм в зависимости от указанных опций. Ниже
- перечислены допустимые формы команды: Команда взаимодействия с менеджером окон. ОПИСАНИЕ
-
-Команда wm предназначена для
-взаимодействия с менеджером окон и обеспечивает таким образом
-управление такими атрибутами окон, как заголовок, размеры и
-размещение, возможность изменять размер. Команда имеет несколько
-форм в зависимости от используемых опций. Во всех формах команда
-предполагает наличие по крайней мере одного аргумента имени toplevel окна.
-
- Ниже перечислены возможные формы команды.
- Если аргументы minNumer, minDenom, maxNume и maxDenom
-заданы, они передаются менеджеру
-окон, который использует их для определения допустимых пропорций
-окна. Пропорции (отношение ширина высота) могут быть в диапазоне
-от minNumer/minDenom до maxNumer/maxDenom. Если
-аргументы minNumer и т.д. определены как пустые строки, то
-существующие ограничения на пропорции отменяются. Если аргументы
-minNumer и т.д. заданы, то команда возвращает пустое
-значение. В противном случае она возвращает список из четырех
-элементов текущих значений minNumer, minDenom, maxNumer, и maxDenom
-(если ограничения не заданы, возвращается пустая строка).
- wm client window name wm colormapwindows window ?windowList? Эта команда используется для управления свойством
-WM_COLORMAP_WINDOWS, которое обеспечивает менеджер окон
-информацией об окнах, имеющих собственную палитру. Если аргумент
-windowListне задан, команда возвращает список окон,
-имеющих собственную палитру. Если аргумент задан, он представляет
-собой список полных имен окон. Команда изменяет старое значение
-свойства на новое и возвращает пустую строку. Список окон
-перечисляет внутренние окна, палитра которых отличается от
-палитры их логических предков. Порядок, в котором перечислены
-окна, указывает порядок, в котором менеджер окон просматривает
-окна, пытаясь разместить новые цвета в палитре. Не указанные в
-списке окна обрабатываются в последнюю очередь. Если команда не
-использовалась, Tk автоматически устанавливает свойство для
-каждого toplevel окна. В списке перечисляются все его внутренние
-окна, имеющие собственную палитру, в случайном порядке. В конце
-списка указывается само toplevel окно. Более подробно свойство
-WM_COLORMAP_WINDOWS описано в (1). wm command window value Если аргумент value задан, команда
-сохраняет его значение в свойстве окна WM_COMMAND, которое
-используется менеджером окон или менеджером сессий. В этом случае
-команда возвращает пустую строку. Аргумент value должен
-содержать список, элементы которого являются словами команды,
-используемой для запуска приложения (см. также wmuse). Если аргумент value не задан, команда возвращает последнее
-установленное ранее значение свойства. Если аргумент name
-определен как пустая строка, свойство окна WM_COMMAND
-удаляется. wm deiconify window Заставляет окно появиться на экране в нормальном
-виде (а не в виде иконки, например,). Если окно ранее не
-появлялось на экране, выполнение команды не приведет к его
-появлению, но она гарантирует, что если в будущем окно появится,
-оно появится в нормальном виде. Команда возвращает пустую
-строку. wm focusmodel windowactive|passive Если тип фокуса для (active или
-passive) окна указан в команде, он определяет какой тип
-фокуса будет использоваться. В этом случае команда возвращает
-пустую строку. Если тип фокуса не указан, команда возвращает
-текущее значение типа. Активный тип фокуса означает, что окно
-запрашивает фокус ввода себе или своим потомкам, даже если в этот
-момент фокус находится в другом приложении. Пассивный фокус
-означает, что окно не запрашивает фокус, а получает его от
-менеджера окон. Однако, после того, как окно или один из его
-потомков получил фокус, приложение может передать его другому
-потомку окна. По умолчанию устанавливает пассивный фокус. wm frame window Если окно заключено менеджером окон в
-декоративную рамку, команда возвращает идентификатор самой
-внешней рамки, которая содержит окно (окно, являющееся потомком
-корневого окна или виртуального корневого окна). Вид
-идентификатора зависит от платформы. Если окно не заключено в
-рамку, возвращается идентификатор окна, вид которого также
-зависит от платформы.
-
- wm geometry window newGeometry Если задан аргумент newGeometry, размеры и размещение
-окна изменяются, а команда возвращает пустую строку. В противном
-случае возвращается последняя информация о размерах и размещении
-окна (независимо от того, была ли она задана путем изменения
-размеров окна вручную или с помощью команды wm). Аргумент
-newGeometry должен быть задан в следующем виде
-=ширинаxвысота╠x╠y, где любая из частей
-=ширинаxвысота или ╠x╠y может быть опущена. Ширина
-и высота должны быть положительными целыми числами, задающими
-желаемый размер окна. Если для окна задана сетка
-(см. .Управление окнами с
-сеткой.), размеры указываются в шагах сетки. В противном
-случае размеры указываются в пикселях. X и Y определяют
-желаемое размещение окна на экране в пикселях. Если перед
-x стоит .+., то величина x определяет
-расстояние от левого края экрана до левого края окна, в противном
-случае x задает расстояние от правого края экрана до
-правого края окна. Если перед y стоит .+., то величина y
-определяет расстояние от верхнего края экрана до верхнего края
-окна, в противном случае y задает расстояние от низа
-экрана до нижнего края окна. Если аргумент newGeometry
-задан как пустая строка, текущие установленные пользователем
-размеры окна отменяются и окно приобретает размеры, определяемые
-размерами составляющих его виджетов. wm grid window baseWidth baseHeight widthInc heightInc Замечание. Потребность в использовании команды
-wm grid возникает относительно редко, поскольку той же
-функциональности поведения окна можно добиться, например, с
-помощью опции setGrid в командах создания виджетов. wm group window pathName Если аргумент pathName указан, окно
-pathName становится лидером группы для window.
-Менеджер окон использует эту информацию, например, для того,
-чтобы одновременно выводить с экрана все окна группы, если
-сворачивается лидер группы. Если аргумент pathName
-представлен пустой строкой, окно window выводится из
-состава группы. wm iconbitmap window bitmap Если аргумент bitmap задан, он определяет
-имя растрового образа, которое передается менеджеру окон для
-использования в качестве иконки. Имя образа может быть задано в
-одной из следующих форм: wm iconify window Команда сворачивает указанное окно. Если окно еще не было размещено на экран, оно появится, когда это произойдет, в виде иконки. wm iconmask window bitmap Если аргумент bitmap задан, он определяет
-имя растрового образа, которое передается менеджеру окон для
-использования в качестве маски для иконки. Там, где маска имеет
-значение .0., образ иконки не отображается; там, где маска имеет
-значение .1., маска рисуется. Имя образа может быть задано в
-одной из следующих форм: wm minsize window width height>
-
- wm overrideredirect window boolean wm positionfrom window who Если изменение размеров окна пользователем запрещено, то либо
-сохраняются те размеры окна, которые были получены в результате
-последнего выполненного пользователем изменения размеров, либо
-размеры окна устанавливаются с помощью команды wm geometry.
-Если этих действий не было, используются размеры
-окна, определяемые размерами составляющих его виджетов.
- По умолчанию toplevel-окна при появлении на
-экране имеют размеры, определяемые размерами составляющих его
-виджетов (.естественные. размеры). Если изменяются размеры или
-состав виджетов, то изменяется и размер toplevel-окна. Для
-toplevel-окна размеры, отличные от .естественных., могут быть
-заданы двумя способами. Первый пользователь может изменить
-размеры окна вручную, используя стандартные механизмы менеджера
-окон. Второй приложение может запросить изменение размеров окна с
-помощью команды wm geometry. Оба зти способа
-обрабатываются в Tk единообразно. Размеры окна изменяются на
-новые, отличные от .естественных.. Чтобы вернуть .естественные.
-размеры окна, нужно выполнить команду wm geometry с пустой
-строкой в качестве аргумента, задающего размеры и размещение окна.
-
- Обычно размеры окна могут изменяться произвольно в диапазоне
-от 1 пикселя до размеров экрана. Однако, с помощью команд wm
-minsize и wm maxsize можно изменить область
-возможных размеров окна. Эти ограничения будут использоваться при
-всех способах изменения размеров окна, в том числе и при ручном
-изменении, и при изменении размеров и состава его виджетов,
-приводящем к изменению его .естественных. размеров. С помощью
-команды wm resizable можно полностью запретить изменение
-размеров окна каким-либо способом в одном или в обоих направлениях. УПРАВЛЕНИЕ ОКНАМИ С СЕТКОЙ
-
- Окна с сеткой используются, если один из виджетов
-окна имеет ограниченное множество .разумных. размеров. Например,
-в текстовом редакторе, где полосы прокрутки, меню и т. д. имеют
-фиксированный размер, а поле редактирования текста может
-содержать произвольное число строк или букв в строке. В этом
-случае желательно дать пользователю возможность устанавливать
-непосредственно число строк или букв в строке при изменении
-размеров окна как вручную, так и с помощью команды wm
-geometry. Как в случае с текстом, так и в других аналогичных,
-.разумным. является не всякий размер окна в пикселях, а только
-размеры, соответствующие целому числу строк или букв в строке.
-
- Введение сетки обеспечивает механизм для реализации этих
-требований. Tk (и менеджер окон) предполагают существование сетки
-в окне, и что .разумными. являются только размеры, выраженные в
-целых шагах сетки, а не в произвольном числе пикселей. Обычно
-сетка устанавливается с помощью опции setGrid для
-соответствующего виджета. Она может также устанавливаться с
-помощью команды wm grid. В любом случае с помощью виджета
-или кода приложения определяются размеры окна в пикселях,
-соответствующие целым размерам в шагах сетки. Чтобы отменить
-сетку, нужно выполнить команду wm grid с пустой строкой, задающей сетку. Если сетка задана, все определения размеров в командах
-wm minsize, wm maxsize и wm geometry
-считаются заданными в шагах сетки, а не в пикселях. Ручное
-изменение размеров окна также производится в целых шагах сетки. Как оказалось, большинство существующих менеджеров окон имеют некоторые ошибки, которые проявляются при выполнении команды wm. Например, некоторые изменения не производятся в окне, если оно активно. Окно должно быть выведено с экрана и возвращено обратно, чтобы изменения выполнились.
-
-
-одна строка, содержащая название программы и краткое
-описание того, что она делает.
-(C) наименование (имя) автора 19гг
-
-Это свободная программа; вы можете повторно распространять ее и/или
-модифицировать ее в соответствии с Универсальной Общественной
-Лицензией GNU, опубликованной Фондом Свободного ПО; либо версии 2,
-либо (по вашему выбору) любой более поздней версии.
-
-Эта программа распространяется в надежде, что она будет полезной,
-но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемых гарантий
-КОММЕРЧЕСКОЙ ЦЕННОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ. Для
-получения подробных сведений смотрите Универсальную Общественную
-Лицензию GNU.
-
-Вы должны были получить копию Универсальной Общественной Лицензии
-GNU вместе с этой программой; если нет, напишите по адресу: Free
-Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
-02111-1307 USA
-
-Добавьте также сведения о том, как связаться с вами по электронной и
-обычной почте.
-
-
-Если программа интерактивная, сделайте так, чтобы при запуске в
-интерактивном режиме она выдавала краткое уведомление вроде следующего:
-
-
-
-Гномовизор, версия 69, (C) имя автора 19 гг
-Гномовизор поставляется АБСОЛЮТНО БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ;
-для получения подробностей напечатайте 'show w'. Это свободная
-программа, и вы приглашаетесь повторно распространять ее при
-определенных условиях; для получения подробностей введите 'show c'.
-
-
-Гипотетические команды 'show w' и 'show c' должны показывать
-соответствующие части Универсальной Общественной Лицензии. Конечно,
-используемые вами команды могут называться как-нибудь иначе, нежели
-`show w' и `show c'; они даже могут выбираться с помощью мыши
-или быть пунктами меню -- как больше подходит для вашей программы.
-
-
-Вы также должны добиться того, чтобы ваш работодатель (если вы работаете
-программистом) или ваше учебное заведение, если таковое имеется,
-подписали в случае необходимости "отказ от имущественных прав" на эту
-программу. Вот образец; замените фамилии:
-
-
-
-Компания ``Братья Ёёдины'' настоящим отказывается от всех
-имущественных прав на программу 'Гномовизор' (которая делает
-пассы в сторону компиляторов), написанную Абстрактным К.И.
-
-подпись Мага Ната, 1 апреля 1989 г
-Маг Нат, Президент фирмы Вице.
-
-
-
-Данная Универсальная Общественная Лицензия не позволяет вам включать
-вашу программу в программы, являющиеся частной собственностью. Если
-ваша программа -- это библиотека процедур, вам стоит подумать, не будет
-ли лучше разрешить программам, являющимся частной собственностью,
-связываться с вашей библиотекой. Если это то, чего вы хотите,
-используйте вместо этой Лицензии Универсальную Общественную Лицензию GNU
-для библиотек.
-
-
diff --git a/hlp/ru/projman/pmabout.html b/hlp/ru/projman/pmabout.html
deleted file mode 100644
index 4d5fc1e..0000000
--- a/hlp/ru/projman/pmabout.html
+++ /dev/null
@@ -1,27 +0,0 @@
-
Tcl/Tk Project Manager
-Version 1.0.0
Домашняя страница: http://nuk-svk.ru
-
-
- менеджер проектов
-
- менеджер файлов
-
- текстовый редактор
-
-- подсветка синтаксиса нескольких языков (Tcl, Html, Rpm.spec)
-
-- навигация по процедурам
-
-- поиск/замена информации
-
-- переход на строку с заданным номером
-
-- возможность повторения/отмены операций
-
- встроенная контекстно-зависимая справочная ситема
-
-- помощь по командам Tcl
-
-- помощь по командам Tk
-
-- помощь по IDE
-
- запуск приложений из IDE
-
-Начало работы с Project Manager-ом
Для этого в меню "Проект" выберите пункт "Новый проект" (либо "Открыть проект"). Откроется форма создания нового проекта, заполните все необходимые поля. Рассмотрим процедуру создания проекта на примере "Tcl/Tk Project manager":
-
"Название проекта" - полное название проекта (программы), это может быть любое предложение, например "Tcl/Tk Project Manager"
-
"Файл проекта" - имя файла проекта, т.е. имя основного файла вашей программы, в нашем примере это projman.tcl.
-
"Каталог проекта" - наименование каталога проекта. Каталог под этим именем будет создан в каталоге с проектами, который можно изменить в настройках(меню "Файл" -> "Установки"). По умолчанию все проекты будут помещены в Ваш домашний каталог в директорию /projects/tcl/"каталог проекта".
-
Tcl интерпретатор - название интерпретатора tcl для выполнения проекта, например tclsh, wish и т.п. Путь к интерпретатору следует указывать полностью - /usr/bin/tclsh
-
"Версия" - текущая версия программы (проекта), используется в имени файла архива, rpm-пакета и так далее.
-
"Выпуск" - по другому можно назвать "релиз", номер релиза, используется так же как и номер версии.
-
"Автор" - имя автора программы, используется в заголовках всех файлов проекта
-
"Эл. почта" - адрес электронной почты
-
Компания - наименование компании
-
Домашняя страница - адрес домашней страницы автора (либо компании) где в будущем будет размещен создаваемый проект.
-
Все пункты, кроме первых четырех, заполнять не обязательно, но желательно.
-Использование справочной системы
Сочетания клавиш
VisualREGEXP
-
Latest version 2.2
On Windows, create a shortcut and invoke the script with 'wish.exe'
-
-
-
- '
-
-
-
-
-
- One 1
- Two 2
- Foo Bar ]*?>(.*?)
' and press 'Go'.
-You see now that the interessing area is shown in blue. Press the Match '1'
-button which will extract the blue text (the regexp to use to get this text
-is then printed on the console).
-Now use '
(.*?) .*?(.*?) ' to get the information you need.
-
-
-http://laurent.riesterer.free.fr
-TkDIFF+
John M. Klassa
-
http://www.gnu.org/gnulist/production/diffutils.html
-
diff --git a/hlp/ru/projman/projman.toc.html b/hlp/ru/projman/projman.toc.html
deleted file mode 100644
index 6135c6a..0000000
--- a/hlp/ru/projman/projman.toc.html
+++ /dev/null
@@ -1,15 +0,0 @@
-
-Работа с программой
-Справочная система
-Работа с VisualREGEXP
-Работа с TkDIFF+
-Горячие клавиши
-Документация
-Лицензия
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/Http.html b/hlp/ru/tcl/Http.html
deleted file mode 100644
index 73ec2da..0000000
--- a/hlp/ru/tcl/Http.html
+++ /dev/null
@@ -1,450 +0,0 @@
-
-
- Http
-
- СИНТАКСИС
-
-
- package require http ?2.0?
- ::http::config ?options?
- ::http::geturl url ?options?
- ::http::formatQuery list
- ::http::reset token ?why?
- ::http::wait token
- ::http::status token
- ::http::size token
- ::http::code token
- ::http::data token
-
-
- ОПИСАНИЕ
-
- КОМАНДЫ
-
-
-
-
-
-
-
-
-
- proc httpCallback {token} {
- upvar #0 state
- # Далее возможна работа со state как с обычным Tcl-массивом
- }
-
-
- proc httpHandlerCallback {socket token} {
- upvar #0 state
- # Получен доступ к socket и Tcl-массиву state
- # ...
- # (например:
- # set data [read 1000];
- # set nbytes [string length ])
- # ...
- return nbytes
- }
-
-
- Pragma: no-cache
-
-
- proc httpProgress {token total current} {
- upvar #0 state
- }
-
- МАССИВ СОСТОЯНИЯ ТРАНЗАКЦИИ
-
-
- upvar #0 state
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/SafeTcl.html b/hlp/ru/tcl/SafeTcl.html
deleted file mode 100644
index ed78946..0000000
--- a/hlp/ru/tcl/SafeTcl.html
+++ /dev/null
@@ -1,448 +0,0 @@
-
-
-
-
- array set meta (meta)
-
-
- # Копирование источника в файл и печать мета данных
- proc ::http::copy { url file {chunk 4096} } {
- set out [open w]
- set token [geturl -channel -progress ::http::Progress -blocksize ]
- close
- # Следующая команда завершает строку, начатую
- # процедурой http::Progress
- puts stderr
- upvar #0 state
- set max 0
- foreach {name value} (meta) {
- if {[string length ] > } {
- set max [string length ]
- }
- if {[regexp -nocase ^location$ ]} {
- # Обработка перенаправления адреса
- puts stderr Location:
- return [copy [string trim ] ]
- }
- }
- incr max
- foreach {name value} (meta) {
- puts [format %-*s %s : ]
- }
- return
- }
- proc ::http::Progress {args} {
- puts -nonewline stderr . ;
- flush stderr
- }
-
- Safe Tcl
-
- СИНТАКСИС
-
-
- ::safe::interpCreate ?slave? ?options...?
- ::safe::interpInit slave ?options...?
- ::safe::interpConfigure slave ?options...?
- ::safe::interpDelete slave
- ::safe::interpAddToAccessPath slave directory
- ::safe::interpFindInAccessPath slave directory
- ::safe::setLogCmd ?cmd arg...?
-
-
- ОПИСАНИЕ
-
- СИНОНИМЫ
-
-
-
-
- КОМАНДЫ
-
-
-
-
-
- ###Создание безопасного интерпретатора
- ::safe::interpCreate qqq
- ###Присваивание переменной tk_library метки соответствующего каталога
- qqq eval [list set tk_library [::safe::interpFindInAccessPath qqq ]]
- ###Выполнение команды source в безопасном интерпретаторе
- qqq eval source $tk_library/msgbox.tcl
-
-
- ::safe::interpAddToAccessPath qqq
- qqq eval source $my_lib/$my_file
-
-
- ::safe::setLogCmd puts stderr
-
-
- NOTICE for slave interp10 : Created
- NOTICE for slave interp10 : Setting accessPath=(/foo/bar)
- staticsok=1 nestedok=0 deletehook=()
- NOTICE for slave interp10 : auto_path in interp10 has been
- set to {(:0:)}
- ERROR for slave interp10 : /foo/bar/init.tcl: no such file
- or directory
-
- ОПЦИИ
-
-
-
-
- БЕЗОПАСНОСТЬ
-
- Tcl
-
- ОПИСАНИЕ
-
-
-
-
-
- (index)
-
-
-
-
-
-
-
-
-
-
- Звуковой сигнал (гудок) (0х7).
-
-
-
- Сдвиг на одну позицию влево (0х8).
-
-
-
- Прогон листа (0xc).
-
-
-
-
- Новая строка, newline (0ха).
-
-
-
- Возврат каретки (0хd).
-
-
-
- Табуляция (0х9).
-
-
-
- Вертикальная табуляция (0xb).
-
-
- \<newline>пробел
- Обратный слэш, символ новой строки и все пробелы и
- табуляции после этого символа заменяются на одиночный
- пробел. Данная последовательность уникальна в том смысле,
- что она замещается в отдельном суб-проходе перед тем, как
- начинается непосредственно анализ команды. Поэтому эта
- последовательность будет замещена, даже если она стоит
- между фигурными скобками, и результирующий пробел будет
- интерпретироваться как разделитель слов, если только он
- не будет стоять между фигурными скобками или
- кавычками.
-
-
- \
- Обратный слэш (\).
-
-
- \ooo
- Цифры ooo (одна, две или все три) дают
- восьмеричное значение символа.
-
-
-
- \xhh
- Шестнадцатеричное число hh дает шестнадцатеричное
- значение символа. Может присутствовать любое количество
- цифр.
- after
-
-
- after ms
- after ms ?script script script...?
- after cancel id
- after cancel script script script...
- after idle ?script script script...?
- after info ?id?
-
-
- ОПИСАНИЕ
-
-
-
-
- append
-
-
- append varName ?value value value...?
-
-
- ОПИСАНИЕ
-
- array
-
-
- array option arrayName ?arg arg...?
- array anymore arrayName searchId
- array donesearch arrayName searchId
- array exists arrayName
- array get arrayName ?pattern?
- array names arrayName ?pattern?
- array nextelement arrayName searchId
- array set arrayName list
- array size arrayName
- array startsearch arrayName
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/bell.html b/hlp/ru/tcl/bell.html
deleted file mode 100644
index 76aec5c..0000000
--- a/hlp/ru/tcl/bell.html
+++ /dev/null
@@ -1,14 +0,0 @@
-bell
bgerror
-
-
- bgerror сообщение
-
-
- ОПИСАНИЕ
-
- binary
-
-
- binary format formatString ?arg arg...?
- binary scan string formatString ?varName varName...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
- binary format a7a*a alpha bravo charlie
-
- break
-
-
- break
-
-
- ОПИСАНИЕ
-
- case
-
-
- case string ?in? patList body ?patList body...?
- case string ?in? {patList body ?patList body...?}
-
-
- ОПИСАНИЕ
-
- catch
-
-
- catch script ?varName?
-
-
- ОПИСАНИЕ
-
- cd
-
- СИНТАКСИС
-
-
- cd dirName
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
-
diff --git a/hlp/ru/tcl/clock.html b/hlp/ru/tcl/clock.html
deleted file mode 100644
index 4343ded..0000000
--- a/hlp/ru/tcl/clock.html
+++ /dev/null
@@ -1,282 +0,0 @@
-
-
-
- clock
-
-
- clock option ?arg arg...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/close.html b/hlp/ru/tcl/close.html
deleted file mode 100644
index edccdba..0000000
--- a/hlp/ru/tcl/close.html
+++ /dev/null
@@ -1,56 +0,0 @@
-
-
-
-
-
-
-
-
-
-
- %%
- вставляет %
-
-
- %a
- сокращенное название дня недели (Mon, Tue, etc.).
-
-
- %A
- полное название дня недели (Monday, Tuesday, etc.).
-
-
- %b
- сокращенное название месяца (Jan, Feb, etc.).
-
-
- %B
- полное название месяца.
-
-
- %c
- локальные дата и время.
-
-
- %d
- день месяца (01 - 31).
-
-
- %H
- часы в двадцатичетырехчасовом формате (00 - 23).
-
-
- %I
- часы в двенадцатичасовом формате (00 - 12).
-
-
- %j
- день года (001 - 366).
-
-
- %m
- номер месяца (01 - 12).
-
-
- %M
- минуты (00 - 59).
-
-
- %p
- AM/PM индикатор (до/после полудня).
-
-
- %S
- секунды (00 - 59).
-
-
- %U
- неделя года (01 - 52), Воскресенье - первый день
- недели.
-
-
- %w
- номер дня недели (Воскресенье = 0).
-
-
- %W
- неделя года (01 - 52), Понедельник первый день
- недели.
-
-
- %x
- локальный формат даты.
-
-
- %X
- локальный формат времени.
-
-
- %y
- год без столетия (00 - 99).
-
-
- %Y
- год со столетием (например, 1990)
-
-
- %Z
- имя часового пояса.
-
-
- Кроме того, в некоторых операционных
- системах могут поддерживаться
-
-
- %D
- дата в формате %m/%d/%y.
-
-
- %e
- день месяца (1 - 31), без нулей впереди.
-
-
- %h
- сокращенное имя месяца.
-
-
- %n
- новая строка.
-
-
- %r
- время в формате %I:%M:%S %p.
-
-
- %R
- время в формате %H:%M.
-
-
- %t
- табуляция.
-
-
-
- %T
- время в формате %H:%M:%S.
-
-
-
-
-
-
- time
-
- Время суток в форме: hh?:mm?:ss??
- ?meridian? ?zone? или в форме
- hhmm?meridian? ?zone?, где
- meridian - индикатор AM или PM, zone -
- имя часового пояса. Если индикатор meridian не
- определен, hh считается числом часов в
- двадцатичетырехчасовом формате.
-
-
-
- date
-
- Месяц, день и, возможно, год. Допустимые форматы
- mm/dd?/yy?, monthname dd?, yy?,
- dd monthname?yy? и day, dd monthname
- yy. По умолчанию год считается текущим годом. Если
- год меньше 100, то года 00-38 считаются годами в
- диапазоне 2000-2038, а года 70-99 считаются годами в
- диапазоне 1970-1999. Года 39-70 могут быть
- недопустимыми на некоторых платформах. Для тех
- платформ, для которых они определены, они считаются
- годами в диапазоне 1939-1999.
-
-
-
-
- relative time
-
- Время относительно текущего момента. Формат - число
- единица измерения. Возможные единицы измерения
- year, fortnight, month,
- week, day, hour,
- minute(или min), и second (или
- sec). Единицы измерения могут указываться во
- множественном числе, например 3 weeks. Кроме того,
- могут использоваться модификаторы: tomorrow,
- yesterday, today, now,
- last, this, next, ago.
-
- close
-
-
- close channelId
-
-
- ОПИСАНИЕ
-
- concat
-
- СИНТАКСИС
-
-
- concat ?arg arg...?
-
-
- ОПИСАНИЕ
-
-
- concat a b {c d e} {f {g h}}
-
-
- a b c d e f {g h}
-
-
- continue
-
-
- continue
-
-
- ОПИСАНИЕ
-
- eof
-
- СИНТАКСИС
-
-
- eof channelId
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
-
diff --git a/hlp/ru/tcl/error.html b/hlp/ru/tcl/error.html
deleted file mode 100644
index 2278ca2..0000000
--- a/hlp/ru/tcl/error.html
+++ /dev/null
@@ -1,57 +0,0 @@
-
-
-
- error
-
- СИНТАКСИС
-
-
- error message info code
-
-
- ОПИСАНИЕ
-
-
- catch {...} errMsg
- set savedInfo
- ...
- error
-
-
- ПРИМЕР
-
-
-
diff --git a/hlp/ru/tcl/eval.html b/hlp/ru/tcl/eval.html
deleted file mode 100644
index c61d625..0000000
--- a/hlp/ru/tcl/eval.html
+++ /dev/null
@@ -1,30 +0,0 @@
-
-
-
- eval
-
- СИНТАКСИС
-
-
- eval arg arg...
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
-
diff --git a/hlp/ru/tcl/exec.html b/hlp/ru/tcl/exec.html
deleted file mode 100644
index bbaa7b2..0000000
--- a/hlp/ru/tcl/exec.html
+++ /dev/null
@@ -1,256 +0,0 @@
-
-
-
- exec
-
- СИНТАКСИС
-
-
- exec ?switches? arg ?arg...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
- |
-
- разделяет команды в конвейере. Стандартный вывод
- предыдущей команды направляется на стандартный вход
- следующей команды.
-
-
- |&
-
- разделяет команды в конвейере. Стандартный вывод и
- стандартный вывод ошибок предыдущей команды направляются
- на стандартный вход следующей команды. Такое выражение
- перебивает выражения типа 2> и >&.
-
-
- < fileName
-
- файл fileName отрывается и используется как
- стандартный ввод для первой команды конвейера.
-
-
- <@ fileId
-
- в этой форме fileId это идентификатор файла,
- открытого с помощью команды open. Он используется как
- стандартный ввод для первой команды конвейера. Файл должен
- быть открыт для чтения.
-
-
- << value
-
- value используется как стандартный ввод для
- первой команды конвейера.
-
-
- > fileName
-
- Стандартный вывод последней команды перенаправляется в
- файл fileName и перезаписывает его содержимое.
-
-
- 2> fileName
-
- Стандартный вывод ошибок всех команд в конвейере
- перенаправляется в файл fileName и перезаписывает
- его содержимое.
-
-
- >& fileName
-
- Стандартный вывод последней команды и стандартный вывод
- ошибок всех команд в конвейере перенаправляется в файл
- fileName и перезаписывает его содержимое.
-
-
- >>fileName
-
- Стандартный вывод последней команды перенаправляется в
- файл fileName и добавляется к его прежнему
- содержимому.
-
-
- 2>>fileName
-
- Стандартный вывод ошибок всех команд в конвейере
- перенаправляется в файл fileName и добавляется к его
- прежнему содержимому.
-
-
- >>& fileName
-
- Стандартный вывод последней команды и стандартный вывод
- ошибок всех команд в конвейере перенаправляется в файл
- fileName и добавляется к его прежнему содержимому.
-
-
-
- >@ ileId
-
- В этой форме fileId это идентификатор файла,
- открытого с помощью команды open. Стандартный вывод
- последней команды перенаправляется в файл fileName
- и перезаписывает его содержимое. Файл должен быть открыт
- для записи.
-
-
- 2>@ fileId
-
- В этой форме fileId это идентификатор файла,
- открытого с помощью команды open. Стандартный вывод
- ошибок всех команд в конвейере перенаправляется в файл
- fileName и перезаписывает его содержимое. Файл должен
- быть открыт для записи.
-
-
-
-
- >&@ fileId
-
- В этой форме fileId это идентификатор файла,
- открытого с помощью команды open. Стандартный вывод
- последней команды и стандартный вывод ошибок всех команд в
- конвейере перенаправляется в файл fileName и
- перезаписывает его содержимое. Файл должен быть открыт для
- записи.
-
Если стандартный ввод конвейера не
- перенаправлен с помощью символов "<",
- "<<" или "<@", стандартный ввод в первую
- команду конвейера осуществляется со стандартного ввода
- приложения.ВОПРОСЫ ПЕРЕНОСИМОСТИ НА ДРУГИЕ ПЛАТФОРМЫ
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/exit.html b/hlp/ru/tcl/exit.html
deleted file mode 100644
index d12c6be..0000000
--- a/hlp/ru/tcl/exit.html
+++ /dev/null
@@ -1,25 +0,0 @@
-
-
-
- exit
-
- СИНТАКСИС
-
-
- exit returnCode
-
-
- ОПИСАНИЕ
-
- fblocked
-
- СИНТАКСИС
-
-
- fblocked channelId
-
-
- ОПИСАНИЕ
-
- СМ. ТАКЖЕ
-
-
-
-
-
diff --git a/hlp/ru/tcl/fconfigure.html b/hlp/ru/tcl/fconfigure.html
deleted file mode 100644
index 283de78..0000000
--- a/hlp/ru/tcl/fconfigure.html
+++ /dev/null
@@ -1,211 +0,0 @@
-
-
-
- fconfigure
-
-
- fconfigure channelId
- fconfigure channelId name
- fconfigure channelId name value ?name value...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
- fcopy
-
-
- fcopy inchan outchan ?-size size? ?-command callback?
-
-
- ОПИСАНИЕ
-
- ПРИМЕРЫ
-
-
- proc Cleanup {in out bytes {error {}}} {
- global total
- set total
- close
- сlose
- if {[string length ]!= 0} {
- # error occurred during the copy
- }
- }
- #### Открыть файл на чтение
- set in [open ]
- #### Открыть сетевое соединение
- set out [socket ]
- #### Скопировать, по окончании копирования вызвать
- Cleanup
- fcopy -command [list Cleanup ]
- #### Ожидать завершения копирования
- vwait total
-
-
-
- proc CopyMore {in out chunk bytes {error {}}} {
- global total done
- incr total
- if {([string length ]!= 0) || [eof ] {
- set done
- close
- close
- } else {
- fcopy -command [list CopyMore ] -size
- }
- }
- set in [open ]
- set out [socket ]
- #### Установить размер фрагмента для копирования.
- set chunk 1024
- set total 0
- fcopy -command [list CopyMore ] -size
- vwait done
-
-
- file
-
-
- file option name ?arg arg...?
-
-
- ОПИСАНИЕ
-
-
-
-
- НА UNIX-ПЛАТФОРМАХ:
-
-
-
-
- НА WINDOWS-ПЛАТФОРМАХ
-
- НА MACINTOSH-ПЛАТФОРМАХ
-
-
- file dirname c:/
-
-
- file dirname ~/src/foo.c
-
-
- file dirname ~
-
-
- file isfile name
-
-
- file join a b /foo bar
-
-
- file split /foo/~bar/baz
-
- ПРОБЛЕМЫ ПЕРЕНОСИМОСТИ
-
-
-
-
- fileevent
-
-
- fileevent channelId readable ?script?
- fileevent channelId writable ?script?
-
-
- ОПИСАНИЕ
-
- filename
-
- ВВЕДЕНИЕ
-
- ТИПЫ ПУТЕЙ
-
- СИНТАКСИС ПУТЕЙ
-
-
-
-
-
-
- ТИЛЬДА-ПОДСТАНОВКИ
-
- ВОПРОСЫ ПЕРЕНОСИМОСТИ
-
-
- flush
-
- СИНТАКСИС
-
-
- flush channelId
-
-
- ОПИСАНИЕ
-
- for
-
- СИНТАКСИС
-
-
- for start test next body
-
-
- ОПИСАНИЕ
-
-
- for {set x 0} {<10} {incr x} {
- puts "x is "
- }
-
-
-
-
diff --git a/hlp/ru/tcl/foreach.html b/hlp/ru/tcl/foreach.html
deleted file mode 100644
index 77a4bc4..0000000
--- a/hlp/ru/tcl/foreach.html
+++ /dev/null
@@ -1,98 +0,0 @@
-
-
-
- foreach
-
- СИНТАКСИС
-
-
- foreach varname list body
- foreach varlist1 list1 ?varlist2 list2...? body
-
-
- ОПИСАНИЕ
-
- ПРИМЕРЫ
-
-
- set x {}
- foreach {i j} {a b c d e f} {
- lappend x
- }
-
-
-
- set x {}
- foreach i {a b c} j {d e f g} {
- lappend x
- }
-
-
-
- set x {}
- foreach i {a b c} {j k} {d e f g} {
- lappend x
- }
-
-
- format
-
-
-
-
-
- format formatString ?arg arg...?
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -
-
- ,
- (
- ).
-
-
- +
-
- , ,
- .
-
-
- space
-
- , ,
- .
-
-
- 0
-
- ,
- .
-
-
-
- #
-
-
- . o O
- , 0.
- x X - 0x
- 0X
- . e, E, f, g,
- G -
- . g G -
- .
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- d
-
-
- .
-
-
- u
-
-
- .
-
-
- i
-
-
- . , (
- 0 ) ( 0x
- ).
-
-
- o
-
-
- .
-
-
- x or X
-
-
- . `0123456789abcdef''
- x ``0123456789ABCDEF'' X.
-
-
-
- c
-
- ,
- .
-
-
- s
-
- ,
-
-
- f
-
-
- xx.yyy,
- .
-
-
- e or E
-
-
- x.yyyezz,
- (
- 6). E
- E e.
-
-
- g or G
-
- -4 , ,
- ,
- %e %E.
- %f.
-
-
-
-
- %
-
- %.
-
- ANSI SPRINTF
-
-
-
-
- gets
-
- СИНТАКСИС
-
-
- gets channelId ?varName?
-
-
- ОПИСАНИЕ
-
- glob
-
- СИНТАКСИС
-
-
- glob ?switches? pattern ?pattern?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
- ?
-
- Удовлетворяет любому символу;
-
-
- *
-
- Удовлетворяет любой последовательности из нуля или
- больше символов;
-
-
- [chars]
-
- Удовлетворяет любому символу из chars. Если
- chars включает последовательность символов типа
- a-b, то удовлетворяет всем символам от a до
- b (включительно).
-
-
-
- \x
-
- Удовлетворяет символу x.
-
-
-
- {a,b,...}
-
- Удовлетворяет любой из строк a, b,> и т.д.
-
-
-
- ОСОБЕННОСТИ РАБОТЫ НА РАЗЛИЧНЫХ ПЛАТФОРМАХ
-
- global
-
- СИНТАКСИС
-
-
- global varname ?varname?
-
-
- ОПИСАНИЕ
-
- history
-
- СИНТАКСИС
-
-
- history ?option? ?arg arg
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
- ПЕРЕФОРМИРОВАНИЕ ЖУРНАЛА
-
- if
-
- СИНТАКСИС
-
-
- if expr1 ?then? body1 elseif expr2 ?then? body2 elseif ...
- ?else? ?bodyN?
-
-
- ОПИСАНИЕ
-
- incr
-
- СИНТАКСИС
-
-
- incr varName increment
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
- incr variable 3
-
-
-
- incr variable
-
-
- Table of contents
-
-
-
-
-
diff --git a/hlp/ru/tcl/info.html b/hlp/ru/tcl/info.html
deleted file mode 100644
index 9464f5d..0000000
--- a/hlp/ru/tcl/info.html
+++ /dev/null
@@ -1,230 +0,0 @@
-
-
-
- info
-
- СИНТАКСИС
-
-
- info option ?arg arg...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/interp.html b/hlp/ru/tcl/interp.html
deleted file mode 100644
index 4f99121..0000000
--- a/hlp/ru/tcl/interp.html
+++ /dev/null
@@ -1,743 +0,0 @@
-
-
-
- interp
-
- СИНТАКСИС
-
-
- interp option ?arg arg...?
-
-
- ОПИСАНИЕ
-
- КОМАНДА INTERP
-
-
-
-
- КОМАНДА РАБОТЫ С
- ИНТЕРПРЕТАТОРОМ (ПОДЧИНЕННАЯ КОМАНДА)
-
-
- slave command ?arg arg...?
-
-
-
-
-
- БЕЗОПАСНЫЕ ИНТЕРПРЕТАТОРЫ
-
-
-
-
-
-
-
- after
- append
- array
- break
- case
-
-
- catch
- clock
- concat
- continue
- eof
-
-
- error
- eval
- expr
- fblocked
- fileevent
-
-
- flush
- for
- foreach
- format
- gets
-
-
- global
- history
- if
- incr
- info
-
-
- interp
- join
- lappend
- lindex
- linsert
-
-
- list
- llength
- lower
- lrange
- lreplace
-
-
- lsearch
- lsort
- package
- pid
- proc
-
-
- puts
- read
- rename
- return
- scan
-
-
- seek
- set
- split
- string
- subst
-
-
- switch
- tell
- trace
- unset
- update
-
-
-
- uplevel
- upvar
- vwait
- while
-
-
-
-
-
-
-
- cd
- exec
- exit
- fconfigure
-
-
- file
- glob
- load
- open
-
-
-
- pwd
- socket
- source
-
- ИСПОЛЬЗОВАНИЕ
- АЛИАСОВ
-
- СКРЫТЫЕ КОМАНДЫ
-
- join
-
- СИНТАКСИС
-
-
- join list joinString
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
-
diff --git a/hlp/ru/tcl/lappend.html b/hlp/ru/tcl/lappend.html
deleted file mode 100644
index 9272fcb..0000000
--- a/hlp/ru/tcl/lappend.html
+++ /dev/null
@@ -1,38 +0,0 @@
-
-
-
- lappend
-
- СИНТАКСИС
-
-
- lappend varName value value value ...
-
-
- ОПИСАНИЕ
-
-
- lappend a
-
-
- set a [concat [list ]]
-
-
-
-
-
diff --git a/hlp/ru/tcl/library.html b/hlp/ru/tcl/library.html
deleted file mode 100644
index 41f237a..0000000
--- a/hlp/ru/tcl/library.html
+++ /dev/null
@@ -1,269 +0,0 @@
-
-
-
- library
-
- СИНТАКСИС
-
-
- auto_execok cmd
- auto_load cmd
- auto_mkindex dir pattern pattern
- auto_reset
- parray arrayName
- tcl_endOfWord str start
- tcl_startOfNextWord str start
- tcl_startOfPreviousWord str start
- tcl_wordBreakAfter str start
- tcl_wordBreakBefore str start
-
-
- ОПИСАНИЕ
-
-
- source [file join [info library] init.tcl]
-
- КОМАНДНЫЕ ПРОЦЕДУРЫ
-
-
-
-
-
-
- auto_mkindex foo *.tcl
-
- ПЕРЕМЕННЫЕ
-
- lindex
-
- СИНТАКСИС
-
-
- lindex list index
-
-
- ОПИСАНИЕ
-
- linsert
-
- СИНТАКСИС
-
-
- linsert listName index element element element ...
-
-
- ОПИСАНИЕ
-
- list
-
- СИНТАКСИС
-
-
- list arg arg ...
-
-
- ОПИСАНИЕ
-
-
- list a b {c d e} {f {g h}}
-
-
-
- a b {c d e} {f {g h}}
-
-
-
- a b c d e f {g h}
-
-
-
-
-
diff --git a/hlp/ru/tcl/llength.html b/hlp/ru/tcl/llength.html
deleted file mode 100644
index e025806..0000000
--- a/hlp/ru/tcl/llength.html
+++ /dev/null
@@ -1,26 +0,0 @@
-
-
-
- llength
-
- СИНТАКСИС
-
-
- llength list
-
-
- ОПИСАНИЕ
-
- load
-
- СИНТАКСИС
-
-
- load fileName
- load fileName packageName
- load fileName packageName interp
-
-
- ОПИСАНИЕ
-
-
- typedef int Tcl_PackageInitProc(Tcl_Interp *interp);
-
-
-
- load bin/last.so {}
-
-
- ОШИБКИ
-
- lrange
-
- СИНТАКСИС
-
-
- lrange list first last
-
-
- ОПИСАНИЕ
-
-
- lrange list first first
-
-
-
- lindex list first
-
-
-
- list [lindex list first]
-
-
-
-
diff --git a/hlp/ru/tcl/lreplace.html b/hlp/ru/tcl/lreplace.html
deleted file mode 100644
index 9877396..0000000
--- a/hlp/ru/tcl/lreplace.html
+++ /dev/null
@@ -1,37 +0,0 @@
-
-
-
- lreplace
-
- СИНТАКСИС
-
-
- lreplace list first last element element ...
-
-
- ОПИСАНИЕ
-
- lsearch
-
- СИНТАКСИС
-
-
- lsearch mode list pattern
-
-
- ОПИСАНИЕ
-
-
-
-
- lsort
-
- СИНТАКСИС
-
-
- lsort ?options? list
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/namespace.html b/hlp/ru/tcl/namespace.html
deleted file mode 100644
index 0dbe714..0000000
--- a/hlp/ru/tcl/namespace.html
+++ /dev/null
@@ -1,602 +0,0 @@
-
-
-
-
-
-
- lsort -integer -index 1 {{First 24} {Second 18} {Third 30}}
-
-
- namespace
-
-
- СИНТАКСИС
-
-
- namespace ?option? ?arg?
-
-
- ОПИСАНИЕ
-
-
-
-
-
- set script [namespace code {foo bar}]
-
-
- eval " x y"
-
-
- namespace eval ::a::b {foo bar x y}
-
-
-
- namespace inscope ::foo a x y z
-
-
- namespace eval ::foo [concat a [list x y z]]
-
- ЧТО ТАКОЕ
- ПРОСТРАНСТВО ИМЕН?
-
-
- namespace eval Counter {
- namespace export Bump
- variable num 0
- proc Bump {} {
- variable num
- incr num
- }
- }
-
-
- namespace eval Counter {
- variable num 0
- proc Bump {} {
- variable num
- return [incr num]
- }
- }
- namespace eval Counter {
- proc test {args} {
- return
- }
- }
-
- namespace eval Counter {
- rename test ""
- }
-
- ПОЛНЫЕ ИМЕНА
-
-
- Counter::Bump 5
- Counter::Reset
-
-
- puts "count = ::num"
-
-
- Foo::Counter::Bump 3
-
-
- proc Foo::Test {args} { return }
-
-
- rename Foo::Test Bar::Test
-
- ПРАВИЛА ВИДИМОСТИ ИМЕН
-
-
- set traceLevel 0
- namespace eval Debug {
- printTrace
- }
-
-
-
- set traceLevel 0
- namespace eval Foo {
- variable traceLevel 3
- namespace eval Debug {
- printTrace
- }
- }
-
-
- namespace eval Foo::Debug {namespace which -variable traceLevel}
-
-
- namespace eval Foo {namespace which -variable traceLevel}
-
- ИМПОРТ КОМАНД
-
-
- Blt::graph .g -background red
- Blt::table .g 0,0
-
-
-
- namespace import Blt::*
-
-
- graph .g -background red
- table .g 0,0
-
-
-
- namespace import Blt::graph Blt::table
-
-
- namespace import -force Blt::graph Blt::table
-
-
- namespace forget Blt::*
-
-
- rename Blt::graph ""
-
- ЭКСПОРТ КОМАНД
-
-
- namespace eval Counter {
- namespace export Bump Reset
- variable num 0
- variable max 100
- proc Bump {{by 1}} {
- variable num
- incr num
- check
- return
- }
- proc Reset {} {
- variable num
- set num 0
- }
- proc check {} {
- variable num
- variable max
- if { > } {
- error "too high!"
- }
- }
- }
-
-
- namespace import Counter::*
-
-
- open
-
- СИНТАКСИС
-
-
- open fileName
- open fileName access
- open fileName access permissions
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
- r
-
- Открывает файл только на чтение. Это значение по умолчанию.
-
-
-
- r+
-
- Открывает файл на чтение и запись. Файл должен
- существовать.
-
-
-
- w
-
- Открывает файл только на запись. Удаляет содержимое
- файла, если он существовал. Если нет, то создает новый
- файл.
-
-
-
- w+
-
- Открывает файл на чтение и запись. Удаляет содержимое
- файла, если он существовал. Если нет, то создает новый
- файл.
-
-
-
- a
-
- Открывает файл на чтение. Файл должен
- существовать. Новые данные записываются в конец файла.
-
-
- a+
-
- Открывает файл на чтение и запись. Если файл не
- существует, создает новый файл. Новые данные
- записываются в конец файла.
-
-
-
-
-
-
- RDONLY
-
- Открывает файл только на чтение.
-
-
-
- WRONLY
-
- Открывает файл только на запись
-
-
-
- RDWR
-
- Открывает файл на чтение и запись.
-
-
-
- APPEND
-
- Переставляет указатель в конец файла перед каждой
- записью.
-
-
-
- CREAT
-
- Создает файл, если он не существует. Без этого флага
- попытка открыть несуществующий флаг приведет к
- ошибке.
-
-
-
- EXCL
-
- Если указан также флаг CREAT, то будет
- сгенерирована ошибка, если файл уже существует.
-
-
-
- NOCTTY
-
- Если файл открыт для терминального устройства, этот флаг
- не позволяет ему стать управляющим терминалом
- процесса.
-
-
-
- NONBLOCK
-
- Позволяет в неблокирующем режиме открыть файл и,
- возможно, выполнять в этом режиме последующие операции
- ввода/вывода. Последствия использования этого флага
- зависят от платформы и устройства. Предпочтительнее
- вместо него использовать команду fconfigure. Конкретные
- особенности использования флага описаны в руководстве по
- вашей операционной системе, системный вызов open, флаг
- O_NONBLOCK.
-
-
-
- TRUNC
-
- Если файл существует, то его содержимое удаляется.
- КОМАНДНЫЙ КОНВЕЙЕР
-
- ПОСЛЕДОВАТЕЛЬНЫЙ ПОРТ
-
- КОНФИГУРИРОВАНИЕ
-
-
- ОСОБЕННОСТИ РЕАЛИЗАЦИИ НА РАЗЛИЧНЫХ ПЛАТФОРМАХ
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/package.html b/hlp/ru/tcl/package.html
deleted file mode 100644
index a3e05d9..0000000
--- a/hlp/ru/tcl/package.html
+++ /dev/null
@@ -1,168 +0,0 @@
-
-
-
- package
-
- СИНТАКСИС
-
-
- package forget package
-
- package ifneeded package version ?script?
-
- package names
-
- package provide package ?version?
-
- package require ?-exact? package ?version?
-
- package unknown ?command?
-
- package vcompare version1 version2
-
- package versions package
-
- package vsatisfies version1 version2
-
-
-
- ОПИСАНИЕ
-
-
-
-
- ИНДЕКСЫ ПАКЕТОВ
-
- pid
-
- СИНТАКСИС
-
-
- pid fileId
-
-
- ОПИСАНИЕ
-
- pkg_mkIndex
-
- СИНТАКСИС
-
-
- pkg_mkIndex dir pattern ?pattern pattern...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
- package require Test
-
-
- package require -exact Test 2.1
-
- ЗАГРУЗЧИК ПАКЕТОВ И АВТОЗАГРУЗЧИК
-
- КАК ЖЕ ЭТО РАБОТАЕТ?
-
- proc
-
- СИНТАКСИС
-
-
- proc name args body
-
-
- ОПИСАНИЕ
-
- puts
-
- СИНТАКСИС
-
-
- puts ?-nonewline? ?channelId? string
-
-
- ОПИСАНИЕ
-
- pwd
-
- СИНТАКСИС
-
-
- pwd
-
-
- ОПИСАНИЕ
-
- read
-
- СИНТАКСИС
-
-
- read -nonewline channelId
- read channelIdnumBytes
-
-
- ОПИСАНИЕ
-
- regexp
-
- СИНТАКСИС
-
-
- regexp ?switches? exp string ?matchVar? ?subMatchVar subMatchVar...?
-
-
- ОПИСАНИЕ
-
-
-
-
- РЕГУЛЯРНЫЕ ВЫРАЖЕНИЯ
-
- ВЫБОР ИЗ АЛЬТЕРНАТИВНЫХ СОСТОЯНИЙ
-
-
- regexp (a*)b* aabaaabb x y
-
-
-
- regexp (ab|a)(b*)c abc x y z
-
-
- regsub
-
- СИНТАКСИС
-
-
- regsub ?switches? exp string subSpec varName
-
-
- ОПИСАНИЕ
-
- rename
-
- СИНТАКСИС
-
-
- rename oldName newName
-
-
- ОПИСАНИЕ
-
- return
-
- СИНТАКСИС
-
-
- return ?-code code? ?-errorinfo info? ?-errorcode code? ?string?
-
-
- ОПИСАНИЕ
-
-
-
-
- scan
-
- СИНТАКСИС
-
-
- scan string format varName ?varName...?
-
-
- ВВЕДЕНИЕ
-
- ПРОЦЕСС СКАНИРОВАНИЯ
-
-
-
-
- ОТЛИЧИЯ ОТ ANSI SSCANF
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/seek.html b/hlp/ru/tcl/seek.html
deleted file mode 100644
index 95b37a5..0000000
--- a/hlp/ru/tcl/seek.html
+++ /dev/null
@@ -1,65 +0,0 @@
-
-
-
-
-
- [1]
- Спецификаторы %p и %n не поддерживаются.
-
-
- [2]
- Для спецификатора %c нельзя указывать ширину
- поля. Только один символ переводится в десятичную
- величину, которая и присваивается соответствующей
- переменной.
-
-
- [3]
- Модификаторы l, h и L игнорируются. Целые
- числа преобразуются так, как будто никакого модификатора
- не было задано, а действительные числа - как при
- модификаторе l, то есть с использованием типа
- double для внутреннего представления.
- seek
-
- СИНТАКСИС
-
-
- seek channelId offset ?origin?
-
-
- ОПИСАНИЕ
-
-
-
-
- send
-
- set
-
- СИНТАКСИС
-
-
- set varName value
-
-
- ОПИСАНИЕ
-
- socket
-
- СИНТАКСИС
-
- socket ?options? host port
- socket -server command ?options? port
-
-
- ОПИСАНИЕ
-
- КЛИЕНТСКОЕ СОЕДИНЕНИЕ
-
-
-
-
- СЕРВЕРНОЕ СОЕДИНЕНИЕ
-
-
-
-
- КОНФИГУРАЦИОННЫЕ ОПЦИИ
-
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/source.html b/hlp/ru/tcl/source.html
deleted file mode 100644
index b25f855..0000000
--- a/hlp/ru/tcl/source.html
+++ /dev/null
@@ -1,36 +0,0 @@
-
-
-
- source
-
- СИНТАКСИС
-
-
- source fileName
-
-
- ОПИСАНИЕ
-
- split
-
- СИНТАКСИС
-
-
- split string splitChars
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
- split comp.unix.misc
-
-
- split Hello world {}
-
- string
-
- СИНТАКСИС
-
-
- string option arg ?arg...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/subst.html b/hlp/ru/tcl/subst.html
deleted file mode 100644
index 1c2ab74..0000000
--- a/hlp/ru/tcl/subst.html
+++ /dev/null
@@ -1,14 +0,0 @@
-
-
-
-
-
- *
- Удовлетворяет любой последовательности из нуля
- или больше символов;
-
-
- ?
- Удовлетворяет любому символу;
-
-
- [chars]
- Удовлетворяет любому символу из chars. Если
- chars включает последовательность символов типа
- a-b, то удовлетворяет всем символам от a
- до b (включительно).
-
-
-
- \x
- Удовлетворяет символу x. Обеспечивает возможность
- избежать в шаблонах специального смысла символов *, ?,
- [, ], \.
- subst
subst {xyz {$a}}
-switch
-
- СИНТАКСИС
-
-
- switch ?options? string pattern body ?pattern body...?
- switch ?options? string {pattern body ?pattern body...?}
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
- switch abc a - b {format 1} abc {format 2} default {format 3}
-
-
- switch -regexp aaab {
- ^a.*b$ -
- b {format 1}
- a* {format 2}
- default {format 3}
- }
-
-
- switch xyz {
- a
- -
- b
- {format 1}
- a*
- {format 2}
- default
- {format 3}
- }
-
-
-SafeTcl
-Tcl
-after
-append
-array
-bgerror
-binary
-break
-case
-catch
-cd
-clock
-close
-concat
-continue
-eof
-error
-eval
-exec
-exit
-expr
-fblocked
-fconfigure
-fcopy
-file
-fileevent
-filename
-flush
-for
-foreach
-format
-gets
-glob
-global
-history
-if
-incr
-info
-interp
-join
-lappend
-library
-lindex
-linsert
-list
-llength
-load
-lrange
-lreplace
-lsearch
-lsort
-namespace
-open
-package
-pid
-pkg_mkIndex
-proc
-puts
-pwd
-read
-regexp
-regsub
-rename
-resource
-return
-scan
-seek
-set
-socket
-source
-split
-string
-subst
-switch
-tclvars
-tell
-time
-trace
-unknown
-unset
-update
-uplevel
-upvar
-variable
-vwait
-while
-
-
-
diff --git a/hlp/ru/tcl/tclvars.html b/hlp/ru/tcl/tclvars.html
deleted file mode 100644
index bcdfba4..0000000
--- a/hlp/ru/tcl/tclvars.html
+++ /dev/null
@@ -1,288 +0,0 @@
-
-
-
- tclvars
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/tell.html b/hlp/ru/tcl/tell.html
deleted file mode 100644
index 1f11093..0000000
--- a/hlp/ru/tcl/tell.html
+++ /dev/null
@@ -1,27 +0,0 @@
-
-
-
-
-
-
-
- expr 1.4
-
- tell
-
- СИНТАКСИС
-
-
- tell channelId
-
-
- ОПИСАНИЕ
-
- time
-
- СИНТАКСИС
-
-
- time script count
-
-
- ОПИСАНИЕ
-
- 503 microseconds per iteration
- trace
-
- СИНТАКСИС
-
-
- trace option ?arg arg...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
diff --git a/hlp/ru/tcl/unknown.html b/hlp/ru/tcl/unknown.html
deleted file mode 100644
index 6d486ff..0000000
--- a/hlp/ru/tcl/unknown.html
+++ /dev/null
@@ -1,88 +0,0 @@
-
-
-
-
-
-
-
-
- r
-
- Вызывает команду command при чтении переменной.
-
-
- w
- Вызывает команду command при присвоении значения
- переменной.
-
-
- u
-
- Вызывает команду command при удалении
- переменной. Переменная может удаляться как явно (с
- помощью команды unset), так и неявно (при
- завершении процедуры). переменная также удаляется
- при удалении интерпретатора, в котором она была
- создана. Однако, при этом соответствующая команда
- не вызывается, так как уже нет интерпретатора, в
- котором ее можно было бы выполнить.
-
-
- command name1 name2 op
-
-
- unknown
-
- СИНТАКСИС
-
-
- unknown cmdName ?arg arg?
-
-
- ОПИСАНИЕ
-
- unset
-
- СИНТАКСИС
-
-
- unset name name name ...
-
-
- ОПИСАНИЕ
-
- update
uplevel
-
- СИНТАКСИС
-
-
- uplevel ?level? arg ?arg...?
-
-
- ОПИСАНИЕ
-
-
- uplevel 1 {set x 43; d}
-
-
- uplevel {set x 42}
-
-
- info level 1
-
- upvar
-
- СИНТАКСИС
-
-
- upvar ?level? otherVar myVar ?otherVar myVar...?
-
-
- ОПИСАНИЕ
-
-
- proc add2 name {
- upvar x
- set x [expr +2]
- }
-
- ОШИБКИ
-
- variable
-
- СИНТАКСИС
-
-
- variable ?name value? name ?value?
-
-
- ОПИСАНИЕ
-
- vwait
-
- СИНТАКСИС
-
-
- vwait varName
-
-
- ОПИСАНИЕ
-
- while
-
- СИНТАКСИС
-
-
- while test body
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
-
- while { < 10} {
- puts x is
- incr x
- }
-
-
-
-
diff --git a/hlp/ru/tk/SafeTk.html b/hlp/ru/tk/SafeTk.html
deleted file mode 100644
index 82e2334..0000000
--- a/hlp/ru/tk/SafeTk.html
+++ /dev/null
@@ -1,50 +0,0 @@
-
-
-
- Safe Tk
-
- СИНТАКСИС
-
-
- ::safe::loadTk slave -use windowId
-
-
- ОПИСАНИЕ
-
- ПРИМЕР
-
- СМ. ТАКЖЕ
-
- bell
bind
-
- СИНТАКСИС
-
-
- bind тег
- bind тег последовательность
- bind тег последовательность скрипт
- bind тег последовательность +скрипт
-
-
- ОПИСАНИЕ
-
-
-
-
- ОБРАЗЦЫ СОБЫТИЙ
-
-
- <модификатор-модификатор-тип-детализация>
-
-
-
- <<имя>>
-
-
- МОДИФИКАТОРЫ
-
-
-
-
- ТИПЫ СОБЫТИЙ
-
-
-
-
- ПОДСТАНОВКИ И СКРИПТЫ ПРИВЯЗКИ
-
-
-
-
- insert %A
-
- insert \[
-
- НЕСКОЛЬКО ПРИВЯЗОК, ОТВЕЧАЮЩИХ ОБРАЗЦУ
-
-
-
-
-
- event add <<Paste>> <Control-y>
- event add <<Paste>> <Button-2>
- event add <<Scroll>> <Button-2>
- bind Entry <<Paste>> {puts Paste}
- bind Entry <<Scroll>> {puts Scroll}
-
-
- ПОСЛЕДОВАТЕЛЬНОСТИ НЕСКОЛЬКИХ СОБЫТИЙ И ИГНОРИРУЕМЫЕ СОБЫТИЯ
-
- ОШИБКИ
-
- bindtags
-
- СИНТАКСИС
-
-
- bindtags window ?tagList?
-
-
- ОПИСАНИЕ
-
- bitmap
-
- СИНТАКСИС
-
-
- image create bitmap name options
-
-
- ОПИСАНИЕ
-
- button
-
- СИНТАКСИС
-
-
- button имяПути параметры
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ
-
-
-
-
- Имя параметра: -command Имя в Базе: command Класс в Базе: Command
-
-
- Имя параметра: -default Имя в Базе: default Класс в Базе: Default
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -state Имя в Базе: state Класс в Базе: State
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр арг арг ...
-
-
-
- имяПути cget параметр
-
-
-
- имяПути configure параметр значение параметр значение ...
-
-
-
- имяПути flash
-
-
-
- имяПути invoke
-
-
- canvas
-
- СИНТАКСИС
-
-
- canvas имяПути параметры
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
-
-
-
- -background
- -highlightthickness
- -insertwidth
-
-
- -takefocus
- -borderwidth
- -insertbackground
-
-
- -relief
- -xscrollcommand
- -cursor
-
-
- -insertborderwidth
- -selectbackground
- -yscrollcommand
-
-
- -highlightbackground
- -insertofftime
- -selectborderwidth
-
-
-
- -highlightcolor
- -insertontime
- -selectforeground
- ПАРАМЕТРЫ, СВЯЗАННЫЕ ИСКЛЮЧИТЕЛЬНО С ПРИМИТИВАМИ
-
-
-
-
- Имя параметра: -closeenough Имя в Базе: closeEnough Класс в Базе: CloseEnough
-
-
- Имя параметра: -confine Имя в Базе: confine Класс в Базе: Confine
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -scrollregion Имя в Базе: scrollRegion Класс в Базе: ScrollRegion
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: width
-
-
- Имя параметра: -xscrollincrement Имя в Базе: xScrollincrement Класс в Базе: Scrollincrement
-
-
- Имя параметра: -yscrollincrement Имя в Базе: yScrollincrement Класс в Базе: Scrollincrement ВВЕДЕНИЕ
-
- СПИСОК ВЫВОДА
-
- ИДЕНТИФИКАТОРЫ И ТЕГИ ЭЛЕМЕНТОВ
-
- КООРДИНАТЫ
-
- ПРЕОБРАЗОВАНИЯ
-
- ИНДЕКСЫ
-
-
-
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр аргумент аргумент ...
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ОБЗОР ТИПОВ ЭЛЕМЕНТОВ
-
- ДУГИ
-
-
-
-
-
-
- ДВУЦВЕТНЫЕ ЭЛЕМЕНТЫ
-
-
-
-
-
-
- ЛИНИИ
-
-
-
-
-
-
- ОВАЛЫ
-
-
-
-
-
-
- МНОГОУГОЛЬНИКИ
-
-
-
-
-
-
-
- ПРЯМОУГОЛЬНИКИ
-
-
-
-
-
-
- ТЕКСТОВЫЕ ЭЛЕМЕНТЫ
-
-
-
-
-
-
- ОКНА
-
-
-
-
-
-
- ТИПЫ ЭЛЕМЕНТОВ, ОПРЕДЕЛЯЕМЫЕ В ПРИЛОЖЕНИЯХ
-
- ПРЕДПОЧТЕНИЯ
-
- checkbutton
-
-
- СИНТАКСИС
-
-
- checkbutton имяПути параметры
-
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -command Имя в Базе: command Класс в Базе: Command
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -indicatoron Имя в Базе: indicatorOn Класс в Базе: IndicatorOn
-
-
- Имя параметра: -offvalue Имя в Базе: offValue Класс в Базе: OffValue
-
-
-
- Имя параметра: -onvalue Имя в Базе: onValue Класс в Базе: OnValue
-
-
-
- Имя параметра: -selectcolor Имя в Базе: selectColor Класс в Базе: SelectColor
-
-
- Имя параметра: -selectimage Имя в Базе: selectImage Класс в Базе: SelectImage
- Задает изображение, выводимое в кнопке при выделении кнопки
- проверки (вместо изображения, заданного параметром -image). Если
- параметр -image отсутствует, то значение параметра
- -selectimage игнорируется.
-
-
-
- Имя параметра: -state Имя в Базе: state Класс в Базе: State
-
-
- Имя параметра: -variable Имя в Базе: variable Класс в Базе: Variable
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
-
-
-
-
-
-
- ПРЕДПОЧТЕНИЯ
-
-
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/clipboard.html b/hlp/ru/tk/clipboard.html
deleted file mode 100644
index 8d6869a..0000000
--- a/hlp/ru/tk/clipboard.html
+++ /dev/null
@@ -1,87 +0,0 @@
-
-
-
- clipboard
-
- СИНТАКСИС
-
-
- clipboard параметр арг арг
-
-
- ОПИСАНИЕ"
-
-
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/destroy.html b/hlp/ru/tk/destroy.html
deleted file mode 100644
index 34aadb1..0000000
--- a/hlp/ru/tk/destroy.html
+++ /dev/null
@@ -1,31 +0,0 @@
-
-
-
- destroy
-
- СИНТАКСИС
-
-
- destroy window window
-
-
- ОПИСАНИЕ
-
- entry
-
- СИНТАКСИС
-
-
- entry имяПути параметры
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
-
-
- Имя параметра: -show Имя в Базе: show Класс в Базе: Show
-
-
-
-
- Имя параметра: -state Имя в Базе: state Класс в Базе: State
-
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
-
- имяПути параметр арг арг ...
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ПРИВЯЗКИ ПО УМОЛЧАНИЮ
-
- event
-
- СИНТАКСИС
-
-
- event параметр ?арг арг ...?
-
-
- ОПИСАНИЕ
-
-
-
-
- ПОЛЯ СОБЫТИЯ
-
-
-
-
-
-
-
-
-
- ПРИМЕРЫ ВИРТУАЛЬНЫХ СОБЫТИЙ
-
-
- event add <<Paste>> <Control-y>
- event add <<Paste>><Button-2>
- event add <<Save>> <Control-X><Control-S>
- event add <<Save>> <Shift-F12>
-
-
-
- bind Entry <<Paste>> {%W insert[selection get]}
-
-
-
- bind <Entry> <Control-y> {}
- event add <<Paste>> <Key-F6>
-
-
-
- event generate окно событие параметр значение параметр значение ...
-
-
-
- event info <<виртуальное>>
-
-
- focus
-
- СИНТАКСИС
-
-
- focus
- focus окно
- focus параметр арг арг ...
-
-
- ОПИСАНИЕ
-
-
-
-
-
- ОСОБЕННОСТИ РЕАЛИЗАЦИИ
-
- font
-
-
- СИНТАКСИС
-
-
- font параметр арг арг ...
-
-
- ОПИСАНИЕ
-
-
-
-
-
- ОПИСАНИЕ ШРИФТА
-
-
-
-
- МЕТРИЧЕСКИЕ ХАРАКТЕРИСТИКИ ШРИФТОВ
-
-
-
-
- ПАРАМЕТРЫ ШРИФТОВ
-
-
-
-
-
- ОСОБЕННОСТИ РЕАЛИЗАЦИИ НА РАЗЛИЧНЫХ ПЛАТФОРМАХ
-
-
-
-
- frame
-
- СИНТАКСИС
-
-
- frame имя_Пути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -background Имя в Базе: background Класс в Базе: Background
-
-
- Имя параметра: -class Имя в Базе: class Класс в Базе: Class
-
-
- Имя параметра: -colormap Имя в Базе: colormap Класс в Базе: Colormap
-
-
- Имя параметра: -container Имя в Базе: container Класс в Базе: Container
-
-
- Имя параметра: -visual Имя в Базе: visual Класс в Базе: Visual
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
- frame имяПути параметр арг арг ...
-
-
-
-
-
- ПРИВЯЗКИ
-
- grab
-
- СИНТАКСИС
-
-
- grab ?-global? окно
- grab параметр ?арг арг...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
- ОШИБКИ
-
- grid
-
- СИНТАКСИС
-
-
- grid option arg ?arg ...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
- ОТНОСИТЕЛЬНОЕ РАЗМЕЩЕНИЕ
-
-
-
-
- АЛГОРИТМ РАЗМЕЩЕНИЯ grid
-
- РАСПРОСТРАНЕНИЕ РАЗМЕРОВ
-
- ОГРАНИЧЕНИЯ НА МАСТЕР-ОКНА
-
- ПОРЯДОК РАЗМЕЩЕНИЯ
-
- image
-
- СИНТАКСИС
-
-
- image параметр ?арг арг ...?
-
-
- ОПИСАНИЕ
-
-
-
-
- ВСТРОЕННЫЕ ТИПЫ ИЗОБРАЖЕНИЙ
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/index-tk.html b/hlp/ru/tk/index-tk.html
deleted file mode 100644
index 423e262..0000000
--- a/hlp/ru/tk/index-tk.html
+++ /dev/null
@@ -1,68 +0,0 @@
-
-
-
- Table of contents
-
-
-
-
-
diff --git a/hlp/ru/tk/label.html b/hlp/ru/tk/label.html
deleted file mode 100644
index e588698..0000000
--- a/hlp/ru/tk/label.html
+++ /dev/null
@@ -1,142 +0,0 @@
-
-
-
- label
-
- СИНТАКСИС
-
-
- label имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
-
- ПРИВЯЗКИ
-
- listbox
-
- СИНТАКСИС
-
-
-
- listbox имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -selectmode Имя в Базе: selectMode Класс в Базе: SelectMode
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- ИНДЕКСЫ
-
-
-
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ПАРАМЕТРЫ ПО УМОЛЧАНИЮ
-
- lower
-
- СИНТАКСИС
-
-
- lower ?window belowThis?
-
-
- ОПИСАНИЕ
-
- menu
-
- СИНТАКСИС
-
-
- menu имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -postcommand Имя в Базе: postCommand Класс в Базе: PostCommand
-
-
- Имя параметра: -selectcolor Имя в Базе: selectColor Класс в Базе: Background
-
-
- Имя параметра: -tearoff Имя в Базе: tearOff Класс в Базе: TearOff
-
-
- Имя параметра: -tearoffcommand Имя в Базе: tearOffCommand Класс в Базе: TearOffCommand
-
-
- Имя параметра: -title Имя в Базе: title Класс в Базе: Title
-
-
-
-
- Имя параметра: -type Имя в Базе: type Класс в Базе: Type ВВЕДЕНИЕ
-
- КОМАНДНЫЕ ВХОДЫ
-
- ВХОДЫ-РАЗДЕЛИТЕЛИ
-
- ЗАЩЕЛКИВАЮЩИЕСЯ ВХОДЫ
-
- ВХОДЫ-ПЕРЕКЛЮЧАТЕЛИ
-
- КАСКАДНЫЕ ВХОДЫ
-
-
-
-
- ВХОДЫ КЛЮЧИ ОТРЫВА
-
- ЛИНЕЙКА МЕНЮ
-
- СПЕЦИАЛЬНЫЕ МЕНЮ В ЛИНЕЙКЕ
-
- КЛОНЫ
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
-
-
-
-
-
-
- КОНФИГУРАЦИИ МЕНЮ
-
-
-
-
- ПАРАМЕТРЫ ПО УМОЛЧАНИЮ
-
-
-
-
-
-
-
-
-
-
-
-
-NAME
-menubutton - Create and manipulate menubutton widgets
-SYNOPSIS
-menubutton pathName ?options?
-STANDARD OPTIONS
-
-
-WIDGET-SPECIFIC OPTIONS
-
-
-INTRODUCTION
-The menubutton command creates a new window (given by the
-pathName argument) and makes it into a menubutton widget.
-Additional
-options, described above, may be specified on the command line
-or in the option database
-to configure aspects of the menubutton such as its colors, font,
-text, and initial relief. The menubutton command returns its
-pathName argument. At the time this command is invoked,
-there must not exist a window named pathName, but
-pathName's parent must exist.
-WIDGET COMMAND
-The menubutton command creates a new Tcl command whose
-name is pathName. This
-command may be used to invoke various
-operations on the widget. It has the following general form:
-pathName option ?arg arg ...?
-Option and the args
-determine the exact behavior of the command. The following
-commands are possible for menubutton widgets:
-
-
-DEFAULT BINDINGS
-Tk automatically creates class bindings for menubuttons that give them
-the following default behavior:
-
-
-KEYWORDS
-menubutton, widget
-
-Copyright © 1990-1994 The Regents of the University of California.
-Copyright © 1994-1997 Sun Microsystems, Inc.
-Copyright © 1995-1997 Roger E. Critchlow Jr.
-
-
diff --git a/hlp/ru/tk/menubutton.html b/hlp/ru/tk/menubutton.html
deleted file mode 100644
index ba2b273..0000000
--- a/hlp/ru/tk/menubutton.html
+++ /dev/null
@@ -1,267 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-NAME
-menubutton - Create and manipulate menubutton widgets
-SYNOPSIS
-menubutton pathName ?options?
-STANDARD OPTIONS
-
-
-WIDGET-SPECIFIC OPTIONS
-
-
-INTRODUCTION
-The menubutton command creates a new window (given by the
-pathName argument) and makes it into a menubutton widget.
-Additional
-options, described above, may be specified on the command line
-or in the option database
-to configure aspects of the menubutton such as its colors, font,
-text, and initial relief. The menubutton command returns its
-pathName argument. At the time this command is invoked,
-there must not exist a window named pathName, but
-pathName's parent must exist.
-WIDGET COMMAND
-The menubutton command creates a new Tcl command whose
-name is pathName. This
-command may be used to invoke various
-operations on the widget. It has the following general form:
-pathName option ?arg arg ...?
-Option and the args
-determine the exact behavior of the command. The following
-commands are possible for menubutton widgets:
-
-
-DEFAULT BINDINGS
-Tk automatically creates class bindings for menubuttons that give them
-the following default behavior:
-
-
-KEYWORDS
-menubutton, widget
-
-Copyright © 1990-1994 The Regents of the University of California.
-Copyright © 1994-1997 Sun Microsystems, Inc.
-Copyright © 1995-1997 Roger E. Critchlow Jr.
-
-
diff --git a/hlp/ru/tk/message.html b/hlp/ru/tk/message.html
deleted file mode 100644
index f71e0e9..0000000
--- a/hlp/ru/tk/message.html
+++ /dev/null
@@ -1,163 +0,0 @@
-
-
-
- message
-
- СИНТАКСИС
-
-
- message имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -aspect Имя в Базе: aspect Класс в Базе: Aspect
-
-
- Имя параметра: -justify Имя в Базе: justify Класс в Базе: Justify
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
- ПАРАМЕТРЫ ПО УМОЛЧАНИЮ
-
- option
-
- СИНТАКСИС
-
-
- option add pattern value ?priority?
- option clear
- option get window name class
- option readfile fileName ?priority?
-
-
- ОПИСАНИЕ
-
- options
-
- ОПИСАНИЕ
-
-
- .a.b.c configure -foreground black
-
-
-
-
-
- Имя параметра: -activebackground Имя в Базе: activeBackground Класс в Базе: Foreground
-
-
- Имя параметра: -activedorderwidth Имя в Базе: activeBorderWidth Класс в Базе: BorderWidth
-
-
- Имя параметра: -activeforeground Имя в Базе: activeForeground Класс в Базе: Background
-
-
- Имя параметра: -anchor Имя в Базе: anchor Класс в Базе: Anchor
-
-
- Имя параметра: -background or -bg Имя в Базе: background Класс в Базе: Background
-
-
- Имя параметра: -bitmap Имя в Базе: bitmap Класс в Базе: Bitmap
-
-
- Имя параметра: -borderwidth or -bd Имя в Базе: borderWidth Класс в Базе: BorderWidth
-
-
- Имя параметра: -cursor Имя в Базе: cursor Класс в Базе: Cursor
-
-
- Имя параметра: -disabledforeground Имя в Базе: disabledForeground Класс в Базе: DisabledForeground
-
-
- Имя параметра: -exportselection Имя в Базе: exportSelection Класс в Базе: ExportSelection
-
-
- Имя параметра: -font Имя в Базе: font Класс в Базе: Font
-
-
- Имя параметра: -fg Имя в Базе: foreground Класс в Базе: Foreground
-
-
- Имя параметра: -highlightbackground Имя в Базе: highlightBackground Класс в Базе: HighlightBackground
-
-
- Имя параметра: -highlightcolor Имя в Базе: highlightColor Класс в Базе: HighlightColor
-
-
- Имя параметра: -highlightthickness Имя в Базе: highlightThickness Класс в Базе: HighlightThickness
-
-
- Имя параметра: -image Имя в Базе: image Класс в Базе: Image
-
-
- Имя параметра: -insertbackground Имя в Базе: insertBackground Класс в Базе: Foreground
-
-
- Имя параметра: -insertborderwidth Имя в Базе: insertBorderWidth Класс в Базе: BorderWidth
-
-
- Имя параметра: -insertofftime Имя в Базе: insertOffTime Класс в Базе: OffTime
-
-
- Имя параметра: -inserontime Имя в Базе: insertOnTime Класс в Базе: OnTime
-
-
- Имя параметра: -insertwidth Имя в Базе: insertWidth Класс в Базе: InsertWidth
-
-
- Имя параметра: -jump Имя в Базе: jump Класс в Базе: Jump
-
-
- Имя параметра: -justify Имя в Базе: justify Класс в Базе: Justify
-
-
- Имя параметра: -orient Имя в Базе: orient Класс в Базе: Orient
-
-
- Имя параметра: padx Имя в Базе: padX Класс в Базе: Pad
-
-
- Имя параметра: -pady Имя в Базе: padY Класс в Базе: Pad
-
-
- Имя параметра: -relief Имя в Базе: relief Класс в Базе: Relief
-
-
- Имя параметра: -repeatdelay Имя в Базе: repeatDelay Класс в Базе: RepeatDelay
-
-
- Имя параметра: -repeatinterval Имя в Базе: repeatInterval Класс в Базе: RepeatInterval
-
-
- Имя параметра: -selectbackground Имя в Базе: selectBackground Класс в Базе: Foreground
-
-
- Имя параметра: -selectborderwidth Имя в Базе: selectBorderWidth Класс в Базе: BorderWidth
-
-
- Имя параметра: -selectforeground Имя в Базе: selectForeground Класс в Базе: Background
-
-
- Имя параметра: -setgrid Имя в Базе: setGrid Класс в Базе: SetGrid
-
-
- Имя параметра: -takefocus Имя в Базе: takeFocus Класс в Базе: TakeFocus
-
-
- Имя параметра: -text Имя в Базе: text Класс в Базе: Text
-
-
- Имя параметра: -textvariable Имя в Базе: textVariable Класс в Базе: Variable
-
-
- Имя параметра: -troughcolor Имя в Базе: troughColor Класс в Базе: Background
-
-
- Имя параметра: -underline Имя в Базе: underline Класс в Базе: Underline
-
-
- Имя параметра: -wraplength Имя в Базе: wrapLength Класс в Базе: WrapLength
-
-
- Имя параметра: -xscrollcommand Имя в Базе: xScrollCommand Класс в Базе: ScrollCommand
-
-
- Имя параметра: -yscrollcommand Имя в Базе: yScrollCommand Класс в Базе: ScrollCommand pack-old
-
- СИНТАКСИС
-
-
- pack after sibling окно параметры ?окно параметры...?
- pack append parent окно параметры ?окно параметры...?
- pack before sibling окно параметры ?окно параметры...?
- pack unpack окно
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
-
-
-
- pack
-
- СИНТАКСИС
-
-
- pack option arg ?arg ...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
- АЛГОРИТМ УПАКОВКИ pack
-
-
-
-
-
- РАСШИРЕНИЕ ВИДЖЕТОВ
-
-
- РАСПРОСТРАНЕНИЕ РАЗМЕРОВ
-
- ОГРАНИЧЕНИЯ НА МАСТЕР-ОКНА
-
- ПОРЯДОК РАЗМЕЩЕНИЯ
-
- photo
-
- СИНТАКСИС
-
-
- image create photo ?имя? ?параметры?
-
-
- ОПИСАНИЕ
-
- СОЗДАНИЕ ИЗОБРАЖЕНИЙ ТИПА photo
-
-
-
-
- КОМАНДА IMAGE
-
-
- imageName параметр ?арг арг ...?
-
-
-
-
-
-
-
-
-
-
-
- ФОРМАТЫ ИЗОБРАЖЕНИЙ
-
- РАСПРЕДЕЛЕНИЕ ЦВЕТОВ
-
- pkg_mkIndex
-
- СИНТАКСИС
-
-
- pkg_mkIndex dir pattern ?pattern pattern...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
- [1]
-
- Создать один или несколько пакетов. Каждый пакет может
- состоять из одного или больше файлов с Tcl-скриптами или
- из бинарных файлов. Бинарные файлы должны быть пригодны
- для их загрузки с помощью команды load с единственным
- аргументом -именем файла. Например, если в пакет входит
- файл test.so, он должен загружаться
- командой load test.so. Каждый файл
- Tcl-скриптов должен содержать команду package
- provide с именем пакета и версией. Каждый
- бинарный файл должен содержать вызов процедуры
- Tcl_PkgProvide.
-
-
-
-
- [2]
-
- Создать индексные файлы с помощью команды
- pkg_mkIndex. Аргумент dir
- указывает имя каталога, в котором лежат файлы пакета, а
- шаблоны pattern, которые могут содержать
- специальные символы, как в команде glob, указывают на файлы
- в этом каталоге. Команда pkg_mkIndex
- создаст в каталоге dir файл
- pkgIndex.tcl, содержащий информацию обо
- всех файлах пакета, заданных с помощью аргументов
- pattern. Для этого загружаются все файлы пакета,
- и определяется, какие новые пакеты и какие новые процедуры
- появились (поэтому в каждом файле пакета и должна быть
- команда package
- provide или вызов
- Tcl_PkgProvide).
-
-
- [3]
-
- Установить пакет как подкаталог одного из каталогов,
- перечисленных в переменной
- tcl_pkgPath. Если в списке
- больше одного каталога, то
- бинарные файлы с разделяемыми библиотеками обычно
- устанавливаются в первом каталоге, а библиотеки
- Tcl-скриптов . во втором. В этих каталогах должны также
- находиться файлы pkgIndex.tcl. Пока
- пакеты будут размещаться в подкаталогах каталогов,
- перечисленных в переменной tcl_pkgPath,
- этого будет достаточно для их автоматической загрузки при
- выполнении команды package
- require.
-
-
-
-
- [4]
-
- Если вы установили пакеты в каких-либо других каталогах,
- то необходимо, чтобы эти каталоги содержались в переменной
- auto_path или были бы непосредственными
- подкаталогами одного из содержащихся там
- каталогов. Переменная auto_path содержит
- список каталогов, которые просматриваются как
- автозагрузчиком, так и загрузчиком пакетов. По умолчанию
- он включает . Загрузчик
- пакетов также просматривает и подкаталоги каталогов,
- включенных в auto_path. Пользователь
- может в явном виде включить в приложении необходимые
- каталоги в auto_path. А можно включить
- эти каталоги в переменную окружения
- TCLLIBPATH. Если она существует, то
- используется для инициализации переменной
- auto_path при запуске приложения.
-
-
- package require Test
-
-
-
- package require -exact Test 2.1
-
-
- ЗАГРУЗЧИК ПАКЕТОВ И АВТОЗАГРУЗЧИК
-
- КАК ЖЕ ЭТО РАБОТАЕТ?
-
- place
-
- СИНТАКСИС
-
-
- place window option value ?option value ...?
- place configure window option value ?option value ...?
- place forget window
- place info window
- place slaves window
-
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
-
-
-
- ЗАМЕЧАНИЕ
-
-
- place slaves window
-
-
-
- place forget window
-
-
-
- place info window
-
-
- radiobutton
-
- СИНТАКСИС
-
-
- radiobutton имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -command Имя в Базе: command Класс в Базе: Command
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -indicatoron Имя в Базе: indicatorOn Класс в Базе: IndicatorOn
-
-
- Имя параметра: -selectcolor Имя в Базе: selectColor Класс в Базе: Background
-
-
- Имя параметра: -selectimage Имя в Базе: selectImage Класс в Базе: SelectImage
-
-
- Имя параметра: -state Имя в Базе: state Класс в Базе: State
-
-
- Имя параметра: -value Имя в Базе: value Класс в Базе: Value
-
-
- Имя параметра: -variable Имя в Базе: variable Класс в Базе: Variable
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
- ПРИВЯЗКИ
-
-
-
-
-
- raise
-
- СИНТАКСИС
-
-
- raise window ?aboveThis?
-
-
- ОПИСАНИЕ
-
- resource
-
- СИНТАКСИС
-
-
- resource option arg arg...
-
-
- ОПИСАНИЕ
-
- scale
-
- СИНТАКСИС
-
-
- scale имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -bigincrement Имя в Базе: bigIncrement Класс в Базе: BigIncrement
-
-
- Имя параметра: -command Имя в Базе: command Класс в Базе: Command
-
-
- Имя параметра: -digits Имя в Базе: digits Класс в Базе: Digits
-
-
-
-
-
- Имя параметра: -from Имя в Базе: from Класс в Базе: From
-
-
- Имя параметра: -label Имя в Базе: label Класс в Базе: Label
-
-
- Имя параметра: -length Имя в Базе: length Класс в Базе: Length
-
-
- Имя параметра: -resolution Имя в Базе: resolution Класс в Базе: Resolution
-
-
- Имя параметра: -showvalue Имя в Базе: showValue Класс в Базе: ShowValue
-
-
- Имя параметра: -sliderlength Имя в Базе: sliderLength Класс в Базе: SliderLength
-
-
- Имя параметра: -sliderrelief Имя в Базе: sliderRelief Класс в Базе: SliderRelief
-
-
- Имя параметра: -state Имя в Базе: state Класс в Базе: State
-
-
- Имя параметра: -tickinterval Имя в Базе: tickInterval Класс в Базе: TickInterval
-
-
- Имя параметра: -to Имя в Базе: to Класс в Базе: To
-
-
- Имя параметра: -variable Имя в Базе: variable Класс в Базе: Variable
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
- ПРИВЯЗКИ
-
- scrollbar
-
- СИНТАКСИС
-
-
- scrollbar имяПути ?параметры?
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -activerelief Имя в Базе: activeRelief Класс в Базе: ActiveRelief
-
-
- Имя параметра: -command Имя в Базе: command Класс в Базе: Command
-
-
- Имя параметра: -elementborderwidth Имя в Базе: elementBorderWidth Класс в Базе: ElementBorderWidth
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- ЭЛЕМЕНТЫ
-
-
-
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
- КОМАНДЫ ПРОКРУТКИ
-
-
-
-
- СИНТАКСИС КОМАНДЫ
-
-
- имяПути set числоЕдин окноЕдин первЕдин последЕдин
-
-
-
- префикс единица
-
-
- ПРИВЯЗКИ
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/selection.html b/hlp/ru/tk/selection.html
deleted file mode 100644
index b73fc32..0000000
--- a/hlp/ru/tk/selection.html
+++ /dev/null
@@ -1,160 +0,0 @@
-
-
-
- selection
-
- СИНТАКСИС
-
-
- selection параметр ?арг арг...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/table.html b/hlp/ru/tk/table.html
deleted file mode 100644
index 97107a3..0000000
--- a/hlp/ru/tk/table.html
+++ /dev/null
@@ -1,850 +0,0 @@
-
-
-
-table
-
-
-
-
-anchor
-
-background
-
-borderwidth
-
-cursor
-
-exportselection
-
-font
-
-foreground
-
-highlightbackground
-
-highlightcolor
-
-highlightthickness
-
-insertbackground
-
-insertborderwidth
-
-insertofftime
-
-insertontime
-
-insertwidth
-
-invertselected
-
-padx
-
-pady
-
-relief
-
-takefocus
-
-xscrollcommand
-
-yscrollcommand
-
- : autoClear
- : AutoClear
- : borderCursor
- : Cursor
- : browseCommand
- : BrowseCommand
- : cache
- : Cache
- : colOrigin
- : Origin
-
-
-
- : cols
- : Cols
- : colSeparator
- : Separator
- : colStretchMode
- : StretchMode
- : colTagCommand
- : TagCommand
-
-
- : colWidth
- : ColWidth
- : command
- : Command
- : drawMode
- : DrawMode
- : flashMode
- : FlashMode
-
-
-
-
- : flashTime
- : FlashTime
- : height
- : Height
- : invertSelected
- : InvertSelected
- : maxHeight
- : MaxHeight
- : maxWidth
- : MaxWidth
- : multiline
- : Multiline
- : resizeBorders
- : ResizeBorders
- : rowHeight
- : RowHeight
-
-
- : rowOrigin
- : Origin
- : rows
- : Rows
-
-
- : rowSeparator
- : Separator
- : rowStretchMode
- : StretchMode
- : rowTagCommand
- : TagCommand
- : selectionCommand
- :
-SelectionCommand
-
-
- : selectMode
- : SelectMode
- : selectTitles
- : SelectTitles
- : selectType
- : SelectType
- : state
- : State
- : titleCols
- : TitleCols
- : titleRows
- : TitleRows
- : useCommand
- : UseCommand
- : validate
- : Validate
- : validateCommand
- : ValidateCommand
- : variable
- : Variable
- : width
- : Width
- : wrap
- : Wrap
-rowseparator .\n. -colseparator .\t.. , , , . tk_tablePasteHandler. , -selectioncommand.
- BrowseCommand .
- Command (get) (set).
-
- :
-
-
-
-
-
-
--yscrollcommand.text
-
- СИНТАКСИС
-
-
- text имяПути параметры
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -spacing1 Имя в Базе: spacing1 Класс в Базе: Spacing1
-
-
-
- Имя параметра: -spacing2 Имя в Базе: spacing2 Класс в Базе: Spacing2
-
-
- Имя параметра: -spacing3 Имя в Базе: spacing3 Класс в Базе: Spacing3
-
-
- Имя параметра: -state Имя в Базе: state Класс в Базе: State
-
-
-
- Имя параметра: -tabs Имя в Базе: tabs Класс в Базе: Tabs
-
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width
-
-
- Имя параметра: -wrap Имя в Базе: wrap Класс в Базе: Wrap ОПИСАНИЕ
-
- ИНДЕКСЫ
-
-
- база модификатор модификатор модификатор ...
-
-
-
-
-
-
-
-
- ТЕГИ
-
-
-
-
- МЕТКИ
-
- ВСТАВЛЕННЫЕ ОКНА
-
-
-
-
-
- ВСТАВЛЕННЫЕ ИЗОБРАЖЕНИЯ
-
-
-
-
- ВЫДЕЛЕНИЕ
-
-
-
-
- КУРСОР ВВОДА
-
- КОМАНДА ПРИМИТИВА
-
-
- имяПути параметр ?арг арг ...?
-
-
-
-
-
-
- ключ1 значение1 индекс1 ключ 2 значение 2 индекс 2 ...
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ПРИВЯЗКИ
-
-
-
-
-
- ВОПРОСЫ ПРОИЗВОДИТЕЛЬНОСТИ
-
- tk
-
- СИНТАКСИС
-
-
- tk параметр ?арг арг ...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/tk.toc.html b/hlp/ru/tk/tk.toc.html
deleted file mode 100644
index a4d25b3..0000000
--- a/hlp/ru/tk/tk.toc.html
+++ /dev/null
@@ -1,60 +0,0 @@
-
-bell
-bind
-bindtags
-bitmap
-button
-canvas
-checkbutton
-clipboard
-destroy
-entry
-event
-focus
-font
-frame
-grab
-grid
-image
-label
-listbox
-lower
-menu
-menubutton
-message
-option
-options
-pack
-pack-old
-photo
-place
-radiobutton
-raise
-scale
-scrollbar
-selection
-send
-table
-text
-tk
-tk_bindForTraversal
-tk_bisque
-tk_menuBar
-tk_chooseColor
-tk_dialog
-tk_focusFollowsMouse
-tk_focusNext
-tk_focusPrev
-tk_getOpenFile
-tk_getSaveFile
-tk_chooseDirectory
-tk_messageBox
-tk_optionMenu
-tk_popup
-tkerror
-tkvars
-tkwait
-toplevel
-winfo
-Wm
diff --git a/hlp/ru/tk/tk_bisque.html b/hlp/ru/tk/tk_bisque.html
deleted file mode 100644
index 46c5c1a..0000000
--- a/hlp/ru/tk/tk_bisque.html
+++ /dev/null
@@ -1,91 +0,0 @@
-
-
-
- tk_bisque, tk_setPalette
-
- СИНТАКСИС
-
-
- tk_setPalette фон
- tk_setPalette имя значение ?имя значение ...
- tk_bisque
-
-
- ОПИСАНИЕ
-
-
-
-
- tk_chooseColor
-
- СИНТАКСИС
-
-
- tk_chooseColor ?параметр значение...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
- tk_chooseDirectory
-
- СИНТАКСИС
-
-
-
- tk_chooseDirectory ?параметр значение ...?
-
-
- ОПИСАНИЕ
-
-
-
-
- СМ. ТАКЖЕ
-
- tk_dialog
-
- СИНТАКСИС
-
-
- tk_dialog окно заголовок текст двуцвет умолч строка строка ...
-
-
- ОПИСАНИЕ
-
-
-
-
- tk_focusFollowsMouse, tk_focusNext, tk_focusPrev
-
- СИНТАКСИС
-
-
- tk_focusNext window
- tk_focusPrev window
- tk_focusFollowsMouse
-
-
- ОПИСАНИЕ
-
- tk_getOpenFile
-
- СИНТАКСИС
-
-
- tk_getOpenFile ?параметр значение...?
-
-
- ОПИСАНИЕ
-
-
-
-
- ОПИСАНИЕ ОБРАЗЦОВ
- ТИПОВ ФАЙЛОВ
-
-
- имяТипа {расширение расширение...} {макТип макТип...}
-
-
- ЗАДАНИЕ РАСШИРЕНИЙ
-
-
-
-
- ПРИМЕР
-
-
- set types {
- {{Text Files} {.txt} }
- {{TCL Scripts} {.tcl} }
- {{C Source Files} {.c} TEXT}
- {{GIF Files} {.gif} }
- {{GIF Files} {} GIFF}
- {{All Files} * }
- }
-
- set filename [tk_getOpenFile -filetypes ]
- if { != ""} {
- # Открыть файл ...
- }
-
-
-
-
diff --git a/hlp/ru/tk/tk_getSaveFile.html b/hlp/ru/tk/tk_getSaveFile.html
deleted file mode 100644
index 726cb5a..0000000
--- a/hlp/ru/tk/tk_getSaveFile.html
+++ /dev/null
@@ -1,177 +0,0 @@
-
-
-
- tk_getSaveFile
-
- СИНТАКСИС
-
-
- tk_getSaveFile параметр значение...
-
-
- ОПИСАНИЕ
-
-
-
-
- ОПИСАНИЕ
- ОБРАЗЦОВ ТИПОВ ФАЙЛОВ
-
-
- имяТипа {расширение расширение...} {макТип макТип...}
-
-
- ЗАДАНИЕ РАСШИРЕНИЙ
-
-
-
-
- ПРИМЕР
-
-
- set types {
- {{Text Files} {.txt} }
- {{TCL Scripts} {.tcl} }
- {{C Source Files} {.c} TEXT}
- {{GIF Files} {.gif} }
- {{GIF Files} {} GIFF}
- {{All Files} * }
- }
- set filename [tk_getSaveFile -filetypes ]
- # Сохранить файл ...
- }
-
-
-
-
-
diff --git a/hlp/ru/tk/tk_menuBar.html b/hlp/ru/tk/tk_menuBar.html
deleted file mode 100644
index b784a08..0000000
--- a/hlp/ru/tk/tk_menuBar.html
+++ /dev/null
@@ -1,27 +0,0 @@
-
-
-
- tk_menuBar, tk_bindForTraversal
-
- СИНТАКСИС
-
-
- tk_menuBar frame ?menu menu?
- tk_bindForTraversal arg arg
-
-
- ОПИСАНИЕ
-
- tk_messageBox
-
- СИНТАКСИС
-
-
- tk_messageBox ?параметр значение...?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
- ПРИМЕР
-
-
- set answer [tk_messageBox -message "Really quit?" -type yesno -icon question]
- case {
- yes exit
- no {tk_messageBox -message "I know you like this application!" -type ok}
- }
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/tk_optionMenu.html b/hlp/ru/tk/tk_optionMenu.html
deleted file mode 100644
index 965b7b7..0000000
--- a/hlp/ru/tk/tk_optionMenu.html
+++ /dev/null
@@ -1,37 +0,0 @@
-
-
-
- tk_optionMenu
-
- СИНТАКСИС
-
-
- tk_optionMenu w varName value ?value value?
-
-
- ОПИСАНИЕ
-
- tk_popup
-
- СИНТАКСИС
-
-
- tk_popup menu x y ?entry?
-
-
- tkerror
-
- СИНТАКСИС
-
-
- tkerror message
-
-
- ОПИСАНИЕ
-
- tkvars
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/tkwait.html b/hlp/ru/tk/tkwait.html
deleted file mode 100644
index 39fe912..0000000
--- a/hlp/ru/tk/tkwait.html
+++ /dev/null
@@ -1,39 +0,0 @@
-
-
-
- tkwait
-
-
- СИНТАКСИС
-
-
- tkwait variable name
- tkwait visibility name
- tkwait window name
-
-
- ОПИСАНИЕ
-
- toplevel
-
- СИНТАКСИС
-
-
- toplevel имяПути ?параметры?
-
-
-
- СТАНДАРТНЫЕ ПАРАМЕТРЫ
-
-
-
-
-
- ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА
-
-
-
-
- Имя параметра: -background Имя в Базе: background Класс в Базе: Background
-
-
- Имя параметра: -class Имя в Базе: class Класс в Базе: Class
-
-
- Имя параметра: -colormap Имя в Базе: colormap Класс в Базе: Colormap
-
-
- Имя параметра: -container Имя в Базе: container Класс в Базе: Container
-
-
- Имя параметра: -height Имя в Базе: height Класс в Базе: Height
-
-
- Имя параметра: -menu Имя в Базе: menu Класс в Базе: Menu
-
-
- Имя параметра: -screen Имя в Базе: Класс в Базе:
-
-
- Имя параметра: -use Имя в Базе: use Класс в Базе: Use
-
-
- Имя параметра: -visual Имя в Базе: visual Класс в Базе: Visual
-
-
- Имя параметра: -width Имя в Базе: width Класс в Базе: Width ОПИСАНИЕ
-
- КОМАНДА ПРИМИТИВА
-
-
-
- имяПути параметр арг арг ...
-
-
-
-
-
- ПРИВЯЗКИ
-
- update
-
- СИНТАКСИС
-
-
- update idletasks
-
-
- ОПИСАНИЕ
-
- winfo
-
- СИНТАКСИС
-
-
- winfo option ?arg arg ..?
-
-
- ОПИСАНИЕ
-
-
-
-
-
-
-
-
diff --git a/hlp/ru/tk/wm.html b/hlp/ru/tk/wm.html
deleted file mode 100644
index c343b2b..0000000
--- a/hlp/ru/tk/wm.html
+++ /dev/null
@@ -1,527 +0,0 @@
-
-
-
-Wm
-
-
-
-
Команда определяет наличие сетки в окне и
-позволяет задать шаг сетки в пикселях. BaseWidth и
-baseHeight определяют в единицах сетки исходный размер
-окна (определяемый, исходя из размеров виджетов). WidthInc
-и heightInc определяют соответственно горизонтальный и
-вертикальный шаг сетки. Таким образом, эти четыре величины
-определяют множество допустимых размеров окна. После выполнения
-этой команды команда wm geometry считает размеры окна
-заданными в шагах сетки. Более того, при ручном изменении
-размеров менеджер окон показывает размер окна в шагах (ячейках)
-сетки и позволяет изменять размер только дискретно в целых шагах
-сетки.
-Если BaseWidth и последующие аргументы команды пустые
-строки, команда указывает, что окно больше не имеет сетки.
Если BaseWidth и последующие аргументы
-заданы, команда возвращает пустую строку. В противном случае
-команда возвращает список из четырех элементов, содержащий
-текущие значения BaseWidth и последующих аргументов. Если
-окно не имеет сетки возвращается пустая строка.
-Если аргумент pathName задан, команда возвращает пустую
-строку. В противном случае команда возвращает имя текущего лидера
-группы для окна window или пустую строку, если лидер не
-определен.
@ИмяФайла файл должен содержать описание растрового рисунка в формате, соответствующем стандарту X11 или X10;
name имя образа типа bitmap, ранее созданного в приложении.
Если аргумент bitmap представляет собой пустую строку, отменяется использование ранее заданной маски (это эквивалентно заданию маски из одних единиц).
Если аргумент bitmap задан, команда возвращает пустую строку. В противном случае команда возвращает имя образа, используемого для маски для данного окна, либо пустую строку, если маска не задана.
wm iconname window ?newName?
Если аргумент newName задан, он передается менеджеру окон для использования в качестве имени иконки для окна. В этом случае команда возвращает пустую строку. Если аргумент newNameне задан, команда возвращает текущее имя иконки для окна; если имя иконки не задано, команда возвращает пустую строку (в этом случае менеджер окон использует в качестве имени иконки имя окна, заданное с помощью команды wmtitle).
wm iconposition window x y
Если аргументы x и y заданы, они
-передаются менеджеру окон и используются как подсказка при
-размещении иконки окна window. В этом случае команда
-возвращает пустую строку. Если x и y представляют
-собой пустые строки, команда отменяет ранее определенную
-подсказку для размещения иконки. Если аргументы x и
-y не заданы, команда возвращает текущее значение подсказки
-(или пустую строку, если она не задана).
wm iconwindow window pathName
Если аргумент pathName указан, он
-определяет имя окна, которое используется в качестве иконки для
-окна window: кодгда окно window свертывается,
-появляется окно pathName, которое используется в качестве
-иконки. Когда окно window разворачивается, окно
-pathName выводится с экрана. Если аргумент pathName
-представляет собой пустую строку, ранее определенное окно больше
-не используется как иконка.
Если аргумент pathName указан, команда возвращает пустую
-строку. В противном случае команда возвращает имя окна, ранее
-заданного в качестве иконки, или пустую строку, если ранее оно не
-было задано.
Нажатие на кнопку .Мыши. в окне-иконке не обрабатываются приложением, что позволяет обрабатывать эти события менеджеру окон.
Замечание. Не все менеджеры окон позволяют использовать Tk-окно в качестве иконки.
wm maxsize window width height
Если аргументы width и height
-заданы, они задают максимальный возможный размер окна. Если в
-окне определена сетка, размеры указываются в шагах сетки. В
-противном случае размеры указываются в пикселях. Менеджер окон не
-позволяет окну становиться больше, чем задано в команде.
-Если аргументы width и height заданы, команда
-возвращает пустую строку, в противном случае она возвращает
-список, содержащий два элемента: текущие ограничения на размер
-окна. По умолчанию максимальные размеры окна равны размеру
-экрана. Если изменение размеров окна запрещено с помощью команды
-wm resizable, команда wmmaxsize не влияет на
-окно. Более подробно этот вопрос рассмотрен ниже
-(см. Управление геометрией.)
Если аргументы width и height
-заданы, они задают минимальный возможный размер окна. Если в окне
-определена сетка, размеры указываются в шагах сетки. В противном
-случае размеры указываются в пикселях. Менеджер окон не позволяет
-окну становиться меньше, чем задано в команде.
-Если аргументы width и height заданы, команда
-возвращает пустую строку, в противном случае она возвращает
-список, содержащий два элемента: текущие ограничения на размер
-окна. По умолчанию минимальные размеры окна равны одному пикселю
-в каждом направлении. Если изменение размеров окна запрещено с
-помощью команды wm resizable, команда wm maxsize не
-влияет на окно. Более подробно этот вопрос рассмотрен ниже
-(см. Управление геометрией.).
Если аргумент boolean задан, он должен
-быть булевой величиной. Его значение присваивается
-override-redirect флагу окна. Если аргумент не задан,
-команда возвращает .1. или .0., в зависимости от того, установлен
-ли флаг для window.
-Установка флага приводит к тому, что окно не управляется
-менеджером окон. В частности, окно не будет заключено в
-декоративную рамку и пользователь не сможет изменять размеры и
-положение окна, используя стандартные механизмы менеджера
-окон.
Если аргумент who задан, он должен иметь
-одно из двух значений program или user (или
-произвольное сокращение от одного из них). Оно определяет, будет
-ли размещение окна определяться программой или пользователем.
-Многие менеджеры окон игнорируют запрошенное программой начальное
-размещение окна и требуют от пользователя разместить его вручную.
-Если задано значение user, менеджер окон не требует этого
-от пользователя. Если аргумент who задан как пустая
-строка, текущая установка отменяется.
-Если аргумент who задан, команда возвращает пустую строку.
-В противном случае команда возвращает установленное ранее
-значение или пустую строку, если значение не было установлено.
-Большинство менеджеров окон считают, что если .источник. не
-задан, это то же самое, что program. Tk автоматически
-устанавливает значение user при выполнении команды wm
-geometry, если ранее не было установлено явно значение
-program.
wm protocol window name command
Эта команда используется для организации
-обработки сообщений (протоколов) менеджера окон, таких как
-WM_DELETE_WINDOW. Аргумент name, если он задан, должен
-быть именем элемента (атома) протокола менеджера окон. Если
-заданы оба аргумента name и command, команда
-command ассоциируется с протоколом name. Значение
-name добавляется к свойству окна WM_PROTOCOLS,
-чтобы указывать менеджеру окон, что приложение имеет обработчика
-соответствующего сообщения, и какая команда должна быть выполнена
-впоследствии, когда менеджер окон пошлет клиентской программе
-соответствующее сообщение. В этом случае команда возвращает
-пустую строку.
-
Если аргумент name задан, а command
-нет, будет возвращена команда, ассоциированная с данным
-протоколом или пустая строка, если такой команды нет. Если
-command определена как пустая строка, текущий обработчик
-соответствующего события будет отменен, а имя протокола будет
-удалено из свойства PROTOCOLS окна window. Команда
-возвратит пустую строку.
-
И наконец, если ни name, ни command не заданы,
-команда возвратит список протоколов, для которых заданы
-обработчики событий для данного окна.
Tk всегда определяет обработчик событий для протокола
-WM_DELETE_WINDOW, даже если он не был задан с помощью
-команды wm protocol. Если обработчик события не был задан
-явно, то, когда поступает сообщение WM_DELETE_WINDOW, Tk
-удаляет окно, для которого было получено это сообщение.
wm resizable window width height
Эта команда управляет возможностью пользователя
-интерактивно изменять размеры окна. Если аргументы width и
-height заданы, они должны быть булевыми величинами,
-определяющими, может ли пользователь изменять в интерактивном
-режиме ширину и высоту окна соответственно. Команда при этом
-возвращает пустую строку. Если аргументы width и
-height отсутствуют, команда возвращает список из двух
-элементов, принимающих значение .0. или .1. и указывающих, может
-ли пользователь изменять высоту и ширину окна соответственно. По
-умолчанию пользователь может изменять размеры окна в обоих направлениях.
-
wm sizefrom window ?who?
Если аргумент who задан, он должен иметь
-одно из двух значений program или user (или
-произвольное сокращение от одного из них). Оно определяет, будет
-ли размер окна определяться программой или пользователем. Многие
-менеджеры окон игнорируют запрошенный программой начальный размер
-окна и требуют от пользователя определить его размер вручную.
-Если задано значение user, менеджер окон не требует этого от
-пользователя. Если аргумент who задан как пустая строка,
-текущая установка отменяется.
-
Если аргумент who задан, команда возвращает пустую
-строку. В противном случае команда возвращает установленное ранее
-значение; если значение не было установлено, команда возвращает
-пустую строку. Большинство менеджеров окон считают, что если
-.источник. не задан, это то же самое, что
-program.
-
wm state window
Команда возвращает текущее состояние окна:
-normal, iconic, withdrawn или icon. Разница
-между iconic и icon в том, что iconic
-используется для свернутого окна (например, с помощью команды
-wm iconify ), а icon для окна, которое используется
-в качестве иконки для другого окна (с помощью команды wm iconwindow).
-
wm title window string
Если аргумент string определен, он
-передается менеджеру окон для использования в качестве имени
-(титула) окна, которое менеджер окон высвечивает на рамке окна. В
-этом случае команда возвращает рустую строку. Если аргумент
-string не задан, команда возвращает ранее установленный
-заголовок. По умолчанию титул окна совпадает с его полным именем как виджета.
-
wm transient window master
Если аргумент master задан, команда
-передает менеджеру окон информацию о том, что окно window
-является временным окном (например, выпадающим меню), работающим
-под управлением master-окна (где master полное имя
-toplevel-окна). Некоторые менеджеры окон используют эту
-информацию для того, чтобы управлять таким окном специальным
-образом. Если аргумент master представляет собой пустую
-строку, окно перестает быть временным окном.
-
Если аргумент master задан, команда возвращает пустую
-строку. В противном случае она возвращает имя управляющего окна
-или пустую строку, если окно window не является временным.
-
wm withdraw window
При выполнении команды окно window
-удаляется с экрана. Информация о нем удаляется из менеджера окон.
-Если окно не присутствовало на экране ранее, оно не появится на
-экране при создании. Но не все менеджеры окон знают, как работать с такими окнами!
-
Замечание. Иногда оказывается необходимым удалить
-окно с помощью команды wm withdraw, а затем возвратить его
-обратно на экран (например, с помощью команды wm deiconify), чтобы менеджер окон учитывал некоторые его атрибуты, например, группу.
-
-
-
-
-
-
-
-