Editing setCtlTextv - FilterMeisterWiki

When saving, enter the following:

 ##   ##   ZZZZZ   TT   TT  __      __ ______  
 ##   ##  ZZ   Z   TT   TT  \ \    / /(  __  \ 
 ##   ##  ZZZ      TT   TT   \ \  / / | (  \  )
 ##   ##   ZZZZ    TT T TT    \ \/ /  | |   ) |
 ##   ##     ZZZ   TTTTTTT     \  /   | |   | |
 ##   ##  Z   ZZ   TTT TTT      \/    | |   ) |
  #####   ZZZZZ    TT   TT            | (__/  )
                                      (______/

Visit Preferences to set your user name

= setCtlTextv =

== Syntax ==
{{bool setCtlTextv(int ctlnum, string textv, ...)}}

== Arguments ==
:'''ctlnum'''
::The number of the control whose text you'd like to change.
:'''textv'''
::A string containing the formatted text you'd like the label text changed to.
:'''...'''
::Additional variables to substitute for the formatting symbols in '''textv'''

== Return ==
Returns false/zero if the text couldn't be set, true/non-zero otherwise.

== Description ==
Sets the text label for user control (with index number ''ctlnum'') to the expanded printf-style formatted string. Note that not all user controls support text strings. Also keep in mind that the user control has to be resized if your text string exceeds the current size. Substrings and escape sequences are allowed.

== Example ==
<code>
%ffp

ctl(10): STATICTEXT, pos=(*,60),fontcolor=red,size=(150,*)

ForEveryTile:{

const int startclock = clock();
	int endclock;

for (y=y_start; y<y_end; y++) {
	for (x=x_start; x<x_end; x++) {

// Effect code goes here

}}

endclock = clock() - startclock;
	setCtlTextv(10, "Render time needed: %d %s", endclock, "ms");

return true;
}
</code>

== See Also ==
((setCtlText))

== Comments ==
Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.

Summary of change:
Add document to category: