org.gnome.gtk
Class EventBox

Object
  org.freedesktop.bindings.Pointer
      org.freedesktop.bindings.Proxy
          org.gnome.glib.Object
              org.gnome.gtk.Object
                  org.gnome.gtk.Widget
                      org.gnome.gtk.Container
                          org.gnome.gtk.Bin
                              org.gnome.gtk.EventBox

public class EventBox
extends Bin

Add the ability for a Widget to accept events. A fair number of Widgets do not have the ability to process events coming from the user because, under ordinary circumstances, they don't need it. If you want a Label or Image to take keystrokes or mouse clicks, then you instantiate an EventBox and pack your Widget into it.

Quite a number of Widgets share underlying resources. That's not something you normally need to worry about as a developer, but if you have called getWindow() and find yourself needing an underlying [org.gnome.gdk] Window specifically for your Widget, then use an EventBox.

EventBoxes can also be used for things like painting a different background colour behind an otherwise transparent Widget.

Since:

4.0.6

Author:

Andrew Cowie

Nested Class Summary

Nested classes/interfaces inherited from class org.gnome.gtk.Widget

Widget.ButtonPressEvent, Widget.ButtonReleaseEvent, Widget.EnterNotifyEvent, Widget.ExposeEvent, Widget.FocusInEvent, Widget.FocusOutEvent, Widget.Hide, Widget.KeyPressEvent, Widget.KeyReleaseEvent, Widget.LeaveNotifyEvent, Widget.MapEvent, Widget.MotionNotifyEvent, Widget.PopupMenu, Widget.ScrollEvent, Widget.UnmapEvent, Widget.VisibilityNotifyEvent

Constructor Summary

EventBox()
Create a new EventBox.

Method Summary

void	setAboveChild(boolean setting) Whether the EventBox should be "above" its child or not.
void	setVisibleWindow(boolean setting) Whether the EventBox will have a "visible" child.

Methods inherited from class org.gnome.gtk.Bin

getChild

Methods inherited from class org.gnome.gtk.Container

add, getChildren, remove, setBorderWidth

Methods inherited from class org.gnome.gtk.Widget

activate, addEvents, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, getAllocation, getCanDefault, getCanFocus, getHasFocus, getName, getParent, getRequisition, getToplevel, getWindow, grabAdd, grabDefault, grabFocus, grabRemove, hide, modifyBackground, modifyBase, modifyFont, modifyText, queueDraw, queueDrawArea, setCanDefault, setCanFocus, setColormap, setEvents, setName, setSensitive, setSizeRequest, setTooltipMarkup, setTooltipText, show, showAll

Methods inherited from class org.freedesktop.bindings.Pointer

toString

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

EventBox

public EventBox()

Create a new EventBox. Be sure to call setAboveChild() and setVisibleWindow() if necessary.

Since:

4.0.6

Method Detail

setAboveChild

public void setAboveChild(boolean setting)

Whether the EventBox should be "above" its child or not. If above, the EventBox will receive all the events targeted at the child. If below, then the events will first go to the child and then to the EventBox. The default is false which is usually what you want (ie, you don't want to mess with existing functionality in a Widget, just add to it).

Since:

4.0.6

setVisibleWindow

public void setVisibleWindow(boolean setting)

Whether the EventBox will have a "visible" child. The default is true; ordinarily you want the child Widget to be displayed normally.

Since:

4.0.6