名称

XmArrowButtonGadget — ArrowButtonGadget widget クラス

形式

#include <Xm/ArrowBG.h>

解説

ArrowButtonGadget は、まわりを影で囲まれた、方向を持った矢印からなっています。 選択されると、影が動いて ArrowButtonGadget が押し込まれたように見えます。 ArrowButtonGadget が選択されていない状態にすると、影が動いて ArrowButtonGadget が離されて、浮き上がったように見えます。

クラス

ArrowButtonGadget は、Object、RectObj、XmGadget から動作とリソースを継承します。

クラスポインタは xmArrowButtonGadgetClass です。

クラス名は XmArrowButtonGadget です。

新しいリソース

次の表は、データを指定するのに用いる widget リソースの一覧です。 継承されたクラスのリソースの値もまた widget の属性として設定することができます。 .Xdefaults ファイルの中で名前やクラスでリソースを参照する場合は、語頭の XmN または XmC を取り除いた名称を用いてください。 .Xdefaults ファイルの中でリソースに定義された値を設定するには、語頭の Xm を取り除いた名称を用いてください。 (大文字と小文字は区別されませんが、語間のアンダースコアは必要です。 ) 「アクセス」欄の文字は、与えられたリソースを、widget 生成時に設定できるか (C)、XtSetValues で設定できるか (S)、XtGetValues で取り出すことができるか (G)、あるいは利用できないか (N/A) を示します。

XmNactiveCallback
ArrowButtonGadget がアクティブになった時に呼び出されるコールバックのリストを指定します。 ボタンをアクティブにするには、ポインタが ArrowButtonGadget の中にあるときに、マウスボタン 1 をクリックしてください。 ArrowButtonGadget をアクティブにすることは、それをディスアームすることにもなります。 このコールバックによって送られるリーズンは XmCR_ACTIVATE です。

XmNarmCallback
ArrowButtonGadget がアームされた時に呼び出されるコールバックのリストを指定します。 ボタンをアームするには、ポインタが ArrowButtonGadget の中にあるときに、マウスボタン 1 を押してください。 このコールバックのためのリーズンは XmCR_ARM です。

XmNarrowDirection
矢印の方向を設定します。 このリソースには次の値があります。

•XmARROW_UP. 

•XmARROW_DOWN. 

•XmARROW_LEFT. 

•XmARROW_RIGHT. 

XmNdisarmCallback
ArrowButtonGadget がディスアームされた時に呼び出されるコールバックのリストを指定します。 ボタンをディスアームするには、ポインタが ArrowButtonGadget の中にあるときに、マウスボタン 1 をクリックしてください。 このコールバックのためのリーズンは XmCR_DISARM です。

継承されるリソース

ArrowButtonGadget は、次のようなスーパークラスから動作とリソースを継承しています。 これらのリソースに関する詳細は、そのスーパークラスの項を参照してください。

コールバックされる情報

各コールバックでは次の構造体が返されます。

typedef struct
{
intreason;
XEvent∗ event;
} XmAnyCallbackStruct;

reasonなぜコールバックが起きたのかを示します。

eventコールバックをトリガした XEvent を指します。 Primitive のリソースである XmNtraversalOn が True の時にコールバックがトリガされたか、ArmAndActivate アクションルーチンを通じてコールバックがアクセスされた時、XmNactivateCallback に対するこのイベントは NULL です。

動作

<Btn1Down>:
このアクションによって矢印がアームされ、影が選択された状態に描かれます。 XmNarmCallback で指定されたコールバックが呼び出されます。

<Btn1Up>:
ポインタが ArrowButtonGadget 上にあるときにマウスのボタンが離されると、矢印の影は選択されていない状態に描き直されます。 XmNdisarmCallback で指定されたコールバックに続いて、XmNactivateCallback で指定されたコールバックが呼び出されます。

ポインタが ArrowButtonGadget 上にないときにマウスのボタンが離された時は、 XmNdisarmCallback で指定されたコールバックが呼び出されます。

<Leave Window>:
マウスのボタンが押されたままカーソルが widget のウィンドウの外へ出ると、矢印の影は選択されていない状態に描き直されます。

<Enter Window>:
マウスのボタンが押されたままカーソルが widget のウィンドウを出て、また入ってくると、矢印の影はボタンが最初にアームされた時と同様に描き直されます。

キーボードトラバース

キーボードトラバースに関する情報は、XmGadget (3X) のマニュアルページ、およびその動作とデフォルトのトランスレーションに関する頁を参照してください。

関連事項

Object(3XM), RectObj(3XM), XmCreateArrowButtonGadget(3XM), XmGadget(3XM)

NEWS-OSRelease 4.2.1R