Scrigroup - Documente si articole

Username / Parola inexistente      

Home Documente Upload Resurse Alte limbi doc  
AccessAdobe photoshopAlgoritmiAutocadBaze de dateCC sharp
CalculatoareCorel drawDot netExcelFox proFrontpageHardware
HtmlInternetJavaLinuxMatlabMs dosPascal
PhpPower pointRetele calculatoareSqlTutorialsWebdesignWindows
WordXml

AspAutocadCDot netExcelFox proHtmlJava
LinuxMathcadPhotoshopPhpSqlVisual studioWindowsXml

AWT Peer Interfaces

java



+ Font mai mare | - Font mai mic



AWT Peer Interfaces

This chapter introduces the concepts behind the peer interfaces of the Java Abstract Windowing Toolkit (AWT). As a Java application developer you will never need to use any of the peer classes. The interfaces described in this chapter will be of interest mainly to programmers who are porting the Java Development Kit (JDK) to a new operating system. This introduction gives you an insight into the object-oriented design of the peer interfaces and describes how they help reduce the effort needed to port the Java AWT to another operating system.



The individual characteristics of the graphics toolkits supported on different operating systems make the task of implementing a portable windowing toolkit difficult. Separating the user's perspective on the windowing abstraction from the operating system's perspective poses a problem that involves a lot of programming effort when moving the toolkit from one platform to another. If the actual implementation of the toolkit is decoupled from the user's perspective, then porting the toolkit as a whole is a lot simpler, as only the implementation module has to be changed to support the new operating system platform. The peer interfaces of the Java AWT do exactly that. They decouple the abstractions of the AWT classes (such as Button, List, Label, and so on) from their implementation on a specific windowing platform (such as the Windows95 operating system or the Motif windowing toolkit available on Unix systems).

The appearance of a graphical user interface component differs from toolkit to toolkit. The common problem faced with developing applications using the windowing toolkits available today is that the user has to relearn the look and feel of the graphical components when the application is run on a different platform. The Java design team designed the AWT in such a way that the graphical components would preserve the look-and-feel of the underlying operating system's native windowing toolkit. This is one reason why Java has been accepted as a language for cross-platform application development.

Figure 9-1 shows two views of a Java application that includes a label, a button, and a checkbox. The window on the left shows the application running on the Windows95 operating system and the one on the right shows the same application running on the Solaris operating system (using the Motif windowing toolkit).


Figure 9-1  The same AWT application running on Windows95 and on Solaris (Motif windowing toolkit)

The GUI-specific code is encapsulated in the classes that implement the peer interface. These peer classes serve as the interface between the AWT classes such as Component, Button, Label, Container, and so on, and the underlying operating system's graphics primitives. The AWT classes do not communicate directly with the native windowing toolkit. They create a peer object that serves as a channel of communication between the AWT class and the native windowing toolkit. Each instance of a class (such as Button) is associated with an instance of the corresponding peer class (such as ButtonPeer). In order to port the Java AWT to a windowing toolkit, only the peer interfaces have to be implemented. The higher level of abstraction such as the Component, Button, or List class need not change at all. Figure 9-2 shows where the peer interfaces fit into the overall Java AWT model.


Figure 9-2  The role of peers in the AWT system model

Each of the peer interfaces described in this chapter has to be implemented to create a GUI-dependent class that performs the task required of the peer. The code for these methods is written in the C language, using the graphics primitives of the native windowing toolkit. Chapter 3 on the Toolkit class and Appendix C on writing native code for Java, provide more information regarding the specifics of implementing native code for a target windowing system.

Due to the licensing issues involved with modifying the source code of the Java Development Kit, this chapter does not contain a project implementation and there are no example entries for individual interfaces or methods. Here is a checklist of the things you have to do in order to extend the peer interfaces described in this chapter to support a target native windowing toolkit.

1.  Contact Sun Microsystems with regard to licensing the source code of the Java Development Kit.

2.  Identify the graphics primitives used in the target operating system.

3.  Implement each of the peer interfaces described in this chapter, using the native methods of the target windowing system. The implementations for the windowing toolkits already supported (Motif, WindowsNT, and Windows95) will help you understand exactly what needs to be done.

4.  Extend the java.awt.Toolkit class to create a GUI-dependent class for the target windowing system. This class will include methods to create each of the peer classes implemented in Step 3.

5.  Compile and install the classes in the appropriate directories.

The Java language is growing in popularity as the language of choice for cross-platform application development. When porting the Java Development Kit to a new operating system or to a new windowing system, the peer interfaces have to be ported to conform to the application programming interface of the target system. The AWT Peer interfaces clearly separate the platform dependent (physical) abstractions of the windowing toolkit from the user-interface (logical ) abstractions, thus making the job easier for developers who are porting Java.

AWT Peer Interface Summaries

Table 9-1 summarizes the interfaces described in this chapter. The rest of the chapter presents the detailed descriptions of the methods defined in each of the interfaces.

Table 9-1 AWT Peer interface descriptions


Interface

Description


ComponentPeer

This interface defines the API between the Component class and the underlying operating system GUI primitives used for querying and modifying the properties associated with an AWT component.

ButtonPeer

This interface defines the API between the Button class and the underlying operating system GUI primitives used with button objects

CanvasPeer

This interface defines the API between the Canvas class and the underlying operating system GUI primitives used with general-purpose canvas objects.

CheckboxPeer

This interface defines the API between the Checkbox class and the underlying operating system GUI primitives used with checkbox objects.

ChoicePeer

This interface defines the API between the Choice class and the underlying operating system GUI primitives used for creating and interacting with pop-up menu objects.

LabelPeer

This interface defines the API between the Label class and the underlying operating system GUI primitives used for creating and interacting with simple label objects that display a noneditable text string.

ListPeer

This interface defines the API between the List class and the underlying operating system GUI primitives used for creating and interacting with graphical objects that contain a scrolling list of text strings.

ScrollbarPeer

This interface defines the API between the Scrollbar class and the underlying operating system GUI primitives used for creating and interacting with scrollbar objects.

ContainerPeer

This interface defines the API between the Container class and the underlying operating system GUI primitives used for creating and interacting with graphical objects that can contain other graphical objects.

PanelPeer

This interface defines the API between the Panel class and the underlying operating system GUI primitives used for creating and interacting with panel objects.

WindowPeer

This interface defines the API between the Window class and the underlying operating system GUI primitives used for creating and interacting with top-level windows that have neither a title bar nor a border.

DialogPeer

This interface defines the API between the Dialog class and the underlying operating system GUI primitives used for creating and interacting with dialog box objects.

FileDialogPeer

This interface defines the API between the FileDialog class and the underlying operating system GUI primitives used for creating and interacting with dialog box objects that display a list of files and allow the user to select from the list.

FramePeer

This interface defines the API between the Frame class and the underlying operating system GUI primitives used for creating and interacting with top-level frame windows that have a title bar and borders and can optionally have a menu bar.

MenuComponentPeer

This interface defines the API between the MenuComponent class and the underlying operating system GUI primitives used for creating and interacting with menu objects.

MenuBarPeer

This interface defines the API between the MenuBar class and the underlying operating system GUI primitives used for creating and interacting with menu bar objects.

MenuItemPeer

This interface defines the API between the MenuItem class and the underlying operating system GUI primitives used for creating and interacting with menu item objects.

CheckboxMenuItemPeer

This interface defines the API between the CheckboxMenuItem class and the underlying GUI primitives used for creating and interacting with checkboxes that can be used as menu item objects.

MenuPeer

This interface defines the API between the Menu class and the underlying GUI primitives that can be components of a menu bar.

TextComponentPeer

This interface defines the API between the TextComponent class and the underlying operating system GUI primitives used for creating graphical objects in which text can be edited.

TextAreaPeer

This interface defines the API between the TextArea class and the underlying operating system GUI primitives used for displaying and editing multiple lines of text.

TextFieldPeer

This interface defines the API between the TextField class and the underlying operating system GUI primitives used for creating graphical objects that allow editing of a single line of text.

ComponentPeer

Purpose

This interface defines the API between the Component class and the underlying operating system GUI primitives used for querying and modifying the properties associated with an AWT component.

Syntax

public interface ComponentPeer extends Object

Description

This interface defines the API between the Component class and the underlying operating system GUI primitives used for querying and modifying graphical components. Native code that uses the API of the underlying GUI toolkit to perform these tasks is encapsulated in a GUI-dependent class that implements this interface. Figure 9-3 shows the inheritance hierarchy for the ComponentPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.ComponentPeer;

Constructors

None.

Parameters

None.


Figure 9-3  Inheritance hierarchy for the ComponentPeer interface

checkImage(Image, int, int, ImageObserver)

InterfaceName

ComponentPeer

Purpose

Returns the status of construction of the specified image object.

Syntax

public abstract int checkImage(Image img, int w, int h, ImageObserver o)

Parameters

img

The Image object whose screen representation is being constructed.

w

The width of the image to check the status of.

h

The height of the image to check the status of.

o

The ImageObserver object that is to be notified as the specified image is being constructed.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to determine the status of construction of the screen representation of the Image object specified as a parameter to this method.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns an integer value that indicates the status of construction of the Image object as indicated by the specified class that implements the ImageObserver interface.

See Also

The checkImage method of the Component class in Chapter 2

createImage(ImageProducer)

InterfaceName

ComponentPeer

Purpose

Creates an Image from the producer object which is an instance of a class that implements the ImageProducer interface.

Syntax

public abstract Image createImage(ImageProducer producer)

Parameters

producer

The ImageProducer object from which the image is created.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to create the image from the ImageProducer object.

Imports

import java.awt.peer.ComponentPeer;

Returns

The return value of this method is an Image object that represents the image that was produced by the ImageProducer.

See Also

The createImage(ImageProducer) method of the Component class in Chapter 2

createImage(int, int)

InterfaceName

ComponentPeer

Purpose

Creates an Image of the specified dimensions. This image can be used for updating the screen using the double-buffering technique.

Syntax

public abstract Image createImage(int width, int height)

Parameters

width

The width of the image to create.

height

The height of the image to create.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to create the off-screen representation of the Image object with the specified width and height.

Imports

import java.awt.peer.ComponentPeer;

Returns

The return value of this method is an Image object that represents the image that can be used for double-buffering.

See Also

The createImage(int, int) method of the Component class in Chapter 2

disable()

InterfaceName

ComponentPeer

Purpose

Disables the Component (associated with this peer) so that it neither responds to user actions nor generates events.

Syntax

public abstract void disable()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to disable the component from responding to events.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The disable method of the Component class in Chapter 2

dispose()

InterfaceName

ComponentPeer

Purpose

Frees the resources allocated to this peer object.

Syntax

public abstract void dispose()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to free all resources that have been allocated to this peer object. The Component object invokes this method to destroy the ComponentPeer object.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The dispose method of the Component class in Chapter 2

enable()

InterfaceName

ComponentPeer

Purpose

Enables the Component object, so that it responds to events.

Syntax

public abstract void enable()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment such that the Component object generates events in response to user actions, etc.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The enable method of the Component class in Chapter 2

getColorModel()

InterfaceName

ComponentPeer

Purpose

Obtains the RGB values for the ColorModel used to display the Component on the current output device.

Syntax

public abstract ColorModel getColorModel()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to determine the Component object's color values in RGB notation.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns a ColorModel object that describes the RGB color model used to display the component on the output device.

See Also

The getColorMethod method of the Component class in Chapter 2; the ColorModel class in Chapter 7

getFontMetrics(Font)

InterfaceName

ComponentPeer

Purpose

Obtains information about the properties of the specified font for this Component.

Syntax

public abstract FontMetrics getFontMetrics(Font font)

Parameters

font

The font object whose metrics are to be retrieved.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to determine the various metrics of the font used by the Component object.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns a FontMetrics object that describes the characteristics of the font used by the component (associated with this peer).

See Also

The getFontMetrics method of the Component class in Chapter 2; the FontMetrics class in Chapter 7

getGraphics()

InterfaceName

ComponentPeer

Purpose

Obtains information about the graphics context of the Component that created this peer object.

Syntax

public abstract Graphics getGraphics()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to get the graphics context information for the Component.

Imports

import java.awt.peer.ComponentPeer;

Returns

The Graphics object returned by this method describes the graphics context of the component. A value of null is returned if the Component is not currently displayed on the screen.

See Also

The getGraphics method of the Component class described in Chapter 2; the Graphics class described in Chapter 1

getToolkit()

InterfaceName

ComponentPeer

Purpose

Gets an instance of the GUI-dependent toolkit used to bind the AWT classes to a particular graphics environment implementation.

Syntax

public abstract Toolkit getToolkit()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to return a Toolkit object for the underlying graphics environment.

Imports

import java.awt.peer.ComponentPeer;

Returns

The Toolkit object returned by this method is a GUI-specific implementation of the Toolkit class. It is the interface between the AWT graphical components and the graphical components of the native graphical toolkit.

See Also

The getToolkit method of the Component class described in Chapter 2; the Toolkit class described in Chapter 3

handleEvent(Event)

InterfaceName

ComponentPeer

Purpose

The event handler for events that occur in the Component object that are neither handled by the object's event handling method nor its container's event handling method.

Syntax

public abstract boolean handleEvent(Event e)

Parameters

e

The event that was detected.

Description

The peer object's handleEvent method is invoked to handle events that are neither handled by the component's handleEvent method nor by its container's handleEvent method. If a component's event handling method (handleEvent) does not handle an event, the event is passed to the event handling method of the component's container. If this container does not handle the event either, then the event is passed to this method of the component's peer object.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns true if it handles the event, and false if it does not handle the event.

See Also

The handleEvent method of the Component class described in Chapter 2; the Event class described in Chapter 3

hide()

InterfaceName

ComponentPeer

Purpose

Hides the Component so that it is not visible on the screen.

Syntax

public abstract void hide()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to hide the component.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The hide method of the Component class described in Chapter 2

minimumSize()

InterfaceName

ComponentPeer

Purpose

Determines the minimum dimensions of the Component object.

Syntax

public abstract Dimension minimumSize()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to determine the minimum dimensions of the Component associated with this peer object.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns a Dimension object that contains the minimum width and height measurements required of the Component object.

See Also

The minimumSize method of the Component class described in Chapter 2

nextFocus()

InterfaceName

ComponentPeer

Purpose

Moves the input focus to the next component.

Syntax

public abstract void nextFocus()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to shift the input focus to the next component in the GUI.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The nextFocus method of the Component class described in Chapter 2

paint(Graphics)

InterfaceName

ComponentPeer

Purpose

Paints the Component on the output device using the specified graphics context.

Syntax

public abstract void paint(Graphics g)

Parameters

g

The graphics context object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment in order to paint the appearance of the Component onto the output device whose characteristics are specified by the graphics context object g.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The paint method of the Component class described in Chapter 2

preferredSize()

InterfaceName

ComponentPeer

Purpose

Determines the ideal dimensions of the Component object.

Syntax

public abstract Dimension preferredSize()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to determine the preferred dimensions of the Component object.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns a Dimension object that contains the ideal width and height measurements for the Component object.

See Also

The preferredSize method of the Component class described in Chapter 2

prepareImage(Image, int, int, ImageObserver)

InterfaceName

ComponentPeer

Purpose

Prepares an image (asynchronously) for rendering onto the current output device.

Syntax

public abstract boolean prepareImage(Image img, int w, int h, ImageObserver o)

Parameters

img

The image to prepare for rendering onto this Component.

w

The width of the image to be prepared for rendering.

h

The height of the image to be prepared for rendering.



o

This parameter denotes the ImageObserver object that is notified as the image specified by img is being prepared for rendering.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to prepare an image for rendering by creating a scaled representation of it.

Imports

import java.awt.peer.ComponentPeer;

Returns

This method returns the value of true if the image to be rendered is already prepared and ready for rendering, and false if it is not prepared.

See Also

The prepareImage method of the Component class described in Chapter 2

print(Graphics)

InterfaceName

ComponentPeer

Purpose

Prints the Component on the device whose graphics context is specified.

Syntax

public abstract void print(Graphics g)

Parameters

g

The graphics context object to use for printing this Component.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to print the Component on the specified graphics context. The default implementation of this method is to invoke the paint method.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The print method of the Component class described in Chapter 2

repaint(long, int, int, int, int)

InterfaceName

ComponentPeer

Purpose

Repaints the specified rectangular area of the Component and updates this area as soon as possible.

Syntax

public abstract void repaint(long tm, int x, int y, int width, int height)

Parameters

tm

The maximum amount of time (expressed in milliseconds) before the update method is invoked.

x

The x coordinate of the top-left part of the area of the Component to be repainted.

y

The y coordinate of the top-left part of the area of the Component to be repainted.

width

The width of the area of the Component to be repainted.

height

The height of the area of the Component to be repainted.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to repaint and update the rectangular area defined by the parameters to this method.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The repaint method of the Component class described in Chapter 2

requestFocus()

InterfaceName

ComponentPeer

Purpose

Requests that the Component associated with this peer receive the input focus.

Syntax

public abstract void requestFocus()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment requesting the native toolkit to change the input focus to the Component associated with this peer object.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The requestFocus method of the Component class described in Chapter 2

reshape(int, int, int, int)

InterfaceName

ComponentPeer

Purpose

Changes the shape of the Component such that it fits into the specified rectangular area.

Syntax

public abstract void reshape(int x, int y, int width, int height)

Parameters

x

The x coordinate of the top-left corner of the bounding box.

y

The y coordinate of the top-left corner of the bounding box.

width

The width of the bounding box.

height

The height of the bounding box.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to alter the shape of the Component such that it fits the specified bounding box.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The reshape method of the Component class described in Chapter 2

setBackground(Color)

InterfaceName

ComponentPeer

Purpose

Sets the background color of the Component to the specified color.

Syntax

public abstract void setBackground(Color c)

Parameters

c

The Color value for the background of the Component associated with this peer object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to change the color used for painting the background of the Component to the specified color.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The setBackground method of the Component class described in Chapter 2

setFont(Font)

InterfaceName

ComponentPeer

Purpose

Changes the font used in the Component to the specified font.

Syntax

public abstract void setFont(Font f)

Parameters

f

The font for the Component associated with this peer object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to change the font used for writing text in the Component.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The setFont method of the Component class described in Chapter 2

setForeground(Color)

InterfaceName

ComponentPeer

Purpose

Sets the foreground color of the Component to the specified color

Syntax

public abstract void setForeground(Color c)

Parameters

c

The foreground color of the Component associated with this peer object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to change the color used for painting the foreground of the Component to the specified color.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The setForeground method of the Component class described in Chapter 2

show()

InterfaceName

ComponentPeer

Purpose

Displays the Component.

Syntax

public abstract void show()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to display the Component on the current output device.

Imports

import java.awt.peer.ComponentPeer;

Returns

None.

See Also

The show method of the Component class described in Chapter 2.

ButtonPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a button object.

Syntax

public interface ButtonPeer extends Object extends ComponentPeer

Description

This interface defines the API between the Button class and the underlying operating system GUI primitives used with button objects. Native code that uses the API of the underlying GUI toolkit to create and manage a button object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-4 shows the inheritance hierarchy for the ButtonPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.ButtonPeer;

Constructors

None.

Parameters

None.


Figure 9-4  Inheritance hierarchy for the ButtonPeer interface

setLabel(String)

InterfaceName

ButtonPeer

Purpose

Displays the specified string on the button.

Syntax

public abstract void setLabel(String label)

Parameters

label

The text string for the Button label.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to set the label of the button object to the string specified as the parameter to this method.

Imports

import java.awt.peer.ButtonPeer;

Returns

None.

See Also

The setLabel method of the Button class described in Chapter 4

CanvasPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a Canvas object.

Syntax

public interface CanvasPeer extends Object extends ComponentPeer

Description

This interface defines the API between the Canvas class and the underlying operating system GUI primitives used with general-purpose Canvas objects. Native code that uses the API of the underlying GUI toolkit to create and manage a Canvas object is encapsulated in a GUI-dependent class that implements this interface. The GUI-dependent class that implements the ComponentPeer interface implements all the GUI-dependent functionality that is required of a Canvas object. This GUI-dependent class is the interface between the Canvas class and the underlying GUI toolkit of the platform on which the Java applications are being executed. Figure 9-5 shows the inheritance hierarchy for the CanvasPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.CanvasPeer;

Constructors

None.

Parameters

None.


Figure 9-5  Inheritance hierarchy for the CanvasPeer interface

CheckboxPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a checkbox object.

Syntax

public interface CheckboxPeer extends Object extends ComponentPeer

Description

This interface defines the API between the Checkbox class and the underlying operating system GUI primitives used with Checkbox objects. Native code that uses the API of the underlying GUI toolkit to create and manage a Checkbox object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-6 shows the inheritance hierarchy for the CheckboxPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.CheckboxPeer;

Constructors

None.

Parameters

None.


Figure 9-6  Inheritance hierarchy for the CheckboxPeer interface

setCheckboxGroup(CheckboxGroup)

InterfaceName

CheckboxPeer

Purpose

Associates the Checkbox object that created this peer object with the CheckboxGroup object specified

Syntax

public abstract void setCheckboxGroup(CheckboxGroup g)

Parameters

g

The CheckboxGroup object to which the Checkbox object associated with this CheckboxPeer object is assigned.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to associate the Checkbox object that created this peer object with the CheckboxGroup object specified as the parameter to this method.

Imports

import java.awt.peer.CheckboxPeer;

Returns

None.

See Also

The setCheckboxGroup method of the Checkbox class; the CheckboxGroup class described in Chapter 6

setLabel(String)

InterfaceName

CheckboxPeer

Purpose

Sets the text label of the Checkbox

Syntax

public abstract void setLabel(String label)

Parameters

label

The text string to display on the label of the Checkbox.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to set the label of the Checkbox object associated with this peer object to the string specified as the parameter to this method.

Imports

import java.awt.peer.CheckboxPeer;

Returns

None.

See Also

The setLabel method of the Checkbox class described in Chapter 6

setState(boolean)

InterfaceName

CheckboxPeer

Purpose

Sets the checkbox state to on or off.

Syntax

public abstract void setState(boolean state)

Parameters

state

A value of true causes the check mark to appear, and a value of false "unchecks" the Checkbox object associated with this CheckboxPeer object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to set the state of the Checkbox to either on (checked) or off (unchecked), depending on whether the value of state is true or false.

Imports

import java.awt.peer.CheckboxPeer;

Returns

None.

See Also

The setState method of the Checkbox class described in Chapter 6

ChoicePeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a pop-up menu of choices.

Syntax

public interface ChoicePeer extends Object extends ComponentPeer

Description

This interface defines the API between the Choice class and the underlying operating system GUI primitives used for creating and interacting with pop-up menu objects. Native code that uses the API of the underlying GUI toolkit to create and manage a pop-up menu of choices is encapsulated in a GUI-dependent class that implements this interface. Figure 9-7 shows the inheritance hierarchy for the ChoicePeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.ChoicePeer;

Constructors

None.

Parameters

None.


Figure 9-7  Inheritance hierarchy for the ChoicePeer interface

addItem(String, int)

InterfaceName

ChoicePeer

Purpose

Adds a text string to the pop-up menu at the specified position in the list of choices.

Syntax

public abstract void addItem(String item, int index)

Parameters

item

The text to insert into the Choice object associated with this ChoicePeer object.

index

The index at which to insert the specified text in the list of choices.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to add the specified text string to the pop-up menu of choices.

Imports

import java.awt.peer.ChoicePeer;

Returns

None.

See Also

The addItem method of the Choice class described in Chapter 6

select(int)

InterfaceName

ChoicePeer

Purpose

Selects the text string at the index position in the list of choices.

Syntax

public abstract void select(int index)

Parameters

index

The index into the list of choices of the item to select.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to select the specified item in the Choice object associated with this peer object.

Imports

import java.awt.peer.ChoicePeer;

Returns

None.

See Also

The select method of the Choice class described in Chapter 6

LabelPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a label object.

Syntax

public interface LabelPeer extends Object extends ComponentPeer

Description

This interface defines the API between the Label class and the underlying operating system GUI primitives used for creating and interacting with simple label objects that display a noneditable text string. Native code that uses the API of the underlying GUI toolkit to create and manage a label object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-8 shows the inheritance hierarchy for the LabelPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.LabelPeer;

Constructors

None.

Parameters

None.


Figure 9-8  Inheritance hierarchy for the LabelPeer interface

setAlignment(int)

InterfaceName

LabelPeer

Purpose

Sets the alignment of the text string on the label.

Syntax

public abstract void setAlignment(int alignment)

Parameters

alignment

The alignment mode for the text string to be displayed in the Label object for which this LabelPeer object was created.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to align the label object's text string as specified by the alignment parameter.

Imports

import java.awt.peer.LabelPeer;

Returns

None.

See Also

The setAlignment method of the Label class described in Chapter 4

setText(String)

InterfaceName

LabelPeer

Purpose

Changes the text string displayed on the label.

Syntax

public abstract void setText(String label)

Parameters

label

The text for the label.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the specified text on the label object.

Imports

import java.awt.peer.LabelPeer;

Returns

None.

See Also

The setText method of the Label class described in Chapter 4

ListPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a list object.

Syntax

public interface ListPeer extends Object extends ComponentPeer

Description

This interface defines the API between the List class and the underlying operating system GUI primitives used for creating and interacting with graphical objects that contain a scrolling list of text strings. Native code that uses the API of the underlying GUI toolkit to create and manage a list object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-9 shows the inheritance hierarchy for the ListPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.ListPeer;

Constructors

None.

Parameters

None.


Figure 9-9  Inheritance hierarchy for the ListPeer interface

addItem(String, int)

InterfaceName

ListPeer

Purpose

Adds a text string at a specified position in the list.

Syntax

public abstract void addItem(String item, int index)

Parameters

item

The text string to add to the list.

index

The index at which to insert the specified text

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to add the specified string at the specified index in the list object for which this peer object was created.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The addItem method of the List class described in Chapter 5

clear()

InterfaceName

ListPeer

Purpose

Empties the list.

Syntax

public abstract void clear()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to remove all the text strings from the list object.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The clear method of the List class described in Chapter 5

delItems(int, int)

InterfaceName

ListPeer

Purpose

Removes a specified range of items from the list object.

Syntax

public abstract void delItems(int start, int end)

Parameters

start

The position of the first item to be deleted.

end

The index of the last item to be removed.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to remove all the text strings between the start and end indices in the list.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The delItems method of the List class described in Chapter 5

deselect(int)

InterfaceName

ListPeer

Purpose

Deselects the item at the specified index in the list.

Syntax

public abstract void deselect(int index)

Parameters

index

The position of the text string to deselect.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to remove the highlight bar from around the item at the position specified by index.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The deselect method of the List class described in Chapter 5

getSelectedIndexes()

InterfaceName

ListPeer

Purpose

Gets the indices of the selected items in the list.

Syntax

public abstract int[] getSelectedIndexes()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the items in the list that have been selected.

Imports

import java.awt.peer.ListPeer;

Returns

This method returns an array containing integer values that indicate the positions that have been selected in the list.

See Also

The getSelectedIndexes method of the List class described in Chapter 5

makeVisible(int)

InterfaceName

ListPeer

Purpose

Forces the item at the specified index in the list to be made visible.

Syntax

public abstract void makeVisible(int index)

Parameters

index

The index of the item in the list that is forced to be made visible.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to bring the specified text item into the visible area of the list box, scrolling the items in the list object if necessary.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The makeVisible method of the List class described in Chapter 5

minimumSize()

InterfaceName

ListPeer

Purpose

Determines the minimum height and width for a List object containing the specified number of rows.

Syntax

public abstract Dimension minimumSize(int v)

Parameters

v

The number of rows in the list.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the minimum dimension required if the List object associated with this peer object has v number of rows.

Imports

import java.awt.peer.ListPeer;

Returns

This method returns a Dimension object that contains the minimum width and height measurements required of the List object.

See Also

The minimumSize method of the List class described in Chapter 5



preferredSize(int)

InterfaceName

ListPeer

Purpose

Determines the ideal dimensions for a List object containing the specified number of rows.

Syntax

public abstract Dimension preferredSize(int v)

Parameters

v

The number of rows in the list.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the ideal dimension required if the List object associated with this peer object has v number of rows.

Imports

import java.awt.peer.ListPeer;

Returns

This method returns a Dimension object that contains the ideal width and height measurements required of the List object.

See Also

The preferredSize method of the List class described in Chapter 5

select(int)

InterfaceName

ListPeer

Purpose

Selects the text item at the specified position in the list.

Syntax

public abstract void select(int index)

Parameters

index

The index of the item in the list to be selected.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to highlight the item at the position specified by index.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The select method of the List class described in Chapter 5

setMultipleSelections(boolean)

InterfaceName

ListPeer

Purpose

Enables and disables multiple selection of items in the list.

Syntax

public abstract void setMultipleSelections(boolean mFlag)

Parameters

mFlag

If the value of mFlag is true, then multiple items in the list can be selected.
If the value of mFlag is false, then the list functions as a single-selection list in which only one of the items displayed can be selected.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI, to set whether or not the user can select multiple items in the List component associated with this peer object.

Imports

import java.awt.peer.ListPeer;

Returns

None.

See Also

The setMultipleSelections method of the List class described in Chapter 5

ScrollbarPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a scrollbar object.

Syntax

public interface ScrollbarPeer extends Object extends ComponentPeer

Description

This interface defines the API between the Scrollbar class and the underlying operating system GUI primitives used for creating and interacting with scrollbar objects. Native code that uses the API of the underlying GUI toolkit to create and manage a scrollbar object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-10 shows the inheritance hierarchy for the ScrollbarPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.ScrollbarPeer;

Constructors

None.

Parameters

None.


Figure 9-10  Inheritance hierarchy for the ScrollbarPeer interface

setLineIncrement(int)

InterfaceName

ScrollbarPeer

Purpose

Sets the step size for decrements and increments when the line up or line down arrow buttons of the scrollbar are invoked.

Syntax

public abstract void setLineIncrement(int l)

Parameters

l

The line increment size.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the step size for line increments and decrements of the Scrollbar object associated with this peer object.

Imports

import java.awt.peer.ScrollbarPeer;

Returns

None.

See Also

The setLineIncrement method of the Scrollbar class described in Chapter 4

setPageIncrement(int)

InterfaceName

ScrollbarPeer

Purpose

Sets the step size for decrements or increments when the page up or page down arrow buttons of the scrollbar are invoked.

Syntax

public abstract void setPageIncrement(int l)

Parameters

l

The page increment size.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the step size for page increments and decrements of the Scrollbar object associated with this peer object.

Imports

import java.awt.peer.ScrollbarPeer;

Returns

None.

See Also

The setPageIncrement method of the Scrollbar class described in Chapter 4

setValue(int)

InterfaceName

ScrollbarPeer

Purpose

Sets the value of the current position of the Scrollbar to the specified value.

Syntax

public abstract void setValue(int p)

Parameters

p

The new value for the current position of the Scrollbar.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the value of the current position of the Scrollbar object associated with this peer object.

Imports

import java.awt.peer.ScrollbarPeer;

Returns

None.

See Also

The setValue method of the Scrollbar class described in Chapter 4

setValues(int, int, int, int)

InterfaceName

ScrollbarPeer

Purpose

Sets various parameters associated with the ScrollBar object.

Syntax

public abstract void setValues(int value, int visible, int minScroll, int maxScroll)

Parameters

value

The position of the scrollbar thumb in the current window.

visible

The size of the visible region of the area that is being scrolled using the scrollbar.

minScroll

The minimum value of the scrollbar.

maxScroll

The maximum value of the scrollbar.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the specified parameters for the Scrollbar object associated with this peer object.

Imports

import java.awt.peer.ScrollbarPeer;

Returns

None

See Also

The setValues method of the Scrollbar class described in Chapter 4

ContainerPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a container object.

Syntax

public interface ContainerPeer extends Object extends ComponentPeer

Description

This interface defines the API between the Container class and the underlying operating system GUI primitives used for creating and interacting with graphical components that can contain other graphical components. Native code that uses the API of the underlying GUI toolkit to create and manage a GUI component that can contain other graphical components is encapsulated in a GUI-dependent class that implements this interface. Figure 9-11 shows the inheritance hierarchy for the ContainerPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.ContainerPeer;

Constructors

None.

Parameters

None.


Figure 9-11  Inheritance hierarchy for the ContainerPeer interface

insets()

InterfaceName

ContainerPeer

Purpose

Determines the top, left, bottom, right insets for the Container object.

Syntax

public abstract Insets insets()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the extra space that must be added as padding on the top, left, bottom, and right sides of the Container object.

Imports

import java.awt.peer.ContainerPeer;

Returns

This method returns an Insets object that specifies the top, left, bottom, and right padding that must be subtracted from the dimensions of the Container object in order to determine the area required for laying out Components within the Container.

See Also

The insets method of the Container class described in Chapter 3

PanelPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a panel object.

Syntax

public interface PanelPeer extends Object extends ContainerPeer

Description

This interface defines the API between the Panel class and the underlying operating system GUI primitives used for creating and interacting with panel graphical components. Native code that uses the API of the underlying GUI toolkit to create and manage a panel object is encapsulated in a GUI-dependent class that implements this interface. This GUI-dependent class is the interface between the Panel class and the underlying GUI toolkit of the platform on which the Java applications are being executed. Figure 9-12 shows the inheritance hierarchy for the PanelPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.PanelPeer;

Constructors

None.

Parameters

None.


Figure 9-12  Inheritance hierarchy for the PanelPeer interface

WindowPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a top-level window object.

Syntax

public interface WindowPeer extends Object extends ContainerPeer

Description

This interface defines the API between the Window class and the underlying operating system GUI primitives used for creating and interacting with top-level windows. These windows have neither a title bar nor a border. Native code that uses the API of the underlying GUI toolkit to create and manage a top-level container object, is encapsulated in a GUI-dependent class that implements this interface. Figure 9-13 shows the inheritance hierarchy for the WindowPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.WindowPeer;

Constructors

None.

Parameters

None.


Figure 9-13  Inheritance hierarchy for the WindowPeer interface

toBack()

InterfaceName

WindowPeer

Purpose

Sends the parent frame object to the back of the Window object associated with this peer.

Syntax

public abstract void toBack()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to push the parent Frame window object to the back of the Window.

Imports

import java.awt.peer.WindowPeer;

Returns

None.

See Also

The toBack method of the Window class described in Chapter 3

toFront()

InterfaceName

WindowPeer

Purpose

Brings the parent frame object to the front of the Window object associated with this peer.

Syntax

public abstract void toFront()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to bring the parent Frame window object to the front of the Window object.

Imports

import java.awt.peer.WindowPeer;

Returns

None.

See Also

The toFront method of the Window class described in Chapter 3

DialogPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a Dialog box object.

Syntax

public interface DialogPeer extends Object extends WindowPeer

Description

This interface defines the API between the Dialog class and the underlying operating system GUI primitives used for creating and interacting with dialog box object. The GUI-dependent class that creates a dialog box object must implement this interface. The methods defined in this interface are implemented in native code, using the API of the underlying GUI toolkit to create and manage a dialog box object. Figure 9-14 shows the inheritance hierarchy for the DialogPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.DialogPeer;

Constructors

None.

Parameters

None.


Figure 9-14  Inheritance hierarchy for the DialogPeer interface

setResizable(boolean)

InterfaceName

DialogPeer

Purpose

Sets whether the dialog box can be resized or not.

Syntax

public abstract void setResizable(boolean resizable)

Parameters

resizable

A value of true makes the Dialog component resizable; false means the Dialog window is not resizable.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to enable and disable the resizable property of the Dialog window object associated with this peer.

Imports

import java.awt.peer.DialogPeer;

Returns

None.

See Also

The setResizable method of the Dialog class described in Chapter 5

setTitle(String)

InterfaceName

DialogPeer

Purpose

Sets the text string on the title bar of the Dialog window.

Syntax

public abstract void setTitle(String title)

Parameters

title

The text to display in the title bar of the Dialog window.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the title of the Dialog window to the string specified in the parameter to this method.

Imports

import java.awt.peer.DialogPeer;

Returns

None.

See Also

The setTitle method of the Dialog class described in Chapter 5

FileDialogPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a FileDialog window that displays a list of files and allows the user to select a file.

Syntax

public interface FileDialogPeer extends Object extends DialogPeer

Description

This interface defines the API between the FileDialog class and the underlying operating system GUI primitives used for creating and interacting with dialog box windows that display a list of files and allow the user to select from the list. The GUI-dependent class that creates a file dialog box window must implement this interface. The methods defined in this interface are implemented in native code using the API of the underlying GUI toolkit to create and manage a dialog box window that allows the user to pick a file from a list of filenames. Figure 9-15 shows the inheritance hierarchy for the FileDialogPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.FileDialogPeer;

Constructors

None.

Parameters

None.


Figure 9-15  Inheritance hierarchy for the FileDialogPeer interface

setDirectory(String)

InterfaceName

FileDialogPeer

Purpose

Sets the directory from which the user is prompted to select a file.

Syntax

public abstract void setDirectory(String dir)

Parameters

dir

The name of the directory from which the user is prompted to select a file.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the text string specified in dir in a window on the FileDialog box.

Imports

import java.awt.peer.FileDialogPeer;

Returns

None.

See Also

The setDirectory method of the FileDialog class described in Chapter 5

setFile(String)

InterfaceName

FileDialogPeer

Purpose

Sets the directory from which the user is prompted to select a file.

Syntax

public abstract void setFile(String file)

Parameters

file

The name of the (default) file for the FileDialog object associated with this peer object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the text string specified in file as a label on the FileDialog box.

Imports

import java.awt.peer.FileDialogPeer;

Returns

None.

See Also

The setFile method of the FileDialog class described in Chapter 5

setFilenameFilter(FilenameFilter)

InterfaceName

FileDialogPeer

Purpose

Sets the filter that determines which files to display for users to select from in the FileDialog box.

Syntax

public abstract void setFilenameFilter(FilenameFilter filter)

Parameters

filter

The file name filter for displaying files in the FileDialog window.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the text string specified in filter on a label on the FileDialog box and to perform the appropriate filtering of file names.

Imports

import java.awt.peer.FileDialogPeer;

Returns

None.

See Also

The setFilenameFilter method of the FileDialog class described in Chapter 5

FramePeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a Frame window.

Syntax

public interface FramePeer extends Object extends WindowPeer

Description

This interface defines the API between the Frame class and the underlying operating system GUI primitives used for creating and interacting with top-level frame windows that have a title bar and borders and can optionally have a menu bar. Native code that uses the API of the underlying GUI toolkit to create and manage a top-level frame window object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-16 shows the inheritance hierarchy for the FramePeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.FramePeer;

Constructors

None.

Parameters

None.


Figure 9-16  Inheritance hierarchy for the FramePeer interface

setCursor(int)

InterfaceName

FramePeer

Purpose

Sets the cursor to display when the pointer is within the Frame window associated with this peer object.

Syntax

public abstract void setCursor(int cursorType)

Parameters

cursorType

An integer constant that indicates the type of cursor to display within the Frame window for which this FramePeer was created.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the appropriate bitmap image when the pointer is within the bounds of the Frame window associated with this peer.

Imports

import java.awt.peer.FramePeer;

Returns

None.

See Also

The setCursor method of the Frame class described in Chapter 4

setIconImage(Image)

InterfaceName

FramePeer

Purpose

Sets the image of the icon of the Frame window associated with this peer object.

Syntax

public abstract void setIconImage(Image img)

Parameters

img

The image to be used for the icon.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the appropriate image when the Frame window is iconized.

Imports

import java.awt.peer.FramePeer;

Returns

None.

See Also

The setIconImage method of the Frame class described in Chapter 4

setMenuBar(MenuBar)

InterfaceName

FramePeer

Purpose

Sets the menu bar for the Frame to the specified MenuBar object.

Syntax

public abstract void setMenuBar(MenuBar mbar)

Parameters

mbar

The MenuBar object that represents the menu bar for the Frame window.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to associate the specified menu bar with the Frame window associated with this peer object.

Imports

import java.awt.peer.FramePeer;

Returns

None.

See Also

The setMenuBar method of the Frame class described in Chapter 4

setResizable(boolean)

InterfaceName

FramePeer

Purpose

Sets whether or not the Frame window can be resized.

Syntax

public abstract void setResizable(boolean resizable)

Parameters

resizable

A boolean value that represents whether or not the Frame window is resizable. If this value is set to true, the Frame window is resizable; if it is set to false, the Frame window is not resizable.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to enable and disable the resizable property of the Frame window associated with this peer.

Imports

import java.awt.peer.FramePeer;

Returns

None.

See Also

The setResizable method of the Frame class described in Chapter 4

setTitle(String)

InterfaceName

FramePeer

Purpose

Sets the text string on the title bar of the frame.

Syntax

public abstract void setTitle(String title)

Parameters

title

The text string to display in the title bar of the Frame window.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the title of the Frame window to the string specified in the parameter to this method.

Imports

import java.awt.peer.FramePeer;

Returns

None.

See Also

The setTitle method of the Frame class described in Chapter 4

MenuComponentPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a MenuComponent object.

Syntax

public interface MenuComponentPeer extends Object

Description

This interface defines the API between the MenuComponent class and the underlying operating system GUI primitives used for creating and interacting with graphical objects associated with menus. Native code that uses the API of the underlying GUI toolkit to create and manage a menu component object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-17 shows the inheritance hierarchy for the MenuComponentPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.MenuComponentPeer;

Constructors

None.

Parameters

None.


Figure 9-17  Inheritance hierarchy for the MenuComponentPeer interface

dispose()

InterfaceName

MenuComponentPeer

Purpose

Frees the resources allocated to the MenuComponent.

Syntax

public abstract void dispose()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to free the resources allocated to the MenuComponent object associated with this peer.

Imports

import java.awt.peer.MenuComponentPeer;

Returns

None.

See Also

The removeNotify method of the MenuComponent class described in Chapter 6

MenuBarPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a MenuBar object.

Syntax



public interface MenuBarPeer extends MenuComponentPeer

Description

This interface defines the API between the MenuBar class and the underlying operating system GUI primitives used for creating and interacting with menu bar objects. Native code that uses the API of the underlying GUI toolkit to create and manage a menu bar object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-18 shows the inheritance hierarchy for the MenuBarPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.MenuBarPeer;

Constructors

None.

Parameters

None.


Figure 9-18  Inheritance hierarchy for the MenuBarPeer interface

addHelpMenu(Menu)

InterfaceName

MenuBarPeer

Purpose

Adds the specified menu as the help menu for the menu bar.

Syntax

public abstract void addHelpMenu(Menu m)

Parameters

m

The help menu on the menu bar is set to this menu object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to add the specified menu to the menu bar and to designate it as the help menu.

Imports

import java.awt.peer.MenuBarPeer;

Returns

None.

See Also

The setHelpMenu method of the MenuBar class described in Chapter 6

addMenu(Menu)

InterfaceName

MenuBarPeer

Purpose

Adds a menu to the MenuBar object associated with this peer object.

Syntax

public abstract void addMenu(Menu m)

Parameters

m

The menu object to be added to the menu bar.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to add the specified menu to the menu bar.

Imports

import java.awt.peer.MenuBarPeer;

Returns

None.

See Also

The add method of the MenuBar class described in Chapter 6

delMenu(int)

InterfaceName

MenuBarPeer

Purpose

Removes the specified menu from the menu bar.

Syntax

public abstract void delMenu(int index)

Parameters

index

The index of the menu to remove from the menu bar object associated with this peer.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to remove the specified menu from the menu bar.

Imports

import java.awt.peer.MenuBarPeer;

Returns

None.

See Also

The remove method of the MenuBar class described in Chapter 6

MenuItemPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a MenuItem object.

Syntax

public interface MenuItemPeer extends MenuComponentPeer

Description

This interface defines the API between the MenuItem class and the underlying operating system GUI primitives used for creating and interacting with menu item objects. Native code that uses the API of the underlying GUI toolkit to create and manage a menu item object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-19 shows the inheritance hierarchy for the MenuItemPeer interface.

PackageName

import java.awt.peer

Imports

import java.awt.peer.MenuBarPeer;

Constructors

None.

Parameters

None.


Figure 9-19  Inheritance hierarchy for the MenuItemPeer interface

disable()

InterfaceName

MenuItemPeer

Purpose

Makes the MenuItem associated with this peer unselectable by the user.

Syntax

public abstract void disable()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to make the menu item unselectable by the user.

Imports

import java.awt.peer.MenuItemPeer;

Returns

None.

See Also

The disable method of the MenuItem class described in Chapter 6

enable()

InterfaceName

MenuItemPeer

Purpose

Makes the MenuItem associated with this peer selectable by the user.

Syntax

public abstract void enable()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to make the menu item selectable by the user.

Imports

import java.awt.peer.MenuItemPeer;

Returns

None.

See Also

The enable method of the MenuItem class described in Chapter 6

setLabel(String)

InterfaceName

MenuItemPeer

Purpose

Sets the text label of the MenuItem to the specified string.

Syntax

public abstract void setLabel(String label)

Parameters

label

The text for the label of the MenuItem for which this peer was created.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the text of the menu item to the string specified in label.

Imports

import java.awt.peer.MenuItemPeer;

Returns

None.

See Also

The setLabel method of the MenuItem class described in Chapter 6

CheckboxMenuItemPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a CheckboxMenuItem object.

Syntax

public interface CheckboxMenuItemPeer extends Object extends MenuItemPeer

Description

This interface defines the API between the CheckboxMenuItem class and the underlying operating system GUI primitives used for creating and interacting with checkboxes that can be used as menu item objects. Native code that uses the API of the underlying GUI toolkit to create and manage a checkbox object that can be used in menus is encapsulated in a GUI-dependent class that implements this interface. Figure 9-20 shows the inheritance hierarchy for the CheckboxMenuItemPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.CheckboxMenuItemPeer;

Constructors

None.

Parameters

None.


Figure 9-20  Inheritance hierarchy for the CheckboxMenuItemPeer interface

setState(boolean)

InterfaceName

CheckboxMenuItemPeer

Purpose

Sets the checkbox state (in the menu) to either on or off.

Syntax

public abstract void setState(boolean t)

Parameters

t

The checkbox is "unchecked" if this value is false. The checkbox is "checked" if the value of this variable is true.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific graphical environment to set the state of the Checkbox to either on (checked) or off (unchecked), depending on whether the value of t is true or false.

Imports

import java.awt.peer.CheckboxMenuItemPeer;

Returns

None.

See Also

The setState method of the CheckboxMenuItem class described in Chapter 6

MenuPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a Menu object.

Syntax

public interface MenuPeer extends MenuItemPeer

Description

This interface defines the API between the Menu class and the underlying GUI primitives that can be components of a menu bar. Native code that uses the API of the underlying GUI toolkit to create and manage a menu object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-21 shows the inheritance hierarchy for the MenuPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.MenuPeer;

Constructors

None.

Parameters

None.


Figure 9-21  Inheritance hierarchy for the MenuPeer interface

addItem(MenuItem)

InterfaceName

MenuPeer

Purpose

Adds the specified MenuItem to the Menu object associated with this peer.

Syntax

public abstract void addItem(MenuItem mItem)

Parameters

mItem

The MenuItem to be added to the menu.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to add the specified menu item to the Menu associated with this peer.

Imports

import java.awt.peer.MenuPeer;

Returns

None.

See Also

The add method of the Menu class described in Chapter 6

addSeparator()

InterfaceName

MenuPeer

Purpose

Adds a separator line in the Menu.

Syntax

public abstract void addSeparator()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to draw a line just below the previous item that was added to the Menu object assoicated with this peer object.

Imports

import java.awt.peer.MenuPeer;

Returns

None.

See Also

The addSeparator method of the Menu class described in Chapter 6

delItem(int)

InterfaceName

MenuPeer

Purpose

Removes the menu item at the index specified by index from the Menu object associated with this peer.

Syntax

public abstract void delItem(int index)

Parameters

index

The index of the item to remove from the Menu object associated with this peer.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to remove the MenuItem at the specified index from the Menu object.

Imports

import java.awt.peer.MenuPeer;

Returns

None.

See Also

The remove method of the Menu class described in Chapter 6

TextComponentPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a TextComponent object.

Syntax

public interface TextComponentPeer extends Object extends ComponentPeer

Description

This interface defines the API between the TextComponent class and the underlying operating system GUI primitives used for creating graphical components in which text can be edited. Native code that uses the API of the underlying GUI toolkit to create and manage a TextComponent object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-22 shows the inheritance hierarchy for the TextComponentPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.TextComponentPeer;

Constructors

None.

Parameters

None.


Figure 9-22  Inheritance hierarchy for the TextComponentPeer interface

getSelectionEnd()

InterfaceName

TextComponentPeer

Purpose

Returns the position of the end of the text that the user selected.

Syntax

public abstract int getSelectionEnd()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the position of the end of the text selected by the user.

Imports

import java.awt.peer.TextComponentPeer;

Returns

This method returns an integer value that indicates the character position of the last character in the text selected by the user.

See Also

The getSelectionEnd method of the TextComponent class described in Chapter 5

getSelectionStart()

InterfaceName

TextComponentPeer

Purpose

Returns the position of the start of the text that the user selected.

Syntax

public abstract int getSelectionStart()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the position of the beginning of the text selected by the user.

Imports

import java.awt.peer.TextComponentPeer;

Returns

This method returns an integer value that indicates the character position of the first character in the text selected by the user.

See Also

The getSelectionStart method of the TextComponent class described in Chapter 5

getText()

InterfaceName

TextComponentPeer

Purpose

Returns the text that the TextComponent contains.

Syntax

public abstract String getText()

Parameters

None.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the text contained in the TextComponent object associated with this peer.

Imports

import java.awt.peer.TextComponentPeer;

Returns

This method returns a string containing all the text contained in the TextComponent.

See Also

The getText method of the TextComponent class described in Chapter 5

select(int, int)

InterfaceName

TextComponentPeer

Purpose

Selects a range of text.

Syntax

public abstract void select(int selStart, int selEnd)

Parameters

selStart

The position at which to start selecting the text.

selEnd

The position at which to stop selecting the text, starting from selStart.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to select the range of text between the start index selStart and the end index selEnd. Highlighting the selected text is a standard convention followed in most graphical environments.

Imports

import java.awt.peer.TextComponentPeer;

Returns

None.

See Also

The select method of the TextComponent class described in Chapter 5

setEditable(boolean)

InterfaceName

TextComponentPeer

Purpose

Sets whether or not the TextComponent permits editing of the text contained in it.

Syntax

public abstract void setEditable(boolean editable)

Parameters

editable

A value of true makes the text in the TextComponent editable by the user. A value of false means the text in the TextComponent cannot be edited.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set whether or not the text contained in the TextComponent can be edited.

Imports

import java.awt.peer.TextComponentPeer;

Returns

None.

See Also

The setEditable method of the TextComponent class described in Chapter 5

setText(String)

InterfaceName

TextComponentPeer

Purpose

Sets the string to display in the TextComponent object associated with this peer.

Syntax

public abstract void setText(String s)

Parameters

s

The text to display in the TextComponent object associated with this peer object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to display the text string s in the TextComponent.

Imports

import java.awt.peer.TextComponentPeer;

Returns

None.

See Also

The setText method of the TextComponent class described in Chapter 5

TextAreaPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a TextArea object.

Syntax

public interface TextAreaPeer extends Object extends TextComponentPeer

Description

This interface defines the API between the TextArea class and the underlying operating system GUI primitives used for displaying, editing, and managing multiline text areas. Native code that uses the API of the underlying GUI toolkit to create and manage a TextArea object is encapsulated in a GUI-dependent class that implements this interface. Figure 9-23 shows the inheritance hierarchy for the TextAreaPeer interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.TextAreaPeer;

Constructors

None.

Parameters

None.


Figure 9-23  Inheritance hierarchy for the TextAreaPeer interface

insertText(String, int)

InterfaceName

TextAreaPeer

Purpose

Inserts a string of text at a specified index into the existing text in the TextArea object.

Syntax

public abstract void insertText(String txt, int pos)

Parameters

txt

The text to insert into the TextArea object.

pos

The position at which to insert the specified text.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to insert the text string(txt) at the index specified by pos into the TextArea component associated with this peer object.

Imports

import java.awt.peer.TextAreaPeer;

Returns

None.

See Also

The insertText method of the TextArea class described in Chapter 5

minimumSize(int, int)

InterfaceName

TextAreaPeer

Purpose

Determines the minimum height and width for a TextArea object containing the specified number of rows and columns of text.

Syntax

public abstract Dimension minimumSize(int rows, int cols)

Parameters

rows

The number of rows in the TextArea object.

cols

The number of columns in the TextArea object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the minimum dimension required if the TextArea object associated with this peer object has the specified number of rows and columns of text.

Imports

import java.awt.peer.TextAreaPeer;

Returns

This method returns a Dimension object that contains the minimum width and height measurements required of the TextArea object.

See Also

The minimumSize method of the TextArea class described in Chapter 5

preferredSize(int, int)

InterfaceName

TextAreaPeer

Purpose

Determines the ideal height and width for a TextArea object containing the specified number of rows and columns of text.

Syntax

public abstract Dimension preferredSize(int rows, int cols)

Parameters

rows

The preferred number of rows for the TextArea object.

cols

The preferred number of columns for the TextArea object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the ideal dimension required if the TextArea object associated with this peer object has the specified number of rows and columns of text.

Imports

import java.awt.peer.TextAreaPeer;

Returns

This method returns a Dimension object that contains the ideal width and height measurements required of the TextArea object.

See Also

The preferredSize method of the TextArea class described in Chapter 5

replaceText(String, int, int)

InterfaceName

TextAreaPeer

Purpose

Replaces a specified range of text with another string of text.

Syntax

public abstract void replaceText (String txt, int start, int end)

Parameters

txt

The new text string to use as the replacement text.

start

The starting position of the text in the TextArea to be replaced.

end

The ending position of the text in the TextArea to be replaced.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to replace the characters between the indices specified by start and end, with the text string supplied in txt.

Imports

import java.awt.peer.TextAreaPeer;

Returns

None.

See Also

The replaceText method of the TextArea class described in Chapter 5

TextFieldPeer

Purpose

Defines the interface that must be implemented by a GUI-dependent class to create and manage a TextField object.

Syntax

public interface TextFieldPeer extends Object extends TextComponentPeer

Description

This interface defines the API between the TextField class and the underlying operating system GUI primitives used for creating graphical components that allow editing of a single line of text. Native code that uses the API of the underlying GUI toolkit to create and manage a TextField object is encapsulated in a GUI-dependent class that implements this interface.

PackageName

java.awt.peer

Imports

import java.awt.peer.TextFieldPeer;

Constructors

None.

Parameters

None.

minimumSize(int)

InterfaceName

TextFieldPeer

Purpose

Determines the minimum height and width for a TextField object containing the specified number of columns.

Syntax

public abstract Dimension minimumSize(int cols)

Parameters

cols

The minimum number of columns the TextField object must have.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the minimum dimension required if the TextField object associated with this peer object has cols number of columns of text.

Imports

import java.awt.peer.TextFieldPeer;

Returns

This method returns a Dimension object that contains the minimum width and height measurements required of the TextField object.

See Also

The minimumSize method of the TextField class described in Chapter 5

preferredSize(int)

InterfaceName

TextFieldPeer

Purpose

Determines the ideal height and width for a TextField object containing the specified number of columns of text.

Syntax

public abstract Dimension preferredSize(int cols)

Parameters

cols

The preferred number of columns the TextField object must have.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to determine the ideal dimension of the TextField object associated with this peer object if it has cols number of columns.

Imports

import java.awt.peer.TextFieldPeer;

Returns

This method returns a Dimension object that contains the ideal width and height measurements required of the TextField object.

See Also

The preferredSize method of the TextField class described in Chapter 5

setEchoCharacter(char)

InterfaceName

TextFieldPeer

Purpose

Sets the character that is echoed when the user enters text in the TextField object associated with this peer.

Syntax

public abstract void setEchoCharacter(char c)

Parameters

c

The character that should be printed in the TextField when the user enters text in the TextField object.

Description

The GUI-dependent class that implements this method must make native calls to the API of the platform-specific GUI to set the echo character for the TextField object to the specified character.

Imports

import java.awt.peer.TextFieldPeer;

Returns

None.

See Also

The setEchoCharacter method of the TextField class described in Chapter 5





Politica de confidentialitate | Termeni si conditii de utilizare



DISTRIBUIE DOCUMENTUL

Comentarii


Vizualizari: 784
Importanta: rank

Comenteaza documentul:

Te rugam sa te autentifici sau sa iti faci cont pentru a putea comenta

Creaza cont nou

Termeni si conditii de utilizare | Contact
© SCRIGROUP 2024 . All rights reserved