CLC_ErrorCode Controller_SendTextValueWithAutomation	(	CPHOBJECT const	hController,
		CPCHAR8 const *const	utf8Value,
		CPBOOLEAN const	fWriteToEnd,
		CPBOOLEAN const	fTouch,
		PerformanceMessageAutomationStates const	state
	)

Send a value using the assigned message, specifying automation (only for controllers assigned to text parameter) The value is sent in proportional mode (see CPNS::ISelectorMessage::SetProportionalValue) if the assigned message.

Parameters

[in]	hController	Controller handle
[in]	utf8Value	the text value
[in]	fWriteToEnd	FALSE: Latch mode, TRUE: Write to End mode
[in]	fTouch	FALSE: No touch, TRUE: touch
[in]	state	see PerformanceMessageAutomationStates

Remarks

If some destination is not yet validated, the method returns ERR_SentToNotYetValidatedDestination. The message delivery is not guaranteed for those destinations.

Returns

Standard CHAILink Client return code. See CLC_ErrorCode enumeration.

Warning

This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.