Spec-Zone.ru › Tcl/Tk

winfo

Имя
winfo — Возвращает информацию, связанную с окнами
Синтаксис
Описание
winfo atom ?-displayof window? name
winfo atomname ?-displayof window? id
winfo cells window
winfo children window
winfo class window
winfo colormapfull window
winfo containing ?-displayof window? rootX rootY
winfo depth window
winfo exists window
winfo fpixels window number
winfo geometry window
winfo height window
winfo id window
winfo interps ?-displayof window?
winfo ismapped window
winfo manager window
winfo name window
winfo parent window
winfo pathname ?-displayof window? id
winfo pixels window number
winfo pointerx window
winfo pointerxy window
winfo pointery window
winfo reqheight window
winfo reqwidth window
winfo rgb window color
winfo rootx window
winfo rooty window
winfo screen window
winfo screencells window
winfo screendepth window
winfo screenheight window
winfo screenmmheight window
winfo screenmmwidth window
winfo screenvisual window
winfo screenwidth window
winfo server window
winfo toplevel window
winfo viewable window
winfo visual window
winfo visualid window
winfo visualsavailable window ?includeids?
winfo vrootheight window
winfo vrootwidth window
winfo vrootx window
winfo vrooty window
winfo width window
winfo x window
winfo y window
Пример
Ключевые слова

Имя

winfo — Возвращает информацию, связанную с окнами

Синтаксис

winfooption ?arg arg ...?

Описание

Команда winfo используется для получения информации об окнах, управляемых Tk. Она может принимать различные формы в зависимости от аргумента option. Допустимые формы:
winfo atom ?-displayof window? name
Возвращает строку с десятичным значением целого идентификатора атома, имя которого name. Если атом с именем name не существует, то создаётся новый. Если опция -displayof указана, то атом ищется на дисплее window; иначе — на дисплее главного окна приложения.
winfo atomname ?-displayof window? id
Возвращает текстовое имя атома с целым идентификатором id. Если опция -displayof указана, то идентификатор ищется на дисплее window; иначе — на дисплее главного окна приложения. Эта команда является обратной командой winfo atom. Возникает ошибка, если такого атома не существует.
winfo cells window
Возвращает строку с десятичным значением числа ячеек в цветовой карте для window.
winfo children window
Возвращает список, содержащий имена путей всех дочерних окон window. Окна верхнего уровня возвращаются как дочерние окна их логических родителей. Список упорядочен по порядку отображения, начиная с самого нижнего окна, за исключением окон верхнего уровня, которые не возвращаются в порядке отображения. Используйте команду wm stackorder для запроса порядка отображения окон верхнего уровня.
winfo class window
Возвращает имя класса для window.
winfo colormapfull window
Возвращает 1, если цветовая карта для window известна как полная, и 0 в противном случае. Цветовая карта окна «известна» как полная, если последняя попытка выделения нового цвета в этом окне закончилась неудачей, и это приложение не освобождало цвета в цветовой карте с момента неудачного выделения.
winfo containing ?-displayof window? rootX rootY
Возвращает имя пути к окну, содержащему точку с координатами rootX и rootY. RootX и rootY задаются в единицах экрана (то есть любой формат, приемлемый для Tk_GetPixels) в системе координат окна корня (если используется менеджер окон виртуального корня, то система координат виртуального окна корня используется). Если опция -displayof указана, то координаты относятся к экрану, содержащему window; иначе — к экрану главного окна приложения. Если в этом приложении нет окна, содержащего точку, возвращается пустая строка. При выборе содержащего окна дочерним окнам отдаётся приоритет перед родительскими, а среди родственных окон выбирается самое верхнее в порядке отображения.
winfo depth window
Возвращает строку с десятичным значением глубины window (количество бит на пиксель).
winfo exists window
Возвращает 1, если существует окно с именем window, и 0, если такого окна не существует.
winfo fpixels window number
Возвращает значение с плавающей точкой, представляющее количество пикселей в window, соответствующее расстоянию, заданному number. Number может быть указан в любом формате, приемлемом для Tk_GetScreenMM, например, «2.0c» или «1i». Возвращаемое значение может быть дробным; для целочисленного значения используйте winfo pixels.
winfo geometry window
Возвращает геометрию для window в формате widthxheight+x+y. Все размеры заданы в пикселях.
winfo height window
Возвращает строку с десятичным значением высоты window в пикселях. Когда окно создаётся впервые, его высота будет 1 пиксел; высота в конечном итоге изменяется менеджером геометрии для удовлетворения потребностей окна. Если вам нужна истинная высота сразу после создания виджета, вызовите update, чтобы заставить менеджер геометрии организовать его, или используйте winfo reqheight, чтобы получить запрошенную высоту окна вместо фактической высоты.
winfo id window
Возвращает шестнадцатеричную строку, представляющую низкоуровневый платформозависимый идентификатор для window. На платформах Unix это идентификатор окна X. В Windows это HWND Windows. На Macintosh значение не имеет смысла за пределами Tk.
winfo interps ?-displayof window?
Возвращает список, члены которого — имена всех интерпретаторов Tcl (например, все приложения на основе Tk), зарегистрированных для определённого дисплея. Если опция -displayof указана, возвращаемое значение относится к дисплею window; иначе — к дисплею главного окна приложения.
winfo ismapped window
Возвращает 1, если window отображено в данный момент, и 0 в противном случае.
winfo manager window
Возвращает имя менеджера геометрии, который в данный момент отвечает за window, или пустую строку, если window не управляется никаким менеджером геометрии. Имя обычно является именем команды Tcl для менеджера геометрии, например, pack или place. Если менеджер геометрии — виджет, например, холсты или текст, имя — команда класса виджета, например, canvas.
winfo name window
Возвращает имя window (то есть его имя внутри родительского окна, в отличие от полного имени пути). Команда winfo name . вернёт имя приложения.
winfo parent window
Возвращает имя пути к родительскому окну window, или пустую строку, если window — главное окно приложения.
winfo pathname ?-displayof window? id
Возвращает имя пути к окну, X-идентификатор которого id. Id должен быть десятичным, шестнадцатеричным или восьмеричным целым числом и должен соответствовать окну в вызывающем приложении. Если опция -displayof указана, то идентификатор ищется на дисплее window; иначе — на дисплее главного окна приложения.
winfo pixels window number
Возвращает количество пикселей в window, соответствующее расстоянию, заданному number. Number может быть указан в любом формате, приемлемом для Tk_GetPixels, например, «2.0c» или «1i». Результат округляется до ближайшего целого значения; для дробного результата используйте winfo fpixels.
winfo pointerx window
Если указатель мыши находится на том же экране, что и window, возвращает координату x указателя, измеренную в пикселях в окне корня экрана. Если на экране используется виртуальное окно корня, позиция измеряется в виртуальном корне. Если указатель мыши не находится на том же экране, что и window, возвращается -1.
winfo pointerxy window
Если указатель мыши находится на том же экране, что и window, возвращает список из двух элементов, представляющих координаты x и y указателя, измеренные в пикселях в окне корня экрана. Если на экране используется виртуальное окно корня, позиция вычисляется в виртуальном корне. Если указатель мыши не находится на том же экране, что и window, обе возвращаемые координаты равны -1.
winfo pointery window
Если указатель мыши находится на том же экране, что и window, возвращает координату y указателя, измеренную в пикселях в окне корня экрана. Если на экране используется виртуальное окно корня, позиция вычисляется в виртуальном корне. Если указатель мыши не находится на том же экране, что и window, возвращается -1.
winfo reqheight window
Возвращает строку с десятичным значением запрошенной высоты window в пикселях. Это значение используется менеджером геометрии window для вычисления его геометрии.
winfo reqwidth window
Возвращает строку с десятичным значением запрошенной ширины window в пикселях. Это значение используется менеджером геометрии window для вычисления его геометрии.
winfo rgb window color
Возвращает список, содержащий три десятичных значения в диапазоне от 0 до 65535, представляющих интенсивности красного, зелёного и синего цветов, соответствующие color в окне window. Color может быть задан в любом формате, приемлемом для опции цвета.
winfo rootx window
Возвращает строку с десятичным значением координаты x, в окне корня экрана, левого верхнего угла границы window (или window, если у него нет границы).
winfo rooty window
Возвращает строку с десятичным значением координаты y, в окне корня экрана, левого верхнего угла границы window (или window, если у него нет границы).
winfo screen window
Возвращает имя экрана, связанного с window, в формате displayName.screenIndex.
winfo screencells window
Возвращает строку с десятичным значением числа ячеек в стандартной цветовой карте для экрана window.
winfo screendepth window
Возвращает строку с десятичным значением глубины окна корня экрана window (количество бит на пиксель).
winfo screenheight window
Возвращает строку с десятичным значением высоты экрана window в пикселях.
winfo screenmmheight window
Возвращает строку с десятичным значением высоты экрана window в миллиметрах.
winfo screenmmwidth window
Возвращает строку с десятичным значением ширины экрана window в миллиметрах.
winfo screenvisual window
Возвращает одну из следующих строк, чтобы указать класс визуального представления по умолчанию для экрана window: directcolor, grayscale, pseudocolor, staticcolor, staticgray или truecolor.
winfo screenwidth window
Возвращает строку с десятичным значением ширины экрана window в пикселях.
winfo server window
Возвращает строку, содержащую информацию о сервере для дисплея window. Точный формат этой строки может различаться в зависимости от платформы. Для серверов X строка имеет вид «XmajorRminor vendor vendorVersion», где major и minor — номера версии и ревизии, предоставленные сервером (например, X11R5), vendor — имя поставщика для сервера, а vendorRelease — целое число, представляющее номер релиза, предоставленный сервером.
winfo toplevel window
Возвращает имя пути окна верхнего уровня, содержащего окно window. В стандартном Tk это всегда будет виджет toplevel, но расширения могут создавать другие типы виджетов верхнего уровня.
winfo viewable window
Возвращает 1, если window и все его предки до ближайшего окна верхнего уровня отображены. Возвращает 0, если любое из этих окон не отображено.
winfo visual window
Возвращает одну из следующих строк, чтобы указать визуальный класс для window: directcolor, grayscale, pseudocolor, staticcolor, staticgray или truecolor.
winfo visualid window
Возвращает идентификатор X для визуального представления для window.
winfo visualsavailable window ?includeids?
Возвращает список, элементы которого описывают доступные визуальные классы для экрана window. Каждый элемент состоит из визуального класса, за которым следует целое число глубины. Класс имеет ту же форму, что и возвращаемое значение winfo visual. Глубина задаёт количество битов на пиксель в визуальном представлении. Кроме того, если аргумент includeids указан, то глубина следует за идентификатором X визуального представления.
winfo vrootheight window
Возвращает высоту виртуального корневого окна, связанного с window, если оно есть; в противном случае возвращает высоту экрана window.
winfo vrootwidth window
Возвращает ширину виртуального корневого окна, связанного с window, если оно есть; в противном случае возвращает ширину экрана window.
winfo vrootx window
Возвращает смещение по x виртуального корневого окна, связанного с window, относительно корневого окна его экрана. Обычно это либо ноль, либо отрицательное число. Возвращает 0, если для window нет виртуального корневого окна.
winfo vrooty window
Возвращает смещение по y виртуального корневого окна, связанного с window, относительно корневого окна его экрана. Обычно это либо ноль, либо отрицательное число. Возвращает 0, если для window нет виртуального корневого окна.
winfo width window
Возвращает строку с десятичным значением, представляющую ширину window в пикселях. Когда окно только что создано, его ширина будет 1 пиксел; ширина в конечном итоге будет изменена менеджером геометрии для удовлетворения потребностей окна. Если вам нужна истинная ширина сразу после создания виджета, вызовите update, чтобы заставить менеджер геометрии его расположить, или используйте winfo reqwidth, чтобы получить запрошенную ширину окна вместо фактической ширины.
winfo x window
Возвращает десятичную строку, содержащую координату x, в родительском элементе window, левого верхнего угла границы window (или window, если у него нет границы).
winfo y window
Возвращает десятичную строку, содержащую координату y, в родительском элементе window, левого верхнего угла границы window (или window, если у него нет границы).

Пример

Печать положения курсора мыши и окна, над которым он находится в настоящее время:
lassign [winfo pointerxy .] x y
puts -nonewline "Mouse pointer at ($x,$y) which is "
set win [winfo containing $x $y]
if {$win eq ""} {
    puts "over no window"
} else {
    puts "over $win"
}

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TkCmd/winfo.htm

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TkCmd/winfo.htm

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API