Caplin Trader 5.1.0

Class: module:ct-element/renderer/MultiStreamRenderer

module:ct-element/renderer/MultiStreamRenderer()

new module:ct-element/renderer/MultiStreamRenderer()

A multi stream renderer.

Extends:

Extends

Methods

addRendererEventListener(rendererEventListener)

Adds a module:ct-element/RendererEventListener to which the Renderer will communicates user-gestures.

Parameters:
Name Type Description
rendererEventListener module:ct-element/RendererEventListener

The renderer event listener.
Overrides:

bind(controlElement)

Binds the renderer to the DOM and attaches any event listeners to the control.

Parameters:
Name Type Description
controlElement HTMLElement

The DOM element representing the renderer
Overrides:
See:

bindHandlers()

Binds event listeners to the control for all the handlers, which will result in a callbacks to the onRendererEvent() method then any event occurs.

Inherited From:

clear()

Clears the renderer value and all associated state, including the displayed value. The renderer will remain bound to the DOM.

Overrides:

clearState()

Clears the renderer state without clearing the displayed value. This is a performant version of clear for when you are going to update the displayed value immediately after clearing.

Overrides:

createHtml(fieldValues, className) → {HtmlElement|DocumentFragment}

Returns an HTMLElement (or DocumentFragment) that defines this element.

This is the first of two steps required to bind a renderer to its corresponding HTML element. In fact, there are two ways of binding a renderer:

  1. The simplest way is to use the module:ct-element/RendererFramework#getElement helper method — this invokes createHtml() and module:ct-element/RendererFramework#bind on your behalf.
  2. A more performant mechanism for components that contain large numbers of renderers is to use invoke module:ct-element/RendererFramework#createHtml and module:ct-element/RendererFramework#bind yourself, so that the entire DOM strucutre for all renderers can be created using a single use call to appendChild, allowing significant performance gains to be achieved.

This method must be called after the FieldModel has been set using FieldModel.setFieldModel(). If the FieldModel is populated with some initial data for this renderer, then the HTML fragment returned will also contain that value, obviating the need for an call to module:ct-element/Renderer#setValue afterwards.

Parameters:
Name Type Description
fieldValues Map

The field values
className string

The HTML class attribute (a space separated list)
Overrides:
See:
Returns:

The HTML fragment.

Type
HtmlElement | DocumentFragment

disable()

Disables the renderer control. Does nothing if the control has no concept of enabled/disabled.

Overrides:

enable()

Enables the renderer control. Does nothing if the control has no concept of enabled/disabled.

Overrides:

finalize()

Releases any renderer resources and resets its state.

Overrides:

focus()

Moves the focus to this renderer. Does nothing if the control has no concept of focus.

Overrides:

getAllFieldNames() → {Array}

Returns a complete list of all field names that the renderer depends on.

Overrides:
Returns:

The field names.

Type
Array

getControl() → {module:ct-control/Control}

Returns a control corresponding to the renderer.

Inherited From:
Returns:

The control

Type
module:ct-control/Control

getElement() → {Element}

Returns the element that this renderer is associated with.

If the renderer binding was not performed manually using module:ct-element/RendererFramework#createHtml and module:ct-element/RendererFramework#bind, then this helper method will do this automatically on your behalf.

Overrides:
See:
Returns:

The element associated with this renderer.

Type
Element

getFieldValues() → {Map}

Returns the fields relating to the currently displayed value.

Overrides:
Returns:

The field values.

Type
Map

getFormattedValue() → {Variant}

Returns the formatted downstream value.

Overrides:
Returns:

The formatted downstream value.

Type
Variant

getName() → {string}

Returns the renderer name.

This is set by the framework that instantiates the Renderer (e.g. the grid) and represents the field context (e.g. "Bid Price").

Overrides:
Returns:

The renderer's name.

Type
string

getNamespace() → {string}

Returns the renderer namespace.

This is set by the framework that instantiates the Renderer (e.g. the grid) and represents the record context (e.g. "/FX/GBPUSD").

Overrides:
Returns:

The renderer's namespace.

Type
string

getParsedValue() → {Variant}

Returns the parsed upstream value.

Overrides:
Returns:

The parsed upstream value.

Type
Variant

getPrimaryFieldNames() → {Array.<string>}

Returns a list of primary fields.

Overrides:
Returns:

The field names.

Type
Array.<string>

getSerialId() → {string}

Returns the serial id of the renderer instance.

Overrides:
Returns:

The renderer serial id.

Type
string

getUnformattedValue() → {Variant}

Returns the unformatted downstream value.

Overrides:
Returns:

The unformatted downstream value.

Type
Variant

getUnparsedValue() → {Variant}

Returns the unparsed upstream value.

Overrides:
Returns:

The unparsed upstream value.

Type
Variant

getValue()

Gets the renderer value.

Overrides:
Returns:

vRendererValue The renderer value.

getVariable(variableName) → {String}

Gets the renderer's variable.

Parameters:
Name Type Description
variableName String

The variable name to retrieve.
Inherited From:
Returns:

The variable value

Type
String

initialize(initialFieldValues)

Initializes the renderer and sets its state according to the supplied field values.

Parameters:
Name Type Description
initialFieldValues Map

The initial field values
Overrides:

isBound() → {boolean}

Returns true if the renderer has been bound to the DOM.

Overrides:
See:
Returns:

True if the renderer has been bound to the DOM, or false otherwise.

Type
boolean

isEnabled() → {boolean}

Determines whether the control is enabled.

Inherited From:
Returns:

if the control is enabled.

Type
boolean

onRendererEvent(domEvent)

Event handler callback function that receives the events attached to the controls and defined in the handlers.

All control events call this function.

Parameters:
Name Type Description
domEvent object

The DOM event that was fired
Inherited From:

raiseEvent(sType, mRendererEvent)

Raises a renderer event.

Parameters:
Name Type Description
sType string

The renderer event type.
mRendererEvent Map

The renderer event to raise.
Overrides:

refresh()

Apply all pending updates

Overrides:

removeRendererEventListener(rendererEventListener)

Removes a module:ct-element/RendererEventListener to which the Renderer will communicate user-gestures.

Parameters:
Name Type Description
rendererEventListener module:ct-element/RendererEventListener

The renderer event listener.
Overrides:

resetUnformattedStreamValue()

Creates a null value for this renderer type

Overrides:

select()

Moves the focus and highlights this renderer. Does nothing if the control has no concept of focus.

Overrides:

setName(name)

Sets the renderer's name.

Parameters:
Name Type Description
name string

The renderer's name.
Overrides:

setNamespace(namespace)

Sets the renderer's namespace.

Parameters:
Name Type Description
namespace string

The renderer's namespace.
Overrides:

setSerialId(serialId)

Sets the serial id.

Parameters:
Name Type Description
serialId int

The serial id
Inherited From:

setValue(vRendererValue)

Sets the renderer value.

Parameters:
Name Type Description
vRendererValue Variant

The renderer value.
Overrides:

toString() → {string}

Returns a human-readable string representation of the object, which is useful for debugging.

Overrides:
Returns:

The string representation

Type
string

unbind()

Unbinds the renderer from the DOM and detaches any event listeners to the control.

Overrides:
See:

unbindHandlers()

Unbinds event listeners from the control for all the handlers.

Inherited From:

updateFields(fieldValues)

Updates the renderer with the supplied fields. The field values will be reflected in the control on the next call to {module:ct-element/Renderer#refresh}.

The Renderer might depend on these fields either because it has been bound to them in the constructor, or if the XML renderer definition refers to these fields using the ${} notation.

Additional field values can be supplied and they will have no effect on the displayed value, but they will be returned by {module:ct-element/Renderer#getFieldValues}. This can exploited to hold additional information about the value (such as price ID or timestamp).

Parameters:
Name Type Description
fieldValues Map

the new field values.
Overrides:

updateFieldValues(fieldValues)

Updates the field values.

Parameters:
Name Type Description
fieldValues Map

The field values.
Inherited From:

updateStreamValues(fieldValues)

Parameters:
Name Type Description
fieldValues Map
Overrides: