Команда становится доступной для выполнения после загрузки библиотеки
Tktable2.3 командой:
Команды
виджета
СИНТАКСИС
table имя виджета ? опции ?СТАНДАРТНЫЕ ОПЦИИ
| -anchor |
-background |
-borderwidth |
| -cursor |
-exportselection |
-font |
| -foreground |
-highlightbackground |
-highlightcolor |
| -highlightthickness |
-insertbackground |
-insertborderwidth |
| -insertofftime |
-insertontime |
-insertwidth |
| -invertselected |
-padx |
-pady |
| -relief |
-takefocus |
-xscrollcommand |
| -yscrollcommand |
|
|
Детальное описание стандартных опций (см. "Опции).СПЕЦИАЛЬНЫЕ ОПЦИИ КОМАНДЫ
Имя опции в Командной строке: -autoclear
Имя опции в Базе данных
Х ресурсов: autoClear
Имя Класса в Базе данных Х ресурсов:
AutoClearБулева величина, которая определяет, будет ли по первому
нажатию на клавишу удаляться из ячейки тот текст, который был прежде там.
Значение по умолчанию - 0.
Имя опции в Командной строке:-bordercursor
Имя опции в Базе
данных Х ресурсов: borderCursor
Имя Класса в Базе данных Х ресурсов:
Cursor
Определяет имя курсора, который появляется на границе поля и показывает,
что размеры поля могут быть изменены интерактивно (определяется значением опции
-resizeborders). По умолчанию - crosshair (перекрестье).
Имя опции в Командной строке:-browsecommand или
-browsecmd
Имя опции в Базе данных Х ресурсов: browseCommand
Имя Класса в Базе данных Х ресурсов: BrowseCommand
Определяет команду, которая выполняется каждый раз, когда изменяется
активная ячейка. В команде могут использоваться %-подстановки, описанные ниже в
разделе Командные
подстановки.
Имя опции в Командной строке:-cache
Имя опции в Базе данных Х
ресурсов: cache
Имя Класса в Базе данных Х ресурсов:
Cache
Булева величина, которая определяет, будет ли использоваться внутренний
кеш таблицы. Его использование позволяет существенно повысить производительность
при использовании опции -command, но требует дополнительной памяти. Может
улучшить производительность и тогда, когда опции -command и
-variable не заданы. Кеш автоматически сбрасывается всякий раз при
изменении опций -cache и -variable, в противном случае Вы должны
сами сделать это. Значение по умолчанию - ложь.
Имя опции в Командной строке:-colorigin
Имя опции в Базе данных
Х ресурсов: colOrigin
Имя Класса в Базе данных Х ресурсов:
OriginОпределяет, какой индекс столбца является самым левым
столбцом в таблице. Эта величина используется для пользовательских индексов в
таблице. Значение по умолчанию - '0'.
Имя опции в Командной строке:-cols
Имя опции в Базе данных Х
ресурсов: cols
Имя Класса в Базе данных Х ресурсов: Cols
Число столбцов в таблице. Значение по умолчанию - '10'.
Имя опции в Командной строке:-colseparator
Имя опции в Базе
данных Х ресурсов: colSeparator
Имя Класса в Базе данных Х ресурсов:
Separator
Определяет символ, который будет использоваться как разделитель столбцов
при выборе данных из таблицы или при вставке данных в таблицу. По умолчанию,
столбцы разделяются как элементы tcl-списка.
Имя опции в Командной строке:-colstretchmode
Имя опции в Базе
данных Х ресурсов: colStretchMode
Имя Класса в Базе данных Х
ресурсов: StretchModeОпределяет один из следующих способов
расширения столбцов для заполнения дополнительного пространства окна:
none
Столбцы не расширяются и не заполняют все отведенное пространство окна
таблицы. Если столбцы слишком узки, то в таблице справа будет пробел. Это -
значение по умолчанию.unset
Расширяются только те столбцы, которые не имеют явно заданной
ширины.all
Все столбцы расширяются на одно и то же количество пикселей, чтобы
заполнить все пространство окна. В этом режиме могут возникнуть трудности при
ручном изменении размеров ширины ячейки.fill (используется
только при значении опции -rowstretch, равном currently)
В таблице получится больше или меньше столбцов в соответствии с величиной
отведенного пространства. Этот способ имеет многочисленные причуды и может
исчезнуть в будущем.last
Последний столбец расширяется так, чтобы заполнить все пространство окна
таблицы.Имя опции в Командной строке:-coltagcommand
Имя опции в
Базе данных Х ресурсов: colTagCommand
Имя Класса в Базе данных Х
ресурсов: TagCommand
Задает имя процедуры, которая выполняется, чтобы определить тэг, который
используется для данного столбца. Чтобы определить, как отображать ячейку,
сначала проверяется, не задан ли тэг для столбца с помощью команды tag
col. Если тэг для столбца не задан, выполняется процедура, определенная с
помощью настоящей опции. Процедура получает номер столбца в качестве
единственного аргумента. Процедура должна возвратить имя тэга или пустую строку.
Если при выполнении процедуры происходит ошибка или процедура возвращает
недопустимое имя тэга, сообщения об ошибке не выдается.
Имя опции в Командной строке:-colwidth
Имя опции в Базе данных Х
ресурсов: colWidth
Имя Класса в Базе данных Х ресурсов:
ColWidthЗадает ширину столбца по умолчанию. Ширина столбца
определяется в символах шрифта (используемого по умолчанию), если она является
положительным числом, или в пикселях, если она является отрицательным числом.
Значение по умолчанию - `10'.
Имя опции в Командной строке:-command
Имя опции в Базе данных Х
ресурсов: command
Имя Класса в Базе данных Х ресурсов:
Command
Определяет команду, которая используется в качестве процедурного
интерфейса к содержимому ячеек. Если опция -usecommand имеет значение
истина, эта команда будет использоваться вместо любой ссылки на массив -
variable. При выборе значения из таблицы вместо содержимого ячейки
возвращается результат выполнения команды. Использует %-подстановки, описанные
ниже в разделе
Командные подстановки.
Имя опции в Командной строке:-drawmode
Имя опции в Базе данных Х
ресурсов: drawMode
Имя Класса в Базе данных Х ресурсов:
DrawMode
Устанавливает один из следующих режимов рисования таблицы:
slow
Таблица предварительно формируется в памяти (offscreen pixmap) с
использованием двойной буферизации. Для границ используются Tk-функции. Этот
способ исключает мигание, но оказывается медленным для больших
таблиц.compatible
Таблица изображается непосредственно на экране с использованием Tk-функций
для границ. Это более быстрый способ, но экран может мигать При изменениях. Это
- значение по умолчанию.fast
Таблица изображается непосредственно на экране, причем границы рисуются с
использованием быстрых X-вызывов, то есть шириной в один пиксель. Как побочный
эффект, сужается область значений допустимых значений опции -borderwidth
до `0' и `1'. Этот способ обеспечивает наилучшую производительность для больших
таблиц, но при этом возможно мигание. Кроме того, этот способ допустим не при
всех возможных в Tk значениях ширины границы.single
Таблица рисуется на экране как в режиме fast, но линии изображаются
только одним пикселем.Имя опции в Командной строке: -flashmode
Имя опции в Базе данных Х ресурсов: flashMode
мя Класса в Базе
данных Х ресурсов: FlashModeБулево значение, которое определяет,
будут ли ячейки мигать, когда их величина изменяется. Тэг flash
назначается этим ячейкам на время, определенное с помощью опции
-flashtime. По умолчанию устанавливается на 0.
Имя опции в Командной строке:-flashtime
Имя опции в Базе данных
Х ресурсов: flashTime
Имя Класса в Базе данных Х ресурсов:
FlashTime
Время в четвертях секунды, в течение которого ячейка высвечивается при
изменении величины. Опция -flashmode должно иметь значение on.
Значение по умолчанию - 2.
Имя опции в Командной строке:-height
Имя опции в Базе данных Х
ресурсов: height
Имя Класса в Базе данных Х ресурсов:
Height
Определяет желаемую высоту для окна в рядах ячеек. Если задано нуль или
менее, высота окна выбирается достаточно большой, чтобы содержать все ряды
таблицы. Высота может ограничиваться с помощью опции -maxheight.
Имя опции в Командной строке:-invertselected
Имя опции в Базе
данных Х ресурсов: invertSelected
Имя Класса в Базе данных Х
ресурсов: InvertSelected
Определяет, будут ли цвета переднего и заднего планов ячейки заменены
друг на друга вместо использования опций тэга sel, когда ячейка выбрана.
По умолчанию устанавливается на 0 (использование опций тэга sel).
Имя опции в Командной строке:-maxheight
Имя опции в Базе данных
Х ресурсов: maxHeight
Имя Класса в Базе данных Х ресурсов:
MaxHeightМаксимально возможная высота окна в пикселях. Значение по
умолчанию - 600.
Имя опции в Командной строке:-maxwidth
Имя опции в Базе данных Х
ресурсов: maxWidth
Имя Класса в Базе данных Х ресурсов:
MaxWidthМаксимально возможная ширина окна в пикселях. Значение по
умолчанию - 800.
Имя опции в Командной строке:-multiline
Имя опции в Базе данных
Х ресурсов: multiline
Имя Класса в Базе данных Х ресурсов:
MultilineОпределяет значение по умолчанию для опции тэгов
-multiline. Значение по умолчанию - `1'.
Имя опции в Командной строке:-resizeborders
Имя опции в Базе
данных Х ресурсов: resizeBorders
Имя Класса в Базе данных Х ресурсов:
ResizeBordersОпределяет возможность интерактивного изменения
размеров ячеек. Допустимые значения опции - row, col, both
(по умолчанию) и none.
Имя опции в Командной строке:-rowheight
Имя опции в Базе данных
Х ресурсов: rowHeight
Имя Класса в Базе данных Х ресурсов:
RowHeightВысота колонки по умолчанию. Задается в числе строк текста
(шрифта, устанавливаемого по умолчанию), когда число является положительными,
или в пикселях, если оно - отрицательное. Значение по умолчанию - `1'.
Имя опции в Командной строке:-roworigin
Имя опции в Базе данных
Х ресурсов: rowOrigin
Имя Класса в Базе данных Х ресурсов:
OriginОпределяет, какую строку считать самой верхней строкой
таблицы. Эта величина используется для индексов пользователя в таблице. По
умолчанию устанавливается на "0".
Имя опции в Командной строке:-rows
Имя опции в Базе данных Х ресурсов: rows
Имя Класса в Базе
данных Х ресурсов: RowsКоличество строк в таблице. Значение по
умолчанию - `10'.
Имя опции в Командной строке:-rowseparator
Имя опции в Базе
данных Х ресурсов: rowSeparator
Имя Класса в Базе данных Х ресурсов:
SeparatorОпределяет символ, который будет проинтерпретирован как
разделитель строк при вставке или удалении данных из таблицы. По умолчанию,
строки разделяются как списки tcl.
Имя опции в Командной строке:-rowstretchmode
Имя опции в Базе
данных Х ресурсов: rowStretchMode
Имя Класса в Базе данных Х
ресурсов: StretchModeОпределяет способ расширения строк для
заполнения дополнительного пространства окна. Допустимые значения опции такие
же, как для опции -colstretchmode.
Имя опции в Командной строке:-rowtagcommand
Имя опции в Базе
данных Х ресурсов: rowTagCommand
Имя Класса в Базе данных Х ресурсов:
TagCommandЗадает имя процедуры, которая выполняется, чтобы
определить тэг, который используется для данной строки. Процедура определяется
пользователем. Она получает номер строки в качестве единственного аргумента.
Процедура должна возвратить имя тэга или пустую строку. Опция аналогична опции
-coltagcommand и отличается только тем, что задает тэг строки.
Имя опции в Командной строке:-selectioncommand or
-selcmd
Имя опции в Базе данных Х ресурсов: selectionCommand
Имя Класса в Базе данных Х ресурсов: SelectionCommandОпределяет
команду, которая выполняется при получении значений ячеек через механизм выбора
(например, при выполнении команды "selection get"). Результат выполнения
команды возвращается как результат выбора. В команде могут использоваться
%-подстановки, описанные ниже в разделе Командные
подстановки. Если при выполнении команды происходит ошибка, она
обрабатывается как ошибка фонового Tcl процесса и команда ничего не возвращает.
Имя опции в Командной строке:-selectmode
Имя опции в Базе
данных Х ресурсов: selectMode
Имя Класса в Базе данных Х ресурсов:
SelectModeОпределяет один из возможных режимов выбора ячеек.
Величина опции может быть произвольной, но встроенная обработка имеется только
для следующих режимов: single, browse, multiple и extended;
значение по умолчанию browse. Эти режимы аналогичны соответствующим
режимам для Tk listbox, за исключением того, что они применяются для двумерных
таблиц.
Имя опции в Командной строке:-selecttitle
Имя опции в Базе
данных Х ресурсов: selectTitles
Имя Класса в Базе данных Х ресурсов:
SelectTitlesОпределяет, допускается ли выбор ячеек заголовков. По
умолчанию устанавливается на '0' (выбор не допускается).
Имя опции в Командной строке:-selecttype
Имя опции в Базе
данных Х ресурсов: selectType
Имя Класса в Базе данных Х ресурсов:
SelectTypeОпределяет один из различных типов выбора для таблицы.
Опция может принимать одно из значений: row, col,
cell, или both (означает row && col); значение по
умолчанию cell. Определяет, будет ли изменение выбора для
ячейки (установление или снятие) воздействовать на весь ряд и(или) колонку.
Имя опции в Командной строке:-state
Имя опции в Базе данных
Х ресурсов: state
Имя Класса в Базе данных Х ресурсов:
StateОпределяет одно из двух состояний таблицы: нормальное или
неактивное. Если таблица не активна, то величины в ячейках не могут быть
изменены с использованием команд таблицы и никакой курсор вставки не
отображается, даже если фокус установлен в таблице. По умолчанию устанавливается
нормальное состояние.
Имя опции в Командной строке:-titlecols
Имя опции в
Базе данных Х ресурсов: titleCols
Имя Класса в Базе данных Х
ресурсов: TitleColsКоличество столбцов, используемое для
заголовков. По умолчанию устанавливается на '0'.
Имя опции в Командной строке:-titlerows
Имя опции в Базе
данных Х ресурсов: titleRows
Имя Класса в Базе данных Х ресурсов:
TitleRowsКоличество строк, используемое для заголовков. По
умолчанию устанавливается на 0.
Имя опции в Командной строке:-usecommand
Имя опции в Базе
данных Х ресурсов: useCommand
Имя Класса в Базе данных Х ресурсов:
UseCommandБулева величина, которое определяет, будет ли
использоваться команда, заданная с помощью опции -command. Эта величина
переустанавливается в нуль, если команда используется и возвращает ошибку.
Значение по умолчанию - `1' (команда будет использоваться, если она задана).
Имя опции в Командной строке:-validate
Имя опции в Базе
данных Х ресурсов: validate
Имя Класса в Базе данных Х ресурсов:
ValidateБулева величина, определяющая, будет ли производиться
проверка корректности значения активной ячейки. По умолчанию устанавливается на
"0".
Имя опции в Командной строке:-validatecommand или -vcmd
Имя опции в Базе данных Х ресурсов: validateCommand
Имя Класса в
Базе данных Х ресурсов: ValidateCommandОпределяет команду, которая
выполняется для проверки корректности нового значения при редактировании
активной ячейки. Эта команда должна возвращать булеву величину. Если она
возвращает true, то считается, что новое значение ячейки корректно. В
противном случае считается, что введенное значение некорректно и изменения
величины в ячейке не произойдет. Если при выполнении этой команды возникает
ошибка, она обрабатывается как ошибка фонового Tcl процесса. В команде могут
использоваться %-подстановки, описанные ниже в разделе Командные
подстановки.
Имя опции в Командной строке:-variable
Имя опции в Базе
данных Х ресурсов: variable
Имя Класса в Базе данных Х ресурсов:
VariableЗадает имя Tcl переменной (глобального массива), для работы
с С массивом, связанным с данной таблицей. Массив будет создан, если он не
существует или если это простая переменная. Индексы элементов массива имеют вид
row,col для соответствующих ячеек. В массиве содержится также элемент active,
который содержит величину буфера активной ячейки. Tcl массив может быть
разреженным массивом (не требуется, чтобы в нем содержались элементы для всех
ячеек таблицы). Более того, никакой элемент массива не содержит пустой величины,
и при очистке ячейки соответствующий элемент удаляется из Tcl массива.
Имя опции в Командной строке:-width
Имя опции в Базе данных
Х ресурсов: width
Имя Класса в Базе данных Х ресурсов:
WidthОпределяет желаемую ширину для окна в столбцах ячеек. Если она
задана равной нулю или отрицательной, то ширина для окна выбирается достаточно
большой, чтобы содержать все столбцы в таблице. Определенная таким образом
величина будет ограничена значением опции -maxwidth, если она задана.
Имя опции в Командной строке:-wrap
Имя опции в Базе данных
Х ресурсов: wrap
Имя Класса в Базе данных Х ресурсов:
WrapРазрешает для тэга перенос текста в ячейках на следующую
строку. Значение по умолчанию - '0'.ОПИСАНИЕ КОМАНДЫ
Команда table создает таблицу - 2-мерную сетку ячеек. Таблица может
использовать переменную Tcl массива или Tcl команду для сохранения и выбора
данных. Таблица имеет активную ячейку, содержимое которой может быть
отредактировано (если таблица находится в нормальном состоянии). Таблица
поддерживает общий стиль для ячеек, а также многочисленные тэги, которые могут
использоваться, чтобы изменить стиль колонки, столбца или конкретной ячейки (см.
"Теги").
Для ячеек можно установить поведение, при котором измененные ячейки меняют цвет
на определенное время ("мигают"). Ячейки могут содержать не только текст, но и
графические изображения или встроенные окна, как указано во фрагментахТеги и
"Встроенные
окна" соответственно.
Одна или более ячеек могут быть выбраны, как указано ниже. Если таблица
экспортирует свой выбор (смотри опцию -exportselection), то соблюдаются
стандартные протоколы X11 для обработки выбора. (См. "Выбор").
Не обязательно, чтобы все ячейки таблицы были видны сразу в табличном окне;
описанные ниже команды могут использоваться для просмотра ячеек. Таблицы
допускают "прокрутку" в обоих направлениях, используя стандартные опции
-xscrollcommand и -yscrollcommand. Они также поддерживают просмотр
ячеек, как указано ниже.
Чтобы обеспечить достаточную производительность, для таблиц можно выбирать
один из трех методов прорисовки, два из которых являются полностью
Tk-совместимыми.
ИНИЦИАЛИЗАЦИЯ
Когда команда table загружается в интерпретатор, выполняется
встроенная Tcl команда tkTableInit. Она ищет и исполняет файл с описанием
стандартного поведения таблиц. Файл ищется в каталогах $tcl_pkgPath (как
для конкретной, так и для произвольной версии Tktable), $tk_library и
[pwd] (текущий каталог). Вы можете также определить
$env(TK_TABLE_LIBRARY), который будет поставлен в начало этого списка. По
умолчанию, ищется файл tkTable.tcl, но имя файла может быть изменено с помощью
переменной $env(TK_TABLE_LIBRARY_FILE).
Этот скрипт может быть заменен на ваш собственный, если вы создадите
собственную процедуру tkTableInit прежде, чем библиотека будет загружена. В
противном случае, вышеупомянутая переменная env(TK_TABLE_LIBRARY) будет
содержать имя каталога, в котором был найден файл
$env(TK_TABLE_LIBRARY_FILE).
ИНДЕКСЫ
Многие команды для таблиц используют один или более индексов как аргументы.
Индекс определяет конкретную ячейку таблицы одним из следующих способов:
число,число
Определяет ячейку, соответствующую элементу row,col связанного Tcl
массива, где -roworigin,-colorigin соответствует первой ячейке в
таблице (0,0 по умолчанию).active
Указывает активную ячейку, (ячейку, которая содержит курсор). Активная
ячейка может задаваться командой activate.anchor
Указывает якорную точку для выбора, которая устанавливается с помощью
команды selection anchor.bottomright
Указывает самую нижнюю - самую правую ячейку, видимую в
таблице.end
Указывает самую нижнюю - самую правую ячейку в
таблице.origin
Указывает самую верхнюю - самую левую редактируемую ячейку таблицы, не
обязательно видимую на экране.topleft
Указывает самую верхнюю - самую левую редактируемую ячейку, видимую в
таблице.@x,y
Указывает ячейку, которая покрывает в табличном окне точку с координатами x
и y (в пикселях). Если никакая ячейка не покрывает эту точку, используется
ближайшая к этой точке ячейка.В описаниях команд таблиц, приведенных
ниже, аргументы, называющиеся index, first или last всегда
обозначают индексы в одной из вышеуказанных форм.ТЕГИ
Тэг является текстовой строкой, которая связывается с нулем или больше
колонок, столбцов или ячеек в таблице. Тэги могут содержать произвольные
символы, но желательно избегать использования для тегов имен, похожих на
индексы. С колонками, столбцами или ячейками таблицы может быть связано любое
количество тэгов. В каждой таблице есть несколько постоянных тэгов, которые
могут конфигурироваться пользователем и определят атрибуты для специальных
ячеек:
active
Это тэг активной ячейки.flash
Если режим высвечивания включен, этот тэг дается всем недавно
отредактированным ячейкам.sel
Этот тэг дается всем выбранным ячейкам.title
Этот тэг дается всем ячейкам, используемым для заголовков колонок и строк.
Для этого тэга по умолчанию определено состояние "неактивно".Тэги
определяют, как соответствующие ячейки отображаются на экране. По умолчанию,
ячейки отображаются, как определено опциями -background, -font, и
-foreground для таблицы. Тем не менее, для каждого тэга могут быть заданы
индивидуальные значения этих опций с помощью команды
pathName tag configureЕсли для ячейки задан тэг, опции
тэга переопределяют стиль таблицы. В настоящее времени для тэгов поддерживаются
следующие опции:
-anchor anchor
якорь для текста или другого объекта в пространстве
ячейки;-background или -bg color
цвет Фона ячейки;-font fontName
шрифт для текста в ячейке;-foeground или -fg
color
цвет переднего плана ячейки;-justify justify
выключка текста в ячейке. Возможные значения left,
right, center;-image imageName
графический объект, который будет отображен в ячейке вместо
текста;-multiline boolean
отобразить текст с символами "конец строки" в виде нескольких
строк;-relief relief
рельеф для ячейки;-showtext boolean
показывать текст поверх графического объекта;-state
state
состояние ячейки, позволяет определенным ячейкам быть неактивными. Это
предохраняет ячейку от редактирования с помощью вставки или удаления, но
остается возможным прямое занесение информации в массив, результаты которого
отображаются в таблице;-wrap boolean
разрешает переносить символы в следующую строку, если ячейка недостаточно
широкая.Для тэгов определен порядок приоритета. Он используется при
выполнении некоторых описанных ниже функций, связанных с тэгами. Когда ячейка
отображается, ее свойства определяются тэгами, которые ей присвоены. Этот
порядок, включая специальные тэги, - flash, active, sel, title,
celltag, rowtag, coltag, default.
Если с ячейкой связано несколько различных тэгов и если их опции противоречат
между собой, используются опции самого приоритетного тэга. Если конкретная опция
не определена для конкретного тэга или если она определена как пустая строка,
эта опция никогда не будет использована. Будет использовано значение опции от
следующего по приоритету тэга. Если ни для одного тэга опция не определена,
будет использован стиль, заданный по умолчанию для виджета.
Графические объекты используются только для показа. Редактирование текста в
таких ячейках остается возможным, и любой запрос покажет текст, хранящийся в
ячейке, независимо от значения опции -showtext.
ВСТРОЕННЫЕ ОКНА
В таблице может быть произвольное количество встроенных окон (по одному на
ячейку), и любой виджет (подчиняющийся обычным правилам, по которым встроенное
окно должно быть потомком табличного окна или его родителя) может быть
использован в качестве встроенного окна. Позиция встроенного окна на экране
будет скорректирована, как только будет изменена или передвинута таблица, и оно
будет отображено на экране или спрятано в зависимости от того, находится ли
соответствующая ячейка в видимой области таблицы. Каждое встроенное окно
занимает одну ячейку таблицы, и на него можно сослаться по индексу ячейки.
Встроенные окна уничтожаются, когда уничтожается содержащая их таблица.
Окна используются только для показа. Текстовое значение для ячеек, занятых
окнами, существует, но оно не отображается, пока окно не удаляется некоторым
способом.
Когда встроенное окно вставлено в таблицу с помощью команды window configure,
с ним связывается несколько опций, которые могут быть изменены с помощью
последующих вызовов команды window configure. В настоящее время поддерживаются
следующие опции:
-create script
В НАСТОЯЩЕЕ ВРЕМЯ НЕ ПОДДЕРЖИВАЕТСЯ. Определяет Tcl скрипт, который может
выполняться для создания заявленного окна. Если для окна, встроенного в ячейку,
опция -window не задана, при необходимости отобразить ячейку на экране будет
выполнен скрипт. Скрипт должен создать окно и вернуть его имя как результат
выполнения скрипта. Если впоследствии окно будет удалено, перед повторным
появлением ячейки на экране скрипт будет выполнен
опять.-background или -bg color
Цвет Фона окна. Если опция не определена, то используется цвет фона
таблицы.-padx pixels
Как определено в руководстве по Tk.-pady pixels
Как определено в руководстве по Tk.-relief relief
Рельеф, используемый для ячейки, в которой лежит окно. Если опция не
определена, используется значение для таблицы.-sticky
sticky
"Клейкость" окна в ячейке, как определено для команды grid.-window
pathName
Определяет имя окна, которое будет отображено в ячейке. Окно должно
существовать прежде, чем может быть использовано здесь.ВЫБОР
Табличные выборы представляют собой данные типа СТРОКА. По умолчанию,
величина выбора состоит из величин (значений) выбранных ячеек в форме Tcl
списка, где каждый ряд является списком и каждый столбец является элементом
списка ряда. Вы можете изменить способ, которым интерпретируется эта величина, с
помощью опций -rowseparator и colseparator. Например, формат
Эксела устанавливается с помощью значений
-rowseparator "\n" и
-colseparator "\t". Изменение этих опций влияет как на формирование
выбора для таблицы, так и на чтение данных при вставке, гарантируя, что в
таблице можно вырезать данные и вставить их в нее же. Можно изменять поведение
таблицы при вставке данных с помощью редактирования библиотечной процедуры
tk_tablePasteHandler. Это может потребоваться, если установлена опция
-selectioncommand.КОМАНДНЫЕ
ПОДСТАНОВКИ
Команды, задающиеся с помощью различных опций таблиц, могут использовать
традиционные для Tk %-ные подстановки (см. bind).
Следующие %-ные подстановки выполняются при работе с таблицами:
%c
Для SelectionCommand это - максимальное количество столбцов в ряду в
выбранной области.
Для остальных команд - индекс столбца ячейки, вызвавшей событие.
%c
Удобная замена для %r,%c.%i
Для SelectionCommand это - общее число ячеек в выбранной
области.Для Command это - `0' для чтения (get) и `1' для
записи (set).
Для остальных команд - текущая позиция курсора в ячейке.
%R
Для SelectionCommand это - количество рядов в выбранной
области.Для остальных команд - ряд ячейки, породившей событие.
%S
Для ValidateCommand это - текущее значение в ячейке, которое будет
проверяться.Для SelectionCommand это - значение по умолчанию для
выбора.
Для BrowseCommand это - индекс последней активной ячейки.
Для Command это - пустое значение для чтения (get) и текущая значение в
ячейке для записи (set).
%S
Для ValidateCommand это - потенциальное новое значение в ячейке, значение в
которой проверяется.Для BrowseCommand это - индекс новой активной
ячейки.
%W
Имя окна, вызвавшего событие.КОМАНДЫ ВИДЖЕТА
Команда table создает новую команду Tcl, чье имя является именем созданного
виджета. Эта команда может использоваться, чтобы выполнить различные действия с
виджетом. У нее есть следующая общая форма:
pathName option ?arg arg ...?
где pathName - имя виджета.
Значение опции и аргументов определяют точное назначение команды.
Для таблиц определены следующие опции команды:
pathName activate index
Активизирует ячейку, заданную индексом.pathName bbox
first ?last?
Возвращает параметры области, объемлющей заданную ячейку (группу ячеек) в
виде списка из четырех элементов: координат x и y левого верхнего угла области,
ее ширины и высоты в пикселях. Область объемлет только те из указанных ячеек,
которые видны на экране. Если таких ячеек нет, возвращается пустая
строка.pathName border optionargs
Эта команда является волшебным средством, для переноса границ ячеек при
изменении их размеров. Обычно она вызывается через события с одной из следующих
подопций:pathName border mark x y
?row|col?
Запоминает координаты x и y и границу строки и/или столбца под этой точкой
в таблице, если точка лежит на границе. Используется в связке с последующей
командой border dragto. Чаще всего эта команда вызывается по нажатию
кнопки "Мыши" на таблице. Если аргумент row или col не задан,
команда возвращает кортеж из обоих индексов границы (пустой кортеж означает, что
точка не принадлежит границе). В противном случае возвращается индекс заданной
границы (строки или столбца соответственно).pathName
border dragto x y
Эта команда вычисляет разность между своими x и y аргументами
и y и x аргументами последней команды border mark
для таблицы. Затем она изменяет положение границы на вычисленную разность. Эта
команда обычно вызывается по событию движения "Мыши" в таблице, чтобы произвести
эффект интерактивного изменения границы.pathName cget
option
Возвращает текущую величину опции. Option может быть любой из опций,
определенных для таблиц.pathName clear option
?first? ?last?
Эта команда является удобной утилитой, чтобы удалять различные объекты
таблицы. first и last представляют правильные табличные индексы.
Если ни один индекс не задан, команда выполняется для всей таблицы. Возможные
подопции:pathName clear cache ?first? ?last?
Очищает определенный раздел кеша, если таблица использовала
кеш.pathName clear sizes ?first? ?last?
Отменяет заданные размеры ячеек для столбцов и колонок, входящих в заданную
область. Если задан только один индекс, например, '2,0', то он задает область,
состоящую из колонки '2' и столбца '0'.pathName clear tags
?first? ?last?
Очищает определенную область от тэгов (все row, column и cell
тэги).pathName clear all ?first? ?last?
Выполняет все вышеуказанные действия в определенной
области.pathName configure ?option?
?value? ?option value ...?
Запрашивает или модифицируют опции таблицы. Если никакая опция не
определена, возвращает список, описывающий все доступные опции для виджета
(смотри Tk_ConfigureInfo для информации о формате этого списка). Если
опци
