console — 控制台输出和各种系统服务的工具集
console
模块提供控制Pythonista中文本输出区域和键盘输入的功能。
还有一些功能可用于显示简单的模式对话框,以及访问系统服务,例如“打开于…”菜单和快速查看。
console.clear()
清除控制台输出。
console.set_font([name, size])
设置之后输出文本的字体和字体大小。不带任何参数调用以重置为默认值。
console.set_color(r, g, b)
设置之后输出文本的RGB颜色。分量是0.0到1.0之间的浮点数。
console.secure_input([prompt])
该函数类似于内置的raw_input
函数,但是用户的输入是隐藏的,因此适合于请求密码和其他敏感信息。
console.show_image(image_path)
在控制台输出区域中显示从文件加载的图像。
console.alert(title[, message, button1, button2, button3, hide_cancel_button=False])
显示带有最多三个自定义按钮的警报对话框。所选按钮以整数形式返回(button1
=> 1 …)。除非hide_cancel_button
为True
,否则所有警报对话框都包含一个“Cancel”按钮,该按钮抛出KeyboardInterrupt
中断异常。
console.input_alert(title[, message, input, ok_button_title, hide_cancel_button=False])
显示一个带有单行文本输入区域的对话框。文本输入区域可以预input
参数。返回用户输入的文本。“Cancel”按钮抛出KeyboardInterrupt
中断异常。
console.password_alert(title[, message, password, ok_button_title, hide_cancel_button = False])
显示带有密码输入文本区域的对话框。密码输入区域可以预填password
参数。将返回用户输入的密码。“Cancel”按钮抛出KeyboardInterrupt
中断异常(通常将停止脚本)。
console.login_alert(title[, message, login, password, ok_button_title])
显示一个包含两个文本输入区域的对话框,一个用于登录,一个用于密码。文本输入区域可以预填login
和password
参数。返回输入的文本的元组,形式为(login,password)
。“Cancel”按钮抛出KeyboardInterrupt
中断异常(通常将停止脚本)。
console.show_activity()
在状态栏中显示“网络活动指示器”(小圆圈)的动画。
脚本结束后,网络活动指示器将自动隐藏。在网络活动指示器已经可见的情况下调用此函数无效。
console.hide_activity()
在状态栏中隐藏动画的“网络活动指示器”。
脚本结束后,网络活动指示器将自动隐藏。在网络活动指示器已经可见的情况下调用此函数无效。
console.hud_alert(message[, icon, duration])
显示带有给定消息的HUD样式警报。icon
可以是’success
‘(默认值,✓
符号),也可以是’error
‘(✕
符号)。
duration
参数来确定在屏幕上显示多长时间警报。它可以在0.25到5.0秒之间。默认值为1.8秒。直到警报解除前该函数将阻塞脚本当前线程。
console.write_link(title, link_url)
在控制台使用给定的标题和URL打印可点击链接。根据URL,可以在内置浏览器中打开(如http,https和文件URL),也可以在其他应用程序中打开(如果可能)。
如果通过设置了自定义文本颜色set_color()
,则链接文本的颜色与该颜色相同,否则将使用默认链接颜色。
console.hide_output()
用滑动动画隐藏控制台输出区域。
console.quicklook(file_path)
显示给定路径下本地文件的全屏预览。可以传递一系列路径(例如列表),以便一次预览多个文件。关闭预览时,该函数返回。
支持许多常见的文件格式:
- iWork文档
- Microsoft Office文档(Office 97和更高版本)
- 富文本格式(RTF)文档
- PDF文件
- 图片
- 统一类型标识符(UTI)符合
public.text
类型的文本文件 - 逗号分隔数值(csv)文件
console.open_in(file_path)
显示指定文件的iOS“打开于…”菜单。
如果在菜单中选择了某个应用程序,则将返回其包标识符(例如’com.getdropbox.Dropbox
‘)。如果取消了菜单,或者未安装任何可以打开该文件的应用程序,则返回值为None
。
console.set_idle_timer_disabled(flag)
禁用或启用空闲计时器(在一段时间不活动后使设备进入睡眠状态)。
console.is_in_background()
如果应用当前正在后台运行,则返回True
,否则返回False
。