XmFrame(3XM) — NEWS-OS Programmer’s Manual
名称
XmFrame — Frame widget クラス
形式
#include <Xm/Frame.h>
解説
Frame は、 Frame が引いたボーダ内に 1 つの子を囲むのに使用する、非常に単純なマネージャです。 Frame は、 Manager クラスのリソースを使用してボーダを引き、 Frame の大きさが常に Frame の子の大きさと Frame に対して定義されているマージンとを加えたものに一致するように、ジオメトリ (配置) のマネージメントを行います。
Frame は、マネージャにプリミティブな widget と同じボーダを持たせたいアプリケーションの開発者が、他のマネージャを囲むのに使うことがほとんどです。 Frame は、同じ型のボーダをサポートしていない複数のプリミティブ widget を囲むのにも使用できます。 このことは、いろいろな widget を使用しているアプリケーションを開発する場合に、見た目の整合性を与えます。
Frame の親が Shell widget の場合、 XmNshadowType は XmSHADOW_OUT に設定され、 Manager リソースの XmNshadowThickness はデフォルトで 1 に設定されます。
クラス
Frame は、 Core 、 Composite 、 Constraint 、および XmManager クラスからの動作とリソースを継承します。
クラスポインタは、 xmFrameWidgetClass です。
クラス名は、 XmFrame です。
新しいリソース
次の表は、データを指定するのに用いる widget リソースの一覧です。 継承されたクラスのリソースの値もまた widget の属性として設定することができます。 .Xdefaults ファイルの中で名前やクラスでリソースを参照する場合は、語頭の XmN または XmC を取り除いた名称を用いてください。 .Xdefaults ファイルの中でリソースに定義された値を設定するには、語頭の Xm を取り除いた名称を用いてください。 (大文字と小文字は区別されませんが、語間のアンダースコアは必要です。 ) 「アクセス」欄の文字は、与えられたリソースを、widget 生成時に設定できるか (C) 、 XtSetValues で設定できるか (S) 、 XtGetValues で取り出すことができるか (G) 、あるいは利用できないか (N/A) を示します。
| XmFrame リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNmarginWidth | XmCMarginWidth | short | 0 | CSG |
| XmNmarginHeight | XmCMarginHeight | short | 0 | CSG |
| XmNshadowType | XmCShadowType | unsigned char | XmSHADOW_ETCHED_IN | CSG |
XmNmarginWidth
Frame の子と Frame の影の間の、左右端で挿入されるスペースを指定します。
XmNmarginHeight
Frame の子と Frame の影の間の、上下端で挿入されるスペースを指定します。
XmNshadowType
Frame に対する描画スタイルを記述します。 このリソースは、次の値をとることができます。
•XmSHADOW_IN — Frame を挿入されたものとして描きます。 これは、上端の影と下端の影の絵が反転されることを意味します。
•XmSHADOW_OUT — Frame を初めからあるものとして描きます。
•XmSHADOW_ETCHED_IN — ウィンドウ中に溝が掘られているような効果を与えるために 2 重線を使用して、 Frame を描きます。 2 重線の太さは、 XmNshadowThickness の値になります。 これは、 Frame の親が Shell widget の場合に、デフォルトとなります。
•XmSHADOW_ETCHED_OUT — ウィンドウから浮き上がっているような効果を与えるために 2 重線を使用します。 2 重線の太さは、 XmNshadowThickness の値になります。 これは、 Frame の親が Shell widget である場合を除いて、デフォルトとなります。
継承されるリソース
Frame は、次のスーパークラスからの動作とリソースを継承します。 これらのリソースについての完全な解説は、そのスーパークラスのマニュアルページを参照してください。
| XmManager リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNbottomShadowColor | XmCForeground | Pixel | dynamic | CSG |
| XmNbottomShadowPixmap | XmCBottomShadowPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| XmNforeground | XmCForeground | Pixel | dynamic | CSG |
| XmNhelpCallback | XmCCallback | XtCallbackList | NULL | C |
| XmNhighlightColor | XmCForeground | Pixel | Black | CSG |
| XmNhighlightPixmap | XmCHighlightPixmap | Pixmap | dynamic | CSG |
| XmNshadowThickness | XmCShadowThickness | short | dynamic | CSG |
| XmNtopShadowColor | XmCBackground | Pixel | dynamic | CSG |
| XmNtopShadowPixmap | XmCTopShadowPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| XmNunitType | XmCUnitType | unsigned char | XmPIXELS | CSG |
| XmNuserData | XmCUserData | caddr_t | NULL | CSG |
| Composite リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNinsertPosition | XmCInsertPosition | XmRFunction | NULL | CSG |
| 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 |
デフォルトのトランスレーション
<EnterWindow>: Enter()
<FocusIn>:FocusIn()
<Btn1Down>:Arm()
<Btn1Up>:Activate()
関連項目
Composite(3XM), Constraint(3XM), Core(3XM), XmCreateFrame(3XM), XmManager(3XM).
NEWS-OSRelease 4.2.1R