Component: Simulation Switch Template (Controls)

Author	Matrix Ltd
Version	1.3
Category	Controls

Simulation Switch Template component

A base for building switches that do not download to chip. Mouse interaction can send 'System.User' events with the following data... ID = The handle of the switch component sending the message Message = 1 (on) or 0 (off) Current state can also be read via simulation macros.

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Downloadable macro reference

	GetState
Read the current state of the switch. Returns BOOL true when the switch is on, or BOOL false when off.
[[File:]] -	Return

	SetState
Sets the current state of the switch. BOOL true when the switch is on, or BOOL false when off.
[[File:]] -	SwitchState
Sets the state of the switch
- VOID	Return

	SetDutyCycle
Sets the PWM duty cycle in terms of on/off based on the current period setting. E.g. if period = 255 then duty of 128 is equal to 50% on and 50% off. 16-bit PIC users should use the 10bit duty function to access the full range.
- BYTE	Duty
8-bit PWM duty 0-255
- VOID	Return

	Enable
Enables a PWM channel as an output overriding the default output pin state.
- VOID	Return

	SetFrequency
Sets a PWM of the specifed frequency at a duty of 50% Ideal use is a frequency generator
- ULONG	Frequency
Enter frequency in Hz
- VOID	Return

	SetDutyCycle10Bit
PIC/AVR - Sets the full scale PWM duty cycle based on the current period setting. If period = 255 then Duty of 512 is equal to 50%. 16-bit PICs have a 16-bit period range available. If period = 65535 then Duty of 32768 is equal to 50%.
- UINT	Duty
PWM duty PIC/AVR: 0-1023 16-bit PIC: 0-65535
- VOID	Return

Property reference

	Properties
	Operation
Latching = Mouse click to turn on, click again to turn off. Momentary = Mouse click to turn on, release to turn off.
	Send Event
Determine when the component will send a User event to its parent. On Change - Whenever the switch state changes. On Click - Only when the mouse clicks the object. On Release - Only when the mouse is released over the object. Never - No events.
	Moving part
Handle of a panel object that will be the moving part of the switch.
	Pivot object
Object around which the moving part will rotate when rotation is selected as the movement tyoe.
	Type
Set whether the moving part will move linearly or by rotation.
	Axis
Axis along which the moving part will move (for push/slide) or around which it will rotate (rotary).
	Movement
Distance or angle by which the mioving part will move.
	Show
Decide what label to show... None - no labels are displayed Name - shows the component's name Property - shows a property value of the component (a field for the property name will appear below)
	Startup State
Default state of the indicator when loading the project or starting the simulation runtime.
	Connections
	Simulations