API Component.Property.SetColor: Difference between revisions
XML import |
m Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead"" |
||
| (18 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
The | {| class="mtx-class-macrotable wikitable" | ||
== | |- | ||
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | |||
| width="90%" class="mtx-class-macrohead" | '''SetColor''' | |||
|- | |||
| colspan="2" | Sets a components 'color' property as a R,G,B value | |||
|- | |||
|- | |||
| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE | |||
| width="90%" | Handle | |||
|- | |||
| colspan="2" | The component handle of the property owner | |||
|- | |||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | |||
| width="90%" | Red | |||
|- | |||
| colspan="2" | The 0-255 red part of the colour | |||
|- | |||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | |||
| width="90%" | Green | |||
|- | |||
| colspan="2" | The 0-255 green part of the colour | |||
|- | |||
| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE | |||
| width="90%" | Blue | |||
|- | |||
| colspan="2" | The 0-255 blue part of the colour | |||
|- | |||
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - NONE | |||
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | |||
|} | |||
== | ==Detailed description== | ||
This is a helper function that takes the red, green and blue values form 0-255 and calls [[API Component.Property.SetValue|SetValue]] with the property name "color" and the argument the RGB value built from this calls arguments. | |||
'' | No check is made to see if the target ''Handle'' has a property called "color", and no error is returned if it does not. | ||
==Examples== | |||
===Calling in a calculation=== | |||
* Add to a calculation icon: <pre class="brush:[cpp]">::Component.Property.SetColor(handle, red, green, blue)</pre> | |||
* Add to a calculation icon: ::Component.Property.SetColor(handle, red, green, blue) | |||
Latest revision as of 14:11, 13 July 2026
|
SetColor |
| Sets a components 'color' property as a R,G,B value | |
 - HANDLE
|
Handle |
| The component handle of the property owner | |
 - BYTE
|
Red |
| The 0-255 red part of the colour | |
| - BYTE
|
Green |
| The 0-255 green part of the colour | |
| - BYTE
|
Blue |
| The 0-255 blue part of the colour | |
 - NONE
|
Return |
Detailed description
This is a helper function that takes the red, green and blue values form 0-255 and calls SetValue with the property name "color" and the argument the RGB value built from this calls arguments.
No check is made to see if the target Handle has a property called "color", and no error is returned if it does not.
Examples
Calling in a calculation
- Add to a calculation icon:
::Component.Property.SetColor(handle, red, green, blue)