LMMS
Loading...
Searching...
No Matches
Steinberg::IUpdateHandler Class Referenceabstract

#include <iupdatehandler.h>

Inheritance diagram for Steinberg::IUpdateHandler:
Steinberg::FUnknown Steinberg::UpdateHandler

Public Member Functions

virtual tresult PLUGIN_API addDependent (FUnknown *object, IDependent *dependent)=0
virtual tresult PLUGIN_API removeDependent (FUnknown *object, IDependent *dependent)=0
virtual tresult PLUGIN_API triggerUpdates (FUnknown *object, int32 message)=0
virtual tresult PLUGIN_API deferUpdates (FUnknown *object, int32 message)=0
Public Member Functions inherited from Steinberg::FUnknown
virtual tresult PLUGIN_API queryInterface (const TUID _iid, void **obj)=0
virtual uint32 PLUGIN_API addRef ()=0
virtual uint32 PLUGIN_API release ()=0

Static Public Attributes

static const FUID iid
Static Public Attributes inherited from Steinberg::FUnknown
static const FUID iid

Detailed Description

Host implements dependency handling for plugins.

  • [host imp]
  • [get this interface from IHostClasses]
  • [released N3.1]
  • Install/Remove change notifications
  • Trigger updates when an object has changed

Can be used between host-objects and the Plug-In or inside the Plug-In to handle internal updates!

See also
IDependent

Member Function Documentation

◆ addDependent()

virtual tresult PLUGIN_API Steinberg::IUpdateHandler::addDependent ( FUnknown * object,
IDependent * dependent )
pure virtual

Install update notification for given object. It is essential to remove all dependencies again using 'removeDependent'! Dependencies are not removed automatically when the 'object' is released!

Parameters
object: interface to object that sends change notifications
dependent: interface through which the update is passed

Implemented in Steinberg::UpdateHandler.

◆ deferUpdates()

virtual tresult PLUGIN_API Steinberg::IUpdateHandler::deferUpdates ( FUnknown * object,
int32 message )
pure virtual

Same as triggerUpdates, but delivered in idle (usefull to collect updates).

Implemented in Steinberg::UpdateHandler.

◆ removeDependent()

virtual tresult PLUGIN_API Steinberg::IUpdateHandler::removeDependent ( FUnknown * object,
IDependent * dependent )
pure virtual

Remove a previously installed dependency.

Implemented in Steinberg::UpdateHandler.

◆ triggerUpdates()

virtual tresult PLUGIN_API Steinberg::IUpdateHandler::triggerUpdates ( FUnknown * object,
int32 message )
pure virtual

Inform all dependents, that object has changed.

Parameters
objectis the object that has changed
messageis a value of enum IDependent::ChangeMessage, usually IDependent::kChanged - can be a private message as well (only known to sender and dependent)

Implemented in Steinberg::UpdateHandler.

Member Data Documentation

◆ iid

const FUID Steinberg::IUpdateHandler::iid
static

The documentation for this class was generated from the following file: