ObjectProxySetTemplate Method (UInt64, Boolean) |
Sets a new template for this object.
Namespace: Articy.Api
Assembly: QueryLayer (in QueryLayer.dll) Version: 1.0.0
SyntaxC#
public void SetTemplate( ulong aId, bool aSetColor = true )
Parameters
- aId
- Type: SystemUInt64
the ID of the new template or InstanceIdManager.InvalidIid to remove an already set template - aSetColor (Optional)
- Type: SystemBoolean
set to false if you do not want that the template change also changes the objects color
Exceptions| Exception | Condition |
|---|---|
| ArticyApiException | if the the specified ID is no valid template, ErrorCode.UnknownTemplate is thrown |
| ArticyApiException | if the object is read-only, ErrorCode.WriteDenied is thrown |
| ArticyApiException | if the object is not customizable, ErrorCode.ObjectNotCustomizeable is thrown |
| ArticyApiException | if the the specified template is not allowed for this type of object, ErrorCode.TemplateNotAllowedForObject is thrown |
See Also