XmPrimitive(3XM) — NEWS-OS Programmer’s Manual
名称
XmPrimitive — Primitive widget クラス
形式
#include <Xm/Xm.h>
解説
Primitive は他の widget クラスをサポートするスーパークラスとして使用される widget クラスです。 これは、ボーダの描画やハイライト、トラバースの実行および非実行、Primitive widget に必要な様々なコールバックのリストをあつかいます。
クラス
Primitive は Core のクラスより動作とリソースを継承します。
クラスポインタは xmPrimitiveWidgetClass です。
クラスの名称は XmPrimitive です。
新しいリソース
次の表は、データを指定するのに用いる widget リソースの一覧です。 継承されたクラスのリソースの値もまた widget の属性として設定することができます。 .Xdefaults ファイルの中で名前やクラスでリソースを参照する場合は、語頭の XmN または XmC を取り除いた名称を用いてください。 .Xdefaults ファイルの中でリソースに定義された値を設定するには、語頭の Xm を取り除いた名称を用いてください。 (大文字と小文字は区別されませんが、語間のアンダースコアは必要です。 ) 「アクセス」欄の文字は、与えられたリソースを、widget 生成時に設定できるか (C)、XtSetValues で設定できるか (S)、XtGetValues で取り出すことができるか (G)、あるいは利用できないか (N/A) を示します。
| XmPrimitive リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| ShadowColor XmNbottomShadowColor | XmCForeground | Pixel | dynamic | CSG |
| ShadowPixmap XmNbottomShadowPixmap | ShadowPixmap XmCBottomShadowPixmap | Pixmap | _PIXMAP XmUNSPECIFIED_PIXMAP | CSG |
| XmNforeground | XmCForeground | Pixel | dynamic | CSG |
| Callback XmNhelpCallback | XmCCallback | List XtCallbackList | NULL | C |
| Color XmNhighlightColor | XmCForeground | Pixel | Black | CSG |
| OnEnter XmNhighlightOnEnter | OnEnter XmCHighlightOnEnter | Boolean | False | CSG |
| Pixmap XmNhighlightPixmap | Pixmap XmCHighlightPixmap | Pixmap | dynamic | CSG |
| Thickness XmNhighlightThickness | Thickness XmCHighlightThickness | short | 0 | CSG |
| Thickness XmNshadowThickness | Thickness XmCShadowThickness | short | 2 | CSG |
| Color XmNtopShadowColor | ground XmCBackground | Pixel | dynamic | CSG |
| Pixmap XmNtopShadowPixmap | Pixmap XmCTopShadowPixmap | Pixmap | _PIXMAP XmUNSPECIFIED_PIXMAP | CSG |
| XmNtraversalOn | XmNTraversalOn | Boolean | False | CSG |
| XmNunitType | XmCUnitType | unsigned char | XmPIXELS | CSG |
| XmNuserData | XmCUserData | caddr_t | NULL | CSG |
XmNbottomShadowColor
ボーダの影の上側と左側を描くのに使用されるピックスマップを指定します。
XmNbottomShadowPixmap
ボーダの影の下側と右側を描くのに使用されるピックスマップを指定します。
XmNforeground
Primitive widget が使用する、フォアグラウンドに塗る色を指定します。
XmNhelpCallback
ヘルプキーシーケンスが押された時に呼び出されるコールバックのリストを指定します。 コールバックによって送られるリーズンは XmCR_HELP です。 このリソースに関連したトランスレーションはありません。 アプリケーションがヘルプに対するトランスレーションを組み込む必要があります。
XmNhighlightColor
ハイライトの矩形の色を指定します。 ハイライトピックスマップリソースが XmUNSPECIFIED_PIXMAP ならば、この色が使用されます。
XmNhighlightOnEnter
カーソルが widget の中に移動した時にハイライトの矩形を描くかを指定します。 このリソースが True であり、XmNtransversalOn が False なら、カーソルがウィンドウに移動してきた時に矩形は、ウィンドウをハイライトにします。 XmNtransversalOn リソースが True に設定されているならば、このリソースは無視されます。
XmNhighlightPixmap
ハイライトの矩形を描くのに使用されるピックスマップを指定します。
XmNhighlightThickness
ハイライトの矩形の厚みを指定します。
XmNshadowThickness
描かれるボーダの影の太さを指定します。
XmNtopShadowColor
ボーダの影の上側と左側を描くのに使用される色を指定します。 XmNtopShadowPixmap リソースが NULL ならばこの色が使用されます。
XmNtopShadowPixmap
ボーダの影の上側と左側を描くのに使用されるピックスマップを指定します。
XmNtraversalOn
この widget に対してトラバースをアクティブにするかを指定します。
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 ポイントは一般的にテキストの処理に使われる単位で、1/72 インチです。
•Xm100TH_FONT_UNITS — widget に提供されたすべての値は 1/100 フォントユニットを単位としてあつかわれます。 フォントユニットとして使用される値は 2 つある方法の内の 1 つによって決められます。 リソース XmNfont はデフォルトファイル中やコマンドラインで使用されます。 -fn や -font といった標準コマンドラインオプションも使われます。 フォントユニットの値はフォントのプロパティである QUAD_WIDTH として受け取られます。 関数 XmSetFontUnits はアプリケーションがフォントユニット値を指定することを許可します。
XmNuserData
アプリケーションが widget に必要なデータを付加することを許可します。 内部的には使用されないリソースです。
ダイナミックカラーデフォルト
フォアグラウンド、バックグラウンド、上側の影、下側の影のリソースはダイナミックに既定されます。 色のデータが指定されない時は自動的に色を発生させます。 モノクロームシステムでは黒と白を配合して色を発生させます。 カラーシステムでは 3 次元の像を正しく隈取りするのに使われる 4 つの色を発生させます。
バックグラウンドの色だけが widget に対して指定されれば、上側の影、下側の影、フォアグラウンドの色は 3 次元の外観を見せるように発生されます。 淡い色を使用すると最もうまく色を発生できます。 純粋な赤色や緑色や青色を使うと良い結果が得られません。
色は生成時にしか発生されません。 XtSetValues を使用してバックグラウンドをリセットしても他の色は再び作られません。
継承されるリソース
Primitive は次のスーパークラスから動作とリソースを継承します。 これらのリソースの完全な解説は、そのスーパークラスのマニュアルページを参照してください。
| Core リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNaccelerators | XmCAccelerators | XtTranslations | NULL | CSG |
| XmNancestorSensitive | XmCSensitive | Boolean | True | G |
| XmNbackground | XmCBackground | Pixel | dynamic | CSG |
| XmNbackgroundPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| XmNborderColor | XmCBorderColor | Pixel | Black | CSG |
| XmNborderPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| XmNborderWidth | XmCBorderWidth | Dimension | 0 | CSG |
| XmNcolormap | XmCColormap | Colormap | XtCopyFromParent | CG |
| XmNdepth | XmCDepth | int | XtCopyFromParent | CG |
| XmNdestroyCallback | XmCCallback | XtCallbackList | NULL | C |
| XmNheight | XmCHeight | Dimension | 0 | CSG |
| XmNmappedWhenManaged | XmCMappedWhenManaged | Boolean | True | CSG |
| XmNscreen | XmCScreen | Pointer | XtCopyScreen | CG |
| XmNsensitive | XmCSensitive | Boolean | True | CSG |
| XmNtranslations | XmCTranslations | XtTranslations | NULL | CSG |
| XmNwidth | XmCWidth | Dimension | 0 | CSG |
| XmNx | XmCPosition | Position | 0 | CSG |
| XmNy | XmCPosition | Position | 0 | CSG |
動作
Shift<Key>Tab:
フォーカスを前のタブグループに含まれる最初の項目に移動します。 タブグループリストの初めに到達すればタブグループリストの最後に戻ります。
<Key>Tab:
フォーカスを次のタブグループに含まれる最初の項目に移動します。 現在のタブグループがタブグループリストの最後ならば、タブグループリストの最初に戻ります。
<Key>Up or <Key>Left:
キーボードフォーカスを現在のタブグループ中の前の Primitive widget や gadget に移動します。 前の widget や gadget とは、子のタブグループのリストの前の内容です。 必要ならば、リストの最初に来たらリストの最後に戻ります。
<Key>Down or <Key>Right:
キーボードフォーカスを現在のタブグループの次の Primitive widget や gadget に移動します。 前の widget や gadget とは、子のタブグループのリストの次の内容です。 必要ならば、リストの最後に来たらリストの最初に戻ります。
<Key>Home:
キーボードフォーカスを現在のタブグループの最初の Primitive widget や gadget に移動します。
デフォルトのトランスレーション
以下は Primitive に関するデフォルトのトランスレーションです。
<FocusIn>:PrimitiveFocusIn()
<FocusOut>:PrimitiveFocusOut()
<Unmap>:PrimitiveUnmap()
Shift<Key>Tab:PrimitivePrevTabGroup()
<Key>Tab:PrimitiveNexTabGroup()
<Key>Up:PrimitiveTraversePrev()
<Key>Down:PrimitiveTraverseNext()
<Key>Left:PrimitiveTraversePrev()
<Key>Right:PrimitiveTraverseNext()
<Key>Home:PrimitiveTraverseHome()
関連事項
NEWS-OSRelease 4.2.1R