IPlugView Class Reference
[Graphical User Interface]

Plug-in definition of a view. More...

#include <iplugview.h>

Inheritance diagram for IPlugView:
Inheritance graph
[legend]

Public Member Functions

virtual tresult isPlatformTypeSupported (FIDString type)=0
 Is Platform UI Type supported.
virtual tresult attached (void *parent, FIDString type)=0
 The parent window of the view has been created, the (platform) representation of the view should now be created as well.
virtual tresult removed ()=0
 The parent window of the view is about to be destroyed.
virtual tresult onWheel (float distance)=0
 Handling of mouse wheel.
virtual tresult onKeyDown (char16 key, int16 keyCode, int16 modifiers)=0
 Handling of keyboard events : Key Down.
virtual tresult onKeyUp (char16 key, int16 keyCode, int16 modifiers)=0
 Handling of keyboard events : Key Up.
virtual tresult getSize (ViewRect *size)=0
 Returns the size of the platform representation of the view.
virtual tresult onSize (ViewRect *newSize)=0
 Resizes the platform representation of the view to the given rect.
virtual tresult onFocus (TBool state)=0
 Focus changed message.
virtual tresult setFrame (IPlugFrame *frame)=0
 Sets IPlugFrame object to allow the Plug-in to inform the host about resizing.
virtual tresult canResize ()=0
 Is view sizable by user.
virtual tresult checkSizeConstraint (ViewRect *rect)=0
 On live resize this is called to check if the view can be resized to the given rect, if not adjust the rect to the allowed size.

Static Public Attributes

static const FUID iid

Detailed Description

Plug-in definition of a view.

Sizing of a view
Usually the size of a Plug-in view is fixed. But both the host and the Plug-in can cause a view to be resized:

Please only resize the platform representation of the view when IPlugView::onSize() is called.
Keyboard handling
The Plug-in view receives keyboard events from the host. A view implementation must not handle keyboard events by the means of platform callbacks, but let the host pass them to the view. The host depends on a proper return value when IPlugView::onKeyDown is called, otherwise the Plug-in view may cause a disfunction of the host's key command handling!
See also:
IPlugFrame, Platform UI Types

Member Function Documentation

virtual tresult isPlatformTypeSupported ( FIDString  type  )  [pure virtual]

Is Platform UI Type supported.

Parameters:
type : IDString of Platform UI Types
virtual tresult attached ( void *  parent,
FIDString  type 
) [pure virtual]

The parent window of the view has been created, the (platform) representation of the view should now be created as well.

Note that the parent is owned by the caller and you are not allowed to alter it in any way other than adding your own views.

Parameters:
parent : platform handle of the parent window or view
type : Platform UI Types which should be created
virtual tresult removed (  )  [pure virtual]

The parent window of the view is about to be destroyed.

You have to remove all your own views from the parent window or view.

virtual tresult onWheel ( float  distance  )  [pure virtual]

Handling of mouse wheel.

virtual tresult onKeyDown ( char16  key,
int16  keyCode,
int16  modifiers 
) [pure virtual]

Handling of keyboard events : Key Down.

Parameters:
key : unicode code of key
keyCode : virtual keycode for non ascii keys - see VirtualKeyCodes in keycodes.h
modifiers : any combination of modifiers - see KeyModifier in keycodes.h
Returns:
kResultTrue if the key is handled, otherwise kResultFalse.
Please note that kResultTrue must only be returned if the key has really been handled. Otherwise key command handling of the host might be blocked!
virtual tresult onKeyUp ( char16  key,
int16  keyCode,
int16  modifiers 
) [pure virtual]

Handling of keyboard events : Key Up.

Parameters:
key : unicode code of key
keyCode : virtual keycode for non ascii keys - see VirtualKeyCodes in keycodes.h
modifiers : any combination of KeyModifier - see KeyModifier in keycodes.h
Returns:
kResultTrue if the key is handled, otherwise return kResultFalse.
virtual tresult getSize ( ViewRect size  )  [pure virtual]

Returns the size of the platform representation of the view.

virtual tresult onSize ( ViewRect newSize  )  [pure virtual]

Resizes the platform representation of the view to the given rect.

virtual tresult onFocus ( TBool  state  )  [pure virtual]

Focus changed message.

virtual tresult setFrame ( IPlugFrame frame  )  [pure virtual]

Sets IPlugFrame object to allow the Plug-in to inform the host about resizing.

virtual tresult canResize (  )  [pure virtual]

Is view sizable by user.

virtual tresult checkSizeConstraint ( ViewRect rect  )  [pure virtual]

On live resize this is called to check if the view can be resized to the given rect, if not adjust the rect to the allowed size.


Field Documentation

const FUID iid [static]

Reimplemented from FUnknown.

 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Defines
Empty

Copyright ©2013 Steinberg Media Technologies GmbH. All Rights Reserved.