window['-TEXT-'] 有哪些属性和方法？

在PySimpleGUI中，window['-TEXT-']（或其他元素如window["-INPUT-"]）作为元素对象，拥有丰富的属性和方法，可实现动态交互和界面控制。以下是核心属性和方法的分类说明：

一、核心属性

1. key

   • 功能：元素的唯一标识符，用于在事件处理和属性访问中定位元素。
   • 示例：window['-TEXT-'].key 返回 '-TEXT-'。

2. visible

   • 功能：控制元素是否可见（True/False）。
   • 示例：window['-TEXT-'].visible = False 隐藏元素。

3. disabled

   • 功能：禁用或启用元素（True为禁用，False为启用）。
   • 示例：window['-INPUT-'].disabled = True 禁用输入框。

4. size

   • 功能：元素的尺寸（宽度、高度），单位为字符或像素。
   • 示例：window['-TEXT-'].size = (30, 2) 设置宽度为30字符，高度为2行。

5. font

   • 功能：设置字体样式（如("Arial", 14)）。
   • 示例：window['-TEXT-'].font = ("微软雅黑", 16)。

6. text_color / background_color

   • 功能：文本颜色和背景颜色（支持颜色名称或十六进制值）。
   • 示例：window['-TEXT-'].text_color = "red"。

7. metadata

   • 功能：存储任意用户数据（可附加到元素上）。
   • 示例：window['-TEXT-'].metadata = {"info": "额外数据"}。

二、核心方法

1. .update(value=None, **kwargs)

   • 功能：更新元素的多个属性（如值、禁用状态、可见性等）。
   • 参数：
     • value：更新文本内容（如window['-TEXT-'].update("新内容")）。
     • disabled、visible等：更新对应属性。
   • 示例：

     window['-INPUT-'].update("默认值", disabled=False)
     

2. .get()

   • 功能：获取元素的当前值（如输入框内容、下拉菜单选中项等）。
   • 示例：input_value = window['-INPUT-'].get()。

3. .set_focus()

   • 功能：将焦点设置到该元素，使用户可以直接输入或操作。
   • 示例：window['-INPUT-'].set_focus()。

4. .set_tooltip(tooltip_text)

   • 功能：动态设置元素的工具提示文本。
   • 示例：window['-INPUT-'].set_tooltip("请输入用户名")。

5. .bind(bind_string, key_modifier)

   • 功能：绑定自定义事件（如键盘快捷键）。
   • 示例：window['-INPUT-'].bind("<Return>", "ENTER")。

6. .unbind(bind_string)

   • 功能：解绑已绑定的事件。
   • 示例：window['-INPUT-'].unbind("<Return>")。

三、输入框专属方法

1. .set_cursor_to_end()

   • 功能：将光标移动到输入框末尾。
   • 示例：window['-INPUT-'].set_cursor_to_end()。

2. .select_text()

   • 功能：选中输入框中的全部文本。
   • 示例：window['-INPUT-'].select_text()。

四、使用场景示例

1. 动态更新文本

import PySimpleGUI as sg

layout = [[sg.Text("初始文本", key="-TEXT-")], [sg.Button("更新")]]
window = sg.Window("示例", layout)

while True:
    event, values = window.read()
    if event == sg.WIN_CLOSED:
        break
    if event == "更新":
        window["-TEXT-"].update("文本已更新！")
window.close()

2. 禁用/启用输入框

import PySimpleGUI as sg

layout = [[sg.Text("输入内容:")], [sg.Input(key="-INPUT-")], [sg.Button("禁用"), sg.Button("启用")]]
window = sg.Window("示例", layout)

while True:
    event, values = window.read()
    if event == sg.WIN_CLOSED:
        break
    if event == "禁用":
        window["-INPUT-"].disabled = True
    if event == "启用":
        window["-INPUT-"].disabled = False
window.close()

3. 绑定键盘事件

import PySimpleGUI as sg

layout = [[sg.Input(key="-INPUT-")]]
window = sg.Window("示例", layout)
window["-INPUT-"].bind("<Return>", "ENTER")

while True:
    event, values = window.read()
    if event == sg.WIN_CLOSED:
        break
    if event == "ENTER":
        print("回车键被按下！")
window.close()