::safe::loadTk slave ?-use windowId?

  Режим Safe Tk основан на режиме Safe Tcl, обеспечивающем ограниченный и опосредованный доступ к автозагрузке и пакетам для безопасных интерпретаторов. Safe Tk добавляет способность конфигурирования интерпретатора для безопасных Tk операций и загрузки Tk в безопасные интерпретаторы.

Команда ::safe:: запускает необходимые структуры данных в безопасном интерпретаторе и загружает в него Tk. Команда возвращает имя безопасного интерпретатора.

При работе с Tk в безопасном интерпретаторе необходимо следовать правилам поддержания безопасности, а также специальным рекомендациям для работы с Tk.

СМ. ТАКЖЕ

 
 

safe(n), interp(n), library(n), load(n), package(n), source(n), unknown(n)
 
 
 

  bell




Команда подает звуковой сигнал.

  bell ?-displayof window?

  Команда bell подает сигнал громкоговорителем дисплея для window. Если этот аргумент не задан, то по умолчанию используется дисплей главного окна приложения. В некоторых случаях команда гасит работающий в данный момент хранитель экрана (screen-saver), и окно снова становится видимым.  
 
   

bind≈ привязка скриптов Tcl к X событиям. Команда назначает событиям ввода от ⌠Мыши■ и клавиатуры (Х событиям) исполнение скрипта Tcl.
 

Синтаксис   Описание   Образцы событий   Модификаторы   Типы событий   Подстановки и скрирты привязки   Несколько привязок , отвечающих образцу     Последовательности нескольких событий и игнорируемые события    Ошибки

 
bind тег

bind тег последовательность

bind тег последовательность скрипт

bind тег последовательность+скрипт

 

  Команда bind привязывает Tcl скрипты к X событиям. Если заданы все три аргумента команды, то при каждом наступлении события последовательность в окне (окнах), описанных тегом, будет выполняться скрипт (скрипт Tcl). Если аргументу скрипт предшествует знак ▒+▓, то скрипт добавляется к уже существующим привязкам к последовательности; в противном случае он замещает все имеющиеся привязки. Если аргумент скрипт пуст, то все имеющиеся привязки к последовательности отменяются, и последовательность становится несвязанной. Если аргумент скрипт присутствует, то команда bind возвращает пустую строку.

Если при отсутствии аргумента скрипт аргумент последовательность задан, то команда возвращает скрипт, привязанный к данной последовательности, или, в случае отсутствия такого скрипта, пустую строку. Если не задан ни один из аргументов последовательность и скрипт, то команда возвращает список, элементами которого служат все последовательности, имеющие привязки к окну тег.

Аргумент тег перечисляет окна, к которым выполняется привязка. Если значение аргумента начинается с точки, скажем ▒.a.b.c▓, то оно должно представлять собой путь к окну; в противном случае оно может быть произвольной строкой. Каждому окну приписан некоторый список тегов, и привязка к данному окну осуществляется, если значение аргумента тег присутствует в этом списке. Команда bindtags позволяет приписать окну произвольный набор тегов привязки; кроме того, по умолчанию окнам приписаны следующие теги:

• тег, являющийся именем внутреннего окна, приписывается этому окну;
• тег, являющийся именем окна верхнего уровня, приписывается этому окну и всем его внутренним окнам;
• тег, являющийся именем класса примитивов, скажем Button, приписывается всем примитивам этого класса;
• тег с именем all приписывается всем окнам приложения.

 
Аргумент последовательность представляет собой последовательность одного или нескольких образцов событий. Каждый образец может быть записан в одном из трех видов. В простейшем случае это символ ASCII, скажем ▒a▓ или ▒|▓. Этот символ не может быть ▒пробелом▓ или знаком ▒<▓. Этот вид образцов соответствует событию KeyPress для конкретной клавиши. Образцы второго вида длиннее, однако, этот вид носит более общий характер. Его синтаксис выглядит следующим образом:

<модификатор-модификатор-тип-детализация>

Образец события целиком заключен в угловые скобки. Внутри угловых скобок располагаются несколько модификаторов (быть может, ни одного), тип события и дополнительная порция информации (детализация), указывающая конкретную кнопку или комбинацию клавиш. Одно из полей тип или детализация должно обязательно присутствовать, остальные могут быть опущены. Поля разделяются пробелами или дефисами.

Третья форма образца используется для задания поименованного виртуального события, определенного пользователем. У нее следующий синтаксис:

<<имя>>

Образец события целиком заключен в двойные угловые скобки. Внутри этих скобок содержится определенное пользователем имя виртуального события. С виртуальным событием нельзя комбинировать модификаторы, такие как Shift или Control. Привязки к виртуальному событию можно создавать до описания самого события; при динамическом изменении этого описания все окна, привязанные к событию, будут обращаться к новому описанию.
 

 
Модификаторы могут быть следующими:

 

Control	Mod2, M2
Shift	Mod3, M3
Lock	Mod4, M4
Button1, B1	Mod5, M5
Button2, B2	Meta, M
Button3, B3	Alt
Button4, B4	Double
Button5, B5	Triple
Mod1,	M1

  Если в строке приведено несколько элементов, разделенных запятыми, то они взаимозаменяемы. У большинства модификаторов есть очевидное X значение. Например, модификатор Button 1 требует нажатия кнопки 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	Button	Expose	Map
ButtonRelease	FocusIn	Motion
Circulate	FocusOut	Property
Colormap	Gravity	Reparent
Configure	KeyPress	Key Unmap
Destroy	KeyRelease	Visibility
Enter	Leave	Activate	Deactivate

Последней частью длинной спецификации события является детализация. Для типов 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, причем интерпретация происходит на верхнем уровне (доступны только значения глобальных переменных). Если в скрипте есть символы ▒%▓, то его исполнение не будет осуществляться непосредственно. Каждый символ ▒%▓ и символ, следующий за ним, заменяются данными о происшедшем событии, в результате чего генерируется новый скрипт. Подстановка осуществляется в соответствии с приводимым ниже списком символов. Если не оговорено противное, то подставляемая строка представляет собой десятичное содержимое указанного поля события. Некоторые подстановки допустимы только для событий определенных типов: при использовании их с событиями других типов результат подстановки не определен.

 
%%  Заменяется однократным процентом.

%#    Номер последнего обработанного сервером запроса клиента (сериальное поле события). 

Допустимо для событий всех типов
.

%a    Поле выше события, отформатированное как шестнадцатеричное число. 

Допустимо только для событий Configure.


%b    Номер нажатой или отпущенной кнопки. 

Допустимо только для событий ButtonPress и ButtonRelease.


%c    Поле счетчик события. 

Допустимо только для событий Expose.


%d    Поле детализация события. 

Символы ▒%d▓ заменяются строкой детализации. 
Для событий Enter, Leave, FocusIn, FocusOut 
строка должна быть одной из следующих:

 
Для прочих событий подставляемая строка не определена.
 

%f	Поле фокус события (0 или 1). Допустимо только для событий Enter и Leave.
%h	Поле высота события. Допустимо только для событий Configure и Expose.
%k	Поле код_клавиши события. Допустимо только для событий KeyPress и KeyRelease.
%m	Поле режим события. Подставляется одна из строк NotifyNormal, NotifyGrab, NotifyUngrab или NotifyWhileGrabbed. Допустимо только для событий Enter,FocusIn, FocusOut и Leave.
%o	Поле подавить_перенаправление события.Допустимо только для событий Map,Reparent и Configure.
%p	Поле размещать события. Строка подстановки имеет вид PlaceOnTop или PlaceOnBottom. Допустимо только для     событий Circulate.
%s	Поле состояние события. Для событий ButtonPress, ButtonRelease, Enter, KeyPress, KeyRelease, Leave и Motion происходит подстановка десятичного числа. Для события Visibility подставляется одна из строк isibilityUnobscured, VisibilityPartiallyObscured или VisibilityFullyObscured.
%t	Поле время события. Допустимо только для событий, содержащих поле время.
%w	Поле ширина события. Допустимо только для событий Configure и Expose.
%x	Поле x события. Допустимо только для событий, содержащих поле x.
%y	Поле y события.Допустимо только для событий, содержащих поле y.
%A	Заменяется символом ASCII, отвечающим происшедшему событию,или пустой строкой, если событию не соответствуетникакой символ ASCII (например, нажата клавиша верхнего регистра). Работу по переводу события в ASCII символ выполняет XLookupString. Допустимо только для событий KeyPress и KeyRelease.
%B	Поле ширина_бордюра события.Допустимо только для событий Configure.
%E	Поле послать_событие события.Допустимо для событий всех типов.
%K	Код клавиши, соответствующей данному событию, представленный текстовой строкой. Допустимо только для событий KeyPress и KeyRelease.
%N	Код клавиши, соответствующей данному событию, представленный десятичным числом. Допустимо только для событий KeyPress и KeyRelease.
%R	Идентификатор корневого окна события.Допустимо только для событий  содержащих поле корень
%S	Идентификатор подокна события, представленный в виде шестнадцатиричного числа. Допустимо только для событий  содержащих поле подокно.
%T	Поле тип события. Допустимо для событий всех типов.
%W	Путь к окну, к которому отнесено событие (поле окно события). Допустимо для событий всех типов.
%X	Поле x_корень события. При использовании виртуально-корневого менеджера окон подставляемое значение равняется x-координате в виртуальном корне. Допустимо только для событий ButtonPress, ButtonRelease, KeyPress, KeyRelease  и Motion.
%Y	Поле y_корень события. При использовании виртуально-корневого менеджера окон подставляемое значение равняется  y-координате в виртуальном корне. Допустимо только для событий ButtonPress, ButtonRelease, KeyPress, KeyRelease   и Motion.

Строка подстановки для %-замещения форматируется как обычный элемент списка Tcl. Это означает, что при наличии в строке пробелов она заключается в фигурные скобки, а специальным символам, таким как `$' и `{' может предшествовать обратная косая черта. Такая строка нормально обрабатывается синтаксическим анализатором Tcl при выполнении скрипта. Строки подстановки по большей части являются числами или корректно определенными строками как, например, Above; такие строки не нуждаются ни в каком специальном форматировании. Чаще всего форматирования требуют строки, замещающие %A. Если, например, скрипт имеет вид insert %A и вводимым символом является открывающая квадратная скобка, то реально исполняемым скриптом будет insert \[ т.е. в качестве первого аргумента insert получит исходную строку подстановки (открывающую квадратную скобку). Если бы обратная косая черта не была добавлена, Tcl не смог бы правильно обработать скрипт.

Данному X событию может отвечать несколько привязок. Если эти привязки соответствуют различным тегам, то все они выполняются по очереди. По умолчанию сначала исполняется привязка для примитива, затем привязка класса, затем привязка верхнего уровня и привязка all. Этот порядок для конкретного окна можно поменять с помощью команды bindtags, которая позволяет также выполнить дополнительные привязки к окну.
Управление обработкой скриптов, отвечающих образцу, осуществляется командами continue и break в привязанном скрипте. При выполнении команды continue выполнение текущего привязанного скрипта прерывается и Tk переходит к выполнению скриптов, соответствующих остальным тегам. При выполнении команды break  выполнение текущего привязанного скрипта прерывается и никакие другие скрипты не выполняются.

Если данному событию соответствует несколько привязок с одним и тем же тегом, то из них выбирается наиболее конкретная привязка и выполняется ее скрипт. Выбор наиболее конкретной привязки осуществляется по следующим критериям:

а) образец события, задающий конкретную кнопку или клавишу, более конкретен, чем тот, в котором такой спецификации не задано;

б) более длинная последовательность (по числу отвечающих образцу событий) конкретнее более короткой;

в) если модификаторы первого образца содержатся среди модификаторов второго, то образец с большим числом модификаторов более конкретен;

г) виртуальное событие, физический образец которого соответствует последовательности, менее конкретно, чем тот же самый физический образец, не связанный ни с каким виртуальным событием;

д) если последовательность отвечает двум или более виртуальным событиям, то из них выбирается какое-нибудь одно, однако порядок выбора не определен.
Если в подходящей последовательности событий больше одного события, то критерии (а) - (д) применяются ко всем событиям, начиная с самого последнего и до самого первого события последовательности. Если критерии не позволяют определить победителя, то победителем становится событие, зарегистрированное последним.

Если одна и та же последовательность осуществляет переключение к двум (или более) виртуальным событиям, и теги окон этих виртуальных событий совпадают, то переключение произойдет лишь к одному из этих виртуальных событий, выбранному случайным образом:

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}

При нажатии 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).

Команда определяет, какие привязки относятся к окну и порядок обработки.

Создание примитива кнопки и управление им.
 

Синтаксис

Стандартные параметры

Дополнительные параметры примитива

Описание

Команда примитива

 

СИНТАКСИС  
button имяПути параметры

 
 

-activebackground	-cursor	-highlightthickness
-takefocus	-activeforeground	-disabledforeground
-image	text	-anchor
-font	-justify	-textvariable
-background	-foreground	-padx
-underline	-bitmap	-highlightbackground
-pady	-wraplength	-borderwidth
-highlightcolor	-relief

Подробное описание этих параметров приведено в разделе options.

ОПИСАНИЕ

canvas имяПути параметры

СТАНДАРТНЫЕ ПАРАМЕТРЫ

 
 

-background	-highlightthickness	-insertwidth
-takefocus	-borderwidth	-insertbackground
-relief	-xscrollcommand	-cursor
-insertborderwidth	-selectbackground	-yscrollcommand
-highlightbackground	-insertofftime	-selectborderwidth
-highlightcolor	-insertontime	-selectforeground

Подробное описание параметров приведено в разделе options.

ПАРАМЕТРЫ, СВЯЗАННЫЕ ИСКЛЮЧИТЕЛЬНО С ПРИМИТИВАМИ

Имя параметра: -closeenough
Имя в Базе: closeEnough
Класс в Базе: CloseEnough
 

Задает значение с плавающей точкой, указывающее расстояние от курсора до объекта на экране, при котором курсор считается находящимся внутри объекта. По умолчанию имеет значение ⌠1.0■.

Имя параметра: -confine
Имя в Базе: confine
Класс в Базе: Confine
 

Булевское значение, указывающее, допустимо ли устанавливать вид канвы вне области, заданной аргументом scrollRegion. По умолчанию имеет значение истина, т.е. такая установка запрещена.

Имя параметра: -height
Имя в Базе: height
Класс в Базе: Height
 

Задает желаемую высоту окна, которое примитив канвы должен запросить у своего графического менеджера. Значение может иметь любой вид из описанных ниже (см. "Координаты").

Имя параметра: -scrollregion
Имя в Базе: scrollRegion
Класс в Базе: ScrollRegion
 

Задает список из четырех величин, описывающих координаты левой, верхней, правой и нижней границы прямоугольной области. Эта область используется для прокрутки и считается границей информации в канве. Каждая из координат может иметь любой вид из описанных ниже в (см. "Координаты").

Имя параметра: -width
Имя в Базе: width
Класс в Базе: width
 

Задает желаемую ширину окна, которое примитив канвы должен запросить у своего графического менеджера. Значение может иметь любой вид из описанных ниже (см. Координаты).

Имя параметра: -xscrollincrement
Имя в Базе: xScrollincrement
Класс в Базе: Scrollincrement
 

Задает шаг горизонтальной прокрутки в любом из принятых видов для расстояний на экране. Если указанная величина положительна, то x-координата левой границы будет выбрана пропорциональной значению xScrollincrement с четным коэффициентом пропорциональности. Кроме того, шаг прокрутки (при нажатии на стрелки влево и вправо полосы прокрутки) также принимает значение xScrollincrement. Если значение параметра неположительно, то прокрутка выполняется без ограничений.

Имя параметра: -yscrollincrement
Имя в Базе: yScrollincrement
Класс в Базе: Scrollincrement

  Задает шаг вертикальной прокрутки в любом из принятых видов для расстояний на экране. Если указанная величина положительна, то y-координата верхней границы будет выбрана пропорциональной значению yScrollincrement с четным коэффициентом пропорциональности. Кроме того, шаг прокрутки (при нажатии на стрелки вверх и вниз полосы прокрутки) также принимает значение yScrollincrement. Если значение параметра неположительно, то прокрутка выполняется без ограничений.

ВВЕДЕНИЕ

 
Команда canvas создает новое окно (заданное аргументом имяПути) и преобразует его в примитив канвы. С помощью описанных выше дополнительных аргументов в строке команды или в базе данных параметров можно задать такие характеристики канвы, как цвета или трехмерное представление. Команда canvas возвращает свой аргумент имяПути. В момент исполнения команды окно с именем имяПути должно отсутствовать, однако его ⌠родительское■ должно существовать.

Примитивы канвы реализуют структурную графику. Канва изображает некоторый набор элементов, таких как прямоугольники, окружности, линии или текстовые элементы. Над элементами можно выполнять различные действия (например, передвигать или перекрашивать их), и к ним можно приписывать команды способом, аналогичным тому, как команда bind привязывает команды к примитивам. Можно, например, приписать некоторую команду событию <Button-1>, и эта команда будет выполняться всякий раз при нажатии кнопки 1 на данном элементе. Таким образом, поведение элементов канвы может определяться привязанным к ним скриптам Tcl.
 

СПИСОК ВЫВОДА  
Элементы канвы упорядочены, так что при выводе на экран сначала выводится первый элемент, за ним второй и так далее. Очередные выводимые элементы заслоняют элементы, уже выведенные на экран; иногда про них говорят, что они выводятся ⌠поверх■ первых. При создании нового элемента он заносится на последнее место в списке, поверх всех элементов, созданных ранее. Порядок элементов в списке можно поменять с помощью команд примитивов.

Элементы-окна представляют собой исключение из приведенного правила. Базовая система управления окнами предполагает, что новое окно всегда выводится поверх всех предыдущих. Кроме того, команды примитивов канвы не влияют на порядок в стеке окон; вместо них надо использовать команды Tk raise и lower.
 

ИДЕНТИФИКАТОРЫ И ТЕГИ ЭЛЕМЕНТОВ  
Есть два способа обращаться к элементам примитивов канвы ≈ по идентификатору и по тегу. У каждого элемента есть свой уникальный идентификационный номер, присваиваемый при создании элемента. Идентификатор элемента никогда не изменяется, и ни один идентификатор не используется дважды на протяжении существования данного примитива канвы.

Кроме того, каждому элементу канвы можно приписать несколько тегов. Тег ≈ это просто строка символов, и он может быть иметь любой вид кроме числового. Например, ⌠x123■ годится, а ⌠1■23■ нет. Один и тот же тег можно приписывать нескольким элементам. Обычно это свойство используется для объединения элементов по характерным признакам. Например, всем выбранным элементам можно приписать тег ⌠selected■.

Тег all приписан по умолчанию всем элементам канвы; с его помощью выполняются операции на всех элементах канвы.

Тегом current автоматически управляет Tk. Он относится к текущему элементу, находящемуся поверх всех остальных из тех, чья область покрывает положение курсора. Если курсор ⌠Мыши■ расположен вне примитива канвы или если он не накрывается никаким элементом, то тег current не приписывается никакому элементу.

При указании элемента в командах примитивов канвы реализован следующий подход: если описатель является числом, то это число интерпретируется как идентификатор элемента. В противном случае описатель относится ко всем элементам с таким тегом. Используемый ниже символ тегИлиИд указывает на то, что соответствующий аргумент может быть тегом, которому отвечает несколько (быть может, ни одного) элемента, или идентификатором, которому отвечает единственный элемент. Некоторые команды примитивов могут работать одновременно только с одним элементом; если символу тегИлиИд соответствует несколько элементов, то такая команда обычно обрабатывает первый (самый нижний) элемент списка вывода, к которому она применима. Исключения приведены ниже в описаниях команд примитивов.
 

КООРДИНАТЫ  
Все координаты канвы записываются в форме чисел с плавающей точкой. Координаты и расстояния на экране задаются в виде чисел с плавающей точкой, за которыми может следовать одна или несколько букв. Если буквы нет, то единицей измерения расстояния является пиксель. Буква m указывает на измерение расстояний в миллиметрах; буква c ≈ в сантиметрах; i ≈ в дюймах; p ≈ в точках принтера (1/72 дюйма). При перемещении по экрану вниз y-координата увеличивается; x-координата возрастает при перемещении по экрану вправо.

ПРЕОБРАЗОВАНИЯ

 
Обычно начало системы координат канвы расположено в верхнем левом углу окна, содержащего канву. Положение начала координат относительно окна можно изменить с помощью команд xview и yview. Обычно этой возможностью пользуются при прокрутке. Канва не позволяет растягивать систему координат или поворачивать ее по отношению к системе координат окна.

Отдельные элементы канвы можно сдвигать с помощью описываемых ниже команд примитивов; их можно также растянуть или сжать, но нельзя повернуть.
 

ИНДЕКСЫ  
Для указания на отдельные части текста в текстовых элементах поддерживаются индексы. Индексы используются в командах вставки текста, удаления части текста, установки курсора ввода. Индекс можно определить одним из нескольких возможных способов; различные типы элементов поддерживают индексы различных типов. Ниже приведено описание видов индексов; при введении новых типов текстовых элементов имеет смысл обеспечить поддержку разумного подмножества видов индекса. Отметим, что можно ссылаться на символ, следующий непосредственно за последним символом текстового элемента; эта возможность полезна, например, при вводе нового текста в конец элемента.

число

Десятичное число, указывающее положение нужного символа внутри текстового элемента. "0" указывает на первый символ, ⌠1■ ≈ на второй и т.д. Отрицательные числа интерпретируются как 0, а числа, большие длины текстового элемента ≈ как если бы они равнялись этой длине. end Указывает на символ, следующий непосредственно за последним символом текстового элемента (совпадает с числом символов в элементе). insert

Указывает на символ, непосредственно предшествующий курсору ввода.

sel.first

Указывает на первый выделенный символ в элементе. Если в элементе нет выделенных символов, то такая форма запрещена. sel.last Указывает на последний выделенный символ в элементе. Если в элементе нет выделенных символов, то такая форма запрещена. @x,y Указывает на символ в позиции (x,y), где x и y заданы в координатной системе канвы. Если значения координат выходят за пределы, занятые текстовым элементом, то берется первый или последний символ в строке, ближайшей к указанной позиции.

КОМАНДА ПРИМИТИВА

 
Команда canvas создает новую команду Tcl с именем имяПути. С помощью этой новой команды можно выполнять различные операции над примитивами. Она имеет следующий общий вид:

имяПутипараметр аргумент аргумент ...

Параметр и аргументы уточняют поведение команды. В примитивах канвы могут встречаться следующие команды примитивов:
 

имяПути addtagтег спец_поиска арг арг ... Добавляет тег к списку тегов, связанному с каждым элементом, удовлетворяющим ограничениям, заданным спец_поиска и аргументами (если такого тега в списке еще нет). Если ни один элемент не удовлетворяет наложенным ограничениям, то команда не производит никаких действий. Результатом выполнения команды является пустая строка. Спец_поиска и аргументы могут принимать следующие значения: above тегИлиИд Выделяет элемент, непосредственно следующий (расположенный поверх) за элементом тегИлиИд в списке вывода. Если аргумент тегИлиИд задает несколько элементов, то команда выполняется по отношению к последнему (самому верхнему) из них. all Выделяет все элементы канвы. below тегИлиИд Выделяет элемент, непосредственно предшествующий (расположенный ниже) элементу тегИлиИд в списке вывода. Если аргумент тегИлиИд задает несколько элементов, то команда выполняется по отношению к первому (самому нижнему) из них. closest x y нимб начало Выделяет элемент, ближайший к точке с координатами (x,y). Если таких элементов несколько (например, несколько элементов накрывают эту точку), то выделяется самый верхний из них. Нимб, если он задан, должен быть неотрицательным числом. Всякий элемент, расстояние от которого до точки (x,y) меньше, чем нимб, считается накрывающим эту точку. Аргумент начало позволяет обходить по кругу все ближайшие к точке элементы. Начало, если оно задано, представляет собой идентификатор или тег элемента (в случае, если это тег, будет выбран первый элемент списка, соответствующего данному тегу). В этой форме выделяется не самый верхний элемент из ближайших, а самый верхний из тех ближайших элементов, которые ниже элемента начало в списке вывода. В случае если таких элементов нет, команда выполняется так же, как и в отсутствие аргумента начало. enclosed x1 y1 x2 y2 Выделяет все элементы, заключенные внутри прямоугольника с углами (x1,y1) и (x2,y2). Величина x1 должна быть не меньше, чем x2, а y1 ≈ не меньше, чем y2. overlapping x1 y1 x2 y2I Выделяет все элементы, перекрывающиеся с прямоугольником с углами (x1,y1) и (x2,y2). Величина x1 должна быть не меньше, чем x2, а y1 ≈ не меньше, чем y2. withtag тегИлиИд Выделяет все элементы, заданные тегИлиИд.

имяПути bbox тегИлиИд тегИлиИд тегИлиИд
 

Возвращает список из четырех элементов ≈ приближенных значений координат прямоугольника, ограничивающего все элементы, заданные аргументами тегИлиИд. Список имеет вид ⌠x1 y1 x2 y2■, причем экранные представления элементов находятся в области, ограниченной слева вертикальной прямой с координатой x1, справа ≈ вертикальной прямой с координатой x2, сверху ≈ горизонтальной прямой с координатой y1, снизу ≈ горизонтальной прямой с координатой y2. Значения координат могут отличаться от точных на несколько пикселей. Если под описание тегИлиИд не подходит ни один элемент или если у этих элементов прямоугольники вывода пусты, то команда возвращает пустую строку.

имяПути bind тегИлиИд последовательность команда

Эта команда привязывает ко всем элементам, заданным аргументом тегИлиИд, команду, которая выполняется всякий раз при наступлении события, описываемого последовательностью, на одном из этих элементов. Эта команда похожа на команду bind, за исключением того, что она действует на элементах канвы, а не на целых примитивах. Синтаксис последовательности и подстановки, выполняемые в команде перед ее выполнением, подробно описаны в bind. Если в команде заданы все аргументы, то создаваемая привязка замещает все предыдущие привязки для той же последовательности и тегИлиИд (если первый символ в команде ⌠+■, то новая привязка присоединяется к уже существующим, а не замещает их). В этом случае команда возвращает пустую строку. Если аргумент команда опущен, то возвращается строка команды, связанной с тегИлиИд и последовательностью (если такой команды нет, то возникает ошибка). Если опущены оба аргумента команда и последовательность, то результатом выполнения служит список всех последовательностей, для которых определена привязка к тегИлиИд. Привязки можно задавать только для событий, связанных с клавиатурой или ⌠Мышью■ (таких как Enter, Leave, ButtonPress, Motion и KeyPress), а также для виртуальных событий. При работе с событиями в канве используется текущий элемент, определенный выше (см. ⌠Идентификаторы и теги  элементов■). События Enter и Leave наступают, когда элемент становится или перестает быть текущим; обратите внимание на отличие этих событий от событий Enter и Leave для окон. События, связанные с ⌠Мышью■, наступают только для текущего элемента (если таковой имеется; подробности см. ниже в описании команды примитива focus). При использовании в привязке виртуального события привязка может подключиться только, если в определении этого виртуального события участвует событие, связанное с ⌠Мышью■ или клавиатурой.

Данному событию может соответствовать несколько привязок. Такое может произойти, например, если одна привязка осуществляется к идентификатору события, а другая ≈ к одному из его тегов. В подобном случае выполняются все привязанные события. Первым идет скрипт, привязанный к тегу all, затем поочередно выполняются скрипты, привязанные к каждому из тегов элемента (в порядке их следования), последней идет привязка к идентификатору элемента. Если несколько привязок соответствует одному тегу, то выполняется лишь самая конкретная из них. Команда continue в скрипте прекращает его выполнение, команда break прекращает выполнение скрипта и всех последующих скриптов для события, как и в случае команды bind.

Если с помощью команды bind к окну канвы были выполнены дополнительные привязки, то они выполняются после привязок к элементам канвы, выполненных командой примитива bind.

имяПути canvasx xЭкрана шагСетки

По заданной x-координате xЭкрана окна возвращает x-координату канвы, расположенной на этом месте. Если задан шагСетки, то координата канвы округляется к ближайшему кратному единиц шагаСетки.

имяПути canvasy yЭкрана шагСетки

По заданной y-координате yЭкрана окна возвращает y-координату канвы, расположенной на этом месте. Если задан шагСетки, то координата канвы округляется к ближайшему кратному единиц шагаСетки.

имяПути cgetпараметр

Возвращает текущее значение параметра конфигурации, заданного аргументом параметр.

имяПути cоnfigure параметр значение параметр значение ...

Сообщает текущие параметры конфигурации примитива или модифицирует их. Если параметр не задан, то возвращает список всех текущих значений параметров имениПути (формат списка приведен в описании Tk_ConfigureInfo). Если параметр задан без указания значения, то команда возвращает список, описывающий указанный параметр (этот список совпадает с частью списка, возвращаемого при отсутствии параметра). Если заданы одна или несколько пар параметр-значение, то команда присваивает указанным параметрам примитива данные значения; результатом ее выполнения в этом случае служит пустая строка. Параметр может принимать любые значения, воспринимаемые командой canvas.

имяПути coords тегИлиИд x0 y0 ...

Сообщает текущие значения координат, определяющих элемент, или модифицирует их. Если координаты не заданы, то возвращает список, составленный из координат элемента, указанного аргументом тегИлиИд. Если координаты заданы, то их значения замещают текущие значения координат означенного элемента. Если тегИлиИд указывает на несколько элементов, то команда выполняется для идущего первым в списке вывода.

имяПути create типx y x y ... параметр значение ...

Создает в имяПути новый элемент типа тип. Формат аргументов, следующих за аргументом тип, зависит от значения типа, однако обычно эти аргументы представляют собой координаты одной или нескольких точек, за которыми следуют спецификации нескольких параметров элемента (быть может, ни одного). Подробнее синтаксис этой команды описан ниже (см. Описания различных типов).

имяПути dchars тегИлиИд первый последний

Удаляет символы с первого по последний включительно в каждом элементе, подходящем под описание тегИлиИд. Если какие-либо из этих элементов не поддерживают текстовых операций, то они пропускаются. Аргументы первый и последний должны быть индексами символов в элементе, заданными в соответствии с описанием, приведенным в разделе  Индексы . При опущенном аргументе последний его значение принимается по умолчанию равным значению первый. Команда возвращает пустую строку.

имяПути delete тегИлиИд тегИлиИд ...

Удаляет все элементы, подходящие под описание, заданное аргументами, и возвращает пустую строку.

имяПути dtagтегИлиИд тегДляУдаления

Удаляет все теги тегДляУдаления из списка тегов, ассоциированного с каждым из элементов, описываемых аргументом тегИлиИд. Если ни один из тегов такого элемента не входит в тегДляУдаления, то никаких действий не производится. Если аргумент тегДляУдаления отсутствует, то его значение по умолчанию совпадает с тегИлиИд. Команда возвращает пустую строку.

имяПути findкомандаПоиска арг арг ...

Команда возвращает список, состоящий из всех элементов, удовлетворяющих критериям поиска, заданным аргументами командаПоиска и арг. Аргументы командаПоиска и арг могут иметь любой вид, воспринимаемый командой addtag. Список элементов представлен в виде стека, в котором нижний элемент идет последним.

имяПути focus тегИлиИд

Устанавливает фокус клавиатуры для примитива канвы на элементе, заданном аргументом тегИлиИд. Если под описание подходят несколько элементов, то фокус устанавливается на тот из них, который идет первым в списке вывода из элементов, поддерживающих курсор ввода. Если под описание не подходит ни один из элементов или если ни один из подходящих элементов не поддерживает курсор ввода, то фокусировка не меняется. Если тегИлиИд представляет собой пустую строку, то ни один из элементов не оказывается в фокусе. Если аргумент тегИлиИд не задан, то команда возвращает идентификатор элемента, находящегося в фокусе или пустую строку, если такого элемента нет. После установки фокуса на элемент в этом элементе будет отображаться курсор ввода и все клавиатурные события будут направлены на этот элемент. Элемент фокусировки канвы и окно фокусировки на экране (установленное командой focus) совершенно независимы: элемент находится в фокусе ввода только если (а) его канва является окном фокусировки и (б) сам элемент является элементом фокусировки канвы. В большинстве случаев полезно вслед за командой focus примитива выполнять команду focus, чтобы установить фокус на канве (если такая установка еще не была произведена).  

имяПути gettags тегИлиИд

Возвращает список, элементами которого служат теги, ассоциированные с элементом, подходящим под описание тегИлиИд. Если под это описание подходят несколько элементов, то список относится к тому из них, который идет первым в списке вывода. Если элементов, подходящих под описание нет или если у подходящего элемента нет тегов, то команда возвращает пустую строку.

имяПути icursor тегИлиИд индекс

Устанавливает курсор ввода для элемента (элементов), подходящего под описание тегИлиИд, в положение, непосредственно предшествующее символу, заданному аргументом индекс. Если некоторые (быть может, все) подходящие элементы не поддерживают курсор ввода, то над ними никаких действий не производится. Допустимые формы аргумента индекс описаны выше (см. Индексы). Замечание: фактическое высвечивание курсора ввода в элементе производится только, если этот элемент находится в фокусе (см. описание команды примитива focus), однако положение курсора можно установить и в элементе вне фокуса. Команда возвращает пустую строку.

имяПути insert тегИлиИд передЭтим строка

Вставляет строку перед символом, заданным аргументом передЭтим, в каждом из элементов, подходящих под описание тегИлиИд и поддерживающих курсор ввода. Возможные формы аргумента передЭтим описаны выше (см. Индексы). Команда возвращает пустую строку.

имяПути itemcget тегИлиИд параметр

Возвращает текущее значение параметра конфигурации с именем параметр для элемента тегИлиИд. Команда аналогична команде примитива cget, за исключением того, что она относится к отдельному элементу, а не к примитиву в целом. Значение параметра может быть любым, допустимым для команды примитива create, используемой для создания элемента. Если тег тегИлиИд описывает несколько элементов, то команда применяется к первому из них.

имяПути itemconfigure тегИлиИд параметр значение параметр значение ...

Команда аналогична команде примитива configure за исключением того, что она изменяет значения параметров элементов, а не всего примитива канвы. Если аргумент параметр не задан, то команда возвращает список значений параметров для первого элемента, подходящего под описание тегИлиИд (формат списка описан в Tk_ConfigureInfo). Если аргумент параметр задан, а аргумент значение отсутствует, то команда возвращает список значений только указанного параметра (этот список является подсписком списка, возвращаемого в отсутствие аргумента параметр). Если задано несколько пар параметр-значение, то команда устанавливает новые значения указанных параметров для каждого из элементов тегИлиИд; в этом случае команда возвращает пустую строку. Допустимые формы параметров и значений такие же, как в команде примитива create, которая создает элементы. Допустимые параметры и возможные их значения описаны ниже (см. описание отдельных типов элементов).

имяПути lower тегИлиИд нижеЭтого

Передвигает все элементы, подходящие под описание тегИлиИд, в списке вывода непосредственно перед элементом, заданным аргументом нижеЭтого. Если под описание подходят несколько элементов, то они передвигаются все, причем их относительный порядок сохраняется. Аргумент нижеЭтого представляет собой тег или идентификатор; если он описывает несколько элементов, то для размещения тегИлиИд используется первый из них. Замечание: на элементы окон эта команда влияния не оказывает. Элементы окон перекрывают элементы других типов и на порядок их расположения влияют команды raise и lower, а не команды raise и lower примитивов канвы. Команда возвращает пустую строку.

имяПути moveтегИлиИд xКоличество yКоличество

Сдвигает каждый из элементов, подходящих под описание тегИлиИд, прибавляя к координатам каждой точки элемента координаты xКоличество и yКоличество. Команда возвращает пустую строку.

имяПути postscript параметр значение параметр значение ...

Генерирует Postscript-представление для каждой канвы или для некоторых из них. Если параметр имеет вид -file, то Postscript-представление записывается в указанный файл, а команда возвращает пустую строку; в противном случае возвращается сгенерированное Postscript-представление. Если интерпретатор, владеющий канвой, помечен как безопасный, то операция закончится неудачно, так как безопасным интерпретаторам не разрешается записывать файлы. Если задан параметр -channel, то аргументом является имя канала, открытого на вывод. Postscript-представление записывает в этот канал; по окончании выполнения команды канал остается открытым для последующих операций вывода. Postscript-представление создается в форме Encapsulated Postscript в соответствии с соглашением Documentation Structuring Conventions, v. 3.0. Замечание: по умолчанию Postscript-представление создается только для информации, выводимой в окно канвы на экране. Только что созданная канва имеет размер 1x1 пиксель, поэтому в Postscript ничего выведено не будет. Чтобы преодолеть эту трудность, необходимо либо выполнить команду ⌠update■ и дождаться пока окно достигнет своего нормального размера, либо задать размеры канвы для печати параметрами -width и -height. Пары аргументов параметр-значения используются для дополнительного управления характеристиками печати. Команда поддерживает следующие параметры:

-colormap имяПеременной

ИмяПеременной должно быть именем массива, описывающего палитру в Postscript. Значение каждого элемента этого массива должно кодировать установку в Postscript определенного цвета, например,1.0 1.0 0.0 setrgbcolor■. При выводе информации о цвете в Postscript Tk проверяет, есть ли в массиве имяПеременной элемент с таким же именем цвета. Если это так, то Tk использует значение этого элемента как команду Postscript для установки цвета. Если параметр -colormap не указан или если данному цвету не соответствует никакой элемент массива, то Tk берет интенсивность красного, голубого или зеленого X цвета.

-colormode режим

Задает способ вывода цветовой информации. Режим может принимать значения color (для полноцветного вывода), gray (преобразует все цвета к их серому аналогу), mono (переводит каждый цвет в черный или белый).

-file имяФайла

Задает имя файла вывода. Если этот параметр не указан, то команда возвращает результирующее Postscript-представление вместо записи его в файл.

-fontmap имяПеременной

ИмяПеременной должно быть именем массива, описывающего преобразование шрифтов. Каждый элемент массива должен представлять собой Tcl список из двух элементов ≈ имени и размера шрифта. При выводе Postscript команд для конкретного шрифта Tk проверяет, описан ли в массиве имяПеременной элемент с соответствующим именем. Если такой элемент есть, то в Postscript используется информация, содержащаяся в нем. В противном случае Tk пытается догадаться о том, какой шрифт использовать. Обычно эти попытки удаются только для стандартных шрифтов, таких как Times, Helvetica и Courier, и только в случае, если в имени X шрифта не пропущено ни одного дефиса перед размером. Так, например, имя -*_-Courier-Bold-R-Normal--*_-120-*_ будет воспринято нормально, а *Courier-Bold-R-Normal*120* ≈ нет; дефисы нужны Tk для распознавания имени шрифта.

-height размер

Задает высоту печатаемого поля канвы. По умолчанию имеет значение высоты окна канвы.

-pageanchor якорь

Указывает, какая из выводимых точек канвы должна попасть в опорную точку страницы печати (заданную параметрами -pagex и -pagey). Например, задание -pageanchor n означает, что при печати верхняя центральная точка окна канвы располагается в опорной точке страницы. По умолчанию параметр имеет значение center.

-pageheight размер

Указывает на необходимость растяжения страницы печати в горизонтальном и вертикальном направлении так, чтобы напечатанная в Postscript страница имела высоту размер. Значением параметра должно быть число с плавающей точкой, за которым следует символ c, если размер указан в сантиметрах, i ≈ в дюймах, m ≈ в миллиметрах, p или ничего ≈ в точках принтерах (1/72 часть дюйма). По умолчанию имеет значение высоты выводимой области экрана. Если заданы оба параметра -pageheight и -pagewidth, то для растяжения используется значение параметра -pagewidth (возможность неравномерного растяжения в двух направлениях не предусмотрена).

-pagewidth размер

Указывает на необходимость растяжения страницы печати в горизонтальном и вертикальном направлении так, чтобы напечатанная в Postscript страница имела ширину размер. Параметр может принимать такие же значения, что и параметр -pageheight. По умолчанию имеет значение ширины выводимой области экрана. Если заданы оба параметра -pageheight и -pagewidth, то для растяжения используется значение параметра -pagewidth (возможность неравномерного растяжения в двух направлениях не предусмотрена).

-pagex координата

Указывает x-координату опорной точки Postscript-страницы в любом виде, приемлемом для -pageheight. В сочетании с параметрами -pagey и -pageanchor позволяет задать размещение выводимой области на Postscript-странице. По умолчанию задает координату центра страницы.

-pagey координата

Указывает y-координату опорной точки Postscript-страницы в любом виде, приемлемом для -pageheight. В сочетании с параметрами -pagex и -pageanchor позволяет задать размещение выводимой области на Postscript-странице. По умолчанию задает координату центра страницы.

-rotate булевское

Булевское значение указывает, следует ли при печати повернуть страницу на 90 градусов. При обычном выводе ось x идет вдоль короткой стороны страницы (ориентация ⌠портрет■); после поворота она идет вдоль длинной стороны (ориентация ⌠пейзаж■). По умолчанию страница печатается без поворота.

-width размер

Задает ширину печатаемого поля канвы. По умолчанию имеет значение ширины окна канвы.

-x координата

Задает x-координату левого края печатаемой области канвы (в координатах канвы, а не окна). По умолчанию совпадает с координатой левого края окна.

-y координата

Задает y-координату верхнего края печатаемой области канвы (в координатах канвы, а не окна). По умолчанию совпадает с координатой верхнего края окна.

имяПути raise тегИлиИд вышеЭтого

Передвигает все элементы, подходящие под описание тегИлиИд, в списке вывода непосредственно за элемент, заданный аргументом вышеЭтого. Если под описание подходят несколько элементов, то они передвигаются все, причем их относительный порядок сохраняется. Аргумент вышеЭтого представляет собой тег или идентификатор; если он описывает несколько элементов, то для размещения тегИлиИд используется последний (самый верхний) из них. Замечание: на элементы окон эта команда влияния не оказывает. Элементы окон перекрывают элементы других типов и на порядок их расположения влияют команды raise и lower, а не команды raise и lower примитивов канвы. Команда возвращает пустую строку.

имяПути scale тегИлиИд xЦентр yЦентр xКоэффициент yКоэффициент

Растягивает или сжимает все элементы, подходящие под описание тегИлиИд в координатном пространстве канвы. Аргументы xЦентр и yЦентр задают координаты центра преобразования, а xКоэффициент и yКоэффициент ≈ коэффициенты растяжения по осям x и y соответственно (значение ⌠1.0■ указывает на отсутствие растяжения). Расстояние по оси x каждой точки, задающей положение элемента, от центра растяжения увеличивается в xКоэффициент раз. Аналогично, расстояние по оси y каждой точки, задающей положение элемента, от центра растяжения увеличивается в yКоэффициент раз. Команда возвращает пустую строку.

имяПути scanпараметр аргументы

Используется для сканирования канвы. Имеет две формы в зависимости от значения параметра:

имяПути scanmark x y

Сохраняет x, y и текущий вид канвы для последующего использования командами scan dragto. Обычно эта команда используется в сочетании с нажатием клавиши ⌠Мыши■ в примитиве, а x и y являются координатами курсора ⌠ Мыши ■. Возвращает пустую строку.

scan dragto x y

Вычисляет разность между значениями координат x и y и значениями тех же координат, сохраненными последней командой scan mark на данном примитиве. Затем переносит изображение примитива на расстояние, в 10 раз превышающее вычисленную разность. Команда обычно связана с событиями движения ⌠ Мыши ■ в примитиве и используется для скоростного перетаскивания канвы в его окне. Возвращает пустую строку.

имяПути select параметр тегИлиИд аргумент

Производит действия над выделенными элементами тем или иным способом в зависимости от значения параметра. Команда может иметь одну из описанных ниже форм. В каждой из приведенных форм тегИлиИд должен описывать элемент, допускающий индексирование и выделение; если под описание подходит несколько элементов, то используется первый из них, допускающий индексирование и выделение. Индекс представляет собой текстовое указание позиции в тегИлиИд (см. описание в Индексы).

имяПути select adjust тегИлиИд индекс

Определяет ближайший к указанному аргументом индекс положению край набора выделенных элементов в тегИлиИд и устанавливает новое значение этого края в индекс (т.е. элемент индекс входит в выделение, а соседний с ним ≈ нет). Противоположный край выделения становится опорной точкой для последующих команд select to. Если в текущий момент в тегИлиИд выделения отсутствуют, то команда ведет себя точно так же, как команда примитива select to. Возвращает пустую строку.

имяПути select clear

Очищает выделенные элементы в данном примитиве. Если таких элементов нет, то не производит никаких действий. Возвращает пустую строку.

имяПути select from тегИлиИд индекс

Устанавливает опорную точку выделения непосредственно перед символом, заданным аргументом индекс. Текущего выделения команда не меняет. Она лишь фиксирует начало выделения для последующих команд select to. Возвращает пустую строку.

имяПути select item

Возвращает идентификатор выделенного элемента, если выделение представляет собой элемент канвы. Если в данной канве выделение отсутствует, то команда возвращает пустую строку.

имяПути select to тегИлиИд индекс

Выделяет все символы между опорным символом выделения и символом, указанным аргументом индекс, включая этот символ. Опорный символ включается в выделение, только если значение аргумента индекс больше номера опорного символа. Опорный символ устанавливается последней выполненной на данном примитиве командой select adjust или select from. Если опорный символ выделения в примитиве не входит в элемент, описываемый аргументом тегИлиИд, то опорная точка устанавливается на символ, указанный аргументом индекс. Команда возвращает пустую строку.

имяПути typeтегИлиИд

Возвращает тип элемента, описываемого аргументом тегИлиИд (например, rectangle или text). Если тегИлиИд описывает несколько элементов, то возвращается тип первого из них. Если ни один элемент не подходит под описание тегИлиИд, токоманда возвращает пустую строку.

имяПути xview аргументы

Используется для запроса горизонтального положения информации, выведенной в окне канвы, и изменения этого положения. Команда может иметь одну из следующих форм:

имяПути xview

Возвращает список, состоящий из двух элементов. Каждый из элементов списка представляет собой вещественное число, заключенное между нулем и единицей; эта пара чисел описывает видимый в окне горизонтальный интервал. Так, например, если первое число равно .⌠2■, а второе .⌠6■, то 20% области канвы оказывается невидимой слева от окна, в окне выводится 40% информации, и еще 40% оказывается невидимой справа от окна.

имяПути xview movetoчисло

Передвигает область видимости так, что слева от окна остается невидимой часть канвы, указанная аргументом число. Число должно быть заключено между ▒0▓ и ⌠1■.

имяПути xview scrollколичество что

Сдвигает выводимый в окне текст вправо или влево, выравнивая его границу в соответствии со значениями аргументов. Количество должно быть целым числом, аргумент что может принимать значения units или pages или быть сокращением одного из этих слов. Если аргумент что принимает значение units, то выравнивание происходит относительно единиц, указанных значением параметра xScrollIncrement (если это значение положительно), или относительно десятой части ширины окна (в противном случае). Если значением аргумента что является pages, то единицей выравнивания служит величина в девять десятых ширины окна. Если количество отрицательно, то видимая информация сдвигается вправо, в противном случае ≈ влево.

имяПути yview аргументы

Используется для запроса вертикального положения информации, выведенной в окне канвы, и изменения этого положения. Команда может иметь одну из следующих форм:

имяПути yview

Возвращает список, состоящий из двух элементов. Каждый из элементов списка представляет собой вещественное число, заключенное между нулем и единицей; эта пара чисел описывает видимый в окне вертикальный интервал. Так, например, если первое число равно .⌠6■, а второе ⌠1.0■, то в окне выводятся нижние 40% области канвы (заданной значением параметра -scrollregion). Эти значения совпадают со значениями, передаваемыми полосам прокрутки через параметр -yscrollcommand.

имяПути yview movetoчисло

Передвигает область видимости так, что сверху от окна остается невидимой часть канвы, указанная аргументом число. Число должно быть заключено между ▒0▓ и ⌠1■.

имяПути yview scrollколичество что

Сдвигает выводимый в окне текст вверх или вниз, выравнивая его границу в соответствии со значениями аргументов. Количество должно быть целым числом, аргумент что может принимать значения units или pages или быть сокращением одного из этих слов. Если аргумент что принимает значение units, то выравнивание происходит относительно единиц, указанных значением параметра yScrollIncrement (если это значение положительно), или относительно десятой части высоты окна (в противном случае). Если значением аргумента что является pages, то единицей выравнивания служит величина в девять десятых высоты окна. Если количество отрицательно, то видимая информация сдвигается вниз, в противном случае ≈ вверх.

ОБЗОР ТИПОВ ЭЛЕМЕНТОВ

 
Ниже описываются различные типы элементов, поддерживаемые примитивами канвы. Каждый тип характеризуется, во-первых, формой команды create, посредством которой создаются элементы этого типа, и, во-вторых, набором параметров конфигурации элементов этого типа, которые можно использовать в командах примитива create и itemconfigure. Большинство типов не поддерживают выделение и индексирование и связанные с этими операциями команды, такие как index или insert. Для типов, поддерживающих указанные возможности, они описаны явно (пока речь идет только о текстовых элементах). ДУГИ  
Элементы типа arc выводятся на экран в виде отрезка дуги. Дуга представляет собой отрезок овала, заключенный между двумя радиусами (заданными параметрами -start и -extent); она изображается на экране в одном из нескольких возможных видов в зависимости от значения параметра -style. Дуги создаются командами примитива.

имяПути createarc x1 y1 x2 y2 параметр значение параметр значение ...

Аргументы x1 y1 x2 y2 задают координаты противоположных углов прямоугольной области, в которую вписан овал. За координатами следует несколько пар параметр-значение, каждая из которых устанавливает значение одного из параметров конфигурации элемента. Такие же пары параметр-значение используются командами примитива itemconfigure для изменения параметров конфигурации. Команда поддерживает следующие параметры:

-extent угол

Задает величину сектора, содержащего дугу. Дуга простирается на угол, отсчитываемый от начальной точки дуги, заданной параметром -start. Угол может быть и отрицательным. Если его величина превосходит 360 градусов или оказывается меньше -360 градусов, то берется его значение по модулю 360.

-fill цвет

Закрашивает цветом область, ограниченную дугой. Аргумент цвет может принимать любое значение, воспринимаемое командой Tk_GetColor. Если значением цвета является пустая строка, то закрашивания не происходит. Пустая строка также принимается значением параметра по умолчанию.

-outline цвет

Цвет задает цвет контура дуги. Этот параметр может принимать любое значение, воспринимаемое командой Tk_GetColor. По умолчанию параметр имеет значение black. Если в качестве параметра задана пустая строка, то контур дуги не изображается.

-outlinestippleдвуцвет

Указывает, что контур дуги должен изображаться в соответствии с образцом пунктира. Аргумент двуцвет указывает этот образец, он может принимать любое значение, воспринимаемое командой Tk_GetBitmap. Если параметр -outline не задан, то задание параметра -outlinestipple не влияет на вывод. Если значением данного параметра является пустая строка, то дуга будет рисоваться сплошной линией.

-start угол

Задает положение начала сектора, содержащего дугу. Угол задается в градусах и отсчитывается против часовой стрелки от 3-часового положения часовой стрелки. Он может быть как положительным, так и отрицательным.

-stipple двуцвет

Указывает необходимость закрашивания области дуги в соответствии с образцом пунктира. Допустимы любые значения, воспринимаемые командой Tk_GetBitmap. Если параметр -fill не задан, то параметр -stipple не оказывает влияния на вывод. Если значением параметра -stipple является пустая строка, то выполняется сплошное закрашивание.

-style тип

Задает тип изображения дуги. Если тип имеет значение pieslice (по умолчанию), то область дуги имеет вид сектора, ограниченного дугой и двумя радиусами, проведенными из центра овала к ее концам. Тип chord указывает на то, что область имеет вид сегмента, ограниченного дугой и отрезком, соединяющим ее концы. Тип arc означает, что область дуги состоит из самой этой дуги. В последнем случае параметр -fill игнорируется.

-tags списокТегов

Задает набор тегов, относящихся к элементу. СписокТегов представляет собой список имен тегов, замещающий имеющиеся теги элемента. СписокТегов может быть пустым.

-width ширинаКонтура

Задает ширину контура вокруг области дуги; значением параметра может быть любое допустимое значение координат, описанное выше (см. ⌠Координаты■). Если значением параметра -outline является пустая строка, то параметр -width не влияет на характер вывода. Широкий контур центрируется на отрезках, ограничивающих область дуги. По умолчанию параметр имеет значение ⌠1.0■.

ДВУЦВЕТНЫЕ ЭЛЕМЕНТЫ

 
Элементы типа bitmap изображаются на экране с помощью двух цветов: цвета фона и цвета переднего плана, Двуцветные изображения создаются командой примитива

имяПути create bitmap x y параметр значение параметр значение ...

Аргументы x и y задают координаты опорной точки двуцветного изображения на экране (подробнее процедура размещения изображения описана ниже при описании параметра -anchor). За координатами следует несколько пар параметр-значение, каждая из которых устанавливает значение одного из параметров конфигурации элемента. Такие же пары параметр-значение используются для изменения значений параметров с помощью команды примитива itemconfigure. Для двуцветных изображений допустимы следующие параметры:

-anchor положениеОпоры

ПоложениеОпоры указывает способ размещения изображения по отношению к его опорной точке. Параметр может принимать произвольное значение, воспринимаемое командой Tk_GetAnchor. Так, если параметр имеет значение center, то в опорной точке располагается центр изображения; значение n указывает, что в опорной точке располагается верхняя центральная точка изображения и т.д. По умолчанию параметр имеет значение center.

-background цвет

Задает цвет, используемый для отображения пикселей двуцветного изображения со значением ⌠0■. Параметр может принимать любое значение, воспринимаемое командой Tk_GetColor. Если параметр не задан или цвет является пустой строкой, то пиксели со значением ▒0▓ не выводятся, что создает эффект прозрачности.

-bitmap двуцвет

Задает двуцветное изображение для вывода в элементе. Параметр может принимать любое значение, воспринимаемое командой Tk_GetBitmap.

-foreground цвет

Задает цвет пикселей двуцветного изображения, имеющих значение ⌠1■. Параметр может принимать любое значение, воспринимаемое командой Tk_GetColor; по умолчанию его значение black.

-tags списокТегов

Приписывает элементу список тегов. СписокТегов представляет собой список имен тегов, замещающий имеющиеся теги элемента. СписокТегов может быть пустым.
  ЛИНИИ  
Элементы типа line выводятся на экран в виде прямо- или криволинейной ломаной. Линии создаются командой примитива

имяПути create line x1 y1 ... xn yn параметр значение параметр значение ...

Аргументы от x1 до yn задают координаты последовательности из двух или более точек, соединенных отрезками. За координатами может следовать произвольный набор пар параметр-значение, каждая из которых устанавливает значение одного из параметров элемента. С помощью тех же пар параметр-значения можно задать новые значения параметров командами примитива itemconfigure. Команда поддерживает следующие параметры:

-arrow где

Указывает, следует ли изображать стрелки на одном или обоих концах линии. Значение где может быть одним из следующих: none (стрелки не изображаются), first (изображается стрелка в начале линии), last (изображается стрелка в конце линии) или both (стрелка изображается на обоих концах).

-arrowshape форма

Описывает форму стрелки. Значением параметра должен быть список, содержащий три элемента, каждый из которых представляет собой расстояние в виде, описанном выше (см. ⌠Координаты■). Первый элемент списка задает расстояние вдоль линии от начала до острия стрелки. Второй элемент задает расстояние вдоль линии от хвостовых концов стрелки до ее острия, третий ≈ расстояние от внешнего ребра линии до хвостовых точек. Если параметр не задан, то Tk самостоятельно выбирает ⌠разумную■ форму стрелки.

-capstyle стиль

Описывает способ изображения концов линии в отсутствие стрелок. Параметр может принимать любое значение, воспринимаемое командой
Tk_GetCapstyle (butt, projecting или round). По умолчанию имеет значение butt. При наличии стрелок параметр игнорируется.

-fill цвет

Задет цвет изображаемой линии. Параметр может принимать любое значение, воспринимаемое командой Tk_GetColor. Если значением параметра является пустая строка, то линия будет прозрачной. По умолчанию цвет имеет значение black.

-joinstyle стиль

Задает способ соединения отрезков линии в вершинах. Параметр может принимать любое значение, воспринимаемое командой Tk_GetCapstyle (bevel, miter или round). По умолчанию имеет значение miter. При наличии всего двух вершин параметр игнорируется.

-smooth булевское

Параметр может принимать любое значение, воспринимаемое командой Tk_GetBoolean. Указывает, нужно ли сглаживать ломаную, превращая ее в кривую (в этом случае линия изображается в виде набора параболических сплайнов: для первого и второго отрезка, для второго и третьего отрезка и т.д.). В кривую можно вставлять прямолинейные отрезки, удваивая нужные вершины.

-splinesteps число

Задает желаемую степень гладкости кривой: каждый сплайн будет аппроксимирован числом прямолинейных отрезков. При опущенном параметре -spline параметр -splinesteps игнорируется.

-stipple двуцвет

Указывает на необходимость пунктирного изображения линии; двуцвет задает образец изображения в виде, воспринимаемом командой Tk_GetBitmap. Если значением параметра является пустая строка (как, например, по умолчанию), то линия изображается непрерывной кривой.

-tags списокТегов

Приписывает к элементу набор тегов. СписокТегов представляет собой список имен тегов, замещающих все имеющиеся теги элемента. Он может быть пустым.

-width ширинаЛинии
 

Задает ширину линии в произвольном виде, описанном выше (см. ⌠Координаты⌠). Центр широкой линии проходит через вершины. По умолчанию параметр имеет значение ▒1.0▓. ОВАЛЫ  
Элементы типа oval появляются на экране в виде овальных или круглых областей. Каждый овал может быть закрашенным и иметь контур. Овалы создаются командой примитива

имяПути create oval x1 y1 x2 y2 параметр значение параметр значение ...

Аргументы x1, y1, x2 и y2 задают координаты двух диагонально противоположных углов прямоугольника, заключающего овал. Овал включает в себя верхнюю и левую стороны прямоугольника, но не его нижнюю и правую сторону. Если прямоугольник представляет собой квадрат, то овал будет кругом, в противном случае он вытянут в одном из направлений. За координатами может следовать произвольный набор пар параметр-значение, каждая пара устанавливает значение одного из параметров. Такие же пары используются командами примитива itemconfigure для изменения конфигурации элемента. Команда поддерживает следующие параметры:

-fill цвет

Закрашивает цветом область, ограниченную овалом. Аргумент цвет может принимать любое значение, воспринимаемое командой Tk_GetColor. Если значением цвета является пустая строка, то закрашивания не происходит. Пустая строка также принимается значением параметра по умолчанию.

-outline цвет

Цвет задает цвет контура овала. Этот параметр может принимать любое значение, воспринимаемое командойTk_GetColor. По умолчанию параметр имеет значение black. Если в качестве параметра задана пустая строка, то контур овала не изображается.

-stipple двуцвет

Указывает на необходимость закрашивания внутренности овала в соответствии с образцом пунктира. Допустимы любые значения, воспринимаемые командой Tk_GetBitmap. Если параметр -fill не задан, то параметр -stipple не оказывает влияния на вывод. Если значением параметра -stipple является пустая строка (по умолчанию), то выполняется сплошное закрашивание.

-tags списокТегов

Задает набор тегов, относящихся к элементу. СписокТегов представляет собой список имен тегов, замещающий имеющиеся теги элемента. СписокТегов может быть пустым.

-width ширинаКонтура

Задает ширину контура вокруг овала; значением параметра может быть любое допустимое значение координат, описанное выше (см. "Координаты"). Если параметр -outline не задан, то параметр -width не влияет на характер вывода. Широкий контур центрируется на овале, заданном координатами x1, y1, x2, y2. По умолчанию параметр имеет значение ⌠1.0■. МНОГОУГОЛЬНИКИ  
Элементы типа polygon выводятся на экран в виде закрашенных многоугольных (возможно, криволинейных) областей. Многоугольники задаются командами примитива

имяПути create polygon x1 y1 ... xn yn параметр значение параметр значение ...

Аргументы с x1 до yn задают координаты не менее чем трех точек, определяющих замкнутый многоугольник. Первая и последняя точки могут совпадать; вне зависимости от того, так это или нет, Tk изображает замкнутый многоугольник. За координатами может следовать несколько пар параметр-значение, каждая из которых устанавливает один из параметров конфигурации элемента. Те же пары параметр-значение могут быть использованы в команде примитива itemconfigure для изменения конфигурации элемента. Команда поддерживает следующие параметры:

-fill цвет

Задет цвет закраски многоугольника. Параметр может принимать любое значение, воспринимаемое командой Tk_GetColor. Если значением параметра является пустая строка, то многоугольник будет прозрачным. По умолчанию цвет имеет значение black.

-outline цвет

Цвет задает цвет контура многоугольника. Этот параметр может принимать любое значение, воспринимаемое командой Tk_GetColor. Если в качестве значения параметра задана пустая строка (по умолчанию), то контур овала не изображается.

-smooth булевское

Параметр может принимать любое значение, воспринимаемое командой Tk_GetBoolean. Указывает, нужно ли сглаживать многоугольник, превращая его в кривую (в этом случае кривая изображается в виде набора параболических сплайнов: для первого и второго отрезка, для второго и третьего отрезка и т.д.). В кривую можно вставлять прямолинейные отрезки, удваивая нужные вершины.

-splinesteps число

Задает желаемую степень гладкости кривой: каждый сплайн будет аппроксимирован числом прямолинейных отрезков. При опущенном параметре -smooth параметр -splinesteps игнорируется.

-stipple двуцвет

Указывает на необходимость пунктирного закрашивания многоугольника; двуцвет задает образец изображения в виде, воспринимаемом командой Tk_GetBitmap. Если значением параметра является пустая строка (как, например, по умолчанию), то осуществляется непрерывное закрашивание.

-tags списокТегов

Приписывает к элементу набор тегов. СписокТегов представляет собой список имен тегов, замещающих все имеющиеся теги элемента. Он может быть пустым.

-width ширинаКонтура

Задает ширину контура вокруг многоугольника в произвольном виде, описанном выше (см. ⌠Координаты⌠). Если параметр -outline не задан, то параметр -width игнорируется. По умолчанию параметр имеет значение ⌠1.0■. Многоугольные элементы отличаются от других ≈ прямоугольников, овалов и дуг ≈ в том отношении, что их внутренние точки считаются находящимися ⌠внутри■ многоугольника (например, в смысле команд примитива find closest и find overlapping), даже если он и не закрашен. Для большинства остальных типов элементов внутренние точки считаются находящимися внутри элемента, только если элемент закрашен или если он не закрашен и не имеет контура. Если Вам нужен незакрашенный многоугольник, внутренние точки которого не считаются находящимися внутри него, то пользуйтесь вместо этого элементом line. ПРЯМОУГОЛЬНИКИ  
Элементы типа rectangle появляются на экране в виде прямоугольных областей. Каждый прямоугольник может быть закрашенным и иметь контур. Прямоугольники создаются командой примитива

имяПути create rectanglex1 y1 x2 y2 параметр значение параметр значение ...

Аргументы x1, y1, x2 и y2 задают координаты двух диагонально противоположных углов прямоугольника (верхняя и левая стороны прямоугольника входят в него, а нижняя и правая сторона ≈ нет). За координатами может следовать произвольный набор пар параметр-значение, каждая пара устанавливает значение одного из параметров. Такие же пары используются командами примитива itemconfigure для изменения конфигурации элемента. Команда поддерживает следующие параметры:

-fill цвет

Закрашивает цветом прямоугольную область. Аргумент цвет может принимать любое значение, воспринимаемое командой Tk_GetColor. Если значением цвета является пустая строка, то закрашивания не происходит. Пустая строка также принимается значением параметра по умолчанию.

-outline цвет

Цвет задает цвет контура прямоугольника. Этот параметр может принимать любое значение, воспринимаемое командой Tk_GetColor. По умолчанию параметр имеет значение black. Если в качестве параметра задана пустая строка, то контур прямоугольника не изображается.

-stipple двуцвет

Указывает на необходимость закрашивания прямоугольника в соответствии с образцом пунктира. Допустимы любые значения, воспринимаемые командой Tk_GetBitmap. Если параметр -fill не задан, то параметр -stipple не оказывает влияния на вывод. Если значением параметра -stipple является пустая строка (по умолчанию), то выполняется сплошное закрашивание.

-tags списокТегов

Задает набор тегов, относящихся к элементу. СписокТегов представляет собой список имен тегов, замещающий имеющиеся теги элемента. СписокТегов может быть пустым.

-width ширинаКонтура

Задает ширину контура вокруг прямоугольника; значением параметра может быть любое допустимое значение координат, описанное выше (см. "Координаты"). Если параметр -outline не задан, то параметр -width не влияет на характер вывода. Широкий контур центрируется на прямоугольнике, заданном координатами x1, y1, x2, y2. По умолчанию параметр имеет значение ⌠1.0■.
  ТЕКСТОВЫЕ ЭЛЕМЕНТЫ
  Текстовый элемент предназначен для вывода на экран строки символов в одну или несколько строчек. Текстовые элементы поддерживают индексы и выделение, и на них могут быть выполнены команды примитива канвы dchars, focus, icursor, index, insert, select. Текстовые элементы создаются командой примитива

имяПути create text x y параметр значение параметр значение ...

Аргументы x и y задают координаты точки, используемой для размещения текста на экране (подробнее размещение текста описано ниже при описании параметров). За координатами могут следовать несколько пар параметр-значение, каждая из которых устанавливает значение одного из параметров конфигурации элемента. Такие же пары используются командами примитива itemconfigure для изменения конфигурации элемента. Команда поддерживает следующие параметры:

-anchor положениеОпоры

ПоложениеОпоры указывает способ размещения текста по отношению к его опорной точке. Параметр может принимать произвольное значение, воспринимаемое командой Tk_GetAnchor. Так, если параметр имеет значение center, то в опорной точке располагается центр текста; значение n указывает что в опорной точке располагается верхняя центральная точка текста и т.д. По умолчанию параметр имеет значение center.

-fill цвет

Закрашивает цветом символы текста. Аргумент цвет может принимать любое значение, воспринимаемое командой Tk_GetColor. Значением параметра по умолчанию является black.

-font имяШрифта

Задает шрифт текста в элементе. ИмяШрифта может быть произвольной строкой, воспринимаемой командой Tk_GetFontStruct. Если параметр не задан, то его значением по умолчанию является системно-зависимый шрифт.

-justify как

Задает способ выравнивания текста внутри области текста. Аргумент как может принимать одно из значений left, right или center. Параметр оказывает влияние на размещение текста, только если выводится несколько строчек. По умолчанию параметр имеет значение left.

-stipple двуцвет

Указывает на необходимость вывода текста в соответствии с образцом пунктира. Допустимы любые значения, воспринимаемые командой Tk_GetBitmap. Если значением параметра -stipple является пустая строка (по умолчанию), то текст выводится сплошной линией.

-tags списокТегов

Задает набор тегов, относящихся к элементу. СписокТегов представляет собой список имен тегов, замещающий имеющиеся теги элемента. СписокТегов может быть пустым.

-width длинаСтрочки

Задает максимальную длину строчки текста; значением параметра может быть любое допустимое значение координат, описанное выше (см. "Координаты"). Если значение параметра равно нулю (по умолчанию), то перенос строки происходит только при появлении в тексте символа новой строчки. Если, однако, значение параметра не равно нулю, то концом строчки, длина которой превосходит длинуСтрочки, считается символ пробела с номером, ближайшим (с недостатком) к длинеСтрочки. Этот символ пробела рассматривается как символ перехода на новую строчку. ОКНА  
Элементы типа window предназначены для вывода окна в указанное положение на канве. Окна создаются командой

имяПути create window x y параметр значение параметр значение ...

Аргументы x и y задают координаты точки, используемой для размещения окна на экране (подробнее размещение текста описано ниже при описании параметра -anchor). За координатами могут следовать несколько пар параметр-значение, каждая из которых устанавливает значение одного из параметров конфигурации элемента. Такие же наборы параметр-значение используются для изменения значений параметров с помощью команды примитива itemconfigure. Окна поддерживают следующие параметры:

-anchor положениеОпоры

ПоложениеОпоры указывает способ размещения окна по отношению к опорной точке элемента. Параметр может принимать произвольное значение, воспринимаемое командой Tk_GetAnchor. Так, если параметр имеет значение center, то в опорной точке располагается центр текста; значение ⌠n■ указывает что в опорной точке располагается верхняя центральная точка текста и т.д. По умолчанию параметр имеет значение center.

-height пиксели

Задает высоту окна элемента. Аргумент пиксели может иметь вид, описанный выше (см. ⌠Координаты⌠). Если параметр не задан или если его значением является пустая строка, то высота окна определяется его содержимым.

-tags списокТегов

Задает набор тегов, относящихся к элементу. СписокТегов представляет собой список имен тегов, замещающий имеющиеся теги элемента. СписокТегов может быть пустым.

-width пиксели

Задает ширину окна элемента. Аргумент пиксели может иметь вид, описанный выше (см. ⌠Координаты⌠). Если параметр не задан или если его значением является пустая строка, то ширина окна определяется его содержимым.

-window имяПути

Приписывает данному элементу окно. Окно, заданное аргументом имяПути, должно быть либо потомком примитива канвы, либо потомком одного из наследников примитива канвы. ИмяПути может и не указывать окно верхнего уровня. Замечание. Ограничения на управление окнами не позволяют выводить графические элементы (такие, как кривые и двуцветные изображения) поверх окон. ТИПЫ ЭЛЕМЕНТОВ, ОПРЕДЕЛЯЕМЫЕ В ПРИЛОЖЕНИЯХ  
В конкретных приложениях можно определять новые типы элементов для примитивов канвы с помощью C кода. Описание этой возможности приведено в документации для Tk_CreateItem. ПРЕДПОЧТЕНИЯ  
В текущей реализации новая канва не имеет никакого поведения по умолчанию; для определения этого поведения необходимо явно выполнить команды Tcl. checkbutton

Создание примитива защелкивающейся кнопки и управление им.
 

Синтаксис

Стандартные параметры

Дополнительные параметры примитива

Описание

Команда примитива

Предпочтения

СИНТАКСИС  

checkbutton имяПути  параметры
 

СТАНДАРТНЫЕ ПАРАМЕ ТРЫ
   

-activebackground	-cursor	-highlightthickness
-takefocus	-activeforeground	-disabledforeground
-image	-text	anchor
-font	-justify	-textvariable
-background	-foreground	padx
-underline	-bitmap	-highlightbackground
-pady	-wraplength	-borderwidth
-highlightcolor	-relief

Подробное описание этих параметров приведено в разделе options.
  ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА   Имя параметра: -command
Имя в Базе: command
Класс в Базе: Command

Ассоциирует с кнопкой команду Tk. Обычно команда выполняется при отпускании клавиши 1 ⌠Мыши■ на кнопке. Перед выполнением этой команды обновляется значение глобальной переменной (параметр -variable).
 

Имя параметра: -height
Имя в Базе: height
Класс в Базе: Height

Задает желаемую высоту кнопки. Если в кнопке выводится изображение или двуцветное изображение, то значение параметра задается в пикселях (т.е., в любом виде, приемлемом для Tk_GetPixels); высота текстовой кнопки задается числом строчек текста. Если параметр не задан, то высота кнопки вычисляется по ее содержимому.
 

Имя параметра: -indicatoron
Имя в Базе: indicatorOn
Класс в Базе: IndicatorOn

Указывает, следует ли выводить индикатор. Значение параметра должно быть булевским. Если значением является ⌠ложь■, то параметр relief игнорируется и примитив всегда изображается вдавленным, если он выделен, и выпуклым в противном случае.
 

Имя параметра: -offvalue
Имя в Базе: offValue
Класс в Базе: OffValue

Задает значение, которое нужно сохранять в переменной кнопки всякий раз при прекращении выделения кнопки. По умолчанию сохраняемое значение равно ⌠0■.
 

Имя параметра: -onvalue
Имя в Базе: onValue
Класс в Базе: OnValue

Задает значение, которое нужно сохранять в переменной кнопки всякий раз при выделении кнопки. По умолчанию сохраняемое значение равно ⌠1■.
 

Имя параметра: -selectcolor
Имя в Базе: selectColor
Класс в Базе: SelectColor Задает цвет фона для изображения выделенной кнопки. Если параметр IndicatorOn имеет значение истина, то указанный цвет применяется для изображения индикатора. В системе Windows тот же цвет используется в качестве фона изображения индикатора вне зависимости от состояния выделения. Если значением параметра IndicatorOn является ложь, то указанный цвет используется в качестве фона для всего примитива, когда он выделен, вместо значений параметров background и activeBackground.
  Имя параметра: -selectimage
Имя в Базе: selectImage
Класс в Базе: SelectImage

Задает изображение, выводимое в кнопке при выделении кнопки проверки (вместо изображения, заданного параметром -image). Если параметр -image отсутствует, то значение параметра -selectimage игнорируется.
 

Имя параметра: -state
Имя в Базе: state
Класс в Базе: State

Задает одно из трех состояний защелкивающейся кнопки: normal, active или disabled. В нормальном состоянии защелкивающаяся кнопка изображается с использованием значений параметров foreground и background. В активном состоянии защелкивающаяся кнопка обычно находится, если на ней расположен курсор. Защелкивающаяся кнопка в активном состоянии изображается с использованием значений параметров activeForeground и activeBackground. Отключенное состояние указывает на то, что кнопка должна быть нечувствительной: привязки по умолчанию не приводят к запуску примитива и нажатия на кнопку ⌠Мыши■ игнорируются. В этом состоянии изображение кнопки определяется значениями параметров disabledForeground и background.
 

Имя параметра: -variable
Имя в Базе: variable
Класс в Базе: Variable Задает имя глобальной переменной, в которой хранится информация о том, выделена или нет данная кнопка. По умолчанию совпадает с именем кнопки (т.е. с последним элементом имени пути окна кнопки).
  Имя параметра: -width
Имя в Базе: width
Класс в Базе: Width

Задает желаемую ширину кнопки. Если в кнопке выводится изображение или двуцветное изображение, то значение параметра задается в пикселях (т.е., в любом виде, приемлемом для Tk_GetPixels); ширина текстовой кнопки задается числом символов. Если параметр не задан, то ширина кнопки вычисляется по ее содержимому.
 

ОПИСАНИЕ  
Команда checkbutton создает новое окно (задаваемое аргументом имяПути) и превращает его в примитив защелкивающейся кнопки. Детали изображения защелкивающейся кнопки, такие как ее цвета, шрифт, текст и объемный вид задаются с помощью описанных выше дополнительных параметров. Команда button возвращает аргумент имяПути. В момент выполнения этой команды не должно существовать окна с именем имяПути, но должен существовать его предок.

Защелкивающаяся кнопка представляет собой примитив, в котором выводится текстовая строка, изображение или двуцветное изображение, а также квадратик, называемый индикатором. Весь выводимый текст должен быть записан одним шрифтом, однако он может занимать несколько строчек на экране (если в нем есть символы перевода строки или задан параметр wrapLength). Один из символов текста может быть подчеркнут (в соответствии со значением параметра underline). Защелкивающаяся кнопка обладает всеми характеристиками обычной кнопки, включая следующие: в зависимости от значения параметра button кнопка имеет три разных вида; кнопка может выглядеть выпуклой, вдавленной или плоской, кроме того, она может мигать. При инициации защелкивающейся кнопки (нажатием на клавишу 1 ⌠Мыши■, когда курсор ⌠Мыши■ находится на кнопке) выполняется команда Tcl, указанная в параметре -command.

Кроме того, защелкивающиеся кнопки можно выделять. Если защелкивающаяся кнопка выделена, то индикатор обычно изображается как выделенный, а переменная Tcl, ассоциированная с данной кнопкой, имеет предписанное значение (обычно ⌠1■). В ОС Unix индикатор изображается вдавленным и имеет специальный цвет. В системе Windows вместо этого в индикаторе стоит галочка. Если защелкивающаяся кнопка не выделена, то индикатор имеет невыделенный вид, а ассоциированная переменная имеет другое значение (обычно 0). В ОС Unix такой индикатор изображается выпуклым и не имеет специального цвета. В системе Windows в невыделенном индикаторе отсутствует галочка. По умолчанию имя переменной, ассоциированной с защелкивающейся кнопкой, совпадает с именем, использующимся при создании самой кнопки. Имя переменной и записываемые в ней значения ⌠выделенная■/■невыделенная■ можно поменять с помощью параметров командной строки или в базе данных параметров. С помощью параметров конфигурации можно также поменять вид индикатора (или даже отменить саму необходимость его вывода). По умолчанию выделение защелкивающейся кнопки меняется при последовательных щелчках кнопки. Кроме того, каждая защелкивающаяся кнопка отслеживает значение своей глобальной переменной и изменяет свое состояние всякий раз при перемене этого значения с ⌠выделенная■ на ■невыделенная■ и обратно.
 

КОМАНДА ПРИМИТИВА  
Команда checkbutton создает новую команду Tcl с именем имяПути. С помощью этой команды можно выполнять различные операции над примитивом. Ее общий вид:

имяПути параметр арг арг ...

Параметр и аргументы уточняют поведение команды. Примитивы защелкивающейся кнопки допускают следующие формы команды: имяПути cget параметр Возвращает текущее значение параметра конфигурации с именем параметр. Параметр может быть любым из параметров команды checkbutton. имяПути configure параметр значение параметр значение ... Запрашивает значения параметров конфигурации примитива или изменяет их. Если параметр не указан, то возвращает список, содержащий значения всех допустимых в имениПути параметров (формат списка описан в Tk_ConfigureInfo). Если параметр задан, а его новое значение ≈ нет, то команда возвращает часть полного списка, относящуюся к указанному параметру. Если заданы одна или несколько пар параметр-значение, то указанным параметрам примитива присваиваются новые значения, а команда возвращает пустую строку. Параметр может быть любым из параметров команды checkbutton. имяПути deselect
  Отменяет выделение защелкивающейся кнопки и устанавливает значение ⌠невыделена■ ассоциированной переменной.

имяПути flash

Заставляет защелкивающуюся кнопку мигать. Этот эффект достигается путем многократного вывода изображения кнопки поочередно в активном и нормальном состоянии. По окончании работы команды защелкивающаяся кнопка остается в том же состоянии (активном или нормальном), что и перед началом ее выполнения. Если перед началом выполнения команды защелкивающаяся кнопка находится в состоянии disabled, то команда игнорируется. имяПути invoke Приводит в точности к тому же результату, что и нажатие клавиши ⌠Мыши■ на защелкивающейся кнопке: кнопка становится выделенной и выполняется команда Tcl, ассоциированная с кнопкой (при наличии такой команды). Возвращаемое значение совпадает с возвращаемым значением команды Tcl (или является пустой строкой, если с защелкивающейся кнопкой никакой команды не ассоциировано). Если перед началом выполнения команды защелкивающаяся кнопка находится в состоянии disabled, то команда игнорируется. имяПути toggle Выделяет кнопку, перерисовывая ее в новом состоянии и изменяя значение ассоциированной переменной. ПРЕДПОЧТЕНИЯ  
При создании защелкивающейся кнопки Tk, в соответствии с типом кнопки, автоматически формирует параметры, определяющие ее поведение по умолчанию:

В ОС Unix кнопка становится активной при появлении над ней курсора ⌠Мыши■ и дезактивируется, когда курсор ее покидает. В системах Mac и Windows при нажатии клавиши 1 ⌠Мыши■ на защелкивающейся кнопке кнопка активизируется, когда курсор ⌠Мыши■ находится на кнопке и становится неактивной, когда курсор ее покидает.

При нажатии клавиши 1 ⌠Мыши■ на защелкивающейся кнопке кнопка становится выделенной и выполняется команда, привязанная к ней.

Если защелкивающаяся кнопка находится в фокусе ввода, то нажатие на клавишу пробела приводит к выполнению команды, привязанной к этой кнопке.

В системе Windows имеются дополнительные привязки клавиш: плюс (▒+▓) и знак равенства (▒=▓) выделяют кнопку, а минус (▒-▓) отменяет выделение.

Если защелкивающаяся кнопка находится в состоянии disabled, то все описанные выше действия не приводят ни к какому результату: кнопка остается неактивной.

Поведение защелкивающейся кнопки можно изменить с помощью новых связей для конкретных примитивов или путем переопределения связей данного класса.
 
 

clipboard

Управление буфером временного хранения Tk.

СИНТАКСИС
  clipboard параметр ?арг арг ...?
  ОПИСАНИЕ Команда обеспечивает Tcl интерфейс с буфером временного хранения Tk, в котором хранятся данные для последующего использования с помощью механизма выделения. Для копирования данных в буфер необходимо вызвать очистку буфера, а затем одну или несколько команд добавления данных в буфер. Полное обновление буфера достигается, если все добавления произведены до завершения события.   Первый аргумент определяет формат последующих аргументов и поведение команды. В настоящее время поддерживаются следующие формы команды:

clipboard clear?-displayof окно?

Заявляет права на буфер в окне и удаляет текущее содержимое буфера. Значением параметра окно по умолчанию является ▒.▓. Команда возвращает пустую строку. clipboard append?-displayof окно? ?-format формат? ?-type тип? ?--? данные Добавляет данные к содержимому буфера окна в виде, заданном параметром тип, и представлении, заданном параметром формат, а также заявляет права на буфер в окне.

Параметр тип задает вид, в котором должно возвращаться выделение; его значение должно быть именем атома, например, STRING или FILE_NAME; детали описания см. в (1). Параметр тип по умолчанию имеет значение STRING.

Аргумент формат задает представление, в котором выделение передается по запросу (см (1). второй столбец в Таблице 2); по умолчанию его значение STRING. В формате STRING выделение передается в виде строки 8-битовых символов ASCII. В формате ATOM данные разделяются на поля, отделенные друг от друга пробелами; каждое поле преобразуется в значение своего атома, а вместо имени атома передается его 32-битовое значение. Во всех других форматах данные делятся на поля, отделенные друг от друга пробелами, каждое поле преобразуется в 32-битовое целое число; затем массив целых чисел передается тому, кто запросил выделение. При этом передаваемые в буфер строки конкатенируются перед преобразованием, поэтому необходимо позаботиться заранее о соответствующем обрамлении их пробелами. Все добавки в буфер одного типа должны иметь одинаковый формат.

Аргумент формат необходим исключительно для обеспечения совместимости пользователям буфера, не использующим Tk. При выводе результатов поиска в выделении CLIPBOARD с помощью инструментов Tk значение буфера переводится в строковый формат, поэтому значение аргумента формат не играет роли.

С помощью аргумента ≈ указывается конец списка параметров: следующий за ним аргумент всегда интерпретируется как данные. Такая возможность полезна, например, если данные начинаются символом ▒-▓.
 
 

destroy

Создание примитива поля ввода текста и управление им.
 

Синтаксис

Стандартные параметры

Дополнительные параметры примитива

Описание

Команда примитива

Привязки по умолчанию

Управление фокусом ввода.

Синтаксис

Описание

Особенности реализации

     focus
     focus окно
     focus параметр ?арг арг ...?

ОПИСАНИЕ

    Команда focus используется для управления фокусом ввода Tk. В любой момент
     времени одно из окон на каждом экране находится в фокусе ввода; всякое
     событие нажатия или отпускания клавиши интерпретируются в этом окне. Обычно
     переключение фокуса между окнами верхнего уровня на экране осуществляется
     менеджером окон. Например, некоторые менеджеры окон автоматически
     переключают фокус на окно верхнего уровня, как только на него попадает курсор
     ⌠Мыши■ ; другие устанавливают фокус только при щелчке на окне. Обычно
     менеджер окон устанавливает фокус только на окнах верхнего уровня, а
     переключением фокуса между подчиненными окнами занимается конкретное
     приложение.

    Для каждого верхнего уровня Tk запоминает одно окно в фокусе (последнего
     наследника данного верхнего уровня, в которое попал фокус); когда менеджер
     окон переключает фокус на данный верхний уровень, Tk автоматически
     устанавливает его на запомненное окно. Внутри конкретного верхнего уровня Tk
     использует явное моделирование фокуса по умолчанию. Обычно перемещение
     курсора ⌠Мыши■ без изменения верхнего уровня не приводит к переключению
     фокуса; переключение происходит, лишь если его запросил примитив (например, в
     результате щелчка по кнопке ⌠Мыши■ ) или если пользователь нажал, например,
     клавишу Tab.

    Неявная модель фокусировки создается процедурой Tcl tk_focusFollowsMouse;
    она меняет параметры конфигурации Tk таким образом, чтобы фокус
     устанавливался на окно при попадании на него курсора ⌠Мыши■. Процедуры Tcl
     tk_focusNext и tk_focusPrev устанавливают порядок переключения фокуса
     между окнами верхнего уровня. Эти процедуры определяют, помимо прочего,
     привязки по умолчанию к клавишам Tab и Shift-Tab.

    Команда focus может принимать одну из следующих форм:

     focus
     Возвращает имя пути окна в фокусе на дисплее, содержащем главное
               окно приложения, или пустую строку, если никакое окно данного
               приложения не находится в фокусе. Замечание: дисплей лучше указать
               явно с помощью параметра -displayof (см. ниже); в этом случае команда
               сможет работать и в приложениях, использующих несколько дисплеев.
     focus окно

     Если одно из окон данного приложения находится в фокусе на дисплее
               окна, то команда устанавливает фокус ввода на окно и возвращает
               пустую строку. Если же у приложения не было фокуса ввода на дисплее
               окна, то окно будет запомнено как окно в фокусе для данного верхнего
               уровня. При попадании фокуса на данный верхний уровень в очередной
               раз Tk установит его на окно. Если аргументом является пустая строка,
               то команда не выполняет никаких действий.

ОСОБЕННОСТИ РЕАЛИЗАЦИИ

    При получении фокуса ввода внутренним окном Tk фактически не устанавливает X
     фокус на это окно. X ведет себя таким образом, что фокус сохранится на окне
     верхнего уровня, которому подчиняется окно с фокусом. Однако Tk создает
     события FocusIn и FocusOut в точности, как если бы X фокус был на внутреннем
     окне. Такой подход порождает ряд трудностей при фактическом переключении X
     фокуса; то, что X фокус установлен на данный верхний уровень, незаметно, если
     не запрашивать X сервер непосредственно из C программы.
 
 

Создание шрифтов и контроль за ними.
 

Синтаксис   Описание    Описание шрифта    Метрические характеристики шрифтов    Параметры шрифтов   Особенности реализации на различных платформах

 

     font параметр ?арг арг ...?

ОПИСАНИЕ

    Возвращает список всех поименованных на текущий момент шрифтов.

ОПИСАНИЕ ШРИФТА
 
 

В качестве описателя шрифта в любой из приведенных выше команд принимаются следующие данные; те же самые форматы допустимы и в качестве значения параметра -font в описателе примитива. [1] имяшрифта Имя поименованного шрифта, созданного командой font create. Использование поименованного шрифта не может привести к ошибке вне зависимости от того, насколько потенциально ошибочны или бессмысленны значения параметров этого шрифта. Если вывод символов в поименованном шрифте невозможен, то для их вывода используется автоматически подбираемый шрифт с близкими значениями параметров.

     [2] систшрифт
     Имя (зависящее от используемой платформы) шрифта,
               интерпретируемого графическим сервером. Сюда входит также (под X)
               шрифт XLFD (см. [4]), в котором используется единственный символ "*",
               предназначенный для забивки нескольких полей в середине имени.
               Список системных шрифтов приведен в части текста, описывающей
               особенности данной платформы.

     [3] семейство ?размер? ?стиль? ?стиль ...?
     Список, первым элементом которого является требуемое семейство
               шрифтов, а вторым, необязательным, элементом ≈ требуемый размер.
               Параметр размер интерпретируется по тем же правилам, что и параметр
               -size (см. "Параметры шрифтов"). Все остальные необязательные
               аргументы, следующие за параметром размер, представляют собой
               стили шрифтов. Они могут иметь следующие значения:

                  normal                                  bold                                                   roman
                  italic                                  underline                                                  overstrike
 

     [4] X-шрифт имена (XLFD)
               Имя шрифта для Unix-машин, представленное в виде

               -заливка-семейство-шрифт-наклон-устширина-добстиль-пиксель-точка-
разрешx-разрешy-промежуток-ширина-наборсимволов-кодирование

               -foundry-family-weight-slant-setwidth-addstyle-pixel-point-resx-
resy-spacing-width-charset-encoding.

     Поля, содержимое которых пользователю безразлично, можно
               пропустить, заменив символом "*". Каждому пропущенному полю должен
               соответствовать ровно один символ "*", а символ ⌠*■ в конце XLFD
               приводит к пропуску всех оставшихся полей; кратчайшая форма XLFD
               имеет вид просто "*", что означает, что значения всех полей берутся по
               умолчанию. Всем пропущенным полям присваиваются значения по
               умолчанию. В целях совместимости XLFD всегда выбирает шрифт
               заданного размера в пикселах (а не в точках). Несмотря на некоторую
               некорректность выбранного подхода, все приложения, использующие
               XLFD, предполагают, что ⌠точка■ в действительности совпадает с одним
               пикселем, и при использовании корректного размера шрифта могут
               привести к неправильному выводу шрифта (обычно с более крупными
               символами).

     [5] параметр значение ? параметр значение ...?
               Правильно сформированный список пар параметр-значение, задающих
               атрибуты шрифта, в том же формате, что и при определении
               поименованного шрифта (см. "Параметры шрифтов").

    При использовании описателя шрифта система пытается проанализировать
     описание в соответствии с приведенными выше пятью правилами в указанном
     порядке. В случаях [1] и [2] имя шрифта должно соответствовать существующему
     поименованному шрифту или системному шрифту. Случаи [3], [4] и [5]
     принимаются на всех платформах и в них будет использоваться шрифт, по
     параметрам ближайший к требуемому. В некоторых ситуациях оказывается
     невозможно найти близкий шрифт (например, имя семейства оказалось
     испорченным); в этом случае выбирается один из системно-зависимых шрифтов по
     умолчанию. Если описатель шрифта не подходит ни под один из приведенных
     выше образцов, то возникает ошибка.

МЕТРИЧЕСКИЕ ХАРАКТЕРИСТИКИ ШРИФТОВ

    Следующие параметры поддерживаются на всех платформах и используются для
     конструирования поименованного шрифта или при задании шрифта с помощью
     стиля [5] выше:

     -family имя
     Имя семейства шрифтов (нечувствительное к регистру). Tk обязательно
               поддерживает семейства с именами Courier (моноширинный шрифт
               ⌠пишущей машинки■), Times (⌠газетный■ шрифт с засечками) и Helvetica
               (рубленый ⌠европейский■ шрифт). При использовании одного из этих
               семейств шрифтов оно автоматически заменяется наиболее подходящим
               ⌠родным■ шрифтом. Имя семейства также может быть именем одного из
               родных шрифтов, зависящих от платформы; в этом случае семейство
               будет работать на своей платформе, как положено, однако при переходе
               к другой платформе могут возникнуть неприятности. Если имя семейства
               не задано или не опознано, то будет выбран шрифт по умолчанию для
               данной платформы.

     -size размер
     Требуемый кегль (размер) шрифта. Если значением аргумента является
               положительное число, то оно интерпретируется как размер символов в
               точках. Если значение отрицательно, то его абсолютная величина
               интерпретируется как размер в пикселах. Если шрифт указанного кегля
               нельзя вывести, то берется ближайший доступный размер. Если размер
               не задан или его значение равно нулю, то будет выбран размер по
               умолчанию для данной платформы.

               Как правило, размер шрифта следует указывать в точках; тогда
               приложение будет иметь один и тот же размер на экране даже на
               мониторах различного разрешения или при переносе скриптов на другие
               платформы. Однако использование пикселей оправдано, например, в
               ситуациях, когда строчка текста должна соответствовать по длине
               двуцветному изображению фиксированного размера. Коэффициент
               перехода от точек к пикселам и обратно устанавливается при запуске
               приложения на основе параметров используемого монитора, однако его
               можно изменить при помощи команды Tk scaling.

     -weight вес
     Условная толщина символов в шрифте. Значение normal задает шрифт
               нормальной толщины, bold ≈ жирный шрифт. Выбирается доступная
               толщина, ближайшая к заданной. По умолчанию параметр имеет
               значение normal.

     -slant наклон
     Величина, на которую символы шрифта отклоняются по вертикали.
               Допустимы значения roman и italic. Шрифт с наклоном roman ≈ это
               обычный прямой шрифт, а символы шрифта с наклоном italic
     отклоняются от вертикали на несколько градусов. Выбирается доступный
               наклон, ближайший к заданному. По умолчанию параметр имеет
               значение roman.

     -underline булевское
     Значением параметра является булевский флажок, указывающий,
               следует ли подчеркивать символы шрифта. По умолчанию параметр
               имеет значение ложь.

     -overstrike булевское
     Значением параметра является булевский флажок, указывающий,
               следует ли перечеркивать символы шрифта (горизонтальной прямой
               посреди символа). По умолчанию параметр имеет значение ложь.

ОСОБЕННОСТИ РЕАЛИЗАЦИИ НА РАЗЛИЧНЫХ ПЛАТФОРМАХ

    Различные платформы поддерживают следующие поименованные системные
     шрифты:

     X Windows:
               Все допустимые имена X шрифтов, включая перечисляемые
                         командой xlsfonts(1).
     MS Windows:

                 system                                        ansi                                                     device
                 systemfixed                               ansifixed                                            oemfixed
 

     Макинтош:

     system application

     См. также options.
 
 

СИНТАКСИС

СИНТАКСИС