All Packages Class Hierarchy This Package Previous Next Index
Class quicktime.app.display.FullScreenWindow
java.lang.Object
|
+----java.awt.Component
|
+----java.awt.Container
|
+----java.awt.Window
|
+----quicktime.app.display.FullScreenWindow
- public class FullScreenWindow
- extends Window
This class is provided for usage when the screen is put into full screen mode.
The class manages a FullScreen object that will hide menu bars, task bars, etc.
thus making available the entire screen for an application to use. The FullScreenWindow
is the window which will fill that screen. As it is an extension of a java.awt.Window
any usage of this window is congruous with the usage of a Window in Java applications.
- See Also:
- FullScreen
-
doNotify
- This variable controls whether addNotify will actually call or fail - failing is silent.
-
FullScreenWindow()
- Creates a awt.Window for use in full screen mode.
-
FullScreenWindow(FullScreen)
- Creates a awt.Window for use in full screen mode.
-
FullScreenWindow(FullScreen, Frame)
- Creates a awt.Window for use in full screen mode.
-
addNotify()
- The addNotify method can only be successful in this class during or after the execution of the show method.
-
getFlags()
- Returns the flags that will be used when the screen is placed in full screen mode with the show method.
-
getFullScreen()
- This returns the FullScreen object that is used by the FullScreenWindow to
place the screen into full screen mode when the show method is called,
and to return the screen to normal mode when the hide method is called.
-
getGDevice()
- Returns the device that corresponds to the screen that will be placed in full screen mode with the show method.
-
getInsets()
- Returns insets of 0, 0, 0, 0 as a FullScreenWindow has no frame or border.
-
getPreferredSize()
- This returns a previously set value of the requested size of the FullScreenWindow.
-
hide()
- This method will return the specified screen to normal mode.
-
pack()
- For a full screen window pack can only be called after the window has been shown.
-
setFlags(int)
- Sets the flags that will be used when the screen is placed in full screen mode with the show method.
-
setGDevice(GDevice)
- Sets the device that corresponds to the screen that will be placed in full screen mode with the show method.
-
setPreferredSize(int, int)
- The application can set the requested size of the full screen when the screen is placed
into full screen mode.
-
show()
- This method is used to place the specified screen, at the specified resolution and flags, into full screen
mode.
doNotify
protected boolean doNotify
- This variable controls whether addNotify will actually call or fail - failing is silent.
The variable is set to true during the show method and is reset to false from the hide method
which also calls removeNotify to remove the native restrictions imposed by incompatible functionality
of native windowing usage in the Java VMs.
FullScreenWindow
public FullScreenWindow() throws QTException
- Creates a awt.Window for use in full screen mode. It will create the
FullScreen object which enables the screen to be placed into full screen mode
FullScreenWindow
public FullScreenWindow(FullScreen fs) throws QTException
- Creates a awt.Window for use in full screen mode. The application can pass in the
FullScreen object which enables the screen to be placed into full screen mode.
- Parameters:
- fs - the QuickTime FullScreen object
FullScreenWindow
public FullScreenWindow(FullScreen fs,
Frame f) throws QTException
- Creates a awt.Window for use in full screen mode. The application can pass in the
FullScreen object which enables the screen to be placed into full screen mode.
- Parameters:
- fs - the QuickTime FullScreen object
- f - the Frame that owns the Window object.
getFullScreen
public FullScreen getFullScreen()
- This returns the FullScreen object that is used by the FullScreenWindow to
place the screen into full screen mode when the show method is called,
and to return the screen to normal mode when the hide method is called.
Whilst the application can use this object for preflighting screen size
no state is stored in the FullScreen object, so the application should interact
directly with the methods of this, the FullScreenWindow, class.
- Returns:
- a FullScreen object
getPreferredSize
public Dimension getPreferredSize()
- This returns a previously set value of the requested size of the FullScreenWindow.
It may return a width and height of 0, 0 if no previous size has been requested.
In this case the current display size of the screen is used when the screen is
placed into full screen mode.
- Returns:
- the currently requested size for full screen display
- Overrides:
- getPreferredSize in class Container
setPreferredSize
public void setPreferredSize(int width,
int height)
- The application can set the requested size of the full screen when the screen is placed
into full screen mode. This method does not establish if the resolution requested is available,
it will only request that size when the show method is called. To see if a requested size
is available the application should get the FullScreen object from this class (getFullScreen) and
call a preflightSize method. The result of the preflightSize method tells you the closest size
that the desired screen can be placed in from your requested size.
- Parameters:
- width - the requested width or 0 to leave the screen at its current resolution when full screen
mode is activated with the show method.
- height - the requested height or 0 to leave the screen at its current resolution when full screen
mode is activated with the show method.
getFlags
public int getFlags()
- Returns the flags that will be used when the screen is placed in full screen mode with the show method.
- Returns:
- the full screen flags
setFlags
public void setFlags(int flags)
- Sets the flags that will be used when the screen is placed in full screen mode with the show method.
- Parameters:
- flags - the full screen flags
setGDevice
public void setGDevice(GDevice gDevice)
- Sets the device that corresponds to the screen that will be placed in full screen mode with the show method.
- Parameters:
- gDevice - the gDevice of a screen of null to set the main screen
getGDevice
public GDevice getGDevice()
- Returns the device that corresponds to the screen that will be placed in full screen mode with the show method.
- Returns:
- the gDevice of a screen of null
show
public void show()
- This method is used to place the specified screen, at the specified resolution and flags, into full screen
mode. It then resizes and positions the FullScreenWindow object so that the content region of this Window
takes up the entire screen. It then shows the FullScreenWindow object. On both MacOS and Win32 there are no
insets so the entire drawing surface from 0,0 to the width and height is available for display.
Due to the restrictions of the usage of addNotify() with this class, the pack() method is also called from
this method (as is toFront). Thus the method does multiple things:
- Puts the screen into full screen mode
- Sets the size of the window to the size of the screen
- call pack() to layout the window.
- shows the window and brings it to the front
It is the Applications responsibility to hide this window when done as the user has no direct way to hide
the window.
- Overrides:
- show in class Window
hide
public void hide()
- This method will return the specified screen to normal mode. It then hides the
window.
- Overrides:
- hide in class Component
addNotify
public void addNotify()
- The addNotify method can only be successful in this class during or after the execution of the show method.
The native Java VM's have peculiarities in windows positioning which are not compatible with
the requirement of the FullScreenWindow's purpose to fill the entire screen. An application should never need
to call this method directly - if it is called at an inappropriate time the call will silently fail.
- Overrides:
- addNotify in class Window
pack
public void pack()
- For a full screen window pack can only be called after the window has been shown.
The FullScreenWindow.show call will call pack to ensure that the contained components
are laid out correctly.
- Overrides:
- pack in class Window
getInsets
public Insets getInsets()
- Returns insets of 0, 0, 0, 0 as a FullScreenWindow has no frame or border.
- Returns:
- the insets of this container.
- Overrides:
- getInsets in class Container
All Packages Class Hierarchy This Package Previous Next Index