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 atomname ?-displayof window? id
- Пример
- Ключевые слова
Имя
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