名称

XmSeparator — Separator widget クラス

形式

#include <Xm/Separator.h>

解説

Separator は、ディスプレイ上で項目を分離するプリミティブ widget です。 垂直、水平のほかに、いくつかの異なった線の描画スタイルが提供されています。

Separator による線は自動的に、水平方向には widget の高さ、垂直方向には widget の幅の中心に描画されます。 新しい XmNseparatorType をもつ XtSetValues は、XtSetValues の呼び出しで明示的に幅と高さを指定しない限り、widget のサイズを最小の高さ (水平方向) と最小の幅 (垂直方向) に変更します。

Separator は影を描画しません。 XmNshadowType が XmSHADOW_ETCHED_IN または XmSHADOW_ETCHED_OUT であるとき、プリミティブリソース XmNshadowThickness は Separator の太さとして使用されます。

Separator はハイライトにならず、トラバースもしません。 プリミティブリソース XmNtraversalOn は強制的に False になります。

XmNseparatorType を XmNO_LINE にすることによって、アプリケーションプログラマは異なる描画スタイルを選択できます。 Core で定義されている XmNbackgroundPixmap の引数の型を使って引数のリストを作り、widget の高さのビックスマップとして作成し、バックグラウンドビックスマップとして使用することができます。 widget が再描画されるときはいつも、必要なセパレータを表示したままバックグラウンドが表示されます。

クラス

Separator は、Core と XmPrimitive クラスの動作とリソースを継承します。

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

クラス名は XmSeparator です。

新しいリソース

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

XmNmargin
水平方向には、Separator のボーダと描画された線との間の右と左の空間を指定します。 垂直方向には、Separator のボーダと描画された線との間の上と下の空間を指定します。

XmNorientation
Separator を垂直あるいは水平のどちらで表示するか指定します。 このリソースは、 XmVERTICAL か XmHORIZONTAL のどちらかの値になります。

XmNseparatorType
Separator widget で描画される線のスタイルを指定します。

•XmSINGLE_LINE — 単線

•XmDOUBLE_LINE — 2 重線

•XmSINGLE_DASHED_LINE — 1 点鎖線

•XmDOUBLE_DASHED_LINE — 2 点鎖線

•XmNO_LINE — 線なし

•XmSHADOW_ETCHED_IN — ウィンドウをくぼんだように見せる効果をもつ 2 重線。 2 重線の太さは XmNshadowThickness の値と同じです。 水平方向には、上端の線は XmNtopShadowColor で描画され、下端の線は XmNbottomShadowColor で描画されます。 垂直方向には、左の線は XmNtopShadowColor で描画され、右の線は XmNbottomShadowColor で描画されます。

•XmSHADOW_ETCHED_OUT — ウィンドウから浮き上がったように見せる効果をもつ 2 重線。 2 重線の太さは XmNshadowThickness の値と同じです。 水平方向には、上端の線は XmNbottomShadowColor で描画され、下端の線は XmNtopShadowColor で描画されます。 垂直方向には、左の線は XmNbottomShadowColor で描画され、右の線は XmNtopShadowColor で描画されます。

継承されるリソース

Separator widget は、次のスーパークラスの動作とリソースを継承します。 これらの詳細な記述はそれぞれのスーパークラスのマニュアルページを参照してください。

キーボードトラバース

キーボードトラバースについての詳細は、XmPrimitive(3XM) のマニュアルページと、その「動作」と「デフォルトのトランスレーション」のセクションを参照してください。

関連事項

Core(3XM), XmCreateSeparator(3XM), XmPrimitive(3XM)

NEWS-OSRelease 4.1C