彈出框其實跟信息框差不多,在寫界面的時候經常用,具體如下
“高級呼叫”是以“彈出”開頭的呼叫。它們是與用戶溝通的最基本形式。它們以它們創建的窗口類型命名,即彈出窗口。這些窗口本來就是短暫的,要么傳遞信息,要么收集信息,然后迅速消失。
將彈出窗口視為您的第一個窗口,有點像您的第一輛自行車。它運作良好,但受到限制。可能不久之后您就想要更多功能,而且對於您新發現的冒險感覺來說似乎太有限了。
當您使用 Popups 時,您正在考慮提交 GitHub“增強問題”以擴展 Popup 調用以包含您認為會有所幫助的新功能......不僅對您而且對其他人都是如此你有想過,對吧?為他人好。
好吧,不要提交那個增強請求。相反,此時您應該立即轉到標題為“自定義窗口 API 調用 - 您的第一個窗口”的部分。恭喜你,你剛剛畢業,現在是一名正式的“GUI 設計師”。哦,別介意你兩周前才開始學習 Python,你現在是一名真正的 GUI 設計師,所以振作起來,開始像一個人一樣行事。編寫自己的彈出函數。然后,將該函數壓縮為一行代碼。是的,這些彈出窗口可以用 1 行代碼編寫。秘訣是close
在調用時使用參數window.read()
但是,現在,讓我們繼續使用這些 1 行窗口調用,即 Popups。這是您可以使用的彈出呼叫列表:
popup_animated popup_annoying popup_auto_close popup_cancel popup_error popup_get_file popup_get_folder popup_get_text popup_no_border popup_no_buttons popup_no_frame popup_no_titlebar popup_no_wait popup_notify popup_non_blocking popup_ok popup_ok_cancel popup_quick popup_quick_message popup_scrolled popup_timed
彈出輸出
將popup
調用視為 print
語句的 GUI 等價物。這是您在窗口世界中向用戶顯示結果的方式。每次調用 Popup 都會創建一個新的 Popup 窗口。
popup
通話通常是阻塞的。您的程序將停止執行,直到用戶關閉彈出窗口。異步部分中討論的 Popup 的非阻塞窗口。
就像打印語句一樣,您可以傳遞任意數量的參數。它們都將變成字符串並顯示在彈出窗口中。
有許多 Popup 輸出調用,每個調用都有略微不同的外觀或功能(例如不同的按鈕標簽、窗口選項)。
Popup 輸出函數列表有: - popup - popup_ok - popup_yes_no - popup_cancel - popup_ok_cancel - popup_error - popup_timed, popup_auto_close, popup_quick, popup_quick_message - popup_no_waitWait, popup_non_blocking - popup_notify
在 Popup 之后的函數名稱的尾隨部分指示顯示了哪些按鈕。 PopupYesNo
顯示一對帶有是和否的按鈕。 PopupCancel
有一個取消按鈕等。
雖然這些是“輸出”窗口,但它們確實以按鈕的形式收集輸入。Popup 函數返回被單擊的按鈕。如果單擊 Ok 按鈕,則 Popup 返回字符串“Ok”。如果用戶單擊 X 按鈕關閉窗口,則返回的按鈕值是None
或者WIN_CLOSED
是更明確的寫法。
該功能popup_timed
或popup_auto_close
彈出窗口會在一段時間后自動關閉。
這是一個快速參考,顯示了 Popup 調用的外觀。
sg.popup('popup') # Shows OK button sg.popup_ok('popup_ok') # Shows OK button sg.popup_yes_no('popup_yes_no') # Shows Yes and No buttons sg.popup_cancel('popup_cancel') # Shows Cancelled button sg.popup_ok_cancel('popup_ok_cancel') # Shows OK and Cancel buttons sg.popup_error('popup_error') # Shows red error button sg.popup_timed('popup_timed') # Automatically closes sg.popup_auto_close('popup_auto_close') # Same as PopupTimed
彈窗預覽:
彈出窗口 - 顯示一個彈出窗口,其中包含您希望包含的參數。這是“打印”語句的 GUI 等效項。在用戶可以閱讀一些錯誤消息之前,它也非常適合“暫停”程序的流程。
如果此彈出窗口沒有您想要的功能,那么您可以輕松制作自己的功能。彈出窗口可以在 1 行代碼中完成:choice, _ = sg.Window('Continue?', [[sg.T('Do you want to continue?')], [sg.Yes(s=10), sg.No(s=10)]], disable_close=True).read(close=True)
popup(args=*<1 or N object>, title = None, button_color = None, background_color = None, text_color = None, button_type = 0, auto_close = False, auto_close_duration = None, custom_text = (None, None), non_blocking = False, icon = None, line_width = None, font = None, no_titlebar = False, grab_anywhere = False, keep_on_top = None, location = (None, None), relative_location = (None, None), any_key_closes = False, image = None, modal = True)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
任何 | *參數 | 可變數量的參數。在通話中加載要查看的內容! |
字符串 | 標題 | 窗口的可選標題。如果沒有提供,將使用第一個 arg 代替。 |
(str, str) 或無 | 按鈕顏色 | 顯示按鈕的顏色(文本顏色、按鈕顏色) |
字符串 | 背景顏色 | 窗口的背景顏色 |
字符串 | text_color | 文字顏色 |
整數 | 按鈕類型 | 不是用戶設置!確定將顯示哪些預定義按鈕(默認值 = POPUP_BUTTONS_OK)。有許多 Popup 函數,它們調用 Popup,更改此參數以獲得所需的效果。 |
布爾 | 自動關閉 | 如果 True 窗口將自動關閉 |
整數 | auto_close_duration | 在自動關閉之前保持窗口打開的時間(以秒為單位) |
(str, str) 或 str | 自定義文本 | 包含要在按鈕上顯示的文本的字符串或字符串對 |
布爾 | 非阻塞 | 如果為 True 則將立即從函數返回,而無需等待用戶輸入。 |
str 或字節 | 圖標 | 圖標顯示在窗口上。與窗口調用相同的格式 |
整數 | 行寬 | 字符的行寬。默認為 MESSAGE_BOX_LINE_WIDTH |
str 或元組[字體名稱、大小、修飾符] | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
布爾 | no_titlebar | 如果 True 將不顯示窗口周圍的框架和頂部的標題欄 |
布爾 | 隨便抓 | 如果 True 可以抓取任意位置來移動窗口。如果 no_titlebar 為 True,grab_anywhere 也應該啟用 |
(整數,整數) | 地點 | 屏幕上顯示窗口左上角的位置。默認為以屏幕為中心的窗口 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
布爾 | 保持在最前 | 如果為 True 窗口將保持在所有當前窗口之上 |
布爾 | any_key_closes | 如果為 True 則將為窗口打開 return_keyboard_events ,這將導致窗口在按下任何鍵時立即關閉。通常返回鍵只會關閉窗口。默認為假。 |
str 或字節 | 圖片 | 要包含在彈出窗口頂部的圖像 |
布爾 | 模態的 | 如果 True 則使彈出窗口的行為類似於模態窗口...在關閉此窗口之前,所有其他窗口均不可操作。默認 = 真 |
str 或無 | 返回 | 返回被按下的按鈕的文本。如果用戶使用 X 關閉窗口,則不會返回任何內容 |
其他輸出彈出窗口是參數的變化。通常 button_type 參數是第一個更改的參數。
button_type 的選擇是(但是您不應該自己指定這些):
POPUP_BUTTONS_YES_NO POPUP_BUTTONS_CANCELLED POPUP_BUTTONS_ERROR POPUP_BUTTONS_OK_CANCEL POPUP_BUTTONS_OK POPUP_BUTTONS_NO_BUTTONS
請注意,您不應使用不同的 button_types 自己調用 Popup。 依靠名為 Popup 的函數來為您設置該值。例如popup_yes_no
將為您設置按鈕類型為 POPUP_BUTTONS_YES_NO。
滾動輸出
如果您有很多信息要顯示,有一個彈出窗口的滾動版本。
顯示包含提供的用戶文本的滾動彈出窗口。使用盡可能多的項目來打印,就像打印語句一樣。
popup_scrolled(args=*<1 or N object>, title = None, button_color = None, background_color = None, text_color = None, yes_no = False, auto_close = False, auto_close_duration = None, size = (None, None), location = (None, None), relative_location = (None, None), non_blocking = False, no_titlebar = False, grab_anywhere = False, keep_on_top = None, font = None, image = None, icon = None, modal = True, no_sizegrip = False)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
任何 | *參數 | 要顯示的可變數量的項目 |
字符串 | 標題 | 在窗口中顯示的標題。 |
(str, str) 或 str | 按鈕顏色 | 按鈕顏色(前景、背景) |
布爾 | 是_否 | 如果為 True,則顯示 Yes 和 No 按鈕而不是 Ok |
布爾 | 自動關閉 | 如果 True 窗口將自行關閉 |
整數或浮點數 | auto_close_duration | 舊版本只接受 int。窗口關閉前的時間(以秒為單位) |
(整數,整數) | 尺寸 | (w,h) w=字符寬,h=行高 |
(整數,整數) | 地點 | 屏幕上放置窗口左上角的位置 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
布爾 | 非阻塞 | 如果為 True 調用將立即返回而不是等待用戶輸入 |
字符串 | 背景顏色 | 背景顏色 |
字符串 | text_color | 文本的顏色 |
布爾 | no_titlebar | 如果為 True 則不會顯示標題欄 |
布爾 | 隨便抓 | 如果為 True,則可以抓取任何位置來移動窗口(默認 = False) |
布爾 | 保持在最前 | 如果為 True 窗口將保持在所有當前窗口之上 |
(str or (str, int[, str]) or None) | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
str 或字節 | 圖片 | 要包含在彈出窗口頂部的圖像 |
字節或字符串 | 圖標 | 用於窗口圖標的文件名或 base64 字符串 |
布爾 | 模態的 | 如果 True 則使彈出窗口的行為類似於模態窗口...在關閉此窗口之前,所有其他窗口均不可操作。默認 = 真 |
布爾 | no_sizegrip | 如果為 True,則在沒有標題欄時不會顯示 Sizegrip。僅在沒有標題欄時顯示 |
str 或 None 或 TIMEOUT_KEY | 返回 | 返回被按下的按鈕的文本。如果用戶使用 X 關閉窗口,則不會返回任何內容 |
典型用法:
sg.popup_scrolled(my_text)
將popup_scrolled
自動調整窗口大小以適應文本大小。None
在參數的高度字段中指定size
以獲取自動調整高度。
此調用將創建一個 80 個字符寬和高度取決於文本行數的滾動框。
sg.popup_scrolled(my_text, size=(80, None))
請注意,滾動發生之前的默認最大行數設置為 50。在 50 行時滾動將開始。
如果non_blocking
設置了參數,則調用不會阻塞等待用戶關閉窗口。執行將立即返回給用戶。當您想在不中斷程序流程的情況下轉儲調試信息時非常方便。
非阻塞彈出窗口 - popup_no_wait 和 non_blocking 參數
顯示彈出窗口並立即返回(不阻塞)
popup_no_wait(args=*<1 or N object>, title = None, button_type = 0, button_color = None, background_color = None, text_color = None, auto_close = False, auto_close_duration = None, non_blocking = True, icon = None, line_width = None, font = None, no_titlebar = False, grab_anywhere = False, keep_on_top = None, location = (None, None), relative_location = (None, None), image = None, modal = False)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
任何 | *參數 | 要顯示的可變數量的項目 |
字符串 | 標題 | 在窗口中顯示的標題。 |
整數 | 按鈕類型 | 確定將顯示哪些預定義按鈕(默認值 = POPUP_BUTTONS_OK)。 |
(str, str) 或 str | 按鈕顏色 | 按鈕顏色(前景、背景) |
字符串 | 背景顏色 | 背景顏色 |
字符串 | text_color | 文本的顏色 |
布爾 | 自動關閉 | 如果 True 窗口將自行關閉 |
整數或浮點數 | auto_close_duration | 舊版本只接受 int。窗口關閉前的時間(以秒為單位) |
布爾 | 非阻塞 | 如果為 True 調用將立即返回而不是等待用戶輸入 |
字節或字符串 | 圖標 | 用於窗口圖標的文件名或 base64 字符串 |
整數 | 行寬 | 字符行寬 |
(str or (str, int[, str]) or None) | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
布爾 | no_titlebar | 如果為 True 則不會顯示標題欄 |
布爾 | 隨便抓 | 如果為真:可以抓取任意位置來移動窗口(默認 = 假) |
(整數,整數) | 地點 | 窗口左上角的位置 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
str 或字節 | 圖片 | 要包含在彈出窗口頂部的圖像 |
布爾 | 模態的 | 如果 True 則使彈出窗口的行為類似於模態窗口...在關閉此窗口之前,所有其他窗口均不可操作。默認 = 假 |
str 或無 | 返回 | 彈窗關閉的原因 |
popup
調用popup_no_wait
or將popup_non_blocking
創建一個彈出窗口,然后立即將控制權返回給您。non_blocking
如果它們有參數,您可以將其他彈出調用轉換為非阻塞彈出。設置non_blocking
為 True 將導致函數立即返回,而不是等待窗口關閉。
當您正在調試並希望將某些內容顯示為輸出但又不想通過阻塞來更改程序的整體時序時,此功能非常方便。把它想象成一個print
聲明。這些彈出窗口之一沒有返回值。
彈出參數組合
因此,您不必指定可能很長的公共參數列表,有許多彈出函數可以設置參數組合。例如popup_quick_message
,將顯示一個自動關閉且沒有標題欄的非阻塞彈出窗口。popup
您可以使用普通調用實現相同的最終結果。
彈出輸入
有針對單項輸入的彈出調用。這些遵循模式,popup_get
然后是要獲取的項目類型。這些輸入彈出窗口中有 3 個可供選擇,每個彈出窗口都具有啟用自定義的設置。
popup_get_text
- 獲取單行文本popup_get_file
- 獲取文件名popup_get_folder
- 獲取文件夾名稱
使用這些彈出窗口而不是制作自定義窗口來獲取一個數據值,調用彈出窗口輸入函數從用戶那里獲取項目。如果您發現參數無法創建您正在尋找的那種窗口,那么是時候創建您自己的窗口了。
popup_get_text
使用此彈出窗口從用戶那里獲取一行文本。
顯示帶有文本輸入字段的彈出窗口。如果關閉/取消,則返回輸入的文本或 None
popup_get_text(message,
title = None, default_text = "", password_char = "", size = (None, None), button_color = None, background_color = None, text_color = None, icon = None, font = None, no_titlebar = False, grab_anywhere = False, keep_on_top = None, location = (None, None), relative_location = (None, None), image = None, modal = True)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
字符串 | 信息 | 向用戶顯示的消息 |
字符串 | 標題 | 窗口標題 |
字符串 | 默認文本 | 輸入區域的默認值 |
字符串 | 密碼字符 | 要顯示的字符而不是實際鍵入的字符 |
(整數,整數) | 尺寸 | InputText 元素的 (width, height) |
(str, str) 或 str | 按鈕顏色 | 按鈕的顏色(文本、背景) |
字符串 | 背景顏色 | 整個窗口的背景顏色 |
字符串 | text_color | 消息文本的顏色 |
字節或字符串 | 圖標 | 用於窗口圖標的文件名或 base64 字符串 |
(str or (str, int[, str]) or None) | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
布爾 | no_titlebar | 如果為 True 則不會顯示標題欄 |
布爾 | 隨便抓 | 如果 True 可以單擊並拖動窗口中的任意位置來移動窗口 |
布爾 | 保持在最前 | 如果為 True 窗口將保持在所有當前窗口之上 |
(整數,整數) | 地點 | (x,y) 屏幕上顯示窗口左上角的位置 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
str 或字節 | 圖片 | 要包含在彈出窗口頂部的圖像 |
布爾 | 模態的 | 如果 True 則使彈出窗口的行為類似於模態窗口...在關閉此窗口之前,所有其他窗口均不可操作。默認 = 真 |
str 或無 | 返回 | 如果窗口關閉或單擊取消按鈕,則輸入文本或無 |
import PySimpleGUI as sg text = sg.popup_get_text('Title', 'Please input something') sg.popup('Results', 'The value returned from PopupGetText', text)
popup_get_file
從用戶處獲取一個或多個文件名。有一些選項可以配置要顯示的對話框類型。通常會顯示“打開文件”對話框。
顯示帶有文本輸入字段和瀏覽按鈕的彈出窗口,以便用戶可以選擇文件。
popup_get_file(message,
title = None, default_path = "", default_extension = "", save_as = False, multiple_files = False, file_types = (('ALL Files', '*.* *'),), no_window = False, size = (None, None), button_color = None, background_color = None, text_color = None, icon = None, font = None, no_titlebar = False, grab_anywhere = False, keep_on_top = None, location = (None, None), relative_location = (None, None), initial_folder = None, image = None, files_delimiter = ";", modal = True, history = False, show_hidden = True, history_setting_filename = None)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
字符串 | 信息 | 向用戶顯示的消息 |
字符串 | 標題 | 窗口標題 |
字符串 | 默認路徑 | 作為起點顯示給用戶的路徑(填寫在輸入字段中) |
字符串 | default_extension | 如果用戶沒有輸入擴展名,請將其添加到文件名(僅在另存為對話框中使用) |
布爾 | 另存為 | 如果為真,則會顯示“另存為”對話框,該對話框將在覆蓋之前進行驗證 |
布爾 | 多個文件 | 如果為 True,則允許選擇多個文件,這些文件返回 ';' 每個文件名之間 |
元組[元組[str,str]] | 文件類型 | 使用通配符顯示的擴展列表。所有文件(默認)= (("ALL Files", " . *"),) |
布爾 | no_window | 如果為 True,則不會顯示 PySimpleGUI 窗口。相反,只顯示 tkinter 對話框 |
(整數,整數) | 尺寸 | InputText 元素或 Combo 元素的(寬度、高度)(如果使用歷史記錄功能) |
(str, str) 或 str | 按鈕顏色 | 按鈕的顏色(文本、背景) |
字符串 | 背景顏色 | 整個窗口的背景顏色 |
字符串 | text_color | 文本的顏色 |
字節或字符串 | 圖標 | 用於窗口圖標的文件名或 base64 字符串 |
(str or (str, int[, str]) or None) | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
布爾 | no_titlebar | 如果為 True 則不會顯示標題欄 |
布爾 | 隨便抓 | 如果為真:可以抓取任意位置來移動窗口(默認 = 假) |
布爾 | 保持在最前 | 如果為 True 窗口將保持在所有當前窗口之上 |
(整數,整數) | 地點 | 窗口左上角的位置 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
字符串 | 初始文件夾 | 文件系統中開始瀏覽的位置 |
str 或字節 | 圖片 | 要包含在彈出窗口頂部的圖像 |
字符串 | 文件分隔符 | 選擇多個文件時放置在文件之間的字符串。通常是 ; |
布爾 | 模態的 | 如果 True 則使彈出窗口的行為類似於模態窗口...在關閉此窗口之前,所有其他窗口均不可操作。默認 = 真 |
布爾 | 歷史 | 如果為真,則啟用“歷史”功能,該功能將顯示以前使用的條目。使用提供的設置文件名,如果沒有提供,則使用默認值 |
布爾 | 顯示隱藏 | 如果 True 則啟用系統對話框中的復選框以選擇要顯示的隱藏文件 |
字符串 | history_setting_filename | 用於用戶設置的文件名。將在此設置文件中存儲先前條目的列表 |
str 或無 | 返回 | 表示所選文件的字符串,如果取消或使用 X 關閉窗口,則為無 |
如果配置為打開文件彈出窗口,則(save_as 不是 True)對話框將如下所示。
如果將參數 save_As 設置為 True,則對話框如下所示:
如果您選擇一個已經存在的文件名,您將收到一個警告彈出框,詢問它是否正常。您還可以指定一個不存在的文件。使用“打開”對話框,您不能選擇不存在的文件。
一個典型的調用會產生這個窗口。
text = sg.popup_get_file('Please enter a file name') sg.popup('Results', 'The value returned from popup_get_file', text)
popup_get_folder
為獲取文件夾名稱而創建的窗口看起來與獲取文件名相同。不同之處在於瀏覽按鈕的作用。 popup_get_file
顯示打開文件對話框,同時popup_get_folder
顯示打開文件夾對話框。
顯示帶有文本輸入字段和瀏覽按鈕的彈出窗口,以便可以選擇文件夾。
popup_get_folder(message,
title = None, default_path = "", no_window = False, size = (None, None), button_color = None, background_color = None, text_color = None, icon = None, font = None, no_titlebar = False, grab_anywhere = False, keep_on_top = None, location = (None, None), relative_location = (None, None), initial_folder = None, image = None, modal = True, history = False, history_setting_filename = None)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
字符串 | 信息 | 向用戶顯示的消息 |
字符串 | 標題 | 窗口標題 |
字符串 | 默認路徑 | 作為起點顯示給用戶的路徑(填寫在輸入字段中) |
布爾 | no_window | 如果為 True,則不會顯示 PySimpleGUI 窗口。相反,只顯示 tkinter 對話框 |
(整數,整數) | 尺寸 | InputText 元素的 (width, height) |
(str, str) 或 str | 按鈕顏色 | 按鈕顏色(前景、背景) |
字符串 | 背景顏色 | 背景顏色 |
字符串 | text_color | 文本的顏色 |
字節或字符串 | 圖標 | 用於窗口圖標的文件名或 base64 字符串 |
(str or (str, int[, str]) or None) | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
布爾 | no_titlebar | 如果為 True 則不會顯示標題欄 |
布爾 | 隨便抓 | 如果為真:可以抓取任意位置來移動窗口(默認 = 假) |
布爾 | 保持在最前 | 如果為 True 窗口將保持在所有當前窗口之上 |
(整數,整數) | 地點 | 窗口左上角的位置 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
字符串 | 初始文件夾 | 文件系統中開始瀏覽的位置 |
str 或字節 | 圖片 | 要包含在彈出窗口頂部的圖像 |
布爾 | 模態的 | 如果 True 則使彈出窗口的行為類似於模態窗口...在關閉此窗口之前,所有其他窗口均不可操作。默認 = 真 |
布爾 | 歷史 | 如果為真,則啟用“歷史”功能,該功能將顯示以前使用的條目。使用提供的設置文件名,如果沒有提供,則使用默認值 |
字符串 | history_setting_filename | 用於用戶設置的文件名。將在此設置文件中存儲先前條目的列表 |
str 或無 | 返回 | 表示所選路徑的字符串,如果取消或使用 X 關閉窗口,則為無 |
這是一個典型的調用
text = sg.popup_get_folder('Please enter a folder name') sg.popup('Results', 'The value returned from popup_get_folder', text)
popup_animated
動畫彈出窗口使您能夠輕松地顯示通過存儲在文件或 base64 變量中的 GIF 文件指定的“加載”樣式動畫。
一次顯示一幀動畫。此函數有其自己的內部時鍾,這意味着您可以以任何頻率調用它,並且視頻幀的顯示速率保持不變。也許您的幀每 30 毫秒更新一次,但您的事件循環每 10 毫秒運行一次。您不必擔心延遲,只需每次循環調用它即可。
popup_animated(image_source,
message = None, background_color = None, text_color = None, font = None, no_titlebar = True, grab_anywhere = True, keep_on_top = True, location = (None, None), relative_location = (None, None), alpha_channel = None, time_between_frames = 0, transparent_color = None, title = "", icon = None)
參數說明:
類型 | 名稱 | 意義 |
---|---|---|
str 或 bytes 或 None | 圖像源 | 文件名或 base64 字符串。使用無關閉窗口。 |
字符串 | 信息 | 與動畫一起顯示的可選消息 |
字符串 | 背景顏色 | 背景顏色 |
字符串 | text_color | 文本的顏色 |
字符串或元組 | 字體 | 指定字體系列、大小等。元組或單字符串格式“名稱大小樣式”。樣式:斜體 * 羅馬粗體 正常下划線 重划線 |
布爾 | no_titlebar | 如果為 True 則不會顯示標題欄和窗口框架 |
布爾 | 隨便抓 | 如果為真,那么您可以移動窗口,只需單擊窗口上的任意位置,按住並拖動 |
布爾 | 保持在最前 | 如果為 True,則 Window 將保持在當前顯示的所有其他窗口之上 |
(整數,整數) | 地點 | (x,y) 在屏幕上放置窗口左上角的位置。默認是在屏幕上居中 |
(整數,整數) | 相對位置 | (x,y) 相對於窗口默認位置的位置,以像素為單位。通常窗口居中。這個位置是相對於窗口將被創建的位置。請注意,它們可以是負數。 |
漂浮 | alpha_channel | 窗口透明度 0 = 不可見 1 = 完全可見。之間的值是透明的 |
整數 | time_between_frames | 每幀之間的時間量(以毫秒為單位) |
字符串 | 透明顏色 | 這種顏色將在您的窗口中完全透明。甚至可以點擊進入 |
字符串 | 標題 | 將在窗口中顯示的標題 |
str 或字節 | 圖標 | 與窗口圖標參數相同。可以是文件名或 Base64 字節字符串。對於 Windows,如果文件名,它必須是 ICO 格式。對於 Linux,不能是 ICO |
布爾 | 返回 | 如果窗口更新正常,則為真。如果窗口關閉則為 False |
要關閉動畫彈出窗口,請調用 PopupAnimatedimage_source=None
。這將關閉所有當前打開的 PopupAnimated 窗口。