Accessors for class IlvGadgetContainer

Properties

allowFocus
autoResize

Methods

getFocus
getGrab
removeGrab
setFocus
setGrab

Description

IlvGadgetContainer is a predefined subtype of the IlvContainer class for storing, displaying, and manipulating gadgets. It has special member functions that handle the input focus and the grabbing of an object (so that the object interactor attached to the grabbing object receives every event). This class also manages the attachments of objects to the container.
The input focus determines which gadget must receive keyboard events when the view gets the focus. The IlvGadgetContainer has a keyboard navigation mechanism allowing the end user to give the input focus to any gadget by cycling through the list of objects using the Tab key (and sometimes the arrow keys). The IlvGadgetContainer must decide which gadget will be the next to get the input focus at each step of keyboard navigation; the default algorithm is based on the geometry of the gadgets (from left to right and from top to bottom). The programmer can force the container to use a given order in keyboard navigation, that is, define its own focus chain.

Type Name Description Notes

Callback IlvGadgetContainer(String name, String title, IlvRect position, Boolean useacc = true, IlvAbstractView transientFor = 0) You can create an IlvGadgetContainer by specifying the name, the title and the position of the new panel. For example:

mypanel = new IlvGadgetContainer("panel", "My Panel", new IlvRect(16, 16, 600, 400));
If you set ussacc to true, the new panel uses the default accelerators of IlvGadgetContainer. The transientFor parameter is used to pass the parent of the new panel. If this parameter is omitted, a top level panel is created.
Once a new panel has been created, add it to Application by calling the addPanel method like this:

Application.addPanel(mypanel);
The name of each panel in an application must be unique.

Boolean allowFocus Sets the focus management.
Returns true if the gadget container allows the manipulation of the focus on the objects it stores. It returns false if the container does not handle the focus.

Boolean autoResize Gets or sets the sizing policy. If autoResize is true, the gadget container resizes itself when loading data containing size information. Otherwise, this container keeps its original dimensions.

Object getFocus() Returns the current object that has the focus in this container. This function returns null if there is no such object.

Object getGrab() Returns the object that is currently grabbing in this container. It returns NULL if there is no grabbing object in this container.

Void removeGrab() Removes any grab that has been set in this container.

Void setFocus(IlvGraphic object) Sets the focus to object. If the container has disallowed the focus mechanism, then this method has no effect.

Void setGrab(IlvGraphic object) Sets the grab on the graphic object. Every event will be sent to this object.

Type	Name	Description
`Callback`	`IlvGadgetContainer(String name, String title, IlvRect position, Boolean useacc = true, IlvAbstractView transientFor = 0)`	You can create an `IlvGadgetContainer` by specifying the `name`, the `title` and the `position` of the new panel. For example: mypanel = new IlvGadgetContainer("panel", "My Panel", new IlvRect(16, 16, 600, 400)); If you set `ussacc` to `true`, the new panel uses the default accelerators of `IlvGadgetContainer`. The `transientFor` parameter is used to pass the parent of the new panel. If this parameter is omitted, a top level panel is created. Once a new panel has been created, add it to `Application` by calling the `addPanel` method like this: Application.addPanel(mypanel); The name of each panel in an application must be unique.
`Boolean`	`allowFocus`	Sets the focus management. Returns `true` if the gadget container allows the manipulation of the focus on the objects it stores. It returns `false` if the container does not handle the focus.
`Boolean`	`autoResize`	Gets or sets the sizing policy. If `autoResize` is `true`, the gadget container resizes itself when loading data containing size information. Otherwise, this container keeps its original dimensions.
`Object`	`getFocus()`	Returns the current object that has the focus in this container. This function returns `null` if there is no such object.
`Object`	`getGrab()`	Returns the object that is currently grabbing in this container. It returns `NULL` if there is no grabbing object in this container.
`Void`	`removeGrab()`	Removes any grab that has been set in this container.
`Void`	`setFocus(IlvGraphic object)`	Sets the focus to `object`. If the container has disallowed the focus mechanism, then this method has no effect.
`Void`	`setGrab(IlvGraphic object)`	Sets the grab on the graphic object. Every event will be sent to this object.