API reference - Class PCellParameterDeclaration

TypeBoolean

Signature: [static] unsigned int TypeBoolean

Description: Type code: boolean data

Python specific notes:
The object exposes a readable attribute 'TypeBoolean'. This is the getter.

TypeCallback

Signature: [static] unsigned int TypeCallback

Description: Type code: a button triggering a callback

This code has been introduced in version 0.28.

Python specific notes:
The object exposes a readable attribute 'TypeCallback'. This is the getter.

TypeDouble

Signature: [static] unsigned int TypeDouble

Description: Type code: floating-point data

Python specific notes:
The object exposes a readable attribute 'TypeDouble'. This is the getter.

TypeInt

Signature: [static] unsigned int TypeInt

Description: Type code: integer data

Python specific notes:
The object exposes a readable attribute 'TypeInt'. This is the getter.

TypeLayer

Signature: [static] unsigned int TypeLayer

Description: Type code: a layer (a LayerInfo object)

Python specific notes:
The object exposes a readable attribute 'TypeLayer'. This is the getter.

TypeList

Signature: [static] unsigned int TypeList

Description: Type code: a list of variants

Python specific notes:
The object exposes a readable attribute 'TypeList'. This is the getter.

TypeNone

Signature: [static] unsigned int TypeNone

Description: Type code: unspecific type

Python specific notes:
The object exposes a readable attribute 'TypeNone'. This is the getter.

TypeShape

Signature: [static] unsigned int TypeShape

Description: Type code: a guiding shape (Box, Edge, Point, Polygon or Path)

Python specific notes:
The object exposes a readable attribute 'TypeShape'. This is the getter.

TypeString

Signature: [static] unsigned int TypeString

Description: Type code: string data

Python specific notes:
The object exposes a readable attribute 'TypeString'. This is the getter.

_const_cast

Signature: [const] PCellParameterDeclaration ptr _const_cast

Description: Returns a non-const reference to self.

Basically, this method allows turning a const object reference to a non-const one. This method is provided as last resort to remove the constness from an object. Usually there is a good reason for a const object reference, so using this method may have undesired side effects.

This method has been introduced in version 0.29.6.

_create

Signature: void _create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

_destroy

Signature: void _destroy

Description: Explicitly destroys the object

Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing.

_destroyed?

Signature: [const] bool _destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

_is_const_object?

Signature: [const] bool _is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

_manage

Signature: void _manage

Description: Marks the object as managed by the script side.

After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required.

Usually it's not required to call this method. It has been introduced in version 0.24.

_unmanage

Signature: void _unmanage

Description: Marks the object as no longer owned by the script side.

Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur.

Usually it's not required to call this method. It has been introduced in version 0.24.

add_choice

Signature: void add_choice (string description, variant value)

Description: Add a new value to the list of choices

This method will add the given value with the given description to the list of choices. If choices are defined, KLayout will show a drop-down box instead of an entry field in the parameter user interface.

assign

Signature: void assign (const PCellParameterDeclaration other)

Description: Assigns another object to self

choice_descriptions

Signature: [const] string[] choice_descriptions

Description: Returns a list of choice descriptions

choice_values

Signature: [const] variant[] choice_values

Description: Returns a list of choice values

clear_choices

Signature: void clear_choices

Description: Clears the list of choices

create

Signature: void create

Description: Ensures the C++ object is created

Use of this method is deprecated. Use _create instead

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

default

Signature: [const] variant default

Description: Gets the default value

Python specific notes:
The object exposes a readable attribute 'default'. This is the getter.

default=

Signature: void default= (variant value)

Description: Sets the default value

If a default value is defined, it will be used to initialize the parameter value when a PCell is created.

Python specific notes:
The object exposes a writable attribute 'default'. This is the setter.

description

Signature: [const] string description

Description: Gets the description text

Python specific notes:
The object exposes a readable attribute 'description'. This is the getter.

description=

Signature: void description= (string description)

Description: Sets the description

Python specific notes:
The object exposes a writable attribute 'description'. This is the setter.

destroy

Signature: void destroy

Description: Explicitly destroys the object

Use of this method is deprecated. Use _destroy instead

Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing.

destroyed?

Signature: [const] bool destroyed?

Description: Returns a value indicating whether the object was already destroyed

Use of this method is deprecated. Use _destroyed? instead

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

dup

Signature: [const] new PCellParameterDeclaration ptr dup

Description: Creates a copy of self

Python specific notes:
This method also implements '__copy__' and '__deepcopy__'.

hidden=

Signature: void hidden= (bool flag)

Description: Makes the parameter hidden if this attribute is set to true

Python specific notes:
The object exposes a writable attribute 'hidden'. This is the setter.

hidden?

Signature: [const] bool hidden?

Description: Returns true, if the parameter is a hidden parameter that should not be shown in the user interface

By making a parameter hidden, it is possible to create internal parameters which cannot be edited.

Python specific notes:
The object exposes a readable attribute 'hidden'. This is the getter.

is_const_object?

Signature: [const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

Use of this method is deprecated. Use _is_const_object? instead

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

max_value

Signature: [const] variant max_value

Description: Gets the maximum value allowed

See max_value= for a description of this attribute.

This attribute has been added in version 0.29.

Python specific notes:
The object exposes a readable attribute 'max_value'. This is the getter.

max_value=

Signature: void max_value= (variant value)

Description: Sets the maximum value allowed

The maximum value is a visual feature and limits the allowed values for numerical entry boxes. This applies to parameters of type int or double. The maximum value is not effective if choices are present.

The maximum value is not enforced - for example there is no restriction implemented when setting values programmatically.

Setting this attribute to "nil" (the default) implies "no limit".

This attribute has been added in version 0.29.

Python specific notes:
The object exposes a writable attribute 'max_value'. This is the setter.

min_value

Signature: [const] variant min_value

Description: Gets the minimum value allowed

See min_value= for a description of this attribute.

This attribute has been added in version 0.29.

Python specific notes:
The object exposes a readable attribute 'min_value'. This is the getter.

min_value=

Signature: void min_value= (variant value)

Description: Sets the minimum value allowed

The minimum value is a visual feature and limits the allowed values for numerical entry boxes. This applies to parameters of type int or double. The minimum value is not effective if choices are present.

The minimum value is not enforced - for example there is no restriction implemented when setting values programmatically.

Setting this attribute to "nil" (the default) implies "no limit".

This attribute has been added in version 0.29.

Python specific notes:
The object exposes a writable attribute 'min_value'. This is the setter.

name

Signature: [const] string name

Description: Gets the name

Python specific notes:
The object exposes a readable attribute 'name'. This is the getter.

name=

Signature: void name= (string value)

Description: Sets the name

Python specific notes:
The object exposes a writable attribute 'name'. This is the setter.

new

Signature: [static] new PCellParameterDeclaration ptr new (string name, unsigned int type, string description, variant default = nil, string unit = )

Description: Create a new parameter declaration with the given name, type, default value and unit string

Python specific notes:
This method is the default initializer of the object.

readonly=

Signature: void readonly= (bool flag)

Description: Makes the parameter read-only if this attribute is set to true

Python specific notes:
The object exposes a writable attribute 'readonly'. This is the setter.

readonly?

Signature: [const] bool readonly?

Description: Returns true, if the parameter is a read-only parameter

By making a parameter read-only, it is shown but cannot be edited.

Python specific notes:
The object exposes a readable attribute 'readonly'. This is the getter.

tooltip

Signature: [const] string tooltip

Description: Gets the tool tip text

This attribute has been introduced in version 0.29.3.

Python specific notes:
The object exposes a readable attribute 'tooltip'. This is the getter.

tooltip=

Signature: void tooltip= (string tooltip)

Description: Sets the tool tip text

This attribute has been introduced in version 0.29.3.

Python specific notes:
The object exposes a writable attribute 'tooltip'. This is the setter.

type

Signature: [const] unsigned int type

Description: Gets the type

The type is one of the T... constants.

Python specific notes:
The object exposes a readable attribute 'type'. This is the getter.

type=

Signature: void type= (unsigned int type)

Description: Sets the type

Python specific notes:
The object exposes a writable attribute 'type'. This is the setter.

unit

Signature: [const] string unit

Description: Gets the unit string

Python specific notes:
The object exposes a readable attribute 'unit'. This is the getter.

unit=

Signature: void unit= (string unit)

Description: Sets the unit string

The unit string is shown right to the edit fields for numeric parameters.

Python specific notes:
The object exposes a writable attribute 'unit'. This is the setter.