PictureResourceButtonList

The value type PictureResourceButtonList is used to create a button list for the input of an integer value. The value is entered by selecting a button from the list.

../../../../_images/PictureResourceButtonList.png

Syntax

<Parameter>
<Name>PictureResourceButtonListRow</Name>
<Text>PictureResourceButtonList</Text>
<ValueType>Row</ValueType>

<Parameter>
<Name>PictureResourceButtonListValue</Name>
<Text>Width=1|Width=2|Width=3|Width=4</Text>
<Value>0</Value>
<ValueList>0|1|2|3</ValueList>
<ValueList2>16433|16441|16449|14563</ValueList2>
<ValueType>PictureResourceButtonList</ValueType>
</Parameter>
</Parameter>

The <Text> is used for the buttons tooltip. The text must be separated by the pipe | character, which must also be used for the text IDs in the <TextId> tag.

The <ValueList2> tag is used to define the image entries of the button list. The values are IDs of Allplan internal image resources and must be separated by the pipe | character.

The <ValueList> tag defines the corresponding integer value for the image that will be assigned to the parameter after selecting the button. The values must be separated by the pipe | character.

The <Value> tag defines the value of the button which will be selected by default.

Optional tags

If the PythonPart should be localized, the following tag must be added

<TextId>1001</TextId>

Sometimes it’s useful to disable or hide the picture resource button list depending on the value of another parameter. This is achieved by adding additional tags to the parameter or by defining functions in the py-file. See Enable and visible options

The persistent state of the parameter can be changed by adding

<Persistent></Persistent>

Example

The implementation of the PictureResourceButtonList value type is described in the example ButtonList, which is located in

…\etc\Examples\PythonParts\PaletteExamples\ButtonList.pyp
…\etc\PythonPartsExampleScripts\PaletteExamples\ButtonList.py