XmGadget(3XM) — NEWS-OS Programmer’s Manual

名称

XmGadget — Gadget widget クラス

形式

#include <Xm/Xm.h>

解説

Gadget は、他の Gadget クラスをサポートするスーパークラスとして使用される widget クラスです。 Gadget は、影のボーダ描画、ハイライト、トラバースの実行および非実行、Gadget に必要なさまざまなコールバックリストを処理します。

XmManager によって定義される色リソースとピックスマップリソースは、Gadget が直接使用します。 XtSetValues を使って Manager widget に対するリソースの 1 つを変更すると、そのマネージャ内の子である Gadget すべても変化します。

クラス

Gadget は、Object および RectObj クラスから動作とリソースを継承します。

クラスポインタは、xmGadgetClass です。

クラス名は、XmGadget です。

新しいリソース

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

XmGadget リソース一覧
名称	クラス	型	デフォルト	アクセス
XmNhelpCallback	XmCCallback	XtCallbackList	NULL	C
XmNhighlightOnEnter	XmCHighlightOnEnter	Boolean	False	CSG
XmNhighlightThickness	XmCHighlightThickness	short	0	CSG
XmNshadowThickness	XmCShadowThickness	short	2	CSG
XmNtraversalOn	XmCTraversalOn	Boolean	False	CSG
XmNunitType	XmCUnitType	unsigned char	XmPIXELS	CSG
XmNuserData	XmCUserData	caddr_t	NULL	CSG

XmNhelpCallback
ヘルプキーのシーケンスが入力された時に呼び出されるコールバックのリストを指定します。コールバックによって送られるリーズンは XmCR_HELP です。

XmNhighlightOnEnter
ボーダをハイライトにして描くかどうかを指定します。このリソースは、XmNtraversalOn が True であれば無視されます。

XmNhighlightThickness
ハイライトにする矩形の太さを指定します。

XmNshadowThickness
描かれるボーダの影の大きさを指定します。

XmNtraversalOn
この gadget に対するトラバースの実行を指定します。

XmNunitType
解像度によらない処理のための基本的なサポートを行います。大きさや位置を指定するリソースと共に widget が使用する、単位の型を定義します。 XmNunitType リソースが明示的に設定されていなければ、親 widget の単位の型がデフォルトとなります。親が Xm100TH_POINTS という単位の型を持っていれば、XmNunitType リソースが設定されていない子の単位の型はすべて、Xm100TH_POINTS になります。この仕様は、親が XmManager のサブクラスである widget にのみ適用されます。親が XmManager のサブクラスではない widget は、単位の型が XmPIXELS になります。

XmNunitType は、次の値をとることができます。

•XmPIXELS — widget に与えられるすべての値は、通常のピクセル値としてあつかわれます。このリソースに対するデフォルトです。

•Xm100TH_MILLIMETERS — widget に与えられるすべての値は、1/100 ミリを単位としてあつかわれます。

•Xm1000TH_INCHES — widget に与えられるすべての値は、1/1000 インチを単位としてあつかわれます。

•Xm100TH_POINTS — widget に与えられるすべての値は、1/100 ポイントを単位としてあつかわれます。ポイントとは、テキストを処理するアプリケーションで普通に使用される単位で、1/72 インチに定義されています。

•Xm100TH_FONT_UNITS — widget に与えられるすべての値は、1/100 フォント単位を単位としてあつかわれます。フォント単位として使用される値は、2 つの方法のうちのいずれかの方法で決定されます。 XmNfont リソースは、デフォルトファイル中あるいはコマンドラインで使用することができます。標準のコマンドラインオプション -fn および -font も、使用することができます。フォント単位値は、フォントの QUAD_WIDTH プロパティとして使用されます。 XmSetFontUnits 関数は、アプリケーションがフォント単位値を指定することを可能にします。

XmNuserData
アプリケーションが、必要な特定のデータすべてを gadget に設定することを可能にします。内部で使用されないリソースです。

継承されるリソース

Gadget は、次に挙げるスーパークラスからのリソースを継承します。これらのリソースについての完全な解説は、そのスーパークラスのマニュアルページを参照してください。

RectObj リソース一覧
名称	クラス	型	デフォルト	アクセス
XmNancestorSensitive	XmCSensitive	Boolean	XtCopyFromParent	CSG
XmNborderWidth	XmCBorderWidth	Dimension	0	CSG
XmNheight	XmCHeight	Dimension	0	CSG
XmNsensitive	XmCSensitive	Boolean	True	CSG
XmNwidth	XmCWidth	Dimension	0	CSG
XmNx	XmCPosition	Position	0	CSG
XmNy	XmCPosition	Position	0	CSG

Object リソース一覧
名称	クラス	型	デフォルト	アクセス
XmNdestroyCallback	XmCCallback	XtCallbackList	NULL	C

動作

Gadget は、それらに関連したトランスレーションを持つことができません。このため、Gadget の動作は、Gadget が置かれている Manager widget によって決定されます。次に挙げるのは、Manager widget が捕捉し Gadget に転送するイベントの型です。

•ButtomPress

•ButtonRelease

•EnterNotify

•LeaveNotify

•FocusIn

•FocusOut

•MotionNotify

すべての Manager widget がサポートしているトランスレーションについての解説は、XmManager(3XM) を参照してください。

Museum

XmGadget(3XM) — NEWS-OS Programmer’s Manual

名称

形式

解説

クラス

新しいリソース

継承されるリソース

動作

関連項目