Yamyam: 1版をインポートしました

2018-06-28T19:42:16Z

1版をインポートしました

2012年12月29日 (土) 18:55にwiki>Mont29による

2012-12-29T18:55:43Z

新規ページ

=UI Template List Enhancement=

{{Warning/Important}} This page is about an old “customization” system, which has now been replaced by a fully pythonic system to define your own lists, pretty much like you define your own menus or panels. Please refer to current ui py code ([code]release/scripts/startup/bl_ui/properties_data_mesh.py[/code] & co) for examples…

==What?==
[[File:UITemplateListEnhancementPatchEx.png|frame|right|A generic list display of a collection, with custom item controls.]]
This patch adds an opportunity for generic items in a collection displayed by that template to display custom controls (e.g. check boxes, numfield, etc.). See the picture to the right (note that you could even, if you like, have different controls for each row/item).

==Why?==
Well, because right now, except for a limited, hard-coded set of collections (e.g. vertex groups, textures/materials slots…), the template list only displays the name of each item in a generic collection, which isn’t so useful… That is especially frustrating when using python-defined collections!

==How?==
Right now, I implemented that by searching, for each item, in the default case, a given string property (which name is given to the template function). That string is then split on ':', and the resulting strings should correspond to the names of some properties in the template-listed item, that are to be displayed in that row of the list.

To test it, you first need to build your own blender patched with the patch linked [[#Links|below]].

Then, copy/paste the following code in a Blender text block, and execute it as a Python script:

<source lang="python">
import bpy
from bpy.props import StringProperty, BoolProperty, IntProperty, CollectionProperty

class TestPropertyGroup(bpy.types.PropertyGroup):
bool = BoolProperty(default=False)
integer = IntProperty()
string = StringProperty()
# A list of identifiers (colon-separated strings) which property’s controls should be displayed
# in a template_list.
# Note that the order is respected.
template_list_controls = StringProperty(default="integer:string:bool", options={"HIDDEN"})

bpy.utils.register_class(TestPropertyGroup)

bpy.types.Scene.my_settings = CollectionProperty(type=TestPropertyGroup)
# Unused, but this is needed for the TemplateList to work…
bpy.types.Scene.my_settings_idx = IntProperty()

# Add ten default items…
my_sett = bpy.context.scene.my_settings
for i in range(10):
my_item = my_sett.add()
my_item.name = "item {}".format(i)
# Hide one property for odd items.
if i % 2:
my_item.template_list_controls = "string:bool"

# Now, create a panel to show all this!
class OBJECT_PT_TemplateListTest(bpy.types.Panel):
bl_label = "Template List Test Panel"
bl_space_type = "PROPERTIES"
bl_region_type = "WINDOW"
bl_context = "render"
def draw(self, context):
layout = self.layout
layout.template_list(context.scene, "my_settings", context.scene, "my_settings_idx",
prop_list="template_list_controls", rows=5)

bpy.utils.register_class(OBJECT_PT_TemplateListTest)
</source>

This should give you a {{Literal|Template List Test Panel}} in the {{Literal|Buttons}} window, {{Literal|Render}} context, with a list which items have a label, a numeric field (for even items only), a text field and a check box. Note how the order of the identifiers in the <code>template_list_controls</code> string determines the order of the UI elements…

You can also enable the [[Extensions:2.5/Py/Scripts/Render/Copy Settings|{{Literal|Render: Copy Setting}} addon]], as I coded this patch for this purpose!

==Links==
* tracker: http://projects.blender.org/tracker/index.php?func=detail&aid=26629
* patch: http://projects.blender.org/tracker/download.php/9/127/26629/15655/ui_template_list_svn35916.patch

==Change Log==
===0.0.1===
Initial release.

===0.0.2===
As asked by Campbell, made the name of the “control property” customizable – you now just have to pass it as an optional parameter of template_list() bpy func.
Leave it empty if you want the default behavior !

===0.0.3===
Now list of properties to display is a simple, colon-separated string, much much easier to handle!

← 古い版	2018年6月28日 (木) 19:42時点における版
(相違点なし)

利用者:Mont29/Dev/UI Template List Enhancement - 版の履歴

Yamyam: 1版 をインポートしました

2012年12月29日 (土) 18:55にwiki>Mont29による

Yamyam: 1版をインポートしました