org.virtualbox_5_0
Class IShowWindowEvent
java.lang.Object
org.virtualbox_5_0.IUnknown
org.virtualbox_5_0.IEvent
org.virtualbox_5_0.IShowWindowEvent
public class IShowWindowEvent
- extends IEvent
Notification when a call toIMachine.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 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}
Constructor Summary |
IShowWindowEvent(java.lang.String wrapped,
org.virtualbox_5_0.jaxws.VboxPortType port)
|
Method Summary |
java.lang.Long |
getWinId()
Platform-dependent identifier of the top-level VM console
window, or zero if this method has performed all actions
necessary to implement theshow windowsemantics for
the given platform and/or this VirtualBox front-end. |
static IShowWindowEvent |
queryInterface(IUnknown obj)
|
void |
setWinId(java.lang.Long value)
Platform-dependent identifier of the top-level VM console
window, or zero if this method has performed all actions
necessary to implement theshow windowsemantics for
the given platform and/or this VirtualBox front-end. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
IShowWindowEvent
public IShowWindowEvent(java.lang.String wrapped,
org.virtualbox_5_0.jaxws.VboxPortType port)
getWinId
public java.lang.Long getWinId()
- Platform-dependent identifier of the top-level VM console
window, or zero if this method has performed all actions
necessary to implement theshow windowsemantics for
the given platform and/or this VirtualBox front-end.
- Returns:
- Long
setWinId
public void setWinId(java.lang.Long value)
- Platform-dependent identifier of the top-level VM console
window, or zero if this method has performed all actions
necessary to implement theshow windowsemantics for
the given platform and/or this VirtualBox front-end.
- Parameters:
value
- Long
queryInterface
public static IShowWindowEvent queryInterface(IUnknown obj)