winfo

winfo -возвращает информацию об окне.

СИНТАКСИС

      winfo option ?arg arg ..?
    

ОПИСАНИЕ

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

winfo atom ?-displayof window? name

Команда возвращает десятичную строку числовой идентификатор атома (напрмер, виджета). Если атома name не существует, он создается. А после создания соответствующего виджета он получает этот идентификатор атома. Если указана опция -displayof window, атом ищется на том же дисплее, на котором находится указанное окно. В противном случае атом ищется на дисплее, на котором размещено главное окно приложения.

winfo atomname ?-displayof window? id

Возвращает текстовое имя атома с идентификатором id. Если указана опция -displayof window, атом ищется на том же дисплее, на котором находится указанное окно. В противном случае атом ищется на дисплее, на котором размещено главное окно приложения. Команда является обратной к команде winfo atom. Команда возвращает код ошибки, если атом не существует.

winfo cells window

Команда возвращает десятичную строку число возможных цветов в палитре для window.

winfo children window

Возвращает список полных имен всех потомков окна window. Потомки перечисляются в порядке стека, начиная с нижних. Toplevel-окна также считаются потомками своих логических предков.

winfo class window

Возвращает класс окна window.

winfo colormapfull window

Возвращает 1, если известно, что палитра (colormap) окна заполнена, и 0 в противном случае. Палитра считается заполненной, если последняя попытка разместить в ней еще один цвет окончилась неуспешно, а приложение не освободило с того момента не одного цвета в палитре.

winfo containing ?-displayof window? rootX rootY

Возвращает имя окна, содержащего точку с координатами rootX и rootY. Координаты задаются в экранных единицах (в любой форме, поддерживаемой Tk) в системе координат корневого окна (если используется менеджер виртуального корневого окна, координаты задаются в его системе координат). Если указана опция -displayof window, окно ищется на дисплее, содержащем window. В противном случае координаты считаются указанными для дисплея, на котором размещено главное окно приложения. Если данная точка не содержится ни в каком окне приложения, возвращается пустая строка. Если точка содержится в нескольких виджетах (например, в кнопке, лежащей в рамке), преимущество имеют логические потомки. Из окон "одного поколения" выбирается окно, лежащее выше других в стеке.

winfo depth window

Возвращает "глубину цвета" число бит на пиксель изображения для окна window.

winfo exists window

Возвращает 1, если существует окно window, и 0 в противоположном случае.

winfo fpixels window number

Возвращает число пикселей (дробное, с плавающей точкой), соответствующее на экране расстоянию number. Расстояние может быть указано в любой форме, поддерживаемой Tk, например, 2.0c или 1i. Чтобы получить целое число пикселей, можно использовать команду winfo pixels.

winfo geometry window

Возвращает размеры и положение окна в форме ширинаxвысота+x+y. Все размеры приводятся в пикселях.

winfo height window

Возвращает десятичную строку, содержащую высоту окна в пикселях. Когда окно только что создано, его размер 1 пиксель. Через некоторое время оно принимает правильные размеры. Однако, если вы хотите получить правильные размеры окна сразу после его создания, используйте перед этим команду update, которая приведет к прорисовке окна и формированию его правильных размеров, либо команду winfo reqheight, которая возвращает требуемые, а не реальные размеры окна.

winfo id window

Возвращает шестнадцатеричную строку зависящий от платформы идентификатор низкого уровня для окна. На Unix-платформах это X-window идентификатор. Под Windows это Windows HWND. На Macintosh этот идентификатор не имеет смысла вне Tk.

winfo interps ?-displayof window?

Возвращает список всех Tcl-интерпретаторов (например, Tk-приложений), зарегистрированных в текущий момент на определенном дисплее. Если задана опция ?-displayof window?, имеется в виду дисплей, на котором находится окно window. В противном случае дисплей, на котором находится главное окно приложения.

winfo ismapped window

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

winfo manager window

Возвращает имя геометрического менеджера, с помощью которого размещено окно, или пустую строку, если окно не размещено. Для виджетов возвращается как правило имя Tcl-команды для соответствующего менеджера, например, pack или place. Для toplevel-окон возвращается wm, для встроенных окон имя команды для соответствующего класса виджетов, например, canvas.

winfo name window

Возвращает имя окна, то есть имя относительно родителя в отличие от полного имени. Команда winfo name возвращает имя приложения.

winfo parent window

Возвращает имя логического родителя окна или пустую строку для главного окна приложения.

winfo pathname ?-displayof window? id

Возвращает полное имя окна с X-идентификатором id. Идентификатор может быть десятичным, шестнадцатеричным или восьмеричным числом и должен принадлежать одному из окон приложения. Если указана опция -displayof window, окно ищется на том же дисплее, на котором находится указанное окно. В противном случае окно ищется на дисплее, на котором размещено главное окно приложения.

winfo pixels window number

Возвращает число пикселей, соответствующее на экране расстоянию number. Расстояние может быть указано в любой форме, поддерживаемой Tk, например, 2.0c или 1i. Результат округляется до ближайшего целого. Чтобы получить дробное число пикселей, можно использовать команду winfo fpixels.

winfo pointerx window

Если указатель "Мыши" находится на том же экране, что и окно, возвращает x- координату пойнтера в пикселях в системе координат корневого окна. Если на экране есть виртуальное корневое окно, возвращаются координаты в его системе координат. Если пойнтера "Мыши" на данном экране нет, возвращается "-1".

winfo pointerxy window

Если указатель "Мыши" находится на том же экране, что и окно, возвращает список, содержащий x- и y-координаты пойнтера в пикселях в системе координат корневого окна. Если на экране есть виртуальное корневое окно, возвращаются координаты в его системе координат. Если пойнтера "Мыши" на данном экране нет, возвращается "-1".

winfo pointery window

Если указатель "Мыши" находится на том же экране, что и окно, возвращает y-координату пойнтера в пикселях в системе координат корневого окна. Если на экране есть виртуальное корневое окно, возвращаются координаты в его системе координат. Если пойнтера "Мыши" на данном экране нет, возвращается "-1".

winfo reqheight window

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

winfo reqwidth window

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

winfo rgb window color

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

winfo rootx window

Возвращает десятичную строку, содержащую x-координату левого верхнего угла рамки окна (или самого окна, если оно не имеет рамки) в системе координат корневого окна.

winfo rooty window

Возвращает десятичную строку, содержащую y-координату левого верхнего угла рамки окна (или самого окна, если оно не имеет рамки) в системе координат корневого окна.

winfo screen window

Возвращает имя экрана, на котором отображается окно, в форме ИмяДисплея.ИндексЭкрана.

winfo screencells 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 serverwindow

Возвращает строку, содержащую информацию о сервере дисплея, на котором находится окно. Точная форма строки зависит от платформы. Для X-сервера строка имеет вид "XmajorRminor vendor vendorVersion" где major и minor соответственно версия и релиз сервера (например, X11R5), vendor имя поставщика, vendorRelease номер релиза сервера, назначенный поставщиком.

winfo toplevel window

Возвращает полное имя ближайшего toplevel-окна, содержащего window.

winfo viewable window

Возвращает 1, если окно и его предки вплоть до ближайшего toplevel размещены, и 0 в противном случае.

winfo visual window

Возвращает одну из строк, указывающих класс окна window: directcolor, grayscale, pseudocolor, staticcolor, staticgray, или truecolor.

winfo visualid window

Возвращает X-идентификатор класса (возвращаемого командой winfo visual) для окна window.

winfo visualsavailable window ?includeids?

Возвращает список, элементы которого описывают режимы, допустимые для экрана, содержащего окно. Каждый элемент состоит из имени класса и глубины цвета. Имена класса такие же, как для команды winfovisual. Глубина указывает число битов на пиксель. Если задана опция includeids, за глубиной следует X-идентификатор класса.

winfo vrootheight window

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

winfo vrootwidth window

Возвращает ширину виртуального корневого окна дляwindow, если такое есть. В противном случае возвращает ширину экрана, на котором размещено окно window.

winfo vrootx window

Возвращает x-координату корневого окна в системе координат виртуального корневого окна. Обычно 0 или отрицательное число. Если виртуального корневого окна на существует, возвращает 0.

winfo vrooty window

Возвращает y-координату корневого окна в системе координат виртуального корневого окна. Обычно 0 или отрицательное число. Если виртуального корневого окна на существует, возвращает 0.

winfo width window

Возвращает десятичную строку, содержащую ширину окна в пикселях. Когда окно только что создано, его размер 1 пиксель. Через некоторое время оно принимает правильные размеры. Однако, если вы хотите получить правильные размеры окна сразу после его создания, используйте перед этим команду update, которая приведет к прорисовке окна и формированию его правильных размеров, либо команду winfo reqwidth, которая возвращает требуемые, а не реальные размеры окна.

winfo x window

Возвращает десятичную строку, содержащую x-координату левого верхнего угла рамки окна (или самого окна, если оно не имеет рамки) в системе координат окна предка.

winfo y window

Возвращает десятичную строку, содержащую x-координату левого верхнего угла рамки окна (или самого окна, если оно не имеет рамки) в системе координат окна предка.