整理 PySimpleGUI 官方网站
原文google翻译过来的
https://pysimplegui.readthedocs.io/en/latest/
您将找到有关Elements的信息,所有其他类和函数都位于本手册结尾处。它们位于自述文件的大部分中,按字母顺序排列以便于查找。本节对Elements的讨论旨在教您如何工作。另一部分包含详细的呼叫签名和参数定义。
图元素 Graph Element
创建一个供您绘制的区域。 该元素具有的MAGICAL属性是您进行交互
使用您自己的坐标系的元素。 这很重要!! 您定义位置
用于(0,0)。 希望(0,0)像数学四象限图一样位于图的中间吗? 没问题! 设置你的
左下角为(-100,-100),右上角为(100,100),您便拥有了一个
(0,0)在中心。
最酷的元素之一。
您还可以使用浮点值。 为此,请确保并设置float_values参数。
可能会发生鼠标单击和拖动事件,并返回鼠标的(x,y)坐标
绘图图元返回一个“ id”,当您要对该项目进行操作时(例如删除它)
Graph(canvas_size,
graph_bottom_left,
graph_top_right,
background_color=None,
pad=None,
change_submits=False,
drag_submits=False,
enable_events=False,
key=None,
tooltip=None,
right_click_menu=None,
visible=True,
float_values=False,
metadata=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Tuple[int, int] | 元组[int,int] | Tuple[int, int] | 画布的尺寸 | 画布区域的(宽度,高度)大小(以像素为单位) |
Tuple[int, int] | 元组[int,int] | Tuple[int, int] | graph_bottom_left | [x,y)坐标系的左下角 |
Tuple[int, int] | 元组[int,int] | Tuple[int, int] | graph_top_right | [x,y)坐标系的右上角 |
str | 力量 | str | 背景颜色 | 绘图区域的背景色 |
(int, int) or ((int, int),(int,int)) or (int,(int,int)) or ((int, int),int) | (int,int)或((int,int),(int,int))或(int,(int,int))或((int,int),int) | (int, int) or ((int, int),(int,int)) or (int,(int,int)) or ((int, int),int) | 垫 | 元素(左/右,上/下)或((左,右),(上,下))周围的填充量 |
bool | 布尔 | bool | change_submits | *请勿使用!与enable_events相同 |
bool | 布尔 | bool | drag_submits | 如果为图表启用了“真”和“事件”,则在按下按钮的任何时间移动鼠标都会报告事件 |
bool | 布尔 | bool | enable_events | 如果为True,则在图表上的点击将立即报告为事件。使用它代替change_submits |
any | 任何 | any | 键 | 从所有其他元素中唯一标识此元素的值。查找元素或返回值时使用。窗口必须是唯一的 |
str | 力量 | str | 工具提示 | 鼠标悬停在元素上时显示的文本 |
List[List[Union[List[str],str]]] | List [List [Union [List [str],str]]] | List[List[Union[List[str],str]]] | right_click_menu | 右键单击此元素时显示的菜单项列表的列表。有关详细格式,请参见用户文档。 |
bool | 布尔 | bool | 可见 | 设置元素的可见性状态(默认= True) |
bool | 布尔 | bool | float_values | If True x,y coordinates are returned as floats, not ints |
Any | Any | Any | metadata | User metadata that can be set to ANYTHING |
把图放在前面Bring Figure To Front
更改图形上图形的Z顺序。将指示的图形置于所有其他绘制图形的前面
BringFigureToFront(figure)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
整型 | 数字 | 创建图形/工程图时,tkinter返回的值 |
int | figure | value returned by tkinter when creating the figure / drawing |
删除图
从图中删除ID代表的图形。每次调用图形图元时都会向您提供ID
DeleteFigure(id)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
整型 | ID | 调用绘图方法之一时返回给您的ID |
int | id | the id returned to you when calling one of the drawing methods |
绘图弧
绘制不同类型的圆弧。使用“边界框”定义位置
DrawArc(top_left,
bottom_right,
extent,
start_angle,
style=None,
arc_color="black",
line_width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 左上方 | 边界矩形的左上角 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | bottom_right | 边界矩形的右下角 |
float | 浮动 | float | 程度 | 安德到结束画。与start_angle结合使用 |
float | 浮动 | float | start_angle | 开始绘制的角度。与范围一起使用 |
str | 力量 | str | 样式 | 有效的选择是以下样式字符串之一-‘pieslice’,‘chord’,‘arc’,‘first’,‘last’,‘butt’,‘projecting’,‘round’,‘bevel’,‘miter’ |
str | 力量 | str | arc_color | 绘制弧线的颜色 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵弧线则需要 |
画圆
画一个圆,以提供的位置为中心。可以设置填充和轮廓颜色
DrawCircle(center_location,
radius,
fill_color=None,
line_color="black",
line_width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union [Tuple[int, int], Tuple[float, float]] | 联合[Tuple [int,int],Tuple [float,float]] | Union [Tuple[int, int], Tuple[float, float]] | center_location | 使用用户坐标系的中心位置 |
Union[int, float] | 联合[int,float] | Union[int, float] | 半径 | 用户坐标值的半径。 |
str | 力量 | str | 填色 | 绘制点的颜色 |
str | 力量 | str | line_color | 绕圆圈的外线的颜色(对不起,无法设置粗细) |
int | 整型 | int | 行宽 | 圆,轮廓线的宽度,以像素为单位 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵圆圈,则需要 |
画图
将图像放置到画布上。对于这个元素来说,这是非常重要的方法,因为它可以实现
DrawImage(filename=None,
data=None,
location=(None, None),
color="black",
font=None,
angle=0)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
str | 力量 | str | 文件名 | 如果图像在文件,图像的路径和文件名中。(仅限GIF和PNG!) |
Union[str, bytes] | 联合[str,字节] | Union[str, bytes] | 数据 | 图像是Base64格式还是原始格式?然后使用格式代替文件名 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 位置 | (x,y)位置以放置图像的左上角 |
str | 力量 | str | 颜色 | 文字颜色 |
Union[str, Tuple[str, int]] | 联合[str,元组[str,int]] | Union[str, Tuple[str, int]] | 字形 | 指定字体系列,大小等 |
float | 浮动 | float | 角度 | 以0到360的角度绘制文本。零代表水平文字 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您要操作图像,则需要此ID |
牵引线
使用用户的坐标在一个点到另一点之间绘制一条线。可以设置线的颜色和宽度
DrawLine(point_from,
point_to,
color="black",
width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | point_from | 线的起点 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 指向 | 线的终点 |
str | 力量 | str | 颜色 | 线的颜色 |
int | 整型 | int | 宽度 | 线宽(以像素为单位) |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tktiner返回的ID,如果用户关闭窗口则返回None。在您使用ID时 |
绘制椭圆
根据用户坐标系中的坐标绘制一个椭圆。提供“边界矩形”的位置
DrawOval(top_left,
bottom_right,
fill_color=None,
line_color=None,
line_width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 左上方 | 边界矩形的左上角 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | bottom_right | 边界矩形的右下角 |
str | 力量 | str | 填色 | 中间色 |
str | 力量 | str | line_color | 椭圆形轮廓颜色 |
int | 整型 | int | 行宽 | 椭圆,轮廓线的宽度,以像素为单位 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵椭圆形,则需要 |
牵引点
在使用用户坐标系指定的点上绘制“点”
DrawPoint(point,
size=2,
color="black")
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union [Tuple[int, int], Tuple[float, float]] | 联合[Tuple [int,int],Tuple [float,float]] | Union [Tuple[int, int], Tuple[float, float]] | 点 | 使用用户坐标系的中心位置 |
Union[int, float] | 联合[int,float] | Union[int, float] | 尺寸 | 半径?(或者是直径?)在用户的坐标值中。 |
str | 力量 | str | 颜色 | 绘制点的颜色 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵该点,则需要 |
绘制多边形
给定点列表绘制多边形
DrawPolygon(points,
fill_color=None,
line_color=None,
line_width=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
List[Union[Tuple[int, int], Tuple[float, float]]] | List [Union [Tuple [int,int],Tuple [float,float]]]] | List[Union[Tuple[int, int], Tuple[float, float]]] | 点数 | 定义多边形的点列表 |
str | 力量 | str | 填色 | 内部颜色 |
str | 力量 | str | line_color | 轮廓颜色 |
int | 整型 | int | 行宽 | 线的宽度(以像素为单位) |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您要操作矩形,则需要 |
绘制矩形
画一个给定2点的矩形。可以控制线条和填充颜色
DrawRectangle(top_left,
bottom_right,
fill_color=None,
line_color=None,
line_width=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 左上方 | 矩形的左上角 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | bottom_right | 矩形的右下角 |
str | 力量 | str | 填色 | 内部颜色 |
str | 力量 | str | line_color | 轮廓颜色 |
int | 整型 | int | 行宽 | 线的宽度(以像素为单位) |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 如果要操作矩形,则需要从tkinter返回的Union [int,None] id |
DrawText
在图形上绘制一些文本。例如,这就是标记图形数字线的方式
DrawText(text,
location,
color="black",
font=None,
angle=0,
text_location="center")
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
str | 力量 | str | 文本 | 要显示的文字 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 位置 | 放置首字母的位置 |
str | 力量 | str | 颜色 | 文字颜色 |
Union[str, Tuple[str, int]] | 联合[str,元组[str,int]] | Union[str, Tuple[str, int]] | 字形 | 指定字体系列,大小等 |
float | 浮动 | float | 角度 | 以0到360的角度绘制文本。零代表水平文字 |
enum | 枚举 | enum | text_location | 文本的“锚定”位置。值以TEXT_LOCATION_开头 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵文本,则需要 |
擦除
擦除图形-使用Graph方法删除所有先前“绘制”的图形(例如DrawText)
Erase()
GetBoundingBoxGet Bounding Box
给定一个图,返回左上和右下边界框坐标
GetBoundingBox(figure)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
object | 宾语 | object | 数字 | 先前绘制的图 |
Union[Tuple[int, int, int, int], Tuple[float, float, float, float]] | 联合[元组[int,int,int,int],元组[float,float,float,float]] | Union[Tuple[int, int, int, int], Tuple[float, float, float, float]] | 返回 | 左上x,左上y,右下x,右下y |
GetFiguresAtLocation在位置获取图形
返回位于图形中特定x,y位置的图形列表
GetFiguresAtLocation(location)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 位置 | 点检查 |
ist[int] | 清单[int] | ist[int] | 返回 | 先前绘制的“图形”的列表(从图形基元返回) |
移动
从当前位置将整个绘图区域(画布)移动一些增量。在坐标系中指示单位,在坐标系中指示刻度数
Move(x_direction, y_direction)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[int, float] | 联合[int,float] | Union[int, float] | x_direction | 在座标中沿“ X”方向移动的距离 |
Union[int, float] | 联合[int,float] | Union[int, float] | y_direction | 在您的座标中沿“ Y”方向移动的距离 |
移动图
从当前位置使用“增量”移动先前绘制的图形
MoveFigure(figure,
x_direction,
y_direction)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
id | ID | id | 数字 | 先前获得的数字ID。这些是从所有Draw方法返回的 |
Union[int, float] | 联合[int,float] | Union[int, float] | x_direction | 应用于X方向位置的变化量 |
Union[int, float] | 联合[int,float] | Union[int, float] | y_direction | 应用于Y方向位置的变化量 |
重新定位图
将先前制作的图形移动到任意(x,y)位置。这与Move方法不同,因为它对Move使用绝对坐标与相对坐标
RelocateFigure(figure,
x,
y)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
id | ID | id | 数字 | 先前获得的数字ID。这些是从所有Draw方法返回的 |
Union[int, float] | 联合[int,float] | Union[int, float] | X | X轴上的位置(以用户坐标为单位)以移动图形的左上角 |
Union[int, float] | 联合[int,float] | Union[int, float] | ÿ | Y轴上的位置(以用户坐标为单位)以移动图形的左上角 |
SendFigureToBack向后发送图
更改图形上图形的Z顺序。将指示的图形发送到所有其他图形的背面
SendFigureToBack(figure)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
整型 | 数字 | 创建图形/工程图时,tkinter返回的值 |
int | figure | value returned by tkinter when creating the figure / drawing |
设定焦点
将当前焦点设置在此元素上
SetFocus(force=False)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
布尔 | 力 | 如果为True,则将调用focus_force;否则,将调用focus_set |
bool | force | if True will call focus_force otherwise calls focus_set |
设定工具提示
由应用程序调用以更改元素的工具提示文本。通常使用Element Object调用,例如:window.Element(‘key’)。SetToolTip(‘New tip’)。
SetTooltip(tooltip_text)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
力量 | tooltip_text | 要在工具提示中显示的文本。 |
str | tooltip_text | the text to show in tooltip. |
TKCanvas
属性:TKCanvas
返回底层的tkiner Canvas小部件
参数类型 | 参数名 | 说明 |
---|---|---|
— | 返回 | Tkinter画布小部件 |
— | return | The tkinter canvas widget |
更新资料
更改“图形元素”的某些设置。必须致电Window.Read或Window.Finalize事先
Update(background_color=None, visible=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
??? | ??? | ??? | 背景颜色 | 背景色 |
bool | 布尔 | bool | 可见 | 控制元素的可见性 |
捆绑
用于将tkinter事件添加到Element。tkinter特定数据位于Element的成员变量user_bind_event中
bind(bind_string, key_modifier)
bring_figure_to_front带上_图_到_前
更改图形上图形的Z顺序。将指示的图形置于所有其他绘制图形的前面
bring_figure_to_front(figure)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
整型 | 数字 | 创建图形/工程图时,tkinter返回的值 |
int | figure | value returned by tkinter when creating the figure / drawing |
change_coordinates
将corrdinate系统更改为新系统。相同的两个空间点用于定义坐标系-图形的左下角和右上角值。
change_coordinates(graph_bottom_left, graph_top_right)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
Tuple[int, int] (x,y) | 元组[int,int](x,y) | Tuple[int, int] (x,y) |
Tuple[int, int] (x,y) | 元组[int,int](x,y) | Tuple[int, int] (x,y) |
delete_figure
从图中删除ID代表的图形。每次调用图形图元时都会向您提供ID
delete_figure(id)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
整型 | ID | 调用绘图方法之一时返回给您的ID |
int | id | the id returned to you when calling one of the drawing methods |
draw_arc
绘制不同类型的圆弧。使用“边界框”定义位置
draw_arc(top_left,
bottom_right,
extent,
start_angle,
style=None,
arc_color="black",
line_width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 左上方 | 边界矩形的左上角 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | bottom_right | 边界矩形的右下角 |
float | 浮动 | float | 程度 | 安德到结束画。与start_angle结合使用 |
float | 浮动 | float | start_angle | 开始绘制的角度。与范围一起使用 |
str | 力量 | str | 样式 | 有效的选择是以下样式字符串之一-‘pieslice’,‘chord’,‘arc’,‘first’,‘last’,‘butt’,‘projecting’,‘round’,‘bevel’,‘miter’ |
str | 力量 | str | arc_color | 绘制弧线的颜色 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵弧线则需要 |
draw_circle
画一个圆,以提供的位置为中心。可以设置填充和轮廓颜色
draw_circle(center_location,
radius,
fill_color=None,
line_color="black",
line_width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union [Tuple[int, int], Tuple[float, float]] | 联合[Tuple [int,int],Tuple [float,float]] | Union [Tuple[int, int], Tuple[float, float]] | center_location | 使用用户坐标系的中心位置 |
Union[int, float] | 联合[int,float] | Union[int, float] | 半径 | 用户坐标值的半径。 |
str | 力量 | str | 填色 | 绘制点的颜色 |
str | 力量 | str | line_color | 绕圆圈的外线的颜色(对不起,无法设置粗细) |
int | 整型 | int | 行宽 | 圆,轮廓线的宽度,以像素为单位 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵圆圈,则需要 |
draw_image
将图像放置到画布上。对于这个元素来说,这是非常重要的方法,因为它可以实现
draw_image(filename=None,
data=None,
location=(None, None),
color="black",
font=None,
angle=0)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
str | 力量 | str | 文件名 | 如果图像在文件,图像的路径和文件名中。(仅限GIF和PNG!) |
Union[str, bytes] | 联合[str,字节] | Union[str, bytes] | 数据 | 图像是Base64格式还是原始格式?然后使用格式代替文件名 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 位置 | (x,y)位置以放置图像的左上角 |
str | 力量 | str | 颜色 | 文字颜色 |
Union[str, Tuple[str, int]] | 联合[str,元组[str,int]] | Union[str, Tuple[str, int]] | 字形 | 指定字体系列,大小等 |
float | 浮动 | float | 角度 | 以0到360的角度绘制文本。零代表水平文字 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您要操作图像,则需要此ID |
draw_line
使用用户的坐标在一个点到另一点之间绘制一条线。可以设置线的颜色和宽度
draw_line(point_from,
point_to,
color="black",
width=1)
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | point_from | 线的起点 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 指向 | 线的终点 |
str | 力量 | str | 颜色 | 线的颜色 |
int | 整型 | int | 宽度 | 线宽(以像素为单位) |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tktiner返回的ID,如果用户关闭窗口则返回None。在您使用ID时 |
draw_oval
根据用户坐标系中的坐标绘制一个椭圆。提供“边界矩形”的位置
draw_oval(top_left,
bottom_right,
fill_color=None,
line_color=None,
line_width=1)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 左上方 | 边界矩形的左上角 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | bottom_right | 边界矩形的右下角 |
str | 力量 | str | 填色 | 中间色 |
str | 力量 | str | line_color | 椭圆形轮廓颜色 |
int | 整型 | int | 行宽 | 椭圆,轮廓线的宽度,以像素为单位 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵椭圆形,则需要 |
draw_polygon
给定点列表绘制多边形
draw_polygon(points,
fill_color=None,
line_color=None,
line_width=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
List[Union[Tuple[int, int], Tuple[float, float]]] | List [Union [Tuple [int,int],Tuple [float,float]]]] | List[Union[Tuple[int, int], Tuple[float, float]]] | 点数 | 定义多边形的点列表 |
str | 力量 | str | 填色 | 内部颜色 |
str | 力量 | str | line_color | 轮廓颜色 |
int | 整型 | int | 行宽 | 线的宽度(以像素为单位) |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您要操作矩形,则需要 |
draw_rectangle
画一个给定2点的矩形。可以控制线条和填充颜色
draw_rectangle(top_left,
bottom_right,
fill_color=None,
line_color=None,
line_width=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 左上方 | 矩形的左上角 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | bottom_right | 矩形的右下角 |
str | 力量 | str | 填色 | 内部颜色 |
str | 力量 | str | line_color | 轮廓颜色 |
int | 整型 | int | 行宽 | 线的宽度(以像素为单位) |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 如果要操作矩形,则需要从tkinter返回的Union [int,None] id |
draw_text
在图形上绘制一些文本。例如,这就是标记图形数字线的方式
draw_text(text,
location,
color="black",
font=None,
angle=0,
text_location="center")
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
str | 力量 | str | 文本 | 要显示的文字 |
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 位置 | 放置首字母的位置 |
str | 力量 | str | 颜色 | 文字颜色 |
Union[str, Tuple[str, int]] | 联合[str,元组[str,int]] | Union[str, Tuple[str, int]] | 字形 | 指定字体系列,大小等 |
float | 浮动 | float | 角度 | 以0到360的角度绘制文本。零代表水平文字 |
enum | 枚举 | enum | text_location | 文本的“锚定”位置。值以TEXT_LOCATION_开头 |
Union[int, None] | 联合[int,无] | Union[int, None] | 返回 | 从tkinter返回的id,如果您想操纵文本,则需要 |
抹去
擦除图形-使用Graph方法删除所有先前“绘制”的图形(例如DrawText)
erase()
扩大
使元素扩展以填充X和Y方向上的可用空间。可以指定哪个或两个方向
expand(expand_x=False,
expand_y=False,
expand_row=True)
get_bounding_box
给定一个图,返回左上和右下边界框坐标
get_bounding_box(figure)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
object | 宾语 | object | 数字 | 先前绘制的图 |
Union[Tuple[int, int, int, int], Tuple[float, float, float, float]] | 联合[元组[int,int,int,int],元组[float,float,float,float]] | Union[Tuple[int, int, int, int], Tuple[float, float, float, float]] | 返回 | 左上x,左上y,右下x,右下y |
get_figures_at_location
返回位于图形中特定x,y位置的图形列表
get_figures_at_location(location)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[Tuple[int, int], Tuple[float, float]] | 联合[元组[int,int],元组[float,float]] | Union[Tuple[int, int], Tuple[float, float]] | 位置 | 点检查 |
ist[int] | 清单[int] | ist[int] | 返回 | 先前绘制的“图形”的列表(从图形基元返回) |
get_size
返回像素的大小。必须小心,因为某些元素使用字符来指定其大小,但是在调用此get_size方法时将返回像素。
get_size()
参数类型 | 参数名 | 说明 |
---|---|---|
— | 返回 | 元素的宽度和高度 |
— | return | width and height of the element |
hide_row
隐藏元素所在的整行。如果在隐藏元素(包括行容器)时必须删除所有空间,请使用此选项
hide_row()
移动
从当前位置将整个绘图区域(画布)移动一些增量。在坐标系中指示单位,在坐标系中指示刻度数
move(x_direction, y_direction)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
Union[int, float] | 联合[int,float] | Union[int, float] | x_direction | 在座标中沿“ X”方向移动的距离 |
Union[int, float] | 联合[int,float] | Union[int, float] | y_direction | 在您的座标中沿“ Y”方向移动的距离 |
move_figure
从当前位置使用“增量”移动先前绘制的图形
move_figure(figure,
x_direction,
y_direction)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
id | ID | id | 数字 | 先前获得的数字ID。这些是从所有Draw方法返回的 |
Union[int, float] | 联合[int,float] | Union[int, float] | x_direction | 应用于X方向位置的变化量 |
Union[int, float] | 联合[int,float] | Union[int, float] | y_direction | 应用于Y方向位置的变化量 |
relocate_figure
将先前制作的图形移动到任意(x,y)位置。这与Move方法不同,因为它对Move使用绝对坐标与相对坐标
relocate_figure(figure,
x,
y)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
id | ID | id | 数字 | 先前获得的数字ID。这些是从所有Draw方法返回的 |
Union[int, float] | 联合[int,float] | Union[int, float] | X | X轴上的位置(以用户坐标为单位)以移动图形的左上角 |
Union[int, float] | 联合[int,float] | Union[int, float] | ÿ | Y轴上的位置(以用户坐标为单位)以移动图形的左上角 |
send_figure_to_back
更改图形上图形的Z顺序。将指示的图形发送到所有其他图形的背面
send_figure_to_back(figure)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
整型 | 数字 | 创建图形/工程图时,tkinter返回的值 |
int | figure | value returned by tkinter when creating the figure / drawing |
设定焦点
将当前焦点设置在此元素上
SetFocus(force=False)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
布尔 | 力 | 如果为True,则将调用focus_force;否则,将调用focus_set |
bool | force | if True will call focus_force otherwise calls focus_set |
设定工具提示
由应用程序调用以更改元素的工具提示文本。通常使用Element Object调用,例如:window.Element(‘key’)。SetToolTip(‘New tip’)。
SetTooltip(tooltip_text)
参数说明:
参数类型 | 参数名 | 说明 |
---|---|---|
力量 | tooltip_text | 要在工具提示中显示的文本。 |
str | tooltip_text | the text to show in tooltip. |
TKCanvas
属性:TKCanvas
返回底层的tkiner Canvas小部件
参数类型 | 参数名 | 说明 |
---|---|---|
— | 返回 | Tkinter画布小部件 |
— | return | The tkinter canvas widget |
更新资料
更改“图形元素”的某些设置。必须致电Window.Read或Window.Finalize事先
Update(background_color=None, visible=None)
参数说明:
参数类型 | 参数名 | 说明 | ||
---|---|---|---|---|
??? | ??? | ??? | 背景颜色 | 背景色 |
bool | 布尔 | bool | 可见 | 控制元素的可见性 |