public class IShowWindowEvent extends IEvent
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 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 and Description |
---|
IShowWindowEvent(java.lang.String wrapped,
org.virtualbox_7_0.ObjectRefManager objMgr,
org.virtualbox_7_0.jaxws.VboxPortType port) |
Modifier and Type | Method and Description |
---|---|
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.
|
getSource, getType, getWaitable, setProcessed, waitProcessed
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote
public IShowWindowEvent(java.lang.String wrapped, org.virtualbox_7_0.ObjectRefManager objMgr, org.virtualbox_7_0.jaxws.VboxPortType port)
public java.lang.Long getWinId()
public void setWinId(java.lang.Long value)
value
- Longpublic static IShowWindowEvent queryInterface(IUnknown obj)