命令 (MEL/Python)
|
MGPickerViewRegion
|
跳转到: 概要. MEL例子. Python例子.
概要
MGPickerViewRegion (viewRegionIDString, [activate=boolean] [animation=unsigned int, string] [exist=boolean] [geometry=float, float, float, float] [getIdFromName=string] [list=boolean] [name=string] [remove=boolean] [select=int]) [view=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
MGPickerViewRegion不可撤消, 可以查询且可以编辑。
这个命令创建, 查询或编辑一个picker视图区域。
长名 (短名)
|
参数类型
|
属性
|
-activate(-act)  
|
|
 
|
|
用于平稳缩放picker视图，以聚集到该视图区域。 该动作支持动画。
|
|
-animation(-ani)
|
unsigned int string
|
|
|
仅用于编辑，用来把其它编辑变成一段动画。
第一个数值是动画长度，以微秒为单位，第二个数值是动画曲线类型，支持的数值可以通过运行MEL来获取：MGPickerAnimation -q -supportedEasingTypes
|
|
-exist(-ex)
|
|
|
|
这个标签只能用于查询模式，用来获取该视图区域是否存在。
|
|
-geometry(-g)
|
float float float float
|
|
|
|
-getIdFromName(-gin)
|
string
|
|
|
只能用于查询。指定一个名字字符窜，将返回所有取这个名字的picker视图区域的id数组。
理论上每个视图区域都应该指定不同的名字，不过这里还是返回数值，以便跟其它命令保持统一。
|
|
-list(-ls)
|
|
|
|
只能用于查询来返回这个picker视图里所有的视图区域的ID.
|
|
-name(-n)
|
string
|
|
|
查询或编辑该视图区域的名字，注意为了保持每个视图区域的名字独特性，实际指定的名字可能跟输入的名字不一样，但会尽量靠近。
|
|
-remove(-rm)
|
|
|
|
|
-select(-sel)
|
int
|
|
|
在查询下将返回当前picker视图所选择的picker视图区域的id数组。
在编辑模式下将选择对应的picker视图区域，配合使用0~3的整数来指定选择模式：0 = 选择，1 = 加选，2 = 去选，3 = 反选。
|
|
-view(-v)
|
string
|
|
|
控制要查询，编辑或创建在哪个picker视图的视图区域，在未使用该标签的情况下，默认是在当前激活的picker视图。
该标签需要您指定一个picker视图id字符窜。该id可以通过下方式来获取(具体请查询MGPicker命名参考文档):
MGPicker -q -currentPickerView; // 获取当前所执行的脚本所属于的视图的id，如picker的加载命令和鼠标进入命令。仅脚本执行过程中可获取。
MGPicker -q -activePickerView; // 获取当前激活视图的id.
MGPicker -q -findPickerView "pickerNodeOrFileName" 1 "namespace"; // 通过指定picker节点或文件名来查找特定的picker视图id.
MGPicker -q -listAllPickerViews; // 列出所有打开的picker视图的id.
MGPicker -e -createTempPicker; // 创建一个临时picker视图并返回其id.
MGPicker -e -createPicker "pickerName" "namespace" "filePath" "nodeName"; //创建一个picker视图并返回其id.
MGPicker -e -readPickerNode "nodeName"; // 读取场景picker节点并返回其所打开的picker视图的id.
MGPicker -e -readScenePicker "nodeName" "pickerName" "namespace" "pickerDataString"; // 读取场景picker节点并返回其所打开的picker视图的id.
MGPicker -e -readPickerFile "pickerFilePath" 1; // 读取picker文件并返回其所打开的picker视图的id.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
标签可以在创建模式中使用
|
标签可以在编辑模式中使用
|
标签可以在查询模式中使用
|
 标签可以在一条命令中多次使用
|
标签可以配合-animation标签进行动画
|
|
MEL例子
// Make sure there is an active picker view, run this to create a view region with the specific geometry and name:
string $newViewRegion = `MGPickerViewRegion -name "Body" -geometry 50.0 50.0 300.0 300.0`;
// Activate that view region:
MGPickerViewRegion -e -activate -animation 500 "OutQuad" $newViewRegion;
Python例子
from mgpicker import mgp
# Make sure there is an active picker view, run this to create a view region with the specific geometry and name:
newViewRegion = mgp.MGPickerViewRegion(name='Body', geometry=(50.0, 50.0, 300.0, 300.0))
# Activate that view region:
mgp.MGPickerViewRegion(newViewRegion, e=True, activate=True, animation=(500, 'OutQuad'))
| 
