48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
|
# Blocks
|
|||
|
|
Blocks是kivyblocks的核心类，负责将字典类型的数据转化为GUI的Widget。
|
|||
|
|
Blocks也注册到了kivy.factory.Factory中，可以使用
|
|||
|
|
```
|
|||
|
|
blocks = Factory.Blocks()
|
|||
|
|
```
|
|||
|
|
初始化实例
|
|||
|
|
|
|||
|
|
## 方法
|
|||
|
|
### widgetBuild(desc)
|
|||
|
|
#### 参数
|
|||
|
|
* desc 1) 字典类型， Widget描述的字典数据
|
|||
|
|
2) 字符串，可通过json导入的字符串
|
|||
|
|
|
|||
|
|
#### 返回值
|
|||
|
|
成功返回创建的widget实例
|
|||
|
|
失败返回空
|
|||
|
|
|
|||
|
|
#### 事件
|
|||
|
|
如果创建widget成功，触发”on_built"事件，
|
|||
|
|
如果创建widget失败，将触发“on_failed”事件
|
|||
|
|
|
|||
|
|
事件处理函数的例子如下：
|
|||
|
|
创建成功：
|
|||
|
|
```
|
|||
|
|
def on_built(o, w):
|
|||
|
|
pass
|
|||
|
|
```
|
|||
|
|
其中，o为Blocks实例， w为新建widget的实例
|
|||
|
|
创建失败
|
|||
|
|
```
|
|||
|
|
def on_failed(o,e):
|
|||
|
|
pass
|
|||
|
|
```
|
|||
|
|
其中， o为Blocks实例， e为例外实例
|
|||
|
|
|
|||
|
|
#### 功能描述
|
|||
|
|
此方法按照desc字典数据构建一个Widget，首先按照desc['options']中的参数初始化“widgettype”属性指定的类，并将“subwidgets”中的子Widget创建，并添加到Widget中，并且将非“options”，“subwidgets“和”binds“的其他属性也创建完成，并作为Widget的属性变量，最后创建”binds“中的事件处理。
|
|||
|
|
|
|||
|
|
widgetBuild按照执行结果的状态，会触发两个事件中的一个，如果创建成功，会触发"on_built"
|
|||
|
|
|
|||
|
|
### getWidgetById(id, from_widget=None)
|
|||
|
|
查找指定id的widget，可以指定从整个widget树上的哪个节点开始查找。
|
|||
|
|
#### 参数
|
|||
|
|
id：字符串，其中‘.'用于分割，节点id，如果id中存在‘.'，那么
|
|||
|
|
## 使用用例
|
|||
|
|
|