VirtualBox Main API
Public Attributes | List of all members
IShowWindowEvent Interface Reference

Notification when a call to IMachine::showConsoleWindow requests the console window to be activated and brought to foreground on the desktop of the host PC. More...

Inheritance diagram for IShowWindowEvent:
IEvent

Public Attributes

attribute long long winId
 Platform-dependent identifier of the top-level VM console window, or zero if this method has performed all actions necessary to implement the show window semantics for the given platform and/or this VirtualBox front-end.
- Public Attributes inherited from IEvent
readonly attribute VBoxEventType type
 Event type.
readonly attribute IEventSource source
 Source of this event.
readonly attribute boolean waitable
 If we can wait for this event being processed.

Additional Inherited Members

- Public Member Functions inherited from IEvent
void setProcessed ()
 Internal method called by the system when all listeners of a particular event have called IEventSource::eventProcessed.
void waitProcessed (in long timeout,[retval] out boolean result)
 Wait until time outs, or this event is processed.

Detailed Description

Notification when a call to IMachine::showConsoleWindow requests the console window to be activated and brought to foreground on the desktop of the host PC.

  This notification should cause the VM console process to
  perform the requested action as described above. If it is
  impossible to do it at a time of this notification, this
  method should return a failure.

  Note that many modern window managers on many platforms
  implement some sort of focus stealing prevention logic, so
  that it may be impossible to activate a window without the
  help of the currently active application (which is supposedly
  an initiator of this notification). In this case, this method
  must return a non-zero identifier that represents the
  top-level window of the VM console process. The caller, if it
  represents a currently active process, is responsible to use
  this identifier (in a platform-dependent manner) to perform
  actual window activation.

  This method must set @a winId to zero if it has performed all
  actions necessary to complete the request and the console
  window is now active and in foreground, to indicate that no
  further action is required on the caller's side.
Interface ID:
{B0A0904D-2F05-4D28-855F-488F96BAD2B2}

Member Data Documentation

attribute long long IShowWindowEvent::winId

Platform-dependent identifier of the top-level VM console window, or zero if this method has performed all actions necessary to implement the show window semantics for the given platform and/or this VirtualBox front-end.