XmMainWindow(3XM) — NEWS-OS Programmer’s Manual
名称
XmMainWindow — MainWindow widget クラス
形式
#include <Xm/MainW.h>
解説
MainWindow は、アプリケーションの一次ウィンドウに対する標準のレイアウトを提供します。 このレイアウトは、MenuBar、CommandWindow、ワーク領域、ScrollBar を含んでいます。 これらの領域のいずれか、あるいはすべてが選択可能です。 MainWindow のワーク領域および ScrollBar は、ScrolledWindow widget におけるワーク領域および ScrollBar と同様な動作を行います。 ユーザは MainWindow を、選択可能な MenuBar と CommandWindow を持つ拡張された ScrolledWindow と考えることができます。
完全にロードされた MainWindow では、MenuBar はウィンドウの一番上に水平に置かれます。 CommandWindow は、MenuBar のすぐ下に水平に置かれます。 そして、ワーク領域は CommandWindow の下に置かれます。 CommandWindow の下にスペースがあれば、ScrolledWindow と同じ方法で管理されます。 ScrolledWindow の動作は、ScrolledWindow のリソースによって制御されます。 MainWindow を生成するためには、最初にワーク領域のエレメント、MenuBar、CommandWindow、水平の ScrollBar、垂直の ScrollBar を生成し、それらの widget ID を持った XmMainWindowSetAreas を呼び出してください。
MainWindow は、MainWindow の 3 つのコンポーネントを別々に表示する 2 つの Separator widget も生成することができます。
クラス
MainWindow は、Core、Composite、Constraint、XmManager、ScrolledWindow クラスからの動作とリソースを継承します。
クラスポインタは xmMainWindowWidgetClass です。
クラス名は XmMainWindow です。
新しいリソース
次の表は、データを指定するのに用いる widget リソースの一覧です。 継承されたクラスのリソースの値もまた widget の属性として設定することができます。 .Xdefaults ファイルの中で名前やクラスでリソースを参照する場合は、語頭の XmN または XmC を取り除いた名称を用いてください。 .Xdefaults ファイルの中でリソースに定義された値を設定するには、語頭の Xm を取り除いた名称を用いてください。 (大文字と小文字は区別されませんが、語間のアンダースコアは必要です。 ) 「アクセス」欄の文字は、与えられたリソースを、widget 生成時に設定できるか (C)、XtSetValues で設定できるか (S)、XtGetValues で取り出すことができるか (G)、あるいは利用できないか (N/A) を示します。
| XmMainWindow リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNcommandWindow | XmCCommandWindow | Widget | NULL | CSG |
| XmNmainWindowMarginHeight | XmCMainWindowMarginHeight | Dimension | 0 | CSG |
| XmNmainWindowMarginWidth | XmCMainWindowMarginWidth | Dimension | 0 | CSG |
| XmNmenuBar | XmCMenuBar | Widget | NULL | CSG |
| XmNshowSeparator | XmCShowSeparator | Boolean | False | CSG |
XmNcommandWindow
CommandWindow としてレイアウトされる widget を指定します。 この widget は、あらかじめ、MainWindow の子として生成され、管理されていなければなりません。
XmNmainWindowMarginHeight
MainWindow の上側と下側のマージン長を指定します。 このリソースは ScrolledWindow のリソースである XmNscrolledWindowMarginHeight のいかなる設定もオーバーライドします。
XmNmainWindowMarginWidth
MainWindow の左側と右側のマージン幅を指定します。 このリソースは ScrolledWindow のリソースである XmNscrolledWindowMarginWidth のいかなる設定もオーバーライドします。
XmNmenuBar
MenuBar としてレイアウトされる widget を指定します。 この widget は、あらかじめ、MainWindow の子として生成され、管理されていなければなりません。
XmNshowSeparator
True に設定されている時は MainWindow のコンポーネント間のセパレータを表示します。 False に設定されている時はセパレータは表示されません。
継承されるリソース
MainWindow は以下のスーパークラスから動作やリソースを継承します。 これらのリソースの完全な解説は、そのスーパークラスのマニュアルページを参照してください。
| XmScrolledWindow リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNclipWindow | XmCClipWindow | Widget | NULL | G |
| XmNhorizontalScrollbar | XmCHorizontalScrollBar | Widget | NULL | CSG |
| XmNscrollBarDisplayPolicy | XmCScrollBarDisplayPolicy | unsigned char | XmSTATIC | CG |
| XmNscrollBarPlacement | XmCScrollBarPlacement | unsigned char | XmBOTTOM_RIGHT | CSG |
| XmNscrolledWindowMarginHeight | XmCScrolledWindowMarginHeight | Dimension | 0 | CSG |
| XmNscrolledWindowMarginWidth | XmCScrolledWindowMarginwidth | Dimension | 0 | CSG |
| XmNscrollingPolicy | XmCScrollingPolicy | unsigned char | XmAPPLICATION_DEFINED | CG |
| XmNspacing | XmCSpacing | int | 4 | CSG |
| XmNverticalScrollBar | XmNVerticalScrollBar | Widget | NULL | CSG |
| XmNvisualPolicy | XmNVisualPolicy | unsigned char | XmVARIABLE | CG |
| XmNworkWindow | XmNWorkWindow | Widget | NULL | CSG |
| XmManager リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNbottomShadowColor | XmCForeground | Pixel | dynamic | CSG |
| XmNbottomShadowPixmap | XmCBottomShadowPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| Xmforeground | XmCForeground | Pixel | dynamic | CSG |
| XmNhelpCallback | XmCCallback | XtCallbackList | NULL | C |
| XmNhighlightColor | XmCForeground | Pixel | Black | CSG |
| XmNhighlightPixmap | XmCHighlighrPixmap | Pixmap | dynamic | CSG |
| XmNshadowThickness | XmCShadowThickness | short | 0 | 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 |
動作
MainWindow は ScrolledWindow の動作を継承します。
キーボードトラバース
キーボードトラバースに関する情報は、XmManager(3XM) のマニュアルページと動作やデフォルトのトランスレーションの項を参照してください。
関連事項
Composite(3XM), Constraint(3XM), Core(3XM), XmCreateMainWindow(3XM), XmMainWindowSep1(3XM), XmMainWindowSep2(3XM), XmMainWindowSetAreas(3XM), XmManager(3XM), XmScrolledWindow(3XM)
NEWS-OSRelease 4.2.1R