GUIScreenShot

A useful GUIKit function used within these pages is GUIScreenShot[obj], which provides a convenient way of generating a Mathematica Raster graphic of the current state of the runtime user interface. GUIObjects, any J/Link Java user interface object, interface expressions, or even string resource names of widget definitions can be arguments to the function. GUIScreenShot is useful for creating previews of a definition within a notebook, documenting changes during the runtime of an interface, and also as an easy way of exchanging and submitting bug and problem reports to others.

In[1]:=

In[2]:=

Out[2]=

In[3]:=

Out[3]=

When we pass a GUIObject in, the state of the interface is captured and left unchanged, but when passing in a widget definition expression, it is created, captured, and then closed assuming it is no longer needed.

In[4]:=

Out[4]=

In[5]:=

In[6]:=

Out[6]=

By default, if we give a widget to GUIScreenShot, it is asked to "paint" itself into the resulting image so we only get the widget requested without the underlying native window.

Note we can also request individual widgets in the GUIObject to capture.

In[7]:=

Out[7]=

Even though this is a GUIKit-defined function, GUIScreenShot works with any active user interface JavaObject produced by any J/Link code.

In[8]:=

Out[8]=

In[9]:=

Out[9]=

Finally, as a convenience, we can specify screen coordinates of the form {{xmin, xmax},{ymin, ymax}} to GUIScreenShot to use the "Grab" method and capture any rectangle of the current screen or no arguments that will attempt to grab the entire screen's contents.

In[10]:=

Out[10]=

In[4]:=