XmForm(3XM) — NEWS-OS Programmer’s Manual
名称 .
XmForm — Form widget クラス
形式
#include <Xm/Form.h>
解説
Form は、自分自身の入力セマンティックスを持たないコンテナ widget です。 コンストレイント (制約) は Form の子に置かれ、子の四方それぞれのアタッチメント (接合) を定義します。 アタッチメントは、Form、他の子 widget や gadget、Form の範囲内の相対位置、子の初期位置に使用できます。 アタッチメントは、リサイズが行われた時、Form のレイアウトの動作を決定します。
クラス
Form は、Core、Composite、Constraint、XmManager、XmBulletinBoard クラスからの動作とリソースを継承します。
クラスポインタは、xmFormWidgetClass です。
クラス名は、XmForm です。
新しいリソース
次の表は、データを指定するのに用いる widget リソースの一覧です。 継承されたクラスのリソースの値もまた widget の属性として設定することができます。 .Xdefaults ファイルの中で名前やクラスでリソースを参照する場合は、語頭の XmN または XmC を取り除いた名称を用いてください。 .Xdefaults ファイルの中でリソースに定義された値を設定するには、語頭の Xm を取り除いた名称を用いてください。 (大文字と小文字は区別されませんが、語間のアンダースコアは必要です。 ) 「アクセス」欄の文字は、与えられたリソースを、widget 生成時に設定できるか (C)、XtSetValues で設定できるか (S)、XtGetValues で取り出すことができるか (G)、あるいは利用できないか (N/A) を示します。
| XmForm リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNfractionBase | XmCMaxValue | int | 100 | CSG |
| XmNhorizontalSpacing | XmCSpacing | int | 0 | CSG |
| XmNrubberPositioning | XmCRubberPositioning | Boolean | False | CSG |
| XmNverticalSpacing | XmCSpacing | int | 0 | CSG |
XmNfractionBase
XmATTACH_POSITION コンストレイント (制約) を使って、子 widget の相対位置の計算のための分母を指定します。
XmNhorizontalSpacing
右と左の位置のオフセットを指定します。
XmNrubberPositioning
Form の子に対するデフォルトの位置を示します。 このブール代数のリソースが False に設定されていると、子の左上端が、Form の左上端に置かれる状態がデフォルトになります。 このリソースが True に設定されていると、子は Form 中の初期位置にある状態がデフォルトとなります。
XmNverticalSpacing
上端と下端の位置に対するオフセットを指定します。
| XmForm Constraint リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNbottomAttachment | XmCAttachment | unsigned char | XmATTACH_NONE | CSG |
| XmNbottomOffset | XmCOffset | int | 0 | CSG |
| XmNbottomPosition | XmCAttachment | int | 0 | CSG |
| XmNbottomWidget | XmCWidget | Widget | NULL | CSG |
| XmNleftAttachment | XmCAttachment | unsigned char | XmATTACH_NONE | CSG |
| XmNleftOffset | XmCOffset | int | 0 | CSG |
| XmNleftPosition | XmCAttachment | int | 0 | CSG |
| XmNleftWidget | XmCWidget | Widget | NULL | CSG |
| XmNresizable | XmCBoolean | Boolean | True | CSG |
| XmNrightAttachment | XmCAttachment | unsigned char | XmATTACH_NONE | CSG |
| XmNrightOffset | XmCOffset | int | 0 | CSG |
| XmNrightPosition | XmCAttachment | int | 0 | CSG |
| XmNrightWidget | XmCWidget | Widget | NULL | CSG |
| XmNtopAttachment | XmCAttachment | unsigned char | XmATTACH_NONE | CSG |
| XmNtopOffset | XmCOffset | int | 0 | CSG |
| XmNtopPosition | XmCAttachment | int | 0 | CSG |
| XmNtopWidget | XmCWidget | Widget | NULL | CSG |
XmNbottomAttachment
子の下端の位置を指定します。 次の値をとることができます。
•XmATTACH_NONE — この端は指定しません。
•XmATTACH_FORM — 子の下端が、Form の下端に置かれます。
•XmATTACH_OPPOSITE_FORM — 子の下端が、Form の上端に置かれます。
•XmATTACH_WIDGET — 子の下端が、XmNbottomWidget リソースによって指定される widget あるいは gadget の上端に置かれます。
•XmATTACH_OPPOSITE_WIDGET — 子の下端が、XmNbottomWidget リソースによって指定される widget あるいは gadget の下端に置かれます。
•XmATTACH_POSITION — 子の下端が、Form 中の相対位置に置かれます。 この位置は、XmNbottomPosition リソースによって指定されます。
•XmATTACH_SELF — 子の下端が、Form 中の初期位置に置かれます。
XmNbottomOffset
子の下端と、それが置かれるオブジェクトの間の一定のオフセットを指定します。 このリソースは、XmNbottomAttachment が XmATTACH_POSITION に設定されていれば無視されます。 指定された関係は、リサイズを行っても変更されません。
XmNbottomPosition
子の下端の相対位置を決定します。 相対位置は、Form の高さの分数値です。 分数値は、このリソースの値を XmNfractionBase の値で割った値に等しくなります。 このリソースは、XmNbottomAttachment が XmATTACH_POSITION に設定されている場合にのみ、使用されます。
XmNbottomWidget
子の下端が置かれる widget あるいは gadget を指定します。 このリソースは、XmNbottomAttachment が XmATTACH_WIDGET あるいは XmATTACH_OPPOSITE_WIDGET のどちらかに設定されていれば使用されます。
XmNleftAttachment
子の左端の位置を指定します。 次の値をとることができます。
•XmATTACH_NONE — この端は指定しません。
•XmATTACH_FORM — 子の左端が、Form の左端に置かれます。
•XmATTACH_OPPOSITE_FORM — 子の左端が、Form の右端に置かれます。
•XmATTACH_WIDGET — 子の左端が、XmNleftWidget リソースによって指定される widget あるいは gadget の右端に置かれます。
•XmATTACH_OPPOSITE_WIDGET — 子の左端が、XmNleftWidget リソースによって指定される widget あるいは gadget の左端に置かれます。
•XmATTACH_POSITION — 子の左端が、Form 中の相対位置に置かれます。 この位置は、XmNleftPosition リソースによって指定されます。
•XmATTACH_SELF — 子の左端が、Form 中の初期位置に置かれます。
XmNleftOffset
子の左端とそれが置かれるオブジェクトの間の一定のオフセットを指定します。 このリソースは、XmNleftAttachment が XmATTACH_POSITION に設定されていれば無視されます。 指定された関係は、リサイズを行っても変更されません。
XmNleftPosition
子の左端の相対位置を決定します。 相対位置は、Form の幅の分数値です。 分数値は、このリソースの値を XmNfractionBase の値で割った値に等しくなります。 このリソースは、XmNleftAttachment が XmATTACH_POSITION に設定されている場合にのみ、使用されます。
XmNleftWidget
子の左端が置かれる widget あるいは gadget を指定します。 このリソースは、XmNleftAttachment が XmATTACH_WIDGET または XmATTACH_OPPOSITE_WIDGET のどちらかに設定されていれば使用されます。
XmNresizable
子 widget が、Form によってリサイズ可能かどうかを指定します。 デフォルト値は、True です。
XmNrightAttachment
子の右端の位置を指定します。 次の値をとることができます。
•XmATTACH_NONE — この端は指定しません。
•XmATTACH_FORM — 子の右端が、Form の右端に置かれます。
•XmATTACH_OPPOSITE_FORM — 子の右端が、Form の左端に置かれます。
•XmATTACH_WIDGET — 子の右端が、XmNrightWidget リソースによって指定される widget あるいは gadget の左端に置かれます。
•XmATTACH_OPPOSITE_WIDGET — 子の右端が、XmNrightWidget リソースによって指定される widget あるいは gadget の右端に置かれます。
•XmATTACH_POSITION — 子の右端が、Form 中の相対位置に置かれます。 この位置は、XmNrightPosition リソースによって指定されます。
•XmATTACH_SELF — 子の右端が、Form 中の初期位置に置かれます。
XmNrightOffset
子の右端とそれが置かれるオブジェクトの間の一定のオフセットを指定します。 このリソースは、XmNrightAttachment が XmATTACH_POSITION に設定されていれば無視されます。 指定された関係は、リサイズを行っても、変更されません。
XmNrightPosition
子の右端の相対位置を決定します。 相対位置は、Form の幅の分数値です。 分数値は、このリソースの値を XmNfractionBase の値で割った値に等しくなります。 このリソースは、XmNrightAttachment が XmATTACH_POSITION に設定されている場合にのみ、使用されます。
XmNrightWidget
子の右端が置かれる widget あるいは gadget を指定します。 このリソースは、XmNrightAttachment が XmATTACH_WIDGET あるいは XmATTACH_OPPOSITE_WIDGET のどちらかに設定されていれば使用されます。
XmNtopAttachment
子の上端の位置を指定します。 次の値をとることができます。
•XmATTACH_NONE — この端は指定しません。
•XmATTACH_FORM — 子の上端が、Form の上端に置かれます。
•XmATTACH_OPPOSITE_FORM — 子の上端が、Form の下端に置かれます。
•XmATTACH_WIDGET — 子の上端が、XmNtopWidget リソースによって指定される widget あるいは gadget の下端に置かれます。
•XmATTACH_OPPOSITE_WIDGET — 子の上端が、XmNtopWidget リソースによって指定される widget あるいは gadget の上端に置かれます。
•XmATTACH_POSITION — 子の上端が、Form 中の相対位置に置かれます。 この位置は、XmNtopPosition リソースによって指定されます。
•XmATTACH_SELF — 子の上端が、Form 中の初期位置に置かれます。
XmNtopOffset
子の上端とそれが置かれるオブジェクトの間の一定のオフセットを指定します。 このリソースは、XmNtopAttachment が XmATTACH_POSITION に設定されていれば無視されます。 指定された関係は、リサイズを行っても、変更されません。
XmNtopPosition
子の上端の相対位置を決定します。 相対位置は、Form の高さの分数値です。 分数値は、このリソースの値を XmNfractionBase の値で割った値に等しくなります。 このリソースは、XmNtopAttachment が XmATTACH_POSITION に設定されている場合にのみ、使用されます。
XmNtopWidget
子の上端が置かれる widget あるいは gadget を指定します。 このリソースは、XmNtopAttachment が XmATTACH_WIDGET あるいは XmATTACH_OPPOSITE_WIDGET のどちらかに設定されていれば使用されます。
継承されるリソース
Form は、以下のスーパークラスからの動作とリソースを継承します。 これらのリソースについての完全な解説は、そのスーパークラスのマニュアルページを参照してください。
| XmBulletinBoard リソース一覧 | ||||
| 名称 | クラス | 型 | デフォルト | アクセス |
| XmNallowOverlap | XmCAllowOverlap | Boolean | True | N/A |
| XmNautoUnmanage | XmCAutoUnmanage | Boolean | True | N/A |
| XmNbuttonFontList | XmCButtonFontList | XmFontList | NULL | N/A |
| XmNcancelButton | XmCWidget | Widget | NULL | N/A |
| XmNdefaultButton | XmCWidget | Widget | NULL | N/A |
| XmNdefaultPosition | XmCDefaultPosition | Boolean | True | N/A |
| XmNdialogStyle | XmCDialogStyle | unsigned char | dynamic | N/A |
| XmNdialogTitle | XmCXmString | XmString | NULL | N/A |
| XmNfocusCallback | XmCCallback | XtCallbackList | NULL | C |
| XmNlabelFontList | XmCLabelFontList | XmFontList | NULL | N/A |
| XmNmapCallback | XmCCallback | XtCallbackList | NULL | C |
| XmNmarginHeight | XmCMarginHeight | short | 10 | N/A |
| XmNmarginWidth | XmCMarginWidth | short | 10 | N/A |
| XmNnoResize | XmCNoResize | Boolean | False | N/A |
| XmNresizePolicy | XmCResizePolicy | unsigned char | XmRESIZE_ANY | CSG |
| XmNshadowType | XmCShadowType | unsigned char | XmSHADOW_OUT | N/A |
| XmNstringDirection | XmCStringDirection | XmStringDirection | XmSTRING_DIRECTION_L_TO_R | N/A |
| XmNtextFontList | XmCTextFontList | XmFontList | NULL | N/A |
| XmNtextTranslations | XmCTranslations | XtTranslations | NULL | N/A |
| XmNunmapCallback | XmCCallback | XtCallbackList | NULL | C |
| 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 | 0 | N/A |
| 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 |
動作
Form は、BulletinBoard の動作を継承します。
デフォルトのトランスレーション
Form は、BulletinBoard のデフォルトのトランスレーションを継承します。
キーボードトラバース
キーボードトラバースに関する情報については、XmManager(3XM) のマニュアルページと、「動作」と「デフォルトのトランスレーション」に関するセクションを参照してください。
関連項目
Composite(3XM), Constraint(3XM), Core(3XM), XmBullentinBoard(3X), XmCreateForm, XmCreateFormDialog(3XM), XmManager(3XM).
NEWS-OSRelease 4.1C