Kagetaka

net.hizlab.kagetaka.awt
クラス ImageButton

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

public class ImageButton
extends Component

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

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

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

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

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

入れ子クラスの概要
 
クラス 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
          マウスが上に来た状態
 
クラス 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 isSeparate, Image buttonNormalImage, Image buttonOverImage, Image buttonDownImage, Image buttonDisableImage, Image hotspotOverImage, Image hotspotDownImage, Image hotspotDisableImage, Polygon hotspotArea)
          指定されたイメージを表示する、イメージボタンを作成します。
ImageButton(Image buttonBaseImage)
          指定されたイメージを表示する、イメージボタンを作成します。
ImageButton(Image buttonBaseImage, Image hotspotBaseImage)
          指定されたイメージを表示する、 ホットスポット付きのイメージボタンを作成します。
ImageButton(String label, boolean isSeparate, Image buttonNormalImage, Image buttonOverImage, Image buttonDownImage, Image buttonDisableImage, Image hotspotOverImage, Image hotspotDownImage, Image hotspotDisableImage, Polygon hotspotArea)
          指定されたイメージとラベルを表示する、 イメージボタンを作成します。
ImageButton(String label, Image buttonBaseImage)
          指定されたイメージとラベルを表示する、イメージボタンを作成します。
ImageButton(String label, Image buttonBaseImage, Image hotspotBaseImage)
          指定されたイメージとラベルを表示する、 ホットスポット付きのイメージボタンを作成します。
 
メソッドの概要
 void addNotify()
          コンポーネントがコンテナに追加されたことを、そのコンポーネントに通知し、 ピアが必要であれば、作成しなければなりません。
 void addStateListener(StateListener l)
          状態リスナを登録します。
 Polygon getHotspotArea()
          ホットスポットとしてい設定されている位置を返します。
 String getLabel()
          ボタンに表示するラベルを返します。
 Dimension getMaximumSize()
          ステータスバーの最大サイズを返します。
 Dimension getMinimumSize()
          ステータスバーの最小のサイズを返します。
 Dimension getPreferredSize()
          ステータスバーの推奨サイズを返します。
 int getState()
          状態を返します。
 boolean hasHotspot()
          ホットスポットが設定されているかを返します。
 void invalidate()
          コンポーネントを無効にします。
 boolean isSeparate()
          指定されたイメージが、ボタンのイメージ部分だけかどうかを返します。
 void paint(Graphics g)
          イメージを実際に描画します。
protected  String paramString()
          このタブのパラメータ文字列を返します。
protected  void processEvent(AWTEvent e)
          このコンポーネントで発生するコンポーネントイベントを処理します。
protected  void processStateEvent(StateEvent e)
          このコンポーネントで発生する状態変更イベントを、 登録されているすべての StateListener に送ることにより、 状態変更イベントを処理します。
 void removeNotify()
          コンポーネントがコンテナから削除されたことをそのコンポーネントに通知し、 ピアが存在すれば破壊します。
 void removeStateListener(StateListener l)
          状態リスナを解除します。
 void setBackImage(Image image)
          背景画像を設定します。
 void setEnabled(boolean b)
          コンポーネントを使用可能にします。
 void setImage(boolean isSeparate, Image buttonNormalImage, Image buttonOverImage, Image buttonDownImage, Image buttonDisableImage, Image hotspotOverImage, Image hotspotDownImage, Image hotspotDisableImage, Polygon hotspotArea)
          イメージを設定します。
 void setImage(Image buttonNormalImage)
          イメージを設定します。
 void setImage(Image buttonNormalImage, Image hotspotBaseImage)
          イメージを設定します。
 void setLabel(String label)
          ボタンに表示するラベルを設定します。
 void update(Graphics g)
          画面をアップデートします。
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, 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, 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, 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 isSeparate,
                   Image buttonNormalImage,
                   Image buttonOverImage,
                   Image buttonDownImage,
                   Image buttonDisableImage,
                   Image hotspotOverImage,
                   Image hotspotDownImage,
                   Image hotspotDisableImage,
                   Polygon hotspotArea)
指定されたイメージを表示する、イメージボタンを作成します。

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

buttonOverImage, buttonDownImage, buttonDisableImage のいずれかに null が指定された場合、 buttonNormalImage から適切なイメージが生成されます。 hotspotDownImage, hotspotDisableImage のいずれかに null が指定された場合、 hotspotOverImage から適切なイメージが生成されます。

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

パラメータ:
isSeparate - イメージがボタンのイメージ部分のみを 表す場合はtrue、 ボタンのイメージ全体を表す場合は false
buttonNormalImage - 通常の状態
buttonOverImage - マウスが上に乗った状態、 buttonNormalImage から生成する場合は null
buttonDownImage - ボタンが押された状態、 buttonNormalImage から生成する場合は null
buttonDisableImage - ボタンが無効の状態、 buttonNormalImage から生成する場合は null
hotspotOverImage - ホットスポット上に来た状態のイメージ、 ホットスポットが存在しない場合は null
hotspotDownImage - ホットスポットが押されている状態のイメージ、 ホットスポットが存在しない場合や hotspotOverImage から生成する場合は null
hotspotDisableImage - ホットスポットが無効の状態のイメージ、 isSeparatefalse の場合や、 ホットスポットが存在しない場合、 hotspotOverImage から生成する場合は null
hotspotArea - hotspotOverImage に対してのホットスポットの位置、 ホットスポットが存在しない場合は null

ImageButton

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

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

ImageButton

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

パラメータ:
buttonBaseImage - 通常の状態のイメージ
hotspotBaseImage - ホットスポットのイメージ、 ホットスポットが存在しない場合は null

ImageButton

public ImageButton(String label,
                   boolean isSeparate,
                   Image buttonNormalImage,
                   Image buttonOverImage,
                   Image buttonDownImage,
                   Image buttonDisableImage,
                   Image hotspotOverImage,
                   Image hotspotDownImage,
                   Image hotspotDisableImage,
                   Polygon hotspotArea)
指定されたイメージとラベルを表示する、 イメージボタンを作成します。

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

ImageButton

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

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

ImageButton

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

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

addNotify

public void addNotify()
コンポーネントがコンテナに追加されたことを、そのコンポーネントに通知し、 ピアが必要であれば、作成しなければなりません。


addStateListener

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

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

getHotspotArea

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

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

getLabel

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

戻り値:
ボタンのラベル

getMaximumSize

public Dimension getMaximumSize()
ステータスバーの最大サイズを返します。 高さのみ制限されています。

戻り値:
最大サイズ

getMinimumSize

public Dimension getMinimumSize()
ステータスバーの最小のサイズを返します。 高さのみ制限されています。

戻り値:
最小サイズ

getPreferredSize

public Dimension getPreferredSize()
ステータスバーの推奨サイズを返します。 高さのみ指定されています。

戻り値:
推奨サイズ

getState

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

戻り値:
状態

hasHotspot

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

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

invalidate

public void invalidate()
コンポーネントを無効にします。


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 - イベント

removeNotify

public void removeNotify()
コンポーネントがコンテナから削除されたことをそのコンポーネントに通知し、 ピアが存在すれば破壊します。


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 isSeparate,
                     Image buttonNormalImage,
                     Image buttonOverImage,
                     Image buttonDownImage,
                     Image buttonDisableImage,
                     Image hotspotOverImage,
                     Image hotspotDownImage,
                     Image hotspotDisableImage,
                     Polygon hotspotArea)
イメージを設定します。

パラメータ:
isSeparate - イメージがボタンのイメージ部分のみを 表す場合はtrue、 ボタンのイメージ全体を表す場合は false
buttonNormalImage - 通常の状態
buttonOverImage - マウスが上に乗った状態、 buttonNormalImage から生成する場合は null
buttonDownImage - ボタンが押された状態、 buttonNormalImage から生成する場合は null
buttonDisableImage - ボタンが無効の状態、 buttonNormalImage から生成する場合は null
hotspotOverImage - ホットスポット上に来た状態のイメージ、 ホットスポットが存在しない場合は null
hotspotDownImage - ホットスポットが押されている状態のイメージ、 ホットスポットが存在しない場合や hotspotOverImage から生成する場合は null
hotspotDisableImage - ホットスポットが無効の状態のイメージ、 isSeparatefalse の場合や、 ホットスポットが存在しない場合、 hotspotOverImage から生成する場合は null
hotspotArea - hotspotOverImage に対してのホットスポットの位置、 ホットスポットが存在しない場合は null
関連項目:
ImageButton(boolean, Image, Image, Image, Image, Image, Image, Image, Polygon)

setImage

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

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

setImage

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

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

setLabel

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

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

update

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

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

Kagetaka

Copyright (c) 2002-2004 The Kagetaka Project 'November 20, 2004'