a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 commodities.library
  ActivateCxObj
  AddIEvents
  AttachCxObj
  ClearCxObjError
  CreateCxObj
  CxBroker
  CxMsgData
  CxMsgID
  CxMsgType
  CxObjError
  CxObjType
  DeleteCxObj
  DeleteCxObjAll
  DisposeCxMsg
  DivertCxMsg
  EnqueueCxObj
  InsertCxObj
  InvertKeyMap
  MatchIX
  ParseIX
  RemoveCxObj
  RouteCxMsg
  SetCxObjPri
  SetFilter
  SetFilterIX
  SetTranslate
Include
GuruMeditation
Docs » Autodocs » commodities.library » SetTranslate

NAME

	SetTranslate -- replace a translator object's translation list. (V36)

SYNOPSIS

	SetTranslate(translator,events);
		     A0         A1
	VOID SetTranslate(CxObj *,struct InputEvent *);

FUNCTION

	This function replaces the translation list of a commodity
	translator object with the linked list starting at 'events'.
	A NULL value for 'events' indicates that the object 'translator'
	should swallow all commodity messages that are sent its way.
	Note that the input events are not copied into commodities' private
	memory, but the value of 'events' is used -- asynchronously to the
	application program -- to find a chain of InputEvents in the
	application's data space. At the time of translation, each input event
	is copied into its own new commodity message.
	The above means that no other commodities' user, nor
	commodities.library itself will be modifying your list of InputEvents.
	On the other hand, your program must not corrupt the input event
	chain that has been presented to a translator.

INPUTS

	translator - the translator object to affect (may be NULL)
	events - the new input event translation list

BUGS

	The list of input events manipulated by a translator object is
	inserted in reverse order in the commodities network, and come out
	of the network in reverse order as well. The cx_lib/InvertString()
	function creates lists of input events that are in reverse order so
	they can be used directly with translator objects.

SEE ALSO

<devices/inputevent.h>, cx_lib/CxTranslate

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Phenomena

SPB
PDX
ANA
PHA

Comments:
$VER: d0.se 1.14 Copyright © 2011-2025 Tobias Geijersson support at d0 dot se