{{div_begin}} [[←　10 章に戻る|Palm OS Programmer's API Reference/10]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[12 章に進む　→|Palm OS Programmer's API Reference/12]] {{div_end}} {{div_begin style="margin-bottom:-10px"}} !!!11 フォーム （ページ 2） {{div_end}} {{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}} *（ページ 1） *{{goto Form Structures and Types,フォーム構造体と型|Palm OS Programmer's API Reference/11-1}} **{{goto AlertTemplateType,AlertTemplateType|Palm OS Programmer's API Reference/11-1}} **{{goto FormActiveStateType,FormActiveStateType|Palm OS Programmer's API Reference/11-1}} **{{goto FormAttrType,FormAttrType|Palm OS Programmer's API Reference/11-1}} **{{goto FormBitmapType,FormBitmapType|Palm OS Programmer's API Reference/11-1}} **{{goto FormFrameType,FormFrameType|Palm OS Programmer's API Reference/11-1}} **{{goto FormGadgetAttrType,FormGadgetAttrType|Palm OS Programmer's API Reference/11-1}} **{{goto FormGadgetType,FormGadgetType|Palm OS Programmer's API Reference/11-1}} **{{goto FormGadgetTypeInCallback,FormGadgetTypeInCallback|Palm OS Programmer's API Reference/11-1}} **{{goto FormLabelType,FormLabelType|Palm OS Programmer's API Reference/11-1}} **{{goto FormLineType,FormLineType|Palm OS Programmer's API Reference/11-1}} **{{goto FormObjAttrType,FormObjAttrType|Palm OS Programmer's API Reference/11-1}} **{{goto FormObjectType,FormObjectType|Palm OS Programmer's API Reference/11-1}} **{{goto FormObjListType,FormObjListType|Palm OS Programmer's API Reference/11-1}} **{{goto FormPopupType,FormPopupType|Palm OS Programmer's API Reference/11-1}} **{{goto FormPtr,FormPtr|Palm OS Programmer's API Reference/11-1}} **{{goto FormRectangleType,FormRectangleType|Palm OS Programmer's API Reference/11-1}} **{{goto FormTitleType,FormTitleType|Palm OS Programmer's API Reference/11-1}} **{{goto FormType,FormType|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGraffitiStateType,FrmGraffitiStateType|Palm OS Programmer's API Reference/11-1}} **{{goto FrmNavHeaderType,FrmNavHeaderType|Palm OS Programmer's API Reference/11-1}} **{{goto FrmNavOrderEntryType,FrmNavOrderEntryType|Palm OS Programmer's API Reference/11-1}} *{{goto Form Constants,フォーム定数|Palm OS Programmer's API Reference/11-1}} **{{goto AlertType,AlertType|Palm OS Programmer's API Reference/11-1}} **{{goto FormObjectKind,FormObjectKind|Palm OS Programmer's API Reference/11-1}} **{{goto FrmNavFocusRingStyleEnum,FrmNavFocusRingStyleEnum|Palm OS Programmer's API Reference/11-1}} **{{goto FrmNavHeaderFlagsType,FrmNavHeaderFlagsType|Palm OS Programmer's API Reference/11-1}} **{{goto FrmNavObjectFlagsType,FrmNavObjectFlagsType|Palm OS Programmer's API Reference/11-1}} **{{goto FrmNavStateFlagsType,FrmNavStateFlagsType|Palm OS Programmer's API Reference/11-1}} **{{goto Form Navigation Focus Error Codes,フォーム ナビゲーション フォーカス エラー コード|Palm OS Programmer's API Reference/11-1}} **{{goto Form Dynamic Input Area Policies,フォームの動的入力エリアのポリシー|Palm OS Programmer's API Reference/11-1}} //Form Dynamic Input Area Policies **{{goto Miscellaneous Form Constants,その他のフォーム定数|Palm OS Programmer's API Reference/11-1}} **{{goto One-Handed Navigation Trap Selectors,One-Handed Navigation Trap Selectors|Palm OS Programmer's API Reference/11-1}} *{{goto フォーム リソース,フォーム リソース|Palm OS Programmer's API Reference/11-1}} *{{goto フォーム関数,フォーム関数|Palm OS Programmer's API Reference/11-1}} **{{goto ECFrmValidatePtr,ECFrmValidatePtr|Palm OS Programmer's API Reference/11-1}} **{{goto FrmAlert,FrmAlert|Palm OS Programmer's API Reference/11-1}} **{{goto FrmCloseAllForms,FrmCloseAllForms|Palm OS Programmer's API Reference/11-1}} **{{goto FrmCopyLabel,FrmCopyLabel|Palm OS Programmer's API Reference/11-1}} **{{goto FrmCopyTitle,FrmCopyTitle|Palm OS Programmer's API Reference/11-1}} **{{goto FrmCountObjectsInNavOrder,FrmCountObjectsInNavOrder|Palm OS Programmer's API Reference/11-1}} **{{goto FrmCustomAlert,FrmCustomAlert|Palm OS Programmer's API Reference/11-1}} **{{goto FrmCustomResponseAlert,FrmCustomResponseAlert|Palm OS Programmer's API Reference/11-1}} **{{goto FrmDeleteForm,FrmDeleteForm|Palm OS Programmer's API Reference/11-1}} **{{goto FrmDispatchEvent,FrmDispatchEvent|Palm OS Programmer's API Reference/11-1}} **{{goto FrmDoDialog,FrmDoDialog|Palm OS Programmer's API Reference/11-1}} **{{goto FrmDrawForm,FrmDrawForm|Palm OS Programmer's API Reference/11-1}} **{{goto FrmEraseForm,FrmEraseForm|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetActiveField,FrmGetActiveField|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetActiveForm,FrmGetActiveForm|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetActiveFormID,FrmGetActiveFormID|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetControlGroupSelection,FrmGetControlGroupSelection|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetControlValue,FrmGetControlValue|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetDIAPolicyAttr,FrmGetDIAPolicyAttr|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetFirstForm,FrmGetFirstForm|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetFocus,FrmGetFocus|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetFormBounds,FrmGetFormBounds|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetFormId,FrmGetFormId|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetFormPtr,FrmGetFormPtr|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetGadgetData,FrmGetGadgetData|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetLabel,FrmGetLabel|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetNavEntry,FrmGetNavEntry|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetNavOrder,FrmGetNavOrder|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetNavState,FrmGetNavState|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetNumberOfObjects,FrmGetNumberOfObjects|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectBounds,FrmGetObjectBounds|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectId,FrmGetObjectId|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectIndex,FrmGetObjectIndex|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectIndexFromPtr,FrmGetObjectIndexFromPtr|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectPosition,FrmGetObjectPosition|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectPtr,FrmGetObjectPtr|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetObjectType,FrmGetObjectType|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetTitle,FrmGetTitle|Palm OS Programmer's API Reference/11-1}} **{{goto FrmGetWindowHandle,FrmGetWindowHandle|Palm OS Programmer's API Reference/11-1}} *（ページ 2） **{{goto FrmGotoForm,FrmGotoForm}} **{{goto FrmHandleEvent,FrmHandleEvent}} **{{goto FrmHelp,FrmHelp}} **{{goto FrmHideObject,FrmHideObject}} **{{goto FrmInitForm,FrmInitForm}} **{{goto FrmNavDrawFocusRing,FrmNavDrawFocusRing}} **{{goto FrmNavGetFocusRingInfo,FrmNavGetFocusRingInfo}} **{{goto FrmNavObjectTakeFocus,FrmNavObjectTakeFocus}} **{{goto FrmNavRemoveFocusRing,FrmNavRemoveFocusRing}} **{{goto FrmNewBitmap,FrmNewBitmap}} **{{goto FrmNewForm,FrmNewForm}} **{{goto FrmNewGadget,FrmNewGadget}} **{{goto FrmNewGsi,FrmNewGsi}} **{{goto FrmNewLabel,FrmNewLabel}} **{{goto FrmPointInTitle,FrmPointInTitle}} **{{goto FrmPopupForm,FrmPopupForm}} **{{goto FrmRemoveObject,FrmRemoveObject}} **{{goto FrmRestoreActiveState,FrmRestoreActiveState}} **{{goto FrmReturnToForm,FrmReturnToForm}} **{{goto FrmSaveActiveState,FrmSaveActiveState}} **{{goto FrmSaveAllForms,FrmSaveAllForms}} **{{goto FrmSetActiveForm,FrmSetActiveForm}} **{{goto FrmSetCategoryLabel,FrmSetCategoryLabel}} **{{goto FrmSetControlGroupSelection,FrmSetControlGroupSelection}} **{{goto FrmSetControlValue,FrmSetControlValue}} **{{goto FrmSetDIAPolicyAttr,FrmSetDIAPolicyAttr}} **{{goto FrmSetEventHandler,FrmSetEventHandler}} **{{goto FrmSetFocus,FrmSetFocus}} **{{goto FrmSetGadgetData,FrmSetGadgetData}} **{{goto FrmSetGadgetHandler,FrmSetGadgetHandler}} **{{goto FrmSetMenu,FrmSetMenu}} **{{goto FrmSetNavEntry,FrmSetNavEntry}} **{{goto FrmSetNavOrder,FrmSetNavOrder}} **{{goto FrmSetNavState,FrmSetNavState}} **{{goto FrmSetObjectBounds,FrmSetObjectBounds}} **{{goto FrmSetObjectPosition,FrmSetObjectPosition}} **{{goto FrmSetTitle,FrmSetTitle}} **{{goto FrmShowObject,FrmShowObject}} **{{goto FrmUpdateForm,FrmUpdateForm}} **{{goto FrmUpdateScrollers,FrmUpdateScrollers}} **{{goto FrmValidatePtr,FrmValidatePtr}} **{{goto FrmVisible,FrmVisible}} *{{goto Application-Defined Functions,アプリケーション定義関数}} **{{goto FormCheckResponseFuncType,FormCheckResponseFuncType}} **{{goto FormEventHandlerType,FormEventHandlerType}} **{{goto FormGadgetHandlerType,FormGadgetHandlerType}} {{div_end}} {{div_begin "style='position:relative;padding:0px;padding-right:5px;padding-left:10px;margin-right:250px;margin-top:20px;width:auto;border-right-style:dotted;border-right-width:2px;border-right-color:silver;'"}} [[←　11 章のページ 1 へ|Palm OS Programmer's API Reference/11-1]]　[[↑　11 章のトップへ|Palm OS Programmer's API Reference/11]] ※訳者は古い Palm デバイスしか所有していないため、ナビゲーション関係の記述についてはあやふやな部分が多いです。 !{{anchor FrmGotoForm}}FrmGotoForm 関数 {{goto top,^TOP^}} '''目的''' 現在のフォームに {{goto frmCloseEvent,frmCloseEvent|Palm OS Programmer's API Reference/2}} を送り、指定されたフォームに {{goto frmLoadEvent,frmLoadEvent|Palm OS Programmer's API Reference/2}} と {{goto frmOpenEvent,frmOpenEvent|Palm OS Programmer's API Reference/2}} を送ります。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmGotoForm ( UInt16 formId ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formId}} **表示されるフォームの ID。 '''返り値''' 返り値はありません。 '''コメント''' デーフォルトのイベント ハンドラ（{{goto FrmHandleEvent,FrmHandleEvent()}}）が、{{goto frmCloseEvent,frmCloseEvent|Palm OS Programmer's API Reference/2}} を受け取ると、フォームを消して処分します。 '''参照''' {{goto FrmPopupForm,FrmPopupForm()}} !{{anchor FrmHandleEvent}}FrmHandleEvent 関数 {{goto top,^TOP^}} '''目的''' フォームの中で起きたイベントをハンドルします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean FrmHandleEvent ( FormType *formP, EventType *eventP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FormType,FormType}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ eventP}} **イベント データ構造体（{{goto EventType,EventType|Palm OS Programmer's API Reference/2}}）へのポインタ '''返り値''' イベントがハンドルされた場合、{{span style='color:blue;font-family:monospace;',true}} を返します。 '''コメント''' この関数を直接呼び出さないでください。代わりに、{{goto FrmDispatchEvent,FrmDispatchEvent()|Palm OS Programmer's API Reference/11-1}} を呼び出してください。{{span style='color:blue;font-family:monospace;',FrmDispatchEvent}} はイベントをフォームのカスタム イベント ハンドラに渡して、それからイベントがハンドルされなかった場合にこの関数に送ります。 //---- //{{span style='color:red;font-weight:bold;',WARNING!}} この関数を直接呼び出してはいけません。代わりに、{{span style='color:blue;font-family:monospace;',FrmDispatchEvent}} 関数を呼び出してください。 //---- ::{{span style='color:red;font-weight:bold;',WARNING!}} :::この関数を直接呼び出してはいけません。代わりに、{{span style='color:blue;font-family:monospace;',FrmDispatchEvent}} 関数を呼び出してください。 {{goto 表 11.1,表 11.1}} は {{span style='color:blue;font-family:monospace;',FrmHandleEvent}} が異なるイベントをどのようにハンドルするのかの概観を示します。 {{anchor 表 11.1}}'''表 11.1 FrmHandleEvent Actions''' ,'''FrmHandleEvent が以下のイベントを受け取ると ...''','''FrmHandleEvent は以下の行動を起こします。''' ,"{{goto frmEnterEvent,frmEnterEvent|Palm OS Programmer's API Reference/2}}","イベントとイベントが起こったオブジェクトへのポインタを {{goto CtlHandleEvent,CtlHandleEvent()|Palm OS Programmer's API Reference/7}} に送ります。オブジェクト ポインタはイベント データから取得されます。コントロールが排他的コントロール グループの一部である場合、グループで現在選択されているコントロールの選択を解除します。" ,"{{goto frmRepeatEvent,frmRepeatEvent|Palm OS Programmer's API Reference/2}}","イベントとイベントが起こったオブジェクトへのポインタを {{span style='color:blue;font-family:monospace;',CtlHandleEvent}} に送ります。オブジェクト ポインタはイベント データから取得されます。" ,"{{goto frmSelectEvent,frmSelectEvent|Palm OS Programmer's API Reference/2}}","コントロールがポップアップ トリガかどうかをチェックします。そうである場合、ポップアップ トリガに関連付けられたリストが、ユーザが選択を行うかそのリストの領域外をペンでタッチするまで、表示されます。選択が行われると、{{goto popSelectEvent,popSelectEvent|Palm OS Programmer's API Reference/2}} がイベント キューに追加されます。" ,"{{goto fldEnterEvent,fldEnterEvent|Palm OS Programmer's API Reference/2}} または {{goto fldHeightChangedEvent,fldHeightChangedEvent|Palm OS Programmer's API Reference/2}}","フィールド オブジェクトまたはテーブル オブジェクトがフォーカスされているかどうかをチェックし、イベントを適切なハンドラ（{{goto FldHandleEvent,FldHandleEvent()|Palm OS Programmer's API Reference/9}} または {{goto TblHandleEvent,TblHandleEvent()|Palm OS Programmer's API Reference/20}}）に渡します。テーブル オブジェクトは、フィールド オブジェクトを持つかもしれないコンテナ オブジェクトでもあります。{{span style='color:blue;font-family:monospace;',TblHandleEvent}} がフィールド イベントを受け取ると、イベントをテーブル内で保持されているフィールド オブジェクトに送ります。" ,"{{goto frmCloseEvent,frmCloseEvent|Palm OS Programmer's API Reference/2}}",フォームを消し、フォームに割り当てられていたすべてのメモリを解放します。 ,"{{goto frmGadgetEnterEvent,frmGadgetEnterEvent|Palm OS Programmer's API Reference/2}}","イベントをガゼットのコールバック関数（ガゼットが持っている場合）に送ります。{{goto FormGadgetHandlerType,FormGadgetHandlerType}} を参照してください。" ,"{{goto frmGadgetMiscEvent,frmGadgetMiscEvent|Palm OS Programmer's API Reference/2}}","イベントをガゼットのコールバック関数（ガゼットが持っている場合）に送ります。{{goto FormGadgetHandlerType,FormGadgetHandlerType}} を参照してください。" ,"{{goto frmTitleEnterEvent,frmTitleEnterEvent|Palm OS Programmer's API Reference/2}}","ペンをペンが持ち上がるまで追跡します。フォームの領域内でペンが持ち上がる場合、{{goto frmTitleSelectEvent,frmTitleSelectEvent|Palm OS Programmer's API Reference/2}} をイベント キューに追加します。" ,"{{goto frmUpdateEvent,frmUpdateEvent|Palm OS Programmer's API Reference/2}}","フォームを再描画するために {{goto FrmDrawFrom,FrmDrawForm()|Palm Programmer's API Reference/11-1}} を呼び出します。" ,"{{goto keyDownEvent,keyDownEvent|Palm OS Programmer's API Reference/2}}","イベントを、フォーカスされているオブジェクトのために、ハンドラに渡します。フォーカスされているオブジェクトが無い場合、イベントは無視されます。" ,"{{goto lstEnterEvent,lstEnterEvent|Palm OS Programmer's API Reference/2}}","イベントとイベントが起きたオブジェクトへのポインタを {{goto LstHandleEvent,LstHandleEvent()|Palm OS Programmer's API Reference/14}} に渡します。オブジェクト ポインタはイベント データから取得されます。" ,"{{goto menuCmdBarOpenEvent,menuCmdBarOpenEvent|Palm OS Programmer's API Reference/2}}","フィールド オブジェクトまたはテーブル オブジェクトがフォーカスされているかどうかをチェックし、イベントを適切なハンドラ（{{span style='color:blue;font-family:monospace;',FldHandleEvent}} または {{span style='color:blue;font-family:monospace;',TblHandleEvent}}）に渡して、通知 {{goto sysNotifyMenuCmdBarOpenEvent,sysNotifyMenuCmdBarOpenEvent|Palm OS Programmer's API Reference/3}} をブロードキャストし、それからコマンド ツールバーを表示します。" ,"{{goto menuEvent,menuEvent|Palm OS Programmer's API Reference/2}}","メニュー コマンドがシステム編集メニュー コマンドの 1 つかどうかをチェックします。システムは、コマンドである取消、切取、コピー、貼付、全選択、それにキーボードを保持している標準編集メニューを提供します。{{span style='color:blue;font-family:monospace;',FrmHandleEvent}} はこれらのコマンドに応答します。" ,"{{goto penDownEvent,penDownEvent|Palm OS Programmer's API Reference/2}}; ペンの位置はフォーム オブジェクトの領域内","フォームによって保持されているオブジェクトのリストを、ペンがそのオブジェクトのなかの 1 つの領域内にあるかどうかを調べるために、チェックします。もしそうであれば、イベントをハンドルするために適切なハンドルが呼び出されます。例えば、ペンがコントロールの領域内であれば、{{span style='color:blue;font-family:monospace;',CtlHandleEvent}} が呼び出されます。ペンがオブジェクトの領域内でない場合、イベントはフォームに無視されます。ペンがヘルプ アイコンの領域内であれば、ペンが持ち上がるまでペンを追跡し、ペンがヘルプ アイコンの領域内で持ち上がると、ヘルプ ダイアログが表示されます。" ,"{{goto popSelectEvent,popSelectEvent|Palm OS Programmer's API Reference/2}}","ポップアップ トリガのラベルをポップアップ リストの現在の選択にセットします。" ,"{{goto sclEnterEvent,sclEnterEvent|Palm OS Programmer's API Reference/2}} または {{goto sclRepeatEvent,sclRepeatEvent|Palm OS Programmer's API Reference/2}}","イベントとイベントが起きたオブジェクトへのポインタを {{goto SclHandleEvent,SclHandleEvent()|Palm OS Programmer's API Reference/18}} に渡します。" ,"{{goto tblEnterEvent,tblEnterEvent|Palm OS Programmer's API Reference/2}}","イベントとイベントが起きたオブジェクトへのポインタを {{span style='color:blue;font-family:monospace;',TblHandleEvent}} に渡します。オブジェクト ポインタはイベント データから取得されます。" '''互換性''' {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合、{{span style='color:blue;font-family:monospace;',FrmHandleEvent}} は {{span style='color:blue;font-family:monospace;',frmTitleSelectEvent}}, {{span style='color:blue;font-family:monospace;',menuCmdBarOpenEvent}}, {{span style='color:blue;font-family:monospace;',frmGadgetEnterEvent}} それに {{span style='color:blue;font-family:monospace;',frmGadgetMiscEvent}} のみをハンドルします。{{goto 5.0 New Feature Set,5.0 New Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合、この関数は「システムのみが使用するもの」と見なされるべきです。アプリケーションは、それを使用するのを避けるために、アプリケーションができることをするべきです。 '''参照''' {{goto FrmDispatchEvent,FrmDispatchEvent()}} !{{anchor FrmHelp}}FrmHelp 関数 {{goto top,^TOP^}} '''目的''' 指定されたヘルプ メッセージを、ユーザがヘルプ ダイアログ内の Done ボタンをタップするまで、表示します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmHelp ( UInt16 helpMsgId ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ helpMsgId}} **ヘルプ メッセージ文字列のリソース ID。 '''返り値''' 返り値はありません。 '''コメント''' ヘルプ メッセージは、必要があればテキストをスクロールさせるモーダル ダイアログ（{{goto modal,訳者注}}）の中に表示されます。 !{{anchor FrmHideObject}}FrmHideObject 関数 {{goto top,^TOP^}} '''目的''' 指定されたオブジェクトを消し、そのオブジェクトの属性データ（{{span style='color:blue;font-family:monospace;',usable}} ビット）をオブジェクトが再描画されたり、ペンに応答したりしないようにセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmHideObject ( FormType *formP, UInt16 objIndex ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FormType,FormType}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるオブジェクトのインデックス。この値を {{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使って取得することができます。 '''返り値''' 返り値はありません。 '''互換性''' OS バージョン 3.2 より前では、この関数はオブジェクト属性データの {{span style='color:blue;font-family:monospace;',usable}} ビットを {{span style='color:blue;font-family:monospace;',false}} にセットしません。OS バージョン 3.2 より前では、直接このビットを {{span style='color:blue;font-family:monospace;',false}} にセットすることでこのバグを回避できます。 OS バージョン 3.5 より前では、この関数はリストまたはテーブルに影響を与えません。OS バージョン 3.5 では、リストを正しく操作しますが、テーブルには一切影響を与えません。OS バージョン 4.0 では、リストとテーブルの両方を正しく操作します。 {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が満たされ、かつ、オブジェクトが拡張ガゼットである場合、この関数は {{span style='color:blue;font-family:monospace;',formGadgetEraseCmd}} と一緒にガゼットのコールバック関数を呼び出します。{{goto FormGadgetHandlerType,DormGadgetHandlerType()}} を参照してください。 '''参照''' {{goto FrmShowObject,FrmShowObject()}} !{{anchor FrmInitForm}}FrmInitForm 関数 {{goto top,^TOP^}} '''目的''' フォーム リソースを読み込み、初期化します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''ProtoType''' FormType *FrmInitForm ( UInt16 rscID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ rscID}} **フォームのリソース ID。 '''返り値''' フォーム データ構造体へのポインタを返します。 デバッグ ROM を使用しているときは、フォームがすでに初期化されている場合、{{span style='color:blue;font-family:monospace;',FrmInitForm}} はエラー メッセージを表示します。 '''コメント''' この関数はディスプレイに影響を与えません（フォームを描くためには {{goto FrmDrawForm,FrmDrawForm()|Palm OS Programmer's API Reference/11-1}} を使用します）し、フォームをアクティブにもしません（フォームをアクティブにするためには {{goto FrmSetActiveForm,FrmSetActiveForm()}} を使用します）。 初期化された各フォームに対して、フォームが終了するときにフォーム メモリを解放するために {{span style='color:blue;font-family:monospace;',FrmDeleteForm}} を呼び出す必要があります。そうする代わりに、{{span style='color:blue;font-family:monospace;',FrmReturnForm()}} を呼び出すことでアクティブ フォームをアクティブでなくすることができます（訳者注: フォームの表示は消されるが、メモリは解放されない）。 '''参照''' {{goto FrmDoDialog,FrmDoDialog()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmDeleteForm,FrmDeleteForm()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmReturnToForm,FrmReturnToForm()}} !{{anchor FrmNavDrawFocusRing}}FrmNavDrawFocusRing 関数 {{goto top,^TOP^}} '''目的''' システムにオブジェクトのフォーカス リングを描くように通知します。 //---- //'''NOTE::''' この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavDrawFocusRing,FrmGlueNavDrawFocusRing()|Palm OS Programmer's API Reference/80}} を使用すべきです。 //---- ::NOTE: :::この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavDrawFocusRing,FrmGlueNavDrawFocusRing()|Palm OS Programmer's API Reference/80}} を使用すべきです。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmNavDrawFocusRing ( FormType *formP, UInt16 objectID, Int16 extraInfo, RectangleType *boundsInsideRingP, FrmNavFocusRingStyleEnum ringStyle, Boolean forceRestore ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **リングが描かれるオブジェクトを保持しているフォームへのポインタ *{{span style='color:blue;font-family:monospace;',→ objectID}} **フォーカス リングを描かれるオブジェクトの ID。 *{{span style='color:blue;font-family:monospace;',→ extraInfo}} **フォーカス リングに関連付けたいすべての情報。例えば、システムはこのフィールドを、フォーカスされている組み込みリストの一時的に選択されたアイテムを保存するために使用します。リングに感づける情報が無い場合は、{{span style='color:blue;font-family:monospace;',frmNavFocusRingNoExtraInfo}} を渡してください。 *{{span style='color:blue;font-family:monospace;',→ boundsInsideRingP}} **周りにリングが描かれるべき {{goto RectangleType,RectangleType|Palm OS Programmer's API Reference/49}} 構造体へのポインタ *{{span style='color:blue;font-family:monospace;',→ ringStyle}} **リングに望まれるスタイルを表す {{goto FrmNavFocusRingStyleEnum,FrmNavFocusRingStyleEnum|Palm OS Programmer's API Reference/11-1}} 値の 1 つ。オブジェクトに対して、デフォルト リング スタイルを望む場合は、{{span style='color:blue;font-family:monospace;',frmNavFocusRingStyleObjectTypeDefault}} を渡してください。 *{{span style='color:blue;font-family:monospace;',→ forceRestore}} **リングがすでにオブジェクトの周りに描かれている場合、リングを再描画する前にリングの背後にあるものを元に戻す（restore）べきかどうかを指定します。 '''返り値''' フォーカス リングが成功裏に描かれた場合、{{span style='color:blue;font-family:monospace;',errNone}} を返します。そうで無い場合、以下で示すエラー コードの 1 つを返します。 *{{span style='color:blue;font-family:monospace;',uilibErrInvalidParam}} **{{span style='color:blue;font-family:monospace;',formP}} または {{span style='color:blue;font-family:monospace;',boundsInsideRingP}} が {{span style='color:blue;font-family:monospace;',NULL}} です。 *{{span style='color:blue;font-family:monospace;',uilibErrInvalidFocusObject}} **{{span style='color:blue;font-family:monospace;',objectID}} が使用可能のマークを付けられていないコントロールを指定しています。 *{{span style='color:blue;font-family:monospace;',uilibErrFormDoesNotHaveFocus}} **指定されたフォームは現在フォーカスされていません。 *{{span style='color:blue;font-family:monospace;',uilibErrObjectFocusModeOff}} **指定されたフォームはオブジェクト フォーカス モードではありません。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。開発者は、最大の互換性を得るために、この関数と等価である Palm OS Glue Libraly -- {{goto FrmGlueNavDrawFocusRing,FrmGlueNavDrawFocusRing()|Palm OS Programmer's API Reference/80}} -- を使用すべきです。 '''参照''' {{goto FrmNavGetFocusRingInfo,FrmNavGetFocusRingInfo()}}, {{goto FrmNavObjectTakeFocus,FrmNavObjectTakeFocus()}}, {{goto FrmNavRemoveFocusRing,FrmNavRemoveFocusRing()}} !{{anchor FrmNavGetFocusRingInfo}}FrmNavGetFocusRingInfo 関数 {{goto top,^TOP^}} '''目的''' フォームがシステムに描画されるフォーカス リングを持つ場合、そのリングについての情報を取得します。 //---- //'''NOTE::''' この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavGetFocusRingInfo,FrmGlueNavGetFocusRingInfo()|Palm OS Programmer's API Reference/80}} を使用すべきです。 //---- ::NOTE: :::この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavGetFocusRingInfo,FrmGlueNavGetFocusRingInfo()|Palm OS Programmer's API Reference/80}} を使用すべきです。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmNavGetFocusRingInfo ( const FormType *formP, UInt16 *objectIDP, Int16 *extraInfoP, RectangleType *boundsInsideRingP, FrmNavFocusRingStyleEnum *ringStyleP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **リング情報が取得されるフォームへのポインタ *{{span style='color:blue;font-family:monospace;',← objectIDP}} **関数の返り時に、システムに描かれたフォーカス リングを持つオブジェクトの ID を保持する {{span style='color:blue;font-family:monospace;',UInt16}} へのポインタを提供してください。この情報を必要としない場合は {{span style='color:blue;font-family:monospace;',NULL}} を渡してください。 *{{span style='color:blue;font-family:monospace;',← extraInfoP}} **関数の返り時に、フォーカス リングに関連付けられた臨時情報を保持する {{span style='color:blue;font-family:monospace;',Int16}} へのポインタ（訳者注: 原文では {{span style='color:blue;font-family:monospace;',UInt16}} だが誤りと思われる）を提供してください。この情報を必要としない場合は {{span style='color:blue;font-family:monospace;',NULL}} を渡してください。「臨時情報」は、{{goto FrmNavDrawFocusRing,FrmNavDrawFocusRing()}} が呼び出されたときに、リングに関連付けされた情報です。フォーカス リングに関連付けられた臨時情報が無い場合、{{span style='color:blue;font-family:monospace;',*extraInfo}} は {{span style='color:blue;font-family:monospace;',frmNavFocusRingNoExtraInfo}} にセットされています。 *{{span style='color:blue;font-family:monospace;',← boundsInsideRingP}} **システムに描かれるフォーカス リングの領域が書き込まれる {{goto RectangleType,RectangleType|Palm OS Programmer's API Reference/49}} 構造体へのポインタを提供してください。この情報を必要としない場合は {{span style='color:blue;font-family:monospace;',NULL}} を渡してください。 *{{span style='color:blue;font-family:monospace;',← ringP}} **フォーカス リングのスタイルが書き込まれる {{goto FrmNaFocusRingStyleEnum,FrmNavFocusRingStyleEnum|Palm OS Programmer's API Reference/11}} 変数へのポインタを提供してください。この情報を必要としない場合は {{span style='color:blue;font-family:monospace;',NULL}} を渡してください。 '''返り値''' フォーカス リングが成功裏に描かれた場合、{{span style='color:blue;font-family:monospace;',errNone}} を返します。そうで無い場合、以下で示すエラー コードの 1 つを返します。 *{{span style='color:blue;font-family:monospace;',uilibErrFormDoesNotHaveFocus}} **指定されたフォームは現在フォーカスされていません。 *{{span style='color:blue;font-family:monospace;',uilibErrObjectFocusModeOff}} **指定されたフォームはオブジェクト フォーカス モードではありません。 *{{span style='color:blue;font-family:monospace;',uilibErrObjectNotFound}} **システムに描かれるフォーカス リングを持つオブジェクトがありません。 '''コメント''' 相互作用モードになっている組み込みリストのために、システムは一時的に選択されているアイテムを臨時情報フィールドに保存します。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。開発者は、最大の互換性を得るために、この関数と等価である Palm OS Glue Libraly -- {{goto FrmGlueNavGetFocusRingInfo,FrmGlueNavGetFocusRingInfo()|Palm OS Programmer's API Reference/80}} -- を使用すべきです。 '''参照''' {{goto FrmNavDrawFocusRing,FrmNavDrawFocusRing()}}, {{goto FrmNavRemoveFocusRing,FrmNavRemoveFocusRing()}} !{{anchor FrmNavObjectTakeFocus}}FrmNavObjectTakeFocus 関数 {{goto top,^TOP^}} '''目的''' オブジェクトのために {{goto frmObjectFocusTakeEvent,frmObjectFocusTakeEvent|Palm OS Programmer's API Reference/2}} を発します。 //---- //'''NOTE::''' この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavObjectTakeFocus,FrmGlueNavObjectTakeFocus()|Palm OS Programmer's API Reference/80}} を使用すべきです。 //---- ::NOTE: :::この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavObjectTakeFocus,FrmGlueNavObjectTakeFocus()|Palm OS Programmer's API Reference/80}} を使用すべきです。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmNavObjectTakeFocus ( const FormType *formP, UInt16 objID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **オブジェクトを保持するフォームへのポインタ *{{span style='color:blue;font-family:monospace;',→ objID}} **オブジェクトの ID '''返り値''' 返り値はありません。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。開発者は、最大の互換性を得るために、この関数と等価である Palm OS Glue Libraly -- {{goto FrmGlueNavObjectTakeFocus,FrmGlueNavObjectTakeFocus()|Palm OS Programmer's API Reference/80}} -- を使用すべきです。 !{{anchor FrmNavRemoveFocusRing}}FrmNavRemoveFocusRing 関数 {{goto top,^TOP^}} '''目的''' 現在フォーカスされているオブジェクトの周りからシステムに描かれるリングを削除を削除します。 //---- //'''NOTE::''' この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavRemoveFocusRing,FrmGlueNavRemoveFocusRing()|Palm OS Programmer's API Reference/80}} を使用すべきです。 //---- ::NOTE: :::この関数は異なる Palm OS ハンドヘルドでは異なる形で実装されます。開発者は、この関数の代わりに {{goto FrmGlueNavRemoveFocusRing,FrmGlueNavRemoveFocusRing()|Palm OS Programmer's API Reference/80}} を使用すべきです。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmNavRemoveFocusRing ( FormType *formP ) ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーカス リングを持つオブジェクトを保持するフォームへのポインタ '''返り値''' フォーカス リングが成功裏に描かれた場合、{{span style='color:blue;font-family:monospace;',errNone}} を返します。そうで無い場合、以下で示すエラー コードの 1 つを返します。 *{{span style='color:blue;font-family:monospace;',uilibErrInvalidParam}} **{{span style='color:blue;font-family:monospace;',formP}} は {{span style='color:blue;font-family:monospace;',NULL}} です。 *{{span style='color:blue;font-family:monospace;',uilibErrFormDoesNotHaveFocus}} **指定されたフォームは現在フォーカスされていません。 *{{span style='color:blue;font-family:monospace;',uilibErrObjectFocusModeOff}} **指定されたフォームはオブジェクト フォーカス モードではありません。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。開発者は、最大の互換性を得るために、この関数と等価である Palm OS Glue Libraly -- {{goto FrmGlueNavRemoveFocusRing,FrmGlueNavRemoveFocusRing()|Palm OS Programmer's API Reference/80}} -- を使用すべきです。 '''参照''' {{goto FrmNavDrawFocusRing,FrmNavDrawFocusRing()}}, {{goto FrmNavGetFocusRingInfo,FrmNavGetFocusRingInfo()}} !{{anchor FrmNewBitmap}}FrmNewBitmap 関数 {{goto top,^TOP^}} '''目的''' 新しいフォーム ビットマップを動的に作成します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' FormBitmapType *FrmNewBitmap ( FormType **formPP, UInt16 ID, UInt16 rscID, Coord x, Coord y ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ formPP}} **新しいビットマップがインストールされるフォームへのポインタへのポインタ。この値はハンドルではありません。つまり、古い {{span style='color:blue;font-family:monospace;',formPP}} 値は、この関数が返った後では、必ずしも有効ではありません。なぜなら、フォームはメモリの中を移動させられるかもしれないからです。この関数の呼び出し後の関数呼び出しでは、常にこの関数で返される新しい {{span style='color:blue;font-family:monospace;',formPP}} を使用してください。 *{{span style='color:blue;font-family:monospace;',→ ID}} **開発者によって指定されるビットマップの記号的な ID。慣例では、この ID はリソース ID と一致するべきです（義務ではありません）。 *{{span style='color:blue;font-family:monospace;',→ rscID}} **ビットマップを提供するリソースを指定する数値。この値はアプリケーション スコープ内で固有の値である必要があります。 *{{span style='color:blue;font-family:monospace;',→ x}} **ビットマップの領域の左上端の水平座標。ビットマップが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ ｙ}} **ビットマップの領域の左上端の垂直座標。ビットマップが現れるウィンドウから見た相対座標です。 '''返り値''' 新しいビットマップへのポインタを返します。呼び出しが成功しなかった場合、0 を返します。失敗する最も一般的な理由はメモリ不足です。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmRemoveObject,FrmRemoveObject()}} !{{anchor FrmNewForm}}FrmNewForm 関数 {{goto top,^TOP^}} '''目的''' 新しいフォーム オブジェクトを動的に作成します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' FormType *FrmNewForm ( UInt16 formID, const Char *titleStrP, Coord x, Coord y, Coord width, Coord height, Boolean modal, UInt16 defaultButton, UInt16 helpRscID, UInt16 menuRscID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formID}} **フォームの記号的 ID。開発者によって指定されます。慣例では、この ID はリソース ID と一致するべきです（義務ではありません）。 *{{span style='color:blue;font-family:monospace;',→ titleStrP}} **フォームのタイトルである文字列へのポインタ。 *{{span style='color:blue;font-family:monospace;',→ x}} **フォームの領域の左上端の水平座標。フォームが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ ｙ}} **フォームの領域の左上端の垂直座標。フォームが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ width}} **フォームの幅。ピクセル数で表します。有効範囲は 1 - 160 です。 *{{span style='color:blue;font-family:monospace;',→ height}} **フォームの高さ。ピクセル数で表します。有効範囲は 1 - 160 です。 *{{span style='color:blue;font-family:monospace;',→ modal}} **{{span style='color:blue;font-family:monospace;',true}} だと、フォームは領域外でのペン イベントを無視します。 *{{span style='color:blue;font-family:monospace;',→ defaultButton}} **フォームのデフォルトの行動を提供するボタンの記号的 ID。開発者によって指定されます。 *{{span style='color:blue;font-family:monospace;',→ helpRscID}} **フォームのオンライン ヘルプを提供するリソースの記号的 ID。開発者によって指定されます。モーダル ダイアログ（{{goto modal,訳者注}}）はヘルプ リソースを持つことができます。 *{{span style='color:blue;font-family:monospace;',→ menuRscID}} **フォームのメニューを提供するリソースの記号的 ID。開発者によって指定されます。 '''返り値''' 新しいフォーム オブジェクトへのポインタを返します。呼び出しが成功しなかった場合、0 を返します。失敗する最も一般的な理由はメモリ不足です。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmValidatePtr,FrmValidatePtr()}}, {{goto WinValidateHandle,WinValidateHandle()|Palm OS Programmer's API Reference/59}}, {{goto FrmRemoveObject,FrmRemoveObject()}} !{{anchor FrmNewGadget}}FrmNewGadget 関数 {{goto top,^TOP^}} '''目的''' 新しいガゼットを動的に作成し、それを指定されたフォームにインストールします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' FormGadgetType *FrmNewGadget ( FormType **formPP, UInt16 id, Coord x, Coord y, Coord width, Coord height ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ formPP}} **新しいガゼットがインストールされるフォームへのポインタへのポインタ。この値はハンドルではありません。つまり、古い {{span style='color:blue;font-family:monospace;',formPP}} 値は、この関数が返った後では、必ずしも有効ではありません。なぜなら、フォームはメモリの中を移動させられるかもしれないからです。この関数の呼び出し後の関数呼び出しでは、常にこの関数で返される新しい {{span style='color:blue;font-family:monospace;',formPP}} を使用してください。 *{{span style='color:blue;font-family:monospace;',→ id}} **開発者によって指定されるガゼットの記号的な ID。慣例では、この ID はリソース ID と一致するべきです（義務ではありません）。 *{{span style='color:blue;font-family:monospace;',→ x}} **ガゼットの領域の左上端の水平座標。ガゼットが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ ｙ}} **ガゼットの領域の左上端の垂直座標。ガゼットが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ width}} **ガゼットの幅。ピクセル数で表します。有効範囲は 1 - 160 です。 *{{span style='color:blue;font-family:monospace;',→ height}} **ガゼットの高さ。ピクセル数で表します。有効範囲は 1 - 160 です。 '''返り値''' 新しいガゼット オブジェクトへのポインタを返します。呼び出しが成功しなかった場合、0 を返します。失敗する最も一般的な理由はメモリ不足です。 '''コメント''' ガゼットはカスタム ユーザ インターフェイス オブジェクトです。追加情報については、''Palm OS User Interface GuideLines'' を参照してください。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmRemoveObject,FrmRemoveObject()}} !{{anchor FrmNewGsi}}FrmNewGsi 関数 {{goto top,^TOP^}} '''目的''' 新しいシフト指示子を動的に作成し、それを指定されたフォームにインストールします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' FrmGraffitiStateType *FrmNewGsi( FormType **formPP, Coord x, Coord y ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ formPP}} **新しいシフト指示子がインストールされるフォームへのポインタへのポインタ。この値はハンドルではありません。つまり、古い {{span style='color:blue;font-family:monospace;',formPP}} 値は、この関数が返った後では、必ずしも有効ではありません。なぜなら、フォームはメモリの中を移動させられるかもしれないからです。この関数の呼び出し後の関数呼び出しでは、常にこの関数で返される新しい {{span style='color:blue;font-family:monospace;',formPP}} を使用してください。 *{{span style='color:blue;font-family:monospace;',→ x}} **シフト指示子の領域の左上端の水平座標。シフト指示子が現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ ｙ}} **シフト指示子の領域の左上端の垂直座標。シフト指示子が現れるウィンドウから見た相対座標です。 '''返り値''' 新しいシフト指示子（訳者注: 原文では Gadget となっていたが誤りと思われる）オブジェクトへのポインタを返します。呼び出しが成功しなかった場合、0 を返します。失敗する最も一般的な理由はメモリ不足です。 '''コメント''' 通常のアプリケーションでは、シフト指示子は、ユーザがシフト入力をしたときに、スクリーンの右下に描かれます。シフト指示子を通常ではない場所に描く必要がある場合、この関数を使用してください。例えば、フォーム マネージャは、シフト指示子をテキスト フィールドを持つカスタム アラート ダイアログ（{{goto FrmCustomResponseAlert,FrmCustomResponseAlert()|Palm OS Programmer's API Reference/11-1}}）の中に描くために、この関数を使用します。 '''互換性''' {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmRemoveObject,FrmRemoveObject()}} !{{anchor FrmNewLabel}}FrmNewLabel 関数 {{goto top,^TOP^}} '''目的''' 新しいラベル オブジェクトを動的に作成し、それを指定されたフォームにインストールします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' FormLabelType *FrmNewLabel ( FormType **formPP, UInt16 ID, const Char *textP, Coord x, Coord y, FontID font ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ formPP}} **新しいラベルがインストールされるフォームへのポインタへのポインタ。この値はハンドルではありません。つまり、古い {{span style='color:blue;font-family:monospace;',formPP}} 値は、この関数が返った後では、必ずしも有効ではありません。なぜなら、フォームはメモリの中を移動させられるかもしれないからです。この関数の呼び出し後の関数呼び出しでは、常にこの関数で返される新しい {{span style='color:blue;font-family:monospace;',formPP}} を使用してください。 *{{span style='color:blue;font-family:monospace;',→ ID}} **開発者によって指定されるラベルの記号的な ID。慣例では、この ID はリソース ID と一致するべきです（義務ではありません）。 *{{span style='color:blue;font-family:monospace;',→ textP}} **ラベル テキストを提供する文字列へのポインタ。この文字列はラベル構造体の中にコピーされます。 *{{span style='color:blue;font-family:monospace;',→ x}} **ラベルの領域の左上端の水平座標。ラベルが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ ｙ}} **ラベルの領域の左上端の垂直座標。ラベルが現れるウィンドウから見た相対座標です。 *{{span style='color:blue;font-family:monospace;',→ font}} **描かれるラベル テキストで使用されるフォント。 '''返り値''' 新しいラベル オブジェクトへのポインタを返します。呼び出しが成功しなかった場合、0 を返します。失敗する最も一般的な理由はメモリ不足です。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto CtlValidatePointer,CtlValidatePointer()|Palm OS Programmer's API Reference/7}}, {{goto FrmRemoveObject,FrmRemoveObject()}} !{{anchor FrmPointInTitle}}FrmPointInTitle 関数 {{goto top,^TOP^}} '''目的''' 座標がフォームのタイトルの領域内であるかどうかをチェックします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean FrmPointInTitle ( const FormType *formP, Coord x, Coord y ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',"→ x, y"}} **ウィンドウから見た相対的な x と y 座標。 '''返り値''' 指定された座標がフォームのタイトルの中であれば、{{span style='color:blue;font-family:monospace;',true}} を返します。 '''互換性''' {{goto 2.0 New Feature Set,2.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 !{{anchor FrmPopupForm}}FrmPopupForm 関数 {{goto top,^TOP^}} '''目的''' 指定されたフォームのために {{goro frmLoadEvent,frmLoadEvent|Palm OS Programmer's API Reference/2}} と {{goro frmOpenEvent,frmOpenEvent|Palm OS Programmer's API Reference/2}} を待ち行列に追加します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmPopupForm ( UInt16 formId ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formID}} **オープンするフォームのリソース ID '''返り値''' 返り値はありません。 '''コメント''' このルーチンは、現在のフォームがクローズされない点が {{goto FrmGotoForm,FrmGotoForm()}} と異なります。{{span style='color:blue;font-family:monospace;',FrmPopupForm}} によってオープンされたフォームをクローズするためには {{goto FrmReturnToForm,FrmReturnToForm()}} を使用します。 !{{anchor FrmRemoveObject}}FrmRemoveObject 関数 {{goto top,^TOP^}} '''目的''' 指定されたフォームから指定されたオブジェクトを削除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmRemoveObject ( FormType **formPP, UInt16 objIndex ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ formPP}} **この関数が削除するオブジェクトがあるフォームへのポインタへのポインタ。この値はハンドルではありません。つまり、古い {{span style='color:blue;font-family:monospace;',formPP}} 値は、この関数が返った後では、必ずしも有効ではありません。なぜなら、フォームはメモリの中を移動させられるかもしれないからです。この関数の呼び出し後の関数呼び出しでは、常にこの関数で返される新しい {{span style='color:blue;font-family:monospace;',formPP}} を使用してください。 *{{span style='color:blue;font-family:monospace;',→ objIndex}} **削除されるオブジェクト。フォームにインストールされたオブジェクトのリストでのインデックスで指定されます。この値を取得するために {{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使用することができます。 '''返り値''' エラーが無い場合、0 を返します。 '''コメント''' あらゆるフォーム オブジェクト（ビットマップ、コントロール、リストなど）を削除し、フォーム データ構造体内のオブジェクトに割り当てられていたメモリを解放するために、この関数を使用できます。多くのフォーム オブジェクトのためのデータ構造体は、フォーム データ構造体メモリ チャンク内に埋め込まれています。この関数はそのメモリを解放し、必要があれば、メモリの「穴」を埋めてフォーム チャンクのサイズを減らすために他のオブジェクトを移動させます。 この関数は、編集可能なフィールド オブジェクトの中の文字列に割り当てられたメモリように、オブジェクトに割り当てられるかもしれないフォーム データ構造体の外のメモリは解放しないことに注意してください。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmNewBitmap,FrmNewBitmap()}}, {{goto FrmNewForm,FrmNewForm()}}, {{goto FrmNewGadget,FrmNewGadget()}}, {{goto FrmNewLabel,FrmNewLabel()}}, {{goto CtlNewControl,CtlNewControl()|Palm OS Programmer's API Reference/7}}, {{goto FldNewField,FldNewField()|Palm OS Programmer's API Reference/9}}, {{goto LstNewList,LstNewList()|Palm OS Programmer's API Reference/14}} !{{anchor FrmRestoreActiveState}}FrmRestoreActiveState マクロ {{goto top,^TOP^}} '''目的''' アクティブなウィンドウとフォームの状態を元に戻します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' #define FrmRestoreActiveState ( stateP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ stateP}} **状態を保存したときに {{span style='color:blue;font-family:monospace;',FrmSaveActiveState}} に渡した {{goto FormActiveStateType,FormActiveStateType|Palm OS Programmer's API Reference/11-1}} 構造体へのポインタ '''返り値''' 成功時に 0 を返します。 '''コメント''' 表示されているフォームの状態を、動的に新しいモーダル フォーム（{{goto modal,訳者注}}）を表示させる前の状態に戻します。状態を保存しておくために、事前に {{goto FrmSaveActiveState,FrmSaveActiveState()}} を呼び出しておく必要があります。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 !{{anchor FrmReturnToForm}}FrmReturnToForm 関数 {{goto top,^TOP^}} '''目的''' 現在のアクティブなフォームの消去と削除を行い、指定されたフォームをアクティブにします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmReturnToForm ( UInt16 formId ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formID}} **戻す（訳者注: アクティブにする）フォームのリソース ID '''返り値''' 返り値はありません。 '''コメント''' 戻されるフォームはすでにメモリに読み込まれて初期化されていると仮定します。0 のフォーム ID を渡すと、ウィンドウ リストの中の最初のフォームを戻します。最初のフォームは最後に読み込まれたフォームです。 {{span style='color:blue;font-family:monospace;',FrmReturnToForm}} は、モーダル フォーム（{{goto modal,訳者注}}）のイベント ハンドラから呼び出されたとき、{{span style='color:blue;font-family:monospace;',frmCloseEvent}} を生成しません。明示的に {{span style='color:blue;font-family:monospace;',FrmReturnToForm}} を呼び出しているため、フォーム変数のクリーン アップを実行済みだと仮定します。 '''参照''' {{goto FrmGotoForm,FrmGotoForm()}}, {[goto FrmPopupForm,FrmPopupForm()}} !{{anchor FrmSaveActiveState}}FrmSaveActiveState マクロ {{goto top,^TOP^}} '''目的''' アクティブなウィンドウとフォームの状態を保存します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' #define FrmSaveActiveState ( stateP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ stateP}} **状態を保存するために使用される {{goto FormActiveStateType,FormActiveStateType|Palm OS Programmer's API Reference/11-1}} 構造体へのポインタ。状態を戻すためには同じポインタを {{goto FrmRestoreActiveState,FrmRestoreActiveState()}} に渡してください。 '''返り値''' 成功時に 0 を返します。 '''コメント''' 動的に新しいモーダル フォーム（{{goto modal,訳者注}}）を表示する前に表示されているフォームの状態を保存するために、この関数を使用します。モーダル フォーム（{{goto modal,訳者注}}）を削除した後に状態を戻すために、{{goto FrmRestoreActiveState,FrmRestoreActiveState()}} を呼び出します。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 !{{anchor FrmSaveAllForms}}FrmSaveAllForms 関数 {{goto top,^TOP^}} '''目的''' {{goto frmSaveEvent,frmSaveEvent|Palm OS Programmer's API Reference/2}} をオープンされているすべてのフォームに送ります。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSaveAllForms ( void ) '''パラメータ''' ありません。 '''返り値''' 返り値はありません。 '''参照''' {{goto FrmCloseAllForms,FrmCloseAllForms()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetActiveForm}}FrmSetActiveForm 関数 {{goto top,^TOP^}} '''目的''' アクティブ フォームをセットします。すべての入力（キーとペン）はアクティブ フォームに向けられ、すべての描画もそこで行われます。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetActiveForm ( FormType *formP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ '''返り値''' 返り値はありません。 '''コメント''' フォームの外側での {{goto penDownEvent,penDownEvent|Palm OS Programmer's API Reference/2}} は、ディスプレイ領域の内側であっても無視されます。 '''互換性''' Palm OS 3.5 より前のリリースでは、この関数は、古いフォームのための {{goto winExitEvent,winExitEvent|Palm OS Programmer's API Reference/2}} のすぐ後に続けて、新しいフォームのための {{goto winEnterEvent,winEnterEvent|Palm OS Programmer's API Reference/2}} を生成します。Palm OS 3.5 からは、{{span style='color:blue;font-family:monospace;',FrmSetActiveForm}} は {{span style='color:blue;font-family:monospace;',winEnterEvent}} を生成しません。{{span style='color:blue;font-family:monospace;',winEnterEvent}} は、新しいアクティブ フォームが描画されるまで、起きません。 '''参照''' {{goto FrmGetActiveForm,FrmGetActiveForm()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetCategoryLabel}}FrmSetCategoryLabel 関数 {{goto top,^TOP^}} '''目的''' フォームのタイトル ライン上に表示されるカテゴリ ラベルをセットします。フォームの {{span style='color:blue;font-family:monospace;',visible}} 属性がセットされている場合、ラベルを再描画します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetCategoryLabel ( const FormType *formP, UInt16 objIndex, Char *newLabel ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるオブジェクトのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ newLabel}} **新しいカテゴリの名前へのポインタ '''返り値''' 返り値はありません。 '''コメント''' 新しいラベル（{{span style='color:blue;font-family:monospace;',newLabel}}））へのポインタはオブジェクト内に保存されます。 !{{anchor FrmSetControlGroupSelection}}FrmSetControlGroupSelection 関数 {{goto top,^TOP^}} '''目的''' コントロール グループの中のコントロールを選択します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetControlGroupSelection( const FormType *formP, UInt8 groupNum, UInt16 controlID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ groupNum}} **コントロール グループ番号 *{{span style='color:blue;font-family:monospace;',→ controlID}} **セットするコントロールの ID。 '''返り値''' 返り値はありません。 '''コメント''' この関数はグループの中の他のすべてのコントロールの選択を解除します。ディスプレイは更新されます。 //---- //'''NOTE::''' {{span style='color:blue;font-family:monospace;',FrmGetControlGroupSelection}} はコントロール グループの中の選択されたオブジェクトを、{{span style='color:blue;font-family:monospace;',FrmSetControlGroupSelection}} が選択されるオブジェクトをセットするために使用するオブジェクト ID ではなく、オブジェクト インデックスで返します。 //---- ::NOTE: :::{{span style='color:blue;font-family:monospace;',FrmGetControlGroupSelection}} はコントロール グループの中の選択されたオブジェクトを、{{span style='color:blue;font-family:monospace;',FrmSetControlGroupSelection}} が選択されるオブジェクトをセットするために使用するオブジェクト ID ではなく、オブジェクト インデックスで返します。 '''参照''' {{goto FrmGetControlGroupSelection,FrmGetControlGroupSelection()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetControlValue}}FrmSetControlValue 関数 {{goto top,^TOP^}} '''目的''' コントロールの現在値をセットします。コントロールが可視の場合、コントロールは再描画されます。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetControlValue ( const FormType *formP, UInt16 objIndex, Int16 newValue ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるコントロールのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ newValue}} **コントロールにセットする新しい値。スライダに対しては、スライダの最小値と最大値の間の値を指定します（訳者注: スライダが示す値のこと）。グラフィカル コントロール、プッシュ ボタンそれにチェック ボックスに対しては、off にする場合は 0 を、on にする場合は 0 でない値を指定します。 '''返り値''' 返り値はありません。 '''コメント''' この関数は、グラフィカル コントロール、スライダ、プッシュ ボタンそれにチェック ボックスに対してのみ機能します。他のタイプのコントロールの値をセットした場合のこの関数の振る舞いは定義されていません。 '''参照''' {{goto FrmGetControlValue,FrmGetControlValue()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetDIAPolicyAttr}}FrmSetDIAPolicyAttr 関数 {{goto top,^TOP^}} '''目的''' '''目的''' フォームの動的入力エリア ポリシーをセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmSetDIAPolicyAttr ( FormPtr formP, UInt16 diaPolicy ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ diaPolicy}} **{{goto フォームの動的入力エリアのポリシー,「フォームの動的入力エリアのポリシー」|Palm OS Programmer's API Reference/11-2}} でリストされている定数の 1 つ '''返り値''' エラーが無い場合、{{span style='color:blue;font-family:monospace;',errNone}} を返します。{{span style='color:blue;font-family:monospace;',diaPolicy}} パラメータが範囲外の場合、{{span style='color:blue;font-family:monospace;',pinErrInvalidParam}} を返します。 '''コメント''' アプリケーションは、{{span style='color:blue;font-family:monospace;',frmLoadEvent}} または {{span style='color:blue;font-family:monospace;',frmOpen}} への応答の中で、フォームが動的入力エリアをオープンまたはクローズする際に使用すべきポリシーをセットするために、この関数を呼び出します。アプリケーションがこの関数を呼び出さない場合のデフォルトのポリシーは {{span style='color:blue;font-family:monospace;',frmDIAPolicyStayOpen}} であることに注意してください。これ（訳者注: デフォルトのポリシー）は過去のアプリケーションが常に適切なサイズにされることを可能にします。なぜなら、アプリケーションが実行されている間、入力エリアはトリガが使用不可の状態で常にオープンされているからです。 '''互換性''' {{goto Pen Input Manager Feature Set,Pen Input Manager Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。 '''参照''' {{goto PINSetInputAreaState,PINSetInputAreaState|Palm OS Programmer's API Reference/46}}, {{goto FrmGetDIAPolicyAttr,FrmGetDIAPolicyAttr|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetEventHandler}}FrmSetEventHandler 関数 {{goto top,^TOP^}} '''目的''' 指定されたフォームのためのイベント ハンドラ コールバック ルーチンを登録します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetEventHandler ( FormType *formP, FormEventHandlerType *handler ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ handler}} **フォーム イベント ハンドラ関数 {{goto FormEventHandlerType,FormEventHandlerType}} のアドレス '''返り値''' 返り値はありません。 '''コメント''' {{goto FrmDispatchEvent,FrmDispatchEvent()|Palm OS Programmer's API Reference/11-1}} は、特定のフォームのためのイベントを受け取るといつでも、このハンドラを呼び出します。 {{span style='color:blue;font-family:monospace;',FrmSetEventHandler}} は、フォーム リソースが読み込まれた後に正しく呼び出されなければなりません。この関数が登録するコールバック ルーチンはイベントをアプリケーションに向けて発信するための機構です。チュートリアルでコールバック ルーチンをどのように使用するか説明しています。 !{{anchor FrmSetFocus}}FrmSetFocus 関数 {{goto top,^TOP^}} '''目的''' フォームのフォーカスを指定されたオブジェクトにセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetFocus ( FormType *formP, UInt16 fieldIndex ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ fieldIndex}} **フォームの中にあるフォーカスされるオブジェクトのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。定数 {{span style='color:blue;font-family:monospace;',noFocus}} を渡すことで、フォーカスされるオブジェクトを無くすることもできます。 '''返り値''' 返り値はありません。 '''コメント''' フィールドまたはテーブル オブジェクトにフォーカスをセットすることができます。フォーカスがフィールド オブジェクトにセットされた場合、この関数は {{goto FldGrabFocus,FldGrabFocus()|Palm OS Programmer's API Reference/9}} を呼び出すことでフィールドの中に挿入ポイントを点灯させます。 '''参照''' {{goto FrmGetFocus,FrmGetFocus()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetGadgetData}}FrmSetGadgetData 関数 {{goto top,^TOP^}} '''目的''' ガゼット オブジェクトの {{span style='color:blue;font-family:monospace;',data}} フィールドのデータ値を戻します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetGadgetData ( FormType *formP, UInt16 objIndex, const void *data ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるオブジェクトのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ data}} **アプリケーション定義値。この値はガゼット データ構造体（{{goto FormGadgetType,FormGadgetType|Palm OS Programmer's API Reference/11-1}}）の {{span style='color:blue;font-family:monospace;',data}} フィールドに戻されます。 '''返り値''' 返り値はありません。 '''コメント''' ガゼット オブジェクトは、アプリケーションのために、カスタム ガゼットをフォームに貼り付ける手段を提供します。一般に、ガゼット オブジェクトの {{span style='color:blue;font-family:monospace;',data}} フィールドはカスタム オブジェクトのデータ構造体へのポインタを保持します。 '''参照''' {{goto FrmGetGadgetData,FrmGetGadgetData()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmSetGadgetHandler,FrmSetGadgetHandler()}} !{{anchor FrmSetGadgetHandler}}FrmSetGadgetHandler 関数 {{goto top,^TOP^}} '''目的''' 指定されたフォーム上の指定されたガゼットのイベント ハンドラであるコールバック ルーチンを登録します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetGadgetHandler ( FormType *formP, UInt16 objIndex, FormGadgetHandlerType *attrP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるガゼットのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ attrP}} **コールバック関数のアドレス。{{goto FormGadgetHandlerType,FormGadgetHandlerType()}} を参照してください。 '''返り値''' 返り値はありません。 '''コメント''' この関数は指定されたガゼットの振る舞いを制御するアプリケーション定義関数をセットします。この関数は、ガゼットが描画される、消される、削除される必要があるとき、または、イベントをハンドルする必要があるときに呼び出されます。 '''互換性''' {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmGetGadgetData,FrmGetGadgetData()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmSetGadgetData,FrmSetGadgetData()}} !{{anchor FrmSetMenu}}FrmSetMenu 関数 {{goto top,^TOP^}} '''目的''' フォームのメニュー バーを変更し、新しいメニューをアクティブにします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetMenu ( FormType *formP, UInt16 menuRscID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ menuRscID}} **メニューのリソース ID '''返り値''' 返り値はありません。 '''互換性''' {{goto 2.0 New Feature Set,2.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 !{{anchor FrmSetNavEntry}}FrmSetNavEntry 関数 {{goto top,^TOP^}} '''目的''' フォームの中にある 1 つのオブジェクトのナビゲーション情報を変更します。 '''Prototype''' Err FrmSetNavEntry ( FormType *formP, UInt16 targetObjectID, UInt16 afterObjectID, UInt16 aboveObjectID, UInt16 belowObjectID, FrmNavObjectFlagsType objectFlags ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **ナビゲーション順が変更されるフォームへのポインタ *{{span style='color:blue;font-family:monospace;',→ targetObjectID}} **編集、追加または削除されるオブジェクトの ID *{{span style='color:blue;font-family:monospace;',→ afterObjectID}} **ターゲット オブジェクトの左にくるオブジェクトの ID。現在ここで指定されるオブジェクトの右にあるオブジェクトはターゲット オブジェクトの右に移動させられます。ターゲット オブジェクトをナビゲーション順の最初に位置させるには、そのオブジェクトを行の中で一番左にして、0 の ID を渡します。ターゲット オブジェクトを完全にナビゲーション順から削除するには {{span style='color:blue;font-family:monospace;',frmInvalidObjectId}} の ID を渡します。 *{{span style='color:blue;font-family:monospace;',→ aboveObjectID}} **ターゲット オブジェクトの上にくるオブジェクトの ID。ターゲット オブジェクトがフォームの最初の行にある場合、0 の ID を渡します。 *{{span style='color:blue;font-family:monospace;',→ belowObjectID}} **ターゲット オブジェクトの下にくるオブジェクトの ID。ターゲット オブジェクトがフォームの最後の行にある場合、0 の ID を渡します。 *{{span style='color:blue;font-family:monospace;',→ objectFlags}} **ターゲット オブジェクトのための新しいオブジェクト フラグ。{{goto FrmNavObjectFlagsType,FrmNavObjectFlagsType|Palm OS Programmer's API Reference/11-1}} を参照してください。 '''返り値''' 操作が成功裏に完了した場合、{{span style='color:blue;font-family:monospace;',errNone}}を返します。そうでない場合はエラー コードを返します。 '''コメント''' //---- //'''NOTE::''' この関数はナビゲーション リソースの内容を置き換えることを意図してはいません。カスタム ナビゲーション順を持つことを必要とするフォームは'''常に'''ナビゲーション リソースを敵供すべきです。この関数は、主に、動的に作成されるフォームまたはナビゲーション リソースを持つがフォームの初期化後に順番を変更するフォームのためにあります。 //---- ::NOTE: :::この関数はナビゲーション リソースの内容を置き換えることを意図してはいません。カスタム ナビゲーション順を持つことを必要とするフォームは'''常に'''ナビゲーション リソースを敵供すべきです。この関数は、主に、動的に作成されるフォームまたはナビゲーション リソースを持つがフォームの初期化後に順番を変更するフォームのためにあります。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmGetNavEntry,FrmGetNavEntry()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetNavOrder}}FrmSetNavOrder 関数 {{goto top,^TOP^}} '''目的''' ナビゲーション順とフォームのヘッダ情報の両方またはどちらかをセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmSetNavOrder ( FormType *formP, FrmNavHeaderType *navHeaderP, FrmNavOrderEntryType *navOrderP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーカス順がセットされるフォームへのポインタ *{{span style='color:blue;font-family:monospace;',→ navHeaderP}} **フォームのナビゲーション情報のためのヘッダ情報を保持する {{goto FrmNavHeaderType,FrmNavHeaderType|Palm OS Programmer's API Reference/11-1}} へのポインタ *{{span style='color:blue;font-family:monospace;',→ navOrderP}} **フォームの新しいナビゲーション順を指定する {{goto FrmNavOrderEntryType,FrmNavOrderEntryType|Palm OS Programmer's API Reference/11-1}} の配列へのポインタ。配列の中のエントリの数はヘッダ パラメータの {{span style='color:blue;font-family:monospace;',numberOfObjects}} フィールドと等しくなければなりません。フォームのナビゲーション順は変更したくないが、フォームのヘッダ情報のみを変更したい場合、{{span style='color:blue;font-family:monospace;',NULL}} を渡します。 '''返り値''' 操作が成功裏に完了した場合、{{span style='color:blue;font-family:monospace;',errNone}} を返します。そうでない場合はエラー コードを返します。 '''コメント''' この関数は渡されたすべての情報のコピーを作成します。 現在フォーカスされているオブジェクトがナビゲーション順から削除された場合、そのオブジェクトはフォーカスされていない状態で再描画され、フォームもフォーカスされていない状態になります。 //---- //'''NOTE::''' この関数はナビゲーション リソースの内容を置き換えることを意図してはいません。カスタム ナビゲーション順を持つことを必要とするフォームは'''常に'''ナビゲーション リソースを敵供すべきです。この関数は、主に、動的に作成されるフォームまたはナビゲーション リソースを持つがフォームの初期化後に順番を変更するフォームのためにあります。 //---- ::NOTE: :::この関数はナビゲーション リソースの内容を置き換えることを意図してはいません。カスタム ナビゲーション順を持つことを必要とするフォームは'''常に'''ナビゲーション リソースを敵供すべきです。この関数は、主に、動的に作成されるフォームまたはナビゲーション リソースを持つがフォームの初期化後に順番を変更するフォームのためにあります。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmGetNavEntry,FrmGetNavEntry()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetNavState}}FrmSetNavState 関数 {{goto top,^TOP^}} '''目的''' フォームのナビゲーション状態をセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Err FrmSetNavState ( FormType *formP, FrmNavStateFlagsType stateFlags ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **ナビゲーション状態がセットされるフォームへのポインタ *{{span style='color:blue;font-family:monospace;',→ stateFlags}} **新しいナビゲーション状態を示すフラグ。状態はフォームの現在のフォーカス モードを示します。このパラメータに渡されるフラグについては、{{goto FrmNavStateFlagsType,FrmNavStateFlagsType|Palm OS Programmer's API Reference/11-1}} を参照してください。 '''返り値''' 操作が成功裏に完了した場合、{{span style='color:blue;font-family:monospace;',errNone}} を返します。そうでない場合はエラー コードを返します。 '''互換性''' {{goto One-Handed Navigation Feature Set,One-Handed Navigation Feature Set|Palm OS Programmer's API Reference/B-2}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmGetNavEntry,FrmGetNavEntry()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetObjectBounds}}FrmSetObjectBounds 関数 {{goto top,^TOP^}} '''目的''' オブジェクトの領域または位置をセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetObjectBounds ( FormType *formP, UInt16 objIndex, const RectangleType *bounds ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるオブジェクトのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ bounds}} **ウィンドウとの相対的な領域。以下のオブジェクトでは、この関数は領域の左上端の位置をセットするだけです: ラベル、ビットマップ、シフト指示子。 '''返り値''' 返り値はありません。 '''コメント''' ディスプレイの更新は行いません。 '''互換性''' {{goto 2.0 New Feature Set,2.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmGetObjectPosition,FrmGetObjectPosition()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmGetObjectBounds,FrmGetObjectBounds()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmSetObjectPosition,FrmSetObjectPosition()}} !{{anchor FrmSetObjectPosition}}FrmSetObjectPosition 関数 {{goto top,^TOP^}} '''目的''' オブジェクトの位置をセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetObjectPosition ( FormType *formP, UInt16 objIndex, Coord x, Coord y ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるオブジェクトのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ x}} **ウィンドウとの相対的な水平座標。 *{{span style='color:blue;font-family:monospace;',→ y}} **ウィンドウとの相対的な垂直座標。 '''返り値''' 返り値はありません。 '''参照''' {{goto FrmGetObjectPosition,FrmGetObjectPosition()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmGetObjectBounds,FrmGetObjectBounds()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmSetTitle}}FrmSetTitle 関数 {{goto top,^TOP^}} '''目的''' フォームのタイトルをセットします。フォームが可視の場合、新しいタイトルを描きます。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmSetTitle ( FormType *formP, Char *newTitle ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ newTitle}} **新しいタイトル文字列へのポインタ '''返り値''' 返り値はありません。 '''コメント''' この関数は、フォームが可視の場合、タイトルを描きます。 この関数は {{span style='color:blue;font-family:monospace;',newTitle}} で渡されたポインタを保存します。コピーは作成しません。{{span style='color:blue;font-family:monospace;',newTitle}} の値はスタック ベースのオブジェクトへのポインタであってはいけません。 '''互換性''' 以前のバージョンでは、この関数は古いタイトルを消さずに新しいタイトルを再描画します。この問題は Palm OS 3.0 で解消されました。 '''参照''' {{goto FrmGetTitle,FrmGetTitle()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmCopyTitle,FrmCopyTitle()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmCopyLabel,FrmCopyLabel()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmShowObject}}FrmShowObject 関数 {{goto top,^TOP^}} '''目的''' フォーム オブジェクトを使用可能にします。フォームが可視の場合、オブジェクトを描きます。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmShowObject ( FormType *formP, UInt16 objIndex ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ objIndex}} **フォームの中にあるオブジェクトのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 '''返り値''' 返り値はありません。 '''互換性''' Palm OS 3.5 より前のバージョンでは、この関数はリストとテーブルに影響を与えません。Palm OS 3.5 では、この関数はリストに対しては正しく機能しますが、テーブルに対しては影響を与えません。Palm OS 4.0 では、この関数はリストとテーブルの両方に対して正しく機能します。 {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が満たされ、かつ、オブジェクトが拡張ガゼットの場合、この関数は {{span style='color:blue;font-family:monospace;',formGadgetDrawCmd}} と一緒にガゼットのコールバック関数を呼び出します。{{goto FormGadgetHandlerType,FormGadgetHandlerType()}} を参照してください。 '''参照''' {{goto FrmHideObject,FrmHideObject()}} !{{anchor FrmUpdateForm}}FrmUpdateForm 関数 {{goto top,^TOP^}} '''目的''' {{goto frmUpdateEvent,frmUpdateEvent|Palm OS Programmer's API Reference/2}} を指定されたフォームに送ります。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmUpdateForm ( UInt16 formId, UInt16 updateCode ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formId}} **更新するフォームのリソース ID *{{span style='color:blue;font-family:monospace;',→ updateCode}} **更新に必要とされるものを示すために使用することができるアプリケーション定義コード。フォーム全体が再描画されるべきであることを示すにはコード {{span style='color:blue;font-family:monospace;',frmRedrawUpdateCode}} を指定します。 '''返り値''' 返り値はありません。 '''コメント''' この関数によって発せられる {{span style='color:blue;font-family:monospace;',frmUpdateEvent}} がデフォルトのフォーム イベント ハンドラ（{{goto FrmHandleEvent,FrmHandleEvent()|Palm OS Programmer's API Reference/11-1}}）によってハンドルされる場合、{{span style='color:blue;font-family:monospace;',updateCode}} パラメータは無視されます。{{span style='color:blue;font-family:monospace;',FrmHandleEvent}} は常にフォームを再描画します。 カスタム イベント ハンドラによって {{span style='color:blue;font-family:monospace;',frmUpdateEvent}} がハンドルされる場合、{{span style='color:blue;font-family:monospace;',updateCode}} パラメータを好きなように使用することができます。例えば、このパラメータを、フォームの再描画されるべき特定の部分を示すために、使用するかもしれません。{{span style='color:blue;font-family:monospace;',frmUpdateEvent}} をハンドルする場合、カスタム イベント ハンドラが {{span style='color:blue;font-family:monospace;',true}} を返し、それによりデフォルトのフォーム イベント ハンドラがフォーム全体の再描画を行わないようになっていることを確認してください。 カスタム イベント ハンドラによって {{span style='color:blue;font-family:monospace;',frmUpdateEvent}} がハンドルされる場合、{{span style='color:blue;font-family:monospace;',updateCode}} が {{span style='color:blue;font-family:monospace;',frmRedrawUpdateCode}} にセットされているイベントをハンドルして、フォーム全体を再描画するようになっていることを確認してください。このイベント（とコード）は、ディスプレイがリフレッシュされる必要があるためにフォーム全体が再描画される必要があるとき、システムによって発せられます。 !{{anchor FrmUpdateScrollers}}FrmUpdateScrollers 関数 {{goto top,^TOP^}} '''目的''' フィールドのスクロール矢印ボタンを視覚的に更新（表示または隠す）します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' void FrmUpdateScrollers ( FormType *formP, UInt16 upIndex, UInt16 downIndex, Boolean scrollableUp, Boolean scrollableDown ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ *{{span style='color:blue;font-family:monospace;',→ upIndex}} **上スクロールボタンのインデックス。{{goto FrmGetObjectIndex,FrmGetObjectIndex()|Palm OS Programmer's API Reference/11-1}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ downIndex}} **下スクロールボタンのインデックス。{{span style='color:blue;font-family:monospace;',FrmGetObjectIndex}} を使ってこの値を取得することができます。 *{{span style='color:blue;font-family:monospace;',→ scrollableUp}} **上スクロールボタンをアクティブにする（表示させる）には {{span style='color:blue;font-family:monospace;',true}} をセットし、隠すには {{span style='color:blue;font-family:monospace;',false}} をセットします。 *{{span style='color:blue;font-family:monospace;',→ scrollableDown}} **下スクロールボタンをアクティブにする（表示させる）には {{span style='color:blue;font-family:monospace;',true}} をセットし、隠すには {{span style='color:blue;font-family:monospace;',false}} をセットします。 '''返り値''' 返り値はありません。 '''コメント''' この関数は、元々は、テキストを持つボタンに対して使用されるものと考えられていました。なぜなら、この関数は矢印（黒または灰、上または下のいずれか）を更新するためにシンボル フォントを使用するからです。しかしながら、この関数はさまざまなボタン タイプに対応します。テキストを持たないボタンの使用可能／使用不可の状態を取得することができ、ガゼットを使用している場合、取得した状態をカスタム スクロール ボタンの表示を変更するために使用することができます。この関数にテキストを持つボタンを渡さなかった場合、この関数はボタンの「テキスト」メンバに関するボタンの表示を更新しようとはしません。 !{{anchor FrmValidatePtr}}FrmValidatePtr 関数 {{goto top,^TOP^}} '''目的''' 指定されたポインタが有効なフォームを参照している場合は {{span style='color:blue;font-family:monospace;',true}} を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean FrmValidatePtr ( const FormType *formP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **テストされるポインタ '''返り値''' 指定されたポインタが有効なフォーム構造体を持つオブジェクトを指す non-{{span style='color:blue;font-family:monospace;',NULL}} ポインタである場合、{{span style='color:blue;font-family:monospace;',true}} を返します。 '''コメント''' この関数はデバッグ目的のみで使用されることを意図しています。リリース コードにこの関数を含めないでください。 リリース コードでウィンドウとフォームを見分けるには、この関数を使用する代わりに、{{goto WindowType,WindowType|Palm OS Programmer's API Rerence/59}} 構造体の中のフラグ {{span style='color:blue;font-family:monospace;',windowFlags.dialog}} を見てください。ウィンドウがフォームの場合、このフラグは {{span style='color:blue;font-family:monospace;',true}} です。 '''互換性''' {{goto 3.0 New Feature Set,3.0 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto ECFrmValidatePtr,ECFrmValidatePtr()|Palm OS Programmer's API Reference/11-1}} !{{anchor FrmVisible}}FrmVisible 関数 {{goto top,^TOP^}} '''目的''' フォームが可視（描かれている）場合、{{span style='color:blue;font-family:monospace;',true}} を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean FrmVisible ( const FormType *formP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ formP}} **フォーム オブジェクト（{{goto FromType,FormType|Palm OS Programmer's API Reference/11-1}} 構造体）へのポインタ '''返り値''' フォームが可視の場合、{{span style='color:blue;font-family:monospace;',true}} を返します。可視でない場合、{{span style='color:blue;font-family:monospace;',false}} を返します。 '''参照''' {{goto FrmDrawForm,FrmDrawForm()|Palm OS Programmer's API Reference/11-1}}, {{goto FrmEraseForm,FrmEraseForm()|Palm OS Programmer's API Reference/11-1}} !!{{anchor Application-Defined Functions}}アプリケーション定義関数 {{goto top,^TOP^}} !{{anchor FormCheckResponseFuncType}}FormCheckResponseFuncType 関数 {{goto top,^TOP^}} '''目的''' {{goto FrmCustomResponseAlert,FrmCustomResponseAlert()|Palm OS Programmer's API Reference/11-1}} のためのコールバック関数。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean FormCheckResponseFuncType ( Int16 button, Char *attempt ) typedef FormCheckResponseFuncType *FormCheckResponseFuncPtr '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ button}} **ユーザがタップするボタンの ID *{{span style='color:blue;font-family:monospace;',→ attempt}} **ユーザがダイアログの中に入力した文字列 '''返り値''' ダイアログを終了させるべきである場合、{{span style='color:blue;font-family:monospace;',true}} を返します。ダイアログを終了させるべきではない場合、{{span style='color:blue;font-family:monospace;',false}} を返します。 '''コメント''' この関数は、{{span style='color:blue;font-family:monospace;',FrmCustomResponseAlert}} ルーチンの中で以下の時点で呼び出されます。 *{{span style='color:blue;font-family:monospace;',FrmCustomResponseAlert}} の開始時、この関数は {{span style='color:blue;font-family:monospace;',frmResponseCreate}} のボタン ID と一緒に呼び出されます。この定数はダイアログが表示されようとしていて、関数は必要な初期化を実行すべきであるということを示します。 *ユーザがダイアログ上のボタンをタップした時。関数は {{span style='color:blue;font-family:monospace;',attempt}} 文字列を処理すべきです。文字列が有効な入力である場合、関数は {{span style='color:blue;font-family:monospace;',true}} を返すべきです。有効でない場合、ユーザに文字列を再入力する機会を与えるために {{span style='color:blue;font-family:monospace;',false}} を返すべきです。 *{{span style='color:blue;font-family:monospace;',FrmCustomResponseAlert}} の終了時、この関数は {{span style='color:blue;font-family:monospace;',frmResponseQuit}} のボタン ID と一緒に呼び出されます。これは、コールバック関数にクリーンアップ、Japanese FEP（訳者注: font-end proccesor つまり、日本語入力システムのことと思われる）を再び使用可能にするなど、を実行する機会を与えます。 '''互換性''' {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 !{{anchor FormEventHanlderType}}FormEventHandlerType 関数 {{goto top,^TOP^}} '''目的''' フォームのためのイベント ハンドラ コールバック ルーチン。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean FormEventHandlerType ( EventType *eventP ) typedef FormEventHandlerType *FormEventHandlerPtr '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ eventP}} **フォーム イベント（{{goto FormType,FormType|Palm OS Programmer's API Reference//11-1}} 構造体）へのポインタ '''返り値''' このルーチンがイベントをハンドルした場合は {{span style='color:blue;font-family:monospace;',true}} を返さなくてはなりません。そうでない場合は {{span style='color:blue;font-family:monospace;',false}} を返さなくてはなりません。 '''コメント''' {{goto FrmDispatchEvent,FrmDispatchEvent()|Palm OS Programmer's API Reference/11-1}} は、フォームのためのイベントを受け取るといつでも、このハンドラを呼び出します。 このコールバック ルーチンは、アプリケーションの中にある特定のフォームにイベントを発信するための機構です。コールバックはルーチン {{goto FrmSetEventHandler,FrmSetEventHandler()}} によって登録されます。 !{{anchor FormGadgetHandlerType}}FormGadgetHandlerType 関数 {{goto top,^TOP^}} '''目的''' 拡張ガゼットのためのイベント ハンドラ コールバック。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',Form.h}} '''Prototype''' Boolean ( FormGadgetHandlerType )( struct FormGadgetTypeInCallback *gadgetP, UInt16 cmd, void *paramP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ gadgetP}} **ガゼット構造体へのポインタ。{{goto FormGadgetType,FormGadgetType|Palm OS Programmer's API Reference/11-1}} を参照してください。 *{{span style='color:blue;font-family:monospace;',→ cmd}} **ハンドラがとるべき行動を指定する定数。この定数は以下に示すものの 1 つです。 {{div_begin style="margin-left:5em;"}} *{{span style='color:blue;font-family:monospace;',formGadgetDeleteCmd}} **ガゼットが削除されているところで、ガゼットは割り当てられていたメモリのクリーンアップまたは他のクリーンアップ タスクを実行しなければならないということを示すために、{{goto FrmDeleteForm,FrmDeleteForm()|Palm OS Programmer's API Reference/11-1}} によって送られます。 *{{span style='color:blue;font-family:monospace;',formGadgetDrawCmd}} **ガゼットは描画または再描画を行わなければならないということを示すために、{{goto FrmDrawForm,FrmDrawForm()|Palm OS Programmer's API Reference/11-1}} または {{goto FrmShowObject,FrmShowObject()}} によって送られます。 *{{span style='color:blue;font-family:monospace;',formGadgetEraseCmd}} **ガゼットは消されようとしているということを示すために、{{goto FrmHideObject,FrmHideObject()}} によって送られます。{{span style='color:blue;font-family:monospace;',FrmEraseObject}} は {{span style='color:blue;font-family:monospace;',bisible}} と {{span style='color:blue;font-family:monospace;',usable}} フラグをクリアします。コールバックが {{span style='color:blue;font-family:monospace;',false}} を返した場合、{{span style='color:blue;font-family:monospace;',FrmEraseObject}} は、ガゼットの領域を消すために、さらに {{span style='color:blue;font-family:monospace;',WinEraseRectangle}} を呼び出します。 *{{span style='color:blue;font-family:monospace;',formGadgetHandleEventCmd}} **ガゼット イベントが受け取られたということを示すために、{{goto FrmHandleEvent,FrmHandleEvent()|Palm OS Programmer's API Reference/11-1}} によって送られます。{{span style='color:blue;font-family:monospace;',paramP}} パラメータは {{span style='color:blue;font-family:monospace;',EventType}} 構造体へのポインタを保持しています。 {{div_end}} *{{span style='color:blue;font-family:monospace;',→ paramP}} **{{span style='color:blue;font-family:monospace;',cmd}} が {{span style='color:blue;font-family:monospace;',formGadgetHandleEventCmd}} である場合を除いて {{span style='color:blue;font-family:monospace;',NULL}} です。除外されたケースでは、このパラメータはイベントを保持している {{span style='color:blue;font-family:monospace;',EventType}} 構造体へのポインタを保持しています。 '''返り値''' イベントが成功裏にハンドルされた場合、{{span style='color:blue;font-family:monospace;',true}} を返します。そうでない場合、{{span style='color:blue;font-family:monospace;',false}} を返します。 '''コメント''' この関数が、{{span style='color:blue;font-family:monospace;',formGadgetDrawCmd}} への応答の中で、描画を行う場合、この関数はガゼットの {{span style='color:blue;font-family:monospace;',visible}} 属性フラグをセットすべきです。（{{span style='color:blue;font-family:monospace;',gadgetP->attr.visible = true}}）このフラグは、ガゼットがスクリーン上に現れるということを示します。{{span style='color:blue;font-family:monospace;',visible}} フラグをセットしない場合、ガゼットは、{{goto FrmHideObject,FrmHideObject()}} が呼び出されたとき、消されません。（{{span style='color:blue;font-family:monospace;',FrmHideObject}} は、オブジェクトの {{span style='color:blue;font-family:monospace;',visible}} フラグが {{span style='color:blue;font-family:monospace;',false}} の場合、すぐに返ります。） 関数が {{span style='color:blue;font-family:monospace;',formGadgetEraseCmd}} を受け取った場合、{{span style='color:blue;font-family:monospace;',paramP}} は以下の 2 つのイベントのうちの 1 つを指しているということに注意してください: {{goto frmGadgetEnterEvent,frmGadgetEnterEvent|Palm OS Programmer's API Reference/2}} または {{goto frmGadgetMiscEvent,frmGadgetMiscEvent|Palm OS Programmer's API Reference/2}}。{{span style='color:blue;font-family:monospace;',frmGadgetEnterEvent}} は、ガゼットの領域内で {{goto penDownEvent,penDownEvent|Palm OS Programmer's API Reference/2}} が起きたときに、渡されます。この関数はペンを追跡し、必要なハイライトを行うべきです。{{span style='color:blue;font-family:monospace;',frmGadgetMiscEvent}} がシステムによって送られることはありません。アプリケーションが、拡張ガゼットにデータを送る必要があるときに、{{span style='color:blue;font-family:monospace;',frmGadgetMiscEvent}} を使用することがあるかもしれません。そのようなケースでは、イベントは {{span style='color:blue;font-family:monospace;',selector}}（符号無し整数）と {{span style='color:blue;font-family:monospace;',dataP}}（データへのポインタ）フィールドのどちらかまたは両方を持ちます。 '''互換性''' {{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。 '''参照''' {{goto FrmSetGadgetHandler,FrmSetGadgetHandler()}} {{anchor modal}} 訳者注: モーダル ダイアログとは、そのダイアログ ボックスが表示されている間はダイアログ以外の操作を受け付けなくするダイアログです。 ※訳者は古い Palm デバイスしか所有していないため、ナビゲーション関係の記述についてはあやふやな部分が多いです。 [[←　11 章のページ 1 へ|Palm OS Programmer's API Reference/11-1]]　[[↑　11 章のトップへ|Palm OS Programmer's API Reference/11]] {{div_end}} {{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}} [[←　10 章に戻る|Palm OS Programmer's API Reference/10]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[12 章に進む　→|Palm OS Programmer's API Reference/12]] {{div_end}}