Kagetaka

net.hizlab.kagetaka.awt
クラス ImageButton

java.lang.Object
  拡張java.awt.Component
      拡張net.hizlab.kagetaka.awt.SizedComponent
          拡張net.hizlab.kagetaka.awt.ImageButton
すべての実装インタフェース:
ImageObserver, MenuContainer, Serializable

public class ImageButton
extends SizedComponent

イメージ付きのアイコンを表すクラスです。 このボタンは、状況により4つのイメージ(通常、オーバー、ダウン、無効)を利用します。 このため、4つの状態すべてのイメージを指定する方法と、 1つの状態(通常)のイメージだけ、あるいは押下時、オーバ時のイメージを指定し、 それから指定されていない他の状態を ImageButton 内部で 作り出す方法があります。

また、setHotspot メソッドで、 サブメニュー用のイメージを追加することが出来ます。

4つの状態すべてのイメージを指定してある場合、 setHotspot メソッドでは、引数が3つのパターンで登録する 必要があります。このメソッドで登録した3つめの引数の領域に マウスが移動・押されると、サブメニュー用の動作を行います。 1つの状態のイメージから作られている場合、setHotspot メソッドは、 1つの引数のパターンで登録する必要があります。この場合、ホットスポット用の イメージは、通常のイメージの右側に追加されます。

1つの状態のイメージから作られている場合、イメージと一緒に表示する文字を 指定できます。この場合、イメージの右側でホットスポットより左側に 文字が表示されます。

バージョン:
$Revision: 1.10 $
関連項目:
直列化された形式
バグ:
直列化は、リスナが保存されないため出来ません。

入れ子クラスの概要
 
クラス java.awt.Component から継承した入れ子クラス
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
static int DISABLE
          ボタンが無効な状態
static int DOWN
          マウスが押された状態
static int HOTSPOT_DOWN
          ホットスポットが押された状態
static int HOTSPOT_OVER
          マウスがホットスポットの上に来た状態
static int NORMAL
          通常の状態
static int OVER
          マウスが上に来た状態
 
クラス net.hizlab.kagetaka.awt.SizedComponent から継承したフィールド
size
 
クラス java.awt.Component から継承したフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
インタフェース java.awt.image.ImageObserver から継承したフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
コンストラクタの概要
ImageButton(boolean separate, Image base, Image over, Image down, Image disable, Image sover, Image sdown, Image sdisable, Polygon sarea)
          指定されたイメージを表示する、 イメージボタンを作成します。
ImageButton(Image base)
          指定されたイメージを表示する、 イメージボタンを作成します。
ImageButton(Image base, Image spot)
          指定されたイメージを表示する、 ホットスポット付きのイメージボタンを作成します。
ImageButton(String label, boolean separate, Image base, Image over, Image down, Image disable, Image sover, Image sdown, Image sdisable, Polygon sarea)
          指定されたイメージとラベルを表示する、 イメージボタンを作成します。
ImageButton(String label, Image base)
          指定されたイメージとラベルを表示する、 イメージボタンを作成します。
ImageButton(String label, Image base, Image spot)
          指定されたイメージとラベルを表示する、 ホットスポット付きのイメージボタンを作成します。
 
メソッドの概要
 void addStateListener(StateListener l)
          状態リスナを登録します。
 Polygon getHotspotArea()
          ホットスポットとしてい設定されている位置を返します。
 String getLabel()
          ボタンに表示するラベルを返します。
 int getState()
          状態を返します。
 boolean hasHotspot()
          ホットスポットが設定されているかを返します。
 boolean isSeparate()
          指定されたイメージが、ボタンのイメージ部分だけかどうかを返します。
 void paint(Graphics g)
          イメージを実際に描画します。
protected  String paramString()
          このタブのパラメータ文字列を返します。
protected  void processEvent(AWTEvent e)
          このコンポーネントで発生するコンポーネントイベントを処理します。
protected  void processStateEvent(StateEvent e)
          このコンポーネントで発生する状態変更イベントを、 登録されているすべての StateListener に送ることにより、 状態変更イベントを処理します。
 void removeStateListener(StateListener l)
          状態リスナを解除します。
 void setBackImage(Image image)
          背景画像を設定します。
 void setEnabled(boolean b)
          コンポーネントを使用可能にします。
 void setImage(boolean separate, Image base, Image over, Image down, Image disable, Image sover, Image sdown, Image sdisable, Polygon sarea)
          イメージを設定します。
 void setImage(Image base)
          イメージを設定します。
 void setImage(Image base, Image spot)
          イメージを設定します。
 void setLabel(String label)
          ボタンに表示するラベルを設定します。
 void update(Graphics g)
          画面をアップデートします。
 
クラス net.hizlab.kagetaka.awt.SizedComponent から継承したメソッド
getMaximumSize, getMinimumSize, getPreferredSize
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

DISABLE

public static final int DISABLE
ボタンが無効な状態

関連項目:
定数フィールド値

DOWN

public static final int DOWN
マウスが押された状態

関連項目:
定数フィールド値

HOTSPOT_DOWN

public static final int HOTSPOT_DOWN
ホットスポットが押された状態

関連項目:
定数フィールド値

HOTSPOT_OVER

public static final int HOTSPOT_OVER
マウスがホットスポットの上に来た状態

関連項目:
定数フィールド値

NORMAL

public static final int NORMAL
通常の状態

関連項目:
定数フィールド値

OVER

public static final int OVER
マウスが上に来た状態

関連項目:
定数フィールド値
コンストラクタの詳細

ImageButton

public ImageButton(boolean separate,
                   Image base,
                   Image over,
                   Image down,
                   Image disable,
                   Image sover,
                   Image sdown,
                   Image sdisable,
                   Polygon sarea)
指定されたイメージを表示する、 イメージボタンを作成します。

separatefalse の場合は、 指定されたイメージがボタン全体を表すイメージとして認識され、 状態にあった枠や、ラベルが表示されなくなります。 true の場合、 ホットスポットは sover と同じ領域になります。

over, down, disable のいずれかに null が 指定された場合、base から適切なイメージが生成されます。 sdown, sdisable のいずれかに null が 指定された場合、sover から適切なイメージが生成されます。

ホットスポットが存在する(sover が指定されている)場合は、 separatetrue の場合のみ sareanull に指定でき、 この場合のホットスポットエリアは sover で指定された イメージ全体となります。 separatefalse にもかかわらず、 sareanull の場合は ホットスポットエリアが設定されないためホットスポットが機能しません。

パラメータ:
separate - イメージがボタンのイメージ部分のみを表す場合は true、 ボタンのイメージ全体を表す場合は false
base - 通常の状態
over - マウスが上に乗った状態、 base から生成する場合は null
down - ボタンが押された状態、 base から生成する場合は null
disable - ボタンが無効の状態、 base から生成する場合は null
sover - ホットスポット上にに来た状態のイメージ、 ホットスポットが存在しない場合は null
sdown - ホットスポットが押されている状態のイメージ、 ホットスポットが存在しない場合や sover から生成する場合は null
sdisable - ホットスポットが無効の状態のイメージ、 separatefalse の場合や、 ホットスポットが存在しない場合、 sover から生成する場合は null
sarea - sover に対してのホットスポットの位置、 ホットスポットが存在しない場合は null

ImageButton

public ImageButton(Image base)
指定されたイメージを表示する、 イメージボタンを作成します。 base で指定されたイメージを元に、 全ての状態を作ります。

パラメータ:
base - 通常の状態のイメージ

ImageButton

public ImageButton(Image base,
                   Image spot)
指定されたイメージを表示する、 ホットスポット付きのイメージボタンを作成します。 base, spot で指定されたイメージを元に、 全ての状態を作ります。

パラメータ:
base - 通常の状態のイメージ

ImageButton

public ImageButton(String label,
                   boolean separate,
                   Image base,
                   Image over,
                   Image down,
                   Image disable,
                   Image sover,
                   Image sdown,
                   Image sdisable,
                   Polygon sarea)
指定されたイメージとラベルを表示する、 イメージボタンを作成します。

パラメータ:
label - ボタンのラベル、表示しない場合は null
separate - イメージがボタンのイメージ部分のみを表す場合は true、 ボタンのイメージ全体を表す場合は false
base - 通常の状態
over - マウスが上に乗った状態、 base から生成する場合は null
down - ボタンが押された状態、 base から生成する場合は null
disable - ボタンが無効の状態、 base から生成する場合は null
sover - ホットスポット上にに来た状態のイメージ、 ホットスポットが存在しない場合は null
sdown - ホットスポットが押されている状態のイメージ、 ホットスポットが存在しない場合や sover から生成する場合は null
sdisable - ホットスポットが無効の状態のイメージ、 separatefalse の場合や、 ホットスポットが存在しない場合、 sover から生成する場合は null
sarea - sover に対してのホットスポットの位置、 ホットスポットが存在しない場合は null
関連項目:
ImageButton(boolean, Image, Image, Image, Image, Image, Image, Image, Polygon)

ImageButton

public ImageButton(String label,
                   Image base)
指定されたイメージとラベルを表示する、 イメージボタンを作成します。 base で指定されたイメージを元に、 全ての状態を作ります。

パラメータ:
label - ボタンのラベル、表示しない場合は null
base - 通常の状態のイメージ

ImageButton

public ImageButton(String label,
                   Image base,
                   Image spot)
指定されたイメージとラベルを表示する、 ホットスポット付きのイメージボタンを作成します。 base, spot で指定されたイメージを元に、 全ての状態を作ります。

パラメータ:
label - ボタンのラベル、表示しない場合は null
base - 通常の状態のイメージ
spot - ホットスポットのイメージ、 ホットスポットが存在しない場合は null
メソッドの詳細

addStateListener

public void addStateListener(StateListener l)
状態リスナを登録します。

パラメータ:
l - 登録する状態リスナ

getHotspotArea

public Polygon getHotspotArea()
ホットスポットとしてい設定されている位置を返します。

戻り値:
ホットスポットの位置

getLabel

public String getLabel()
ボタンに表示するラベルを返します。

戻り値:
ボタンのラベル

getState

public int getState()
状態を返します。

戻り値:
状態

hasHotspot

public boolean hasHotspot()
ホットスポットが設定されているかを返します。

戻り値:
ホットスポットが設定されている場合は true、 それ以外の場合は false

isSeparate

public boolean isSeparate()
指定されたイメージが、ボタンのイメージ部分だけかどうかを返します。

戻り値:
ボタンのイメージ部分だけの場合は true、 ボタン全体の場合は false

paint

public void paint(Graphics g)
イメージを実際に描画します。

パラメータ:
g - グラフィックス

paramString

protected String paramString()
このタブのパラメータ文字列を返します。

戻り値:
パラメータ文字列

processEvent

protected void processEvent(AWTEvent e)
このコンポーネントで発生するコンポーネントイベントを処理します。

パラメータ:
e - イベント

processStateEvent

protected void processStateEvent(StateEvent e)
このコンポーネントで発生する状態変更イベントを、 登録されているすべての StateListener に送ることにより、 状態変更イベントを処理します。

パラメータ:
e - イベント

removeStateListener

public void removeStateListener(StateListener l)
状態リスナを解除します。

パラメータ:
l - 解除する状態リスナ

setBackImage

public void setBackImage(Image image)
背景画像を設定します。

パラメータ:
image - 画像

setEnabled

public void setEnabled(boolean b)
コンポーネントを使用可能にします。

パラメータ:
b - 利用可能にする場合は true、 利用不可にする場合は false

setImage

public void setImage(boolean separate,
                     Image base,
                     Image over,
                     Image down,
                     Image disable,
                     Image sover,
                     Image sdown,
                     Image sdisable,
                     Polygon sarea)
イメージを設定します。

パラメータ:
separate - イメージがボタンのイメージ部分のみを表す場合は true、 ボタンのイメージ全体を表す場合は false
base - 通常の状態
over - マウスが上に乗った状態、 base から生成する場合は null
down - ボタンが押された状態、 base から生成する場合は null
disable - ボタンが無効の状態、 base から生成する場合は null
sover - ホットスポット上にに来た状態のイメージ、 ホットスポットが存在しない場合は null
sdown - ホットスポットが押されている状態のイメージ、 ホットスポットが存在しない場合や sover から生成する場合は null
sdisable - ホットスポットが無効の状態のイメージ、 separatefalse の場合や、 ホットスポットが存在しない場合、 sover から生成する場合は null
sarea - sover に対してのホットスポットの位置、 ホットスポットが存在しない場合は null
関連項目:
ImageButton(boolean, Image, Image, Image, Image, Image, Image, Image, Polygon)

setImage

public void setImage(Image base)
イメージを設定します。

パラメータ:
base - 通常の状態
関連項目:
ImageButton(Image)

setImage

public void setImage(Image base,
                     Image spot)
イメージを設定します。

パラメータ:
base - 通常の状態
spot - ホットスポットのイメージ、 ホットスポットが存在しない場合は null
関連項目:
ImageButton(Image, Image)

setLabel

public void setLabel(String label)
ボタンに表示するラベルを設定します。

パラメータ:
label - ボタンのラベル

update

public void update(Graphics g)
画面をアップデートします。

パラメータ:
g - グラフィックス

Kagetaka

Copyright (c) 2002-2003 The Kagetaka Project 'December 16, 2003'