При отрисовке рукояток перегородки задаёт расстояние от верхнего или левого края перегородки (в зависимости от ориентации виджета), где следует отобразить рукоятку. Может принимать любое значение, допустимое для Tk_GetPixels.
Имя в командной строке: -handlesize
Имя в базе данных: handleSize
Класс в базе данных: HandleSize
Задаёт длину стороны рукоятки перегородки. Рукоятки всегда рисуются в виде квадратов. Может принимать любое значение, допустимое для Tk_GetPixels.
Имя в командной строке: -height
Имя в базе данных: height
Класс в базе данных: Height
Задаёт желаемую высоту всего виджета panedwindow. Может принимать любое значение, допустимое для Tk_GetPixels. Если значение пустое, виджет будет иметь высоту, достаточную для размещения всех вложенных виджетов с их естественной высотой.
Имя в командной строке: -proxybackground
Имя в базе данных: proxyBackground
Класс в базе данных: ProxyBackground
Цвет фона, используемый при отрисовке прокси. Если значение пустое, используется значение опции -background.
Имя в командной строке: -proxyborderwidth
Имя в базе данных: proxyBorderWidth
Класс в базе данных: ProxyBorderWidth
Задаёт ширину границы прокси. Может принимать любое значение, допустимое для Tk_GetPixels.
Имя в командной строке: -proxyrelief
Имя в базе данных: proxyRelief
Класс в базе данных: ProxyRelief
Тип рельефа, используемый при отрисовке прокси. Может принимать любое из стандартных значений рельефа Tk. Если значение пустое, используется значение опции -sashrelief.
Имя в командной строке: -opaqueresize
Имя в базе данных: opaqueResize
Класс в базе данных: OpaqueResize
Задаёт, должны ли панели изменяться в размере по мере перемещения перегородки (true), или изменение размера должно быть отложено до размещения перегородки (false).
Имя в командной строке: -sashcursor
Имя в базе данных: sashCursor
Класс в базе данных: SashCursor
Курсор мыши, используемый при наведении на перегородку. Если значение null, для горизонтальных panedwindow используется sb_h_double_arrow, а для вертикальных - sb_v_double_arrow.
Имя в командной строке: -sashpad
Имя в базе данных: sashPad
Класс в базе данных: SashPad
Задаёт отступ по обеим сторонам перегородки. Может принимать любое значение, допустимое для Tk_GetPixels.
Имя в командной строке: -sashrelief
Имя в базе данных: sashRelief
Класс в базе данных: SashRelief
Тип рельефа, используемый при отрисовке перегородки. Может принимать любое из стандартных значений рельефа Tk.
Имя в командной строке: -sashwidth
Имя в базе данных: sashWidth
Класс в базе данных: SashWidth
Задаёт ширину каждой перегородки. Может принимать любое значение, допустимое для Tk_GetPixels.
Имя в командной строке: -showhandle
Имя в базе данных: showHandle
Класс в базе данных: ShowHandle
Задаёт, должны ли отображаться рукоятки перегородки. Может принимать любое допустимое булево значение Tcl.
Имя в командной строке: -width
Имя в базе данных: width
Класс в базе данных: Width
Задаёт желаемую ширину всего виджета panedwindow. Может принимать любое значение, допустимое для Tk_GetPixels. Если значение пустое, виджет будет иметь ширину, достаточную для размещения всех вложенных виджетов с их естественной шириной.
Описание
Команда panedwindow создаёт новое окно (заданное аргументом pathName) и преобразует его в виджет panedwindow. Дополнительные параметры, описанные выше, могут быть заданы в командной строке или в базе параметров для настройки аспектов виджета panedwindow, таких как цвет фона и рельеф по умолчанию. Команда panedwindow возвращает имя пути нового окна.
Виджет panedwindow содержит любое количество панелей, расположенных горизонтально или вертикально в соответствии со значением опции -orient. Каждая панель содержит один виджет, а каждая пара панелей разделена подвижной (с помощью движений мыши) перегородкой. Перемещение перегородки приводит к изменению размеров виджетов с обеих сторон перегородки.
Команда виджета
Команда panedwindow создаёт новую Tcl-команду, имя которой совпадает с именем пути окна виджета panedwindow. Эта команда может использоваться для вызова различных операций над виджетом. Она имеет следующий общий формат:
pathName option ?arg arg ...?
PathName — имя команды, которое совпадает с именем пути виджета panedwindow. Option и argопределяют точное поведение команды. Доступны следующие команды для виджетов panedwindow:
pathName add window ?window ...? ?option value ...?
Добавить одну или несколько окон в panedwindow, каждое в отдельной панели. Аргументы состоят из имён одного или нескольких окон, за которыми следуют пары аргументов, определяющих способ управления окнами. Option может иметь любое значение, принимаемое подкомандой configure.
pathName cget option
Возвращает текущее значение конфигурационного параметра, заданного option. Option может иметь любое значение, принимаемое командой panedwindow.
pathName configure ?option? ?value option value ...?
Запрос или изменение конфигурационных параметров виджета. Если option не указан, возвращает список, описывающий все доступные параметры для pathName (см. Tk_ConfigureInfo для информации о формате этого списка). Если option указан без value, то команда возвращает список, описывающий указанный параметр (этот список будет идентичен соответствующему подсписку значения, возвращённого, если option не указан). Если указана одна или несколько пар option-value, то команда изменяет указанный(ые) параметр(ы) виджета на заданное(ые) значение(я); в этом случае команда возвращает пустую строку. Option может иметь любое значение, принимаемое командой panedwindow.
pathName forget window ?window ...?
Удалить панель, содержащую window, из panedwindow. Все параметры управления геометрией для window будут забыты.
pathName identify x y
Определяет компонент panedwindow под точкой, заданной x и y, в координатах окна. Если точка находится над перегородкой или её ручкой, результатом является список из двух элементов, содержащий индекс перегородки или ручки и слово, указывающее, находится ли она над перегородкой или ручкой, например {0 sash} или {2 handle}. Если точка находится над любой другой частью panedwindow, результатом является пустой список.
pathName proxy ?args?
Эта команда используется для запроса и изменения положения прокси-перегородки, используемой для изменения размера панелей методом резинового ленточного захвата. Она может принимать любой из следующих форм:
pathName proxy coord
Возвращает список, содержащий координаты x и y последнего расположения прокси.
pathName proxy forget
Удаляет прокси с экрана.
pathName proxy place x y
Размещает прокси в заданных координатах x и y.
pathName sash ?args?
Эта команда используется для запроса и изменения положения перегородок в panedwindow. Она может принимать любой из следующих форм:
pathName sash coord index
Возвращает текущую пару координат x и y для перегородки, заданной index. Index должен быть целым числом от 0 до на 1 меньше количества панелей в panedwindow. Возвращаемые координаты — это координаты левого верхнего угла области, содержащей перегородку.
pathName sash dragto index x y
Эта команда вычисляет разницу между заданными координатами и координатами, заданными последней командой sash mark для данной перегородки. Затем она перемещает перегородку на вычисленную разницу. Возвращаемое значение — пустая строка.
pathName sash mark index x y
Записывает x и y для перегородки, заданной index; используется совместно с последующими командами sash dragto для перемещения перегородки.
pathName sash place index x y
Размещает перегородку, заданную index, в заданных координатах.
pathName panecget window option
Запрос параметра управления для window. Option может быть любым значением, разрешённым подкомандой paneconfigure.
pathName paneconfigure window ?option? ?value option value ...?
Запрос или изменение параметров управления для окна. Если параметр не указан, возвращает список, описывающий все доступные параметры для pathName (см. Tk_ConfigureInfo для получения информации о формате этого списка). Если параметр указан без значения, то команда возвращает список, описывающий один указанный параметр (этот список будет идентичен соответствующему подсписку значения, возвращаемого при отсутствии параметра). Если указана одна или несколько пар параметр-значение, то команда изменяет указанный(ые) параметр(ы) виджета на указанное(ые) значение(я); в этом случае команда возвращает пустую строку. Поддерживаются следующие параметры:
-после окно
Вставить окно после указанного окна. окно должно быть именем окна, уже управляемого pathName.
-перед окно
Вставить окно перед указанным окном. окно должно быть именем окна, уже управляемого pathName.
-высота размер
Указать высоту окна. Высота будет внешним размером окна, включая его рамку, если она есть. Если размер является пустой строкой или если -высота не указана, то высота, запрошенная внутри окна, будет использоваться изначально; высота может быть позже скорректирована перемещением разделителей в окне с разделителями. Размер может иметь любое значение, принимаемое Tk_GetPixels.
-скрыть булево значение
Управляет видимостью панели. Когда булево значение равно true (согласно Tcl_GetBoolean), панель не будет видимой, но она по-прежнему будет поддерживаться в списке панелей.
-минимальный размер n
Указывает, что размер окна не может быть меньше n. Это ограничение влияет только на размер виджета в направлении разделителя — ось x для горизонтальных окон с разделителями, ось y для вертикальных окон с разделителями. Может быть любое значение, принимаемое Tk_GetPixels.
-отступ по X n
Указывает неотрицательное значение, определяющее, сколько дополнительного места следует оставить с каждой стороны окна в направлении X. Значение может иметь любой из форматов, принимаемых Tk_GetPixels.
-отступ по Y n
Указывает неотрицательное значение, определяющее, сколько дополнительного места следует оставить с каждой стороны окна в направлении Y. Значение может иметь любой из форматов, принимаемых Tk_GetPixels.
-прилипание стиль
Если панель окна больше, чем запрошенные размеры окна, этот параметр может использоваться для позиционирования (или растяжения) окна в его панели. Стиль — это строка, содержащая ноль или более символов n, s, e или w. Строка может необязательно содержать пробелы или запятые, но они игнорируются. Каждый символ относится к стороне (север, юг, восток или запад), к которой окно будет «прикреплено». Если указаны и n, и s (или e и w), окно будет растянуто для заполнения всей высоты (или ширины) его области.
-растяжение когда
Управляет тем, как дополнительное пространство распределяется между панелями. Когда — это одно из значений всегда, первое, последнее, середина и никогда. Окно с разделителями рассчитает требуемый размер всех его панелей. Любое оставшееся (или недостающее) пространство будет распределено между панелями, отмеченными для растяжения. Распределение будет основано на текущем соотношении каждой панели к целому. Значения когда имеют следующее определение:
всегда
Эта панель всегда будет растягиваться.
первое
Только если эта панель является первой панелью (самой левой или верхней), она будет растягиваться.
последнее
Только если эта панель является последней панелью (самой правой или нижней), она будет растягиваться. Это значение по умолчанию.
середина
Только если эта панель не является первой или последней, она будет растягиваться.
никогда
Эта панель никогда не будет растягиваться.
-ширина размер
Указать ширину окна. Ширина будет внешним размером окна, включая его рамку, если она есть. Если размер является пустой строкой или если -ширина не указана, то ширина, запрошенная внутри окна, будет использоваться изначально; ширина может быть позже скорректирована перемещением разделителей в окне с разделителями. Размер может иметь любое значение, принимаемое Tk_GetPixels.
pathName панели
Возвращает упорядоченный список виджетов, управляемых pathName.
Изменение размера панелей
Панель изменяется размером путем захвата разделителя (или ручки разделителя, если она есть) и перемещения мышью. Это достигается с помощью привязок к движениям мыши к виджету. При перемещении разделителя размеры панелей с каждой стороны разделителя, а следовательно, и виджетов в этих панелях, корректируются.
Когда панель изменяется размером снаружи (например, она упакована для расширения и заполнения, а содержащий верхний уровень изменен размером), пространство добавляется к последней (самой правой или самой нижней) панели в окне.
В отличие от окон-рабов, управляемых, например, pack или grid, панели, управляемые panedwindow, не изменяют ширину или высоту для адаптации к изменениям запрошенных ширин или высот панелей после того, как они были отображены. Поэтому, особенно при создании макетов интерактивно, не рекомендуется добавлять панель в виджет panedwindow до тех пор, пока не будут окончательно определены запросы геометрии этой панели (т.е., все компоненты панели вставлены, все параметры, влияющие на геометрию, установлены в свои надлежащие значения и т. д.).
