# table

Создание таблиц и действия с ними.

Команда становится доступной для выполнения после загрузки библиотеки Tktable2.3 командой:

load /..../lib/Tktable2.3/Tktable.so.2.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.div>

%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 option args

Эта команда является волшебным средством, для переноса границ ячеек при изменении их размеров. Обычно она вызывается через события с одной из следующих подопций:

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 для информации о формате этого списка). Если опция указана без значения, команда возвращает список, описывающий одну опцию (этот список идентичен соответствующему подсписку списка, возвращаемого, если никакая опция не задана). Если заданы одна или более пар опция-величина, то команда модифицирует данную опцию виджета, чтобы она имела данное значение (значения); в этом случае команда возвращает пустую строку. Опция может быть любой из опций, определенных для команды table.

pathName curselection set value

Если аргументы команды не заданы, то команда возвращает отсортированные индексы выбранных ячеек. В противном случае она устанавливает во все выбранные ячейки заданное значение. Опция set не воздействует на таблицу, если у таблицы нет связанного Tcl массива или состояние таблицы неактивно.

pathName curvalue value

Если величина не задана, возвращается величина из редактируемой ячейки (с индексом active), иначе величина устанавливается в активной величине.

pathName delete optionarg?arg?

Эта команда используется, чтобы удалять различные компоненты таблицы. У нее есть различные формы, в зависимости от подопции:

pathName deleteactive index index

Удаляет текст из активной ячейки. Если дан только один индекс, команда удаляет символ после этого индекса, в противном случае удаляются символы с первого индекса по второй. index может быть числом, insert или end/div>

pathName deletecols switches index count

Удаляет count колонок, начиная с колонки с индексом index. Если count . отрицательное, удаляет колонки влево от начальной. В противном случае удаляет колонки вправо. Выбор очистится. Дополнительные ключи:

-cols value

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

-holddimensions

Обеспечивает сохранение числа столбцов в таблице (при удалении могут появиться пустые столбцы вместо удаленных). По умолчанию число столбцов уменьшается в соответствии со значением count.

-holdtags

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

-keeptitles

Защищает ячейки области заголовка от изменения. В противном случае они могут быть удалены подобно регулярным ячейкам.

-rows value

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

--

Означает конец ключей.

pathName delete rows switches index count

Удаляет count строк таблицы, начиная со строки index (и включая ее). Если count отрицательное, то удаляются предшествующие строки. В противном случае удаляются последующие строки. Выбор очищается. Ключи такие же, как для удаления столбца.

pathName flush first last

Сохраняет табличный кеш от first до last. Если индексы не заданы, сохраняется весь кеш.

pathName get first last

Возвращает (в виде списка) значения из ячеек, содержащихся в прямоугольной области с левым верхним углом, заданным индексом first, и правым нижним углом, определяемым индексом last (если задан).

pathName height row value row value ...

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

pathName icursor arg

Если команда задана без аргументов, то она возвращает позицию курсора вставки в активной ячейке. Если команда задана с одним аргументом, то она устанавливает курсор в этой точке в строке. 0 . перед первым символом. Допустимые индексы: insert для текущего положения курсора и end для конца текста.

pathName index index row|col

Возвращает индекс ячейки, которая соответствует указанному индексу, в форме row,col. Если задана опция row или col, то команда возвращает только индекс строки или столбца соответственно.

pathName insert optionarg arg

Эта команда используется, чтобы вставлять различные объекты (значения, колонки, столбцы и т.п.) в таблицу. У нее есть различные формы в зависимости от подопции:

pathName insert active index value

value является текстовой строкой, которая вставляется в активную ячейку, начиная с позиции index. Курсор затем позиционируется после встроенного текста. index может быть числом, insert или end.

pathName insert cols switches index count

Вставляет count столбцов, начиная с индекса col. Если count является отрицательным числом, они вставляются перед столбцом с индексом col. В противном случае они вставляются после столбца с индексом col. Выбор очищается. Ключи те же, как при удаления столбца.

pathName insert rows switches index count

Вставляет count строк, начиная с индекса col. Если count является отрицательным числом, они вставляются перед строкой с индексом col. В противном случае они вставляются после строки с индексом col. Выбор очистится. Ключи те же, как для удаления строки.

pathName reread

Перечитывает старое содержимое ячейки снова в буфер редактирования. Полезно для обработки событий, когда <Escape> нажимается, чтобы прервать редактирование (стандартное поведение).

pathName scan option args

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

pathName scan mark x y

Запоминает текущие координаты x и y и вид таблицы; используется в связке с последующей scan dragto командой. Обычно эта команда вызывается по нажатию на кнопку "Мыши". Возвращает пустую строку.

pathName scan dragto x y

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

pathName see index

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

pathName selection optionarg

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

pathName selection anchorinde

Устанавливает якорь выбора в ячейке, заданной индексом. Якорь выбора является концом выбора, который фиксируется, пока второй конец области выбора передвигается с помощью .Мыши.. Индекс anchor может использоваться для ссылок на соответствующую ячейку.

pathName selection clear first last

Снимает выбор с выбранных ячеек от first до last (включительно). Состояние выбора для ячеек за пределами этой области не изменяется. Если first равно all, команда удаляет выбор из всех ячеек.

pathName selection includes index

Возвращает `1', если ячейка, указанная индексом, выбрана, и `0. если нет.

pathName selection set first last

Выбирает все ячейки в области от first до last включительно, не влияя на состояние выбора ячеек за пределами этой области.

pathName set row|col index value index value ...

Для каждой пары index value устанавливает значение value в ячейке, определенной индексом. Проверка корректности значений при этом не производится. Если списку пар индекс-величина предшествует row или col, величина value рассматривается как Tcl список, и значения из списка устанавливаются в последовательных ячейках строки или колонки соответственно. Например, команда

set row 2,3 {2,3 2,4 2,5}

Установит значения в 3 ячейки, от 2,3 до 2,5.

pathName tag option arg arg ...

Эта команда используется, чтобы управлять тэгами. Точное поведение команды зависит от значения опции и аргументов. Только опция cget требует использования реально существующих тэгов. В настоящее время поддерживаются следующие формы команды:

pathName tag cell tagName index ...

Если команда задана без аргументов, то она распечатывает список ячеек, которые используют тэг. В противном случае она устанавливает тэг заданным ячейкам. Если тэг пустой ({}), ячейкам восстанавливается тэг по умолчанию. Тэги, добавленные с помощью опций -*tagcommand, здесь не обрабатываются.

pathName tag cget tagNameoption

Эта команда возвращает текущую величину опции option для тэга tagName. option может быть любой из опций, определенных для команды tag configure для таблиц.

pathName tag col tagName col ...

Если команда задана без аргументов, то она распечатывает список колонок, которые используют данный тэг. В противном случае устанавливает тэг заданным столбцам. Если тэг пустой ({}), столбцам восстанавливается тэг по умолчанию. Тэги, добавленные с помощью опции -coltagcommand, здесь не обрабатываются.

pathName tag configure tagName option value option value ...

Эта команда подобна команде configure для таблиц, за исключением того, что она изменяет опции, связыванные с тэгом tagName вместо модификации опций для всей таблицы. Если никакая опция не задана, команда возвращает список всех доступных опций для tag_Name (смотри Tk_ConfigureInfo для информации о формате этого списка). Если опция указана без величины, возвращается подсписок указанного списка, соответствующий указанной опции. Если указана одна или более пар опция- величина, то команда модифицирует данную опцию (опции) для указанного тэга; в этом случае команда возвращает пустую строку. См. "ТЭГИ".

pathName tag delete tagName

Удаляет тэг. Если тэг не существует, ошибки не возникает.

pathName tag exists tagName

Возвращает `1', если указанный тэг существует, и "0" в противном случае.

pathName tag includes tagNameindex

Возвращает `1', если ячейка с данным индексом имеет указанный тэг, и "0" в противном случае.

pathName tag names pattern

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

pathName tag row tagName row ...

Если команда задана без аргументов, то она распечатывает список строк, которые используют данный тэг. В противном случае она устанавливает данный тэг указанным строкам. Если тэг пустой ({}), строкам восстанавливается тэг по умолчанию. Тэги, добавленные с помощью опции rowtagcommand, не обрабатываются здесь.

pathName validate index

Явно проверяет корректность значения в ячейке, определенной индексом, с помощью команды, заданной опцией validatecommand. Возвращает `0' или `1' в зависимости от результатов проверки.

pathName width col value col value ...

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

pathName window option arg arg ...

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

pathName window cget index option

Эта команда возвращает текущую величину опции option для окна в ячейке с данным индексом. option может иметь любое из значений, допустимых для команды window configure.

pathName window configure index option value option value ...

Эта команда подобна команде configure для таблицы, за исключением того, что она изменяет опции, связанные с встроенным окном с данным индексом, а не опции таблицы в целом. Если опция указана без величины, возвращается подсписок указанного списка, соответствующий указанной опции. Если указана одна или более пар опция-величина, то команда модифицирует данную опцию (опции) для указанного окна; в этом случае команда возвращает пустую строку. См. "Встроенные окна ".

pathName window delete index index ...

Удаляет встроенное окно из таблицы.Соответствующее окно также будет удалено.

pathName window move indexFrom indexTo

Перемещает встроенное окно из одной ячейки в другую. Если в целевой ячейке уже существует другое окно, оно будет удалено.

pathName window names pattern

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

pathName xview args

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

pathName xview

Возвращает список, содержащий два элемента. Каждый из них является действительным числом из диапазона `0' `1'. Они указывают соответственно левую и правую границы видимой области. Например, если первый элемент `2' а второй элемент `6', то 20% табличного текста выходит за пределы экрана слева, средние 40% текста видны в окне, и 40% текста выходит за пределы экрана вправо. Эти величины используются для конфигурации полос прокрутки с помощью команды, заданной опцией -xscrollcommand.

pathName xview index

.Прокручивает. таблицу так, чтобы столбец с данным индексом отображался на левом крае окна.

pathName xview moveto fraction
═

.Прокручивает. таблицу так, чтобы доля общей ширины табличного текста, выходящая за пределы экрана влево, равнялась fraction. fraction должно быть дробью между `0' и `1'.

pathName xview scroll numberwhat

Эта команда .прокручивает. таблицу влево или вправо на заданное расстояние. number должно быть целым числом. what должно быть units или pages или сокращением одного из их. Если what равно units, таблица сдвигается на number символов (символ равен ширине символа 0); если what равно pages, таблица сдвигается на соответствующее число экранов. Если number является отрицательным числом, тогда более левые символы становятся видимыми; если number положительное число, тогда более правые символы становятся видимыми.

pathName yview args

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

pathName xview

Возвращает список, содержащий два элемента. Каждый из них является действительным числом из диапазона `0' - `1'. Они указывают соответственно верхнюю и нижнюю границы видимой области (например, `5' означает середину таблицы) Эти величины используются для конфигурации полос прокрутки с помощью команды, заданной опцией
-yscrollcommand.

pathName yview index

.Прокручивает. таблицу так, чтобы строка с данным индексом отображалась на верхнем крае окна.

pathName yview moveto fraction

.Прокручивает. таблицу так, чтобы доля общей высоты табличного текста, выходящая за пределы экрана вверх, равнялась fraction. fraction должно быть дробью между `0' и `1'.

pathName yview scroll number what

Эта команда .прокручивает. таблицу вверх или вниз на заданное расстояние. number должно быть целым числом. what должно быть units или pages или сокращением одного из их. Если what равно units, таблица сдвигается на number строк текста; если what равно pages, таблица сдвигается на соответствующее число экранов. Если number является отрицательным числом, тогда более ранние символы становятся видимыми; если number положительное число, тогда более поздние символы становятся видимыми.

СТАНДАРТНОЕ ПОВЕДЕНИЕ
═

Вновь созданная таблица обладает следующим поведением.

[1] Нажатие левой кнопки .Мыши. в ячейке активизирует эту ячейку. Нажатие кнопки .Мыши. в уже активной ячейке перемещает курсор вставки на ближайший символ.

[2] Перемещение курсора .Мыши., при нажатой левой кнопке, позволяет выделить область таблицы. Выход курсора из таблицы вниз, при нажатой левой кнопке .Мыши., обеспечивает прокрутку таблицы одновременно с выделением ячеек.

[3] Перемещение курсора .Мыши., при нажатой средней кнопке "Мыши", обеспечивает прокрутку таблицы без выделения.

[4] Клавиша Home возвращает к началу таблицы.

[5] Клавиша End перемещает в конец таблицы.

[6] Сочетание клавиш Control-Home перемещает в начало таблицы и активизирует первую ячейку.

[7] Сочетание клавиш Control-End перемещает в конец таблицы и активизирует последнюю ячейку.

[8] Сочетание клавиш Shift-Control-Home расширяет выделенную область таблицы до ее начала.

[9] Сочетание клавиш Shift-Control-End расширяет выделенную область таблицы до ее конца.

[10] Клавиши с изображениями стрелок позволяют выбрать соседнюю ячейку в соответствующем направлении.

[11] Сочетание клавиш Shift-<arrow> расширяет выбранную область в направлении, указываемом стрелкой.

[12] Сочетание клавиш Control-leftarrow и Control-rightarrow перемещают курсор вставки внутри ячейки.

[13] Сочетание клавиш Control-slash выбирает все ячейки.

[14] Сочетание клавиш Control-backslash clears снимает выбор со всех ячеек.

[15] Клавиша Backspace удаляет символ перед курсором вставки в активной ячейке.

[16] Клавиша Delete удаляет символ после курсора вставки в активной ячейке.

[17] Клавиша Escape перечитывает содержимое активной ячейки из заданного источника данных, отменяя любые изменения, выполненные в ячейке.

[18] Сочетание клавиш Control-a перемещает курсор вставки в начало активной ячейки.

[19] Сочетание клавиш Control-e перемещает курсор вставки в конец активной ячейки.

[20] Control-minus и Control-equals уменьшает и увеличивает ширину столбца, содержащего активную ячейку.

[21] Перемещение курсора .Мыши. с нажатой правой кнопкой когда курсор находится на границе ячейки вызовет изменение размеров строки и/или столбца, (при соответствующей величине опция resizeborders).

Поведение таблицы может незначительно отличаться от описанного выше в зависимости от значения опции -selectionmode.

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

Поведение таблиц может изменяться путем определения новых событий для конкретной таблицы или путем переопределения событий для всего класса. Описание стандартных событий приведено в файле tkTable.tcl.