Meeting SDK for Windows API Reference
Loading...
Searching...
No Matches
IMeetingWhiteboardController Class Referenceabstract

Whiteboard controller interface. More...

#include <meeting_whiteboard_ctrl_interface.h>

Public Member Functions

virtual SDKError SetEvent (IMeetingWhiteboardCtrlEvent *pEvent)=0
 Configure the meeting whiteboard controller callback event handler.
 
virtual SDKError SetOwnerWindow (HWND hOwner)=0
 Set the whiteboard web view and dashboard web view owner window.
 
virtual bool IsSupportWhiteBoard ()=0
 
virtual bool CanStartShareWhiteboard (CannotShareReasonType &reason)=0
 Determine whether the current meeting can start sharing the whiteboard.
 
virtual SDKError ShowDashboardView (int x=-1, int y=-1)=0
 Show the dashboard web view window.
 
virtual SDKError SetDashboardViewSize (int width=-1, int height=-1)=0
 Set the dashboard web view window size.
 
virtual SDKError SetWhiteboardViewPos (int x=-1, int y=-1)=0
 Set the whiteboard web view window position.
 
virtual SDKError SetWhiteboardViewSize (int width=-1, int height=-1)=0
 Set the whiteboard web view window size.
 
virtual SDKError SetWhiteboardShareOption (SDKWhiteboardShareOption option)=0
 Set the option for who can share a whiteboard.
 
virtual SDKError GetWhiteboardShareOption (SDKWhiteboardShareOption &option)=0
 Get the option for who can share a whiteboard.
 
virtual SDKError SetWhiteboardCreateOption (SDKWhiteboardCreateOption option)=0
 Set the option for who can initiate a new whiteboard.
 
virtual SDKError GetWhiteboardCreateOption (SDKWhiteboardCreateOption &option)=0
 Get the option for who can initiate a new whiteboard.
 
virtual SDKError EnableParticipantsCreateWithoutHost (bool bEnable)=0
 Enable the participants to create a new whiteboard without the host in the meeting.
 
virtual bool IsParticipantsCreateWithoutHostEnabled ()=0
 
virtual bool IsOtherSharingWhiteboard ()=0
 Query if other user is sharing whiteboard.
 
virtual bool IsSharingWhiteboardOut ()=0
 Query if the current user is sharing whiteboard successfully.
 

Detailed Description

Whiteboard controller interface.

Definition at line 57 of file meeting_whiteboard_ctrl_interface.h.

Member Function Documentation

◆ CanStartShareWhiteboard()

virtual bool IMeetingWhiteboardController::CanStartShareWhiteboard ( CannotShareReasonType & reason)
pure virtual

Determine whether the current meeting can start sharing the whiteboard.

Parameters
[out]reasonThe reason that no one can start sharing the whiteboard. See CannotShareReasonType enum.
Returns
True indicates you can start sharing the whiteboard.

◆ EnableParticipantsCreateWithoutHost()

virtual SDKError IMeetingWhiteboardController::EnableParticipantsCreateWithoutHost ( bool bEnable)
pure virtual

Enable the participants to create a new whiteboard without the host in the meeting.

Parameters
bEnableTRUE indicates to enable. FALSE not.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.

◆ GetWhiteboardCreateOption()

virtual SDKError IMeetingWhiteboardController::GetWhiteboardCreateOption ( SDKWhiteboardCreateOption & option)
pure virtual

Get the option for who can initiate a new whiteboard.

Parameters
[out]optionSetting option for who can initiate a new whiteboard, see SDKWhiteboardCreateOption enum.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.

◆ GetWhiteboardShareOption()

virtual SDKError IMeetingWhiteboardController::GetWhiteboardShareOption ( SDKWhiteboardShareOption & option)
pure virtual

Get the option for who can share a whiteboard.

Parameters
[out]optionSetting option for who can share a whiteboard, see SDKWhiteboardShareOption enum.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.

◆ IsOtherSharingWhiteboard()

virtual bool IMeetingWhiteboardController::IsOtherSharingWhiteboard ( )
pure virtual

Query if other user is sharing whiteboard.

Returns
True means other user is sharing. False means not.

◆ IsParticipantsCreateWithoutHostEnabled()

virtual bool IMeetingWhiteboardController::IsParticipantsCreateWithoutHostEnabled ( )
pure virtual
Returns
True indicates that they have these permission.

◆ IsSharingWhiteboardOut()

virtual bool IMeetingWhiteboardController::IsSharingWhiteboardOut ( )
pure virtual

Query if the current user is sharing whiteboard successfully.

Returns
True means the current user is sharing successfully. False means not.

◆ IsSupportWhiteBoard()

virtual bool IMeetingWhiteboardController::IsSupportWhiteBoard ( )
pure virtual
Returns
True indicates to support.

◆ SetDashboardViewSize()

virtual SDKError IMeetingWhiteboardController::SetDashboardViewSize ( int width = -1,
int height = -1 )
pure virtual

Set the dashboard web view window size.

Parameters
heightSpecify the height of the window.
widthSpecify the width of the window.
Remarks
If height == -1 and width == -1, the window size will be default.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.
Remarks
Valid only for custom user interface mode.

◆ SetEvent()

virtual SDKError IMeetingWhiteboardController::SetEvent ( IMeetingWhiteboardCtrlEvent * pEvent)
pure virtual

Configure the meeting whiteboard controller callback event handler.

Parameters
pEventAn object pointer to the IMeetingWhiteboardControllerEvent that receives the meeting whiteboard callback event. For more details, see IMeetingWhiteboardControllerEvent.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.
Remarks
The SDK use pEvent to transmit the callback event to the user's application. If the function is not called or fails, the user's application is unable to retrieve the callback event.

◆ SetOwnerWindow()

virtual SDKError IMeetingWhiteboardController::SetOwnerWindow ( HWND hOwner)
pure virtual

Set the whiteboard web view and dashboard web view owner window.

Parameters
[in]hOwnerSpecify the owner window. If the hOwner is nullptr, the owner window will be desktop window. \Call this function before calling ShowDashboardView. Call this function when receiving the meeting status MEETING_STATUS_INMEETING. Otherwise, the dashboard web view owner window will be desktop window.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.
Remarks
Valid only for user custom interface mode.

◆ SetWhiteboardCreateOption()

virtual SDKError IMeetingWhiteboardController::SetWhiteboardCreateOption ( SDKWhiteboardCreateOption option)
pure virtual

Set the option for who can initiate a new whiteboard.

Parameters
[in]optionSetting option for who can initiate a new whiteboard, see SDKWhiteboardCreateOption enum.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.

◆ SetWhiteboardShareOption()

virtual SDKError IMeetingWhiteboardController::SetWhiteboardShareOption ( SDKWhiteboardShareOption option)
pure virtual

Set the option for who can share a whiteboard.

Parameters
[in]optionNew setting for who can share a whiteboard, see SDKWhiteboardShareOption enum.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.

◆ SetWhiteboardViewPos()

virtual SDKError IMeetingWhiteboardController::SetWhiteboardViewPos ( int x = -1,
int y = -1 )
pure virtual

Set the whiteboard web view window position.

Parameters
xThe horizontal coordinate value.
yThe vertical coordinate value.
Remarks
If x == -1 and y = -1, the window position will be in the center of the screen where the owner window is located.
If you don't call this function, the window position will be in the center of the screen where the owner window is located.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.
Remarks
Valid only for custom user interface mode.

◆ SetWhiteboardViewSize()

virtual SDKError IMeetingWhiteboardController::SetWhiteboardViewSize ( int width = -1,
int height = -1 )
pure virtual

Set the whiteboard web view window size.

Parameters
heightSpecify the height of the window.
widthSpecify the width of the window.
Remarks
If height == -1 and width == -1, the window size will be default.
If you don't call this function, the window size will be default.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.
Remarks
Valid only for custom user interface mode.

◆ ShowDashboardView()

virtual SDKError IMeetingWhiteboardController::ShowDashboardView ( int x = -1,
int y = -1 )
pure virtual

Show the dashboard web view window.

Parameters
xThe horizontal coordinate value.
yThe vertical coordinate value.
Remarks
If x == -1 and y = -1, the window position will be in the center of the screen where the owner window is located.
Returns
If the function succeeds, the return value is SDKErr_Success. Otherwise the function fails. To get extended error information, see SDKError enum.
Remarks
Valid only for custom user interface mode.