click

バインディング

宣言

click メソッドでは、指定された場所でマウスダウンイベントを処理しなければなりません。関数　wind_defaultscroll は、オブジェクトがスクロールバーを含むイベントを処理する場合の手助けとなります。また、はマウスのドラッグ操作を処理するためには、wind_drag を使われなければなりません。これらの２つの関数については後述します。

update

バインディング

宣言

このメッセージは、ウィンドウの内容を描画することによって生じる update イベントに応答する必要があることを示します。ウィンドウにスクロールバーやグロウアイコンがある場合、Maxはスクロールバーの描画（Max はウィンドウ上で DrawContols を呼び出します）や、ウィンドウのグロウアイコンの処理を引き受けてくれます。また、ウィンドウ内部にある、影響を受ける領域の消去も行なってくれます。これは覚えておいて下さい。

key

バインディング

宣言

このキーイベントによって、GetNextEvent から返されるMacOS イベントレコードの modifiers フィールド。shift,option,command,capslock,control キーが押されていたかどうかを示します。

このメッセージは、キーダウン、またはオートキーイベントに応答することを可能にします。Windows XP では、キーイベントは Macintosh の 修飾キーとキーコードに読みかえられます。詳細は、関連した Macintosh の開発ドキュメントを参照して下さい。

cursor

バインディング

宣言

cursor メソッドは、カーソルがウィンドウ上にある間は、繰り返し呼び出されます。マウスの位置はローカル座標として pt に渡されます。また、修飾キーの状態やウィンドウのアクティブ／非アクティブの状態は、 modifiers および active にそれぞれ報告されます。一般的に、ウィンドウはカーソルがテキストエディットのフィールドのような特定の場所にある場合に、その位置を調節するために cursor メソッドを使います。カーソルをセットするためには、wind_setcursor を使うことができます。

パッチャーはまた、ウィンドウ内でテキストが編集されている場合にTEIdleを呼び出したり、マウスがインレットやアウトレットの上に来たときにそれをハイライトさせたりするために cursor メソッドを利用しています。cursor 関数は、マウスが押し下げられ、wind_drag を呼び出している間でも呼び出しを受けるという点に注意して下さい。

cursorout

バインディング

宣言

cursolout メソッドはカーソルがウィンドウの中から外へ出た時に一度呼び出されます。ローカル座標で表されるマウス位置が pt に渡され、修飾キーの状態とウィンドウのアクティブ／非アクティブの状態が、それぞれ modifiers と active を通して報告されます。一般的に、ウィンドウは、カーソルがウィンドウの境界から出たときに cursolout メソッドを使ってそれを調整します。カーソルは wind_setcursol を使ってセットすることができます。

widle

バインディング

宣言

cursor メッセージにメッセージがバインドされている場合、これを使う必要はないでしょう。

activate

バインディング

宣言

一般的な activate イベントへの応答は active の値に応じて、選択している何かをハイライトしたり、ハイライトを止めたりすることです。Max はスクロールバーの使用可／不可を受け持ちます。

close

バインディング

宣言

このメッセージはユーザがウィンドウを閉じたい場合にオブジェクトに送られます。ウィンドウを閉じることによってオブジェクトのデータが破壊されないようにオブジェクトを書いて下さい。それによって、ユーザは何かを失うのではないかという心配をせずにウィンドウを閉じることができます。後々、wind_new で他のウィンドウを作成するつもりならば、freeobject（これは CloseWindow を実行します）を呼び出して、ウィンドウのメモリを開放します。そうでない場合、次のように t_syswind に対してsyswindow_hide を使う必要があります。。

syswindow_hide(wind_syswind(myobject->m_wind)));

Max は単に、ユーザがウィンドウを閉じたがっているということを報告するに過ぎません。このメッセージに対して、好きな方法で応答することができますが、もしウィンドウを開いたままにしておくと、ユーザが終了するときに問題が起きるかもしれません。

scroll

バインディング

宣言

Max はユーザがスクロールバーを動かすと、このルーチンを呼び出します。このとき、t_wind の　w_xoffset（水平方向）と　w_yoffset（垂直方向）フィールドをチェックして、以前に保存した値と比較し、それに従ってウィンドウをスクロールする必要があります。

vis and invis

バインディング

addmess (myobject_vis, "vis", A_CANT, 0);
addmess (myobject_invis, "invis", A_CANT, 0) ;

宣言

void myobject_vis (t_myobject *x);
void myobject_invis (t_myobject *x);

これらのメッセージに応答して、適当な動作を行なうことができます。例えば、vis メッセージを受け取ったときにウィンドウのユーザインターフェイスを初期化することなどがあります。

oksize

バインディング

宣言

oksize メソッドによって、実際にウィンドウのサイズが変更される前に、サイズをチェックし、できるかぎりの調整を行なうことができます。（下記の wsize メッセージを参照）。提示されたサイズはhsize と vsize に渡されます。これらを好きな値にセットすることができます。ウィンドウが「セル」を持っていて、ウィンドウのサイズがセルの数の正確な倍数であって欲しい場合には、oksize メッセージを利用したいと思うでしょう。下で述べるように、明らかに、oksize メッセージは wsize メッセージより前に送られます。

wsize

バインディング

宣言

ユーザがウィンドウのサイズを変更したときに、wsize メッセージを通して報告されます。新しいウィンドウの大きさは、hsize と vsise として渡されます。ウィンドウにスクロールバーがある場合、それらを動かし、サイズ変更し、再描画する必要があります。

otclick

バインディング

宣言

otclick は 「Option-Title-Click」を表しています。例えば、パッチャーウィンドウがサブパッチウィンドウから、ポップアップメニューによって親ウィンドウに戻ることができるのは、このメソッドを実装しているためです。otclick メソッドを実装していない場合は、[option]+クリックを行なった際に、ユーザが期待するような通常のドラッグ動作を実行します。

ｍouseup

バインディング

宣言

chkmenu

バインディング

宣言

メニューのアイテムを使用可にする必要がある場合に値を入れる t_menuinfo 構造体デフォルトではすべてのアイテムは有効になっています。後述するこの構造体の記述を参照して下さい。

ウィンドウがアクティブウィンドウになると、Max はウィンドウのメニューを、そのウィンドウが応答できるアイテムに基づいたものに更新します。あなたは、すべて０の値に初期化された Menuinfo 構造体へのポインタを渡されます。もし、ユーザが特定のメニューアイテムを選んだ時にメッセージを送って欲しいときは、Menuinfo構造体の該当のアイテムに１をセットし、そのアイテムが使用可能になるようにします。Menuinfo 構造体は short による整数の配列で、ext_menu.h で宣言されています。次に示すものは、あなたが利用できるメニューコマンドです。

undo

バインディング

宣言

このメッセージを受け取るためには、Undo メニューアイテムを明確に有効にし、テキストをセットしなければなりません。これによって 後述するようなundoitem メッセージに応答することができます。メニューアイテムのテキストをあなた自身でセットして以降、オブジェクトが undoitem メッセージを受け取った場合、それを把握することはあなたの責任になります。あなたがundo または redo を実行しなければならないとしても、これはそれほど難しいことではありません。undoitem メソッドを実装しない場合、あなたのウィンドウがアクティブウィンドウになった時に、Undo メニューアイテムは常に無効になります。

undoitem

バインディング

宣言

pastepic

バインディング

宣言

ピクチャデータは、まだクリップボードにあります。あなたの責任は、そのデータを（Mac OS の GetScrap ルーチンを使って）コピーし、それを使って何かの処理を行なうことです。

saveto

バインディング

宣言

あなたのウィンドウがアクティブウィンドウであるときに、ユーザが File メニューからSave As... を選択した場合、ユーザが標準ファイル保存ダイアログボックスでファイル名とボリュームを指定した後、このメッセージに応答します。この時点ではファイルは開かれもしませんし、作られもしません。あなたはファイルを作り、開き、書き出し、閉じなければなりません。wind_settitle を使ってウィンドウのタイトルを変えたいとも思うかも知れませんが、これは、wind_new に WKEEPT ビットをオンにした引数 flags を渡していない限り、自動的に行なわれます。

　ユーザが File メニューから Save を選んだ場合、Max は既にファイル名とボリュームを知らされていて、あなたの saveto メソッドが呼び出されます。

dialog

バインディング

宣言

dialog メソッドはパッチャーウィンドウ内で、選択されたパッチャーオブジェクトに info メッセージを送るために使われます。既に述べたように、あなたのオブジェクトはinfo メッセージに応答することができますが、これは通常、内部の値をセットしたダイアログボックスを用意することによって行なうことができます。

dialog メッセージはあなたのウィンドウがアクティブウィンドウで、ユーザが Maxメニューから Get Info... を選択した場合に送られます。あなたのメソッドはオブジェクトの info メソッドと同じダイアログを表示することができます。あるいは、あなたのウィンドウが選択可能な項目を持っている場合には、その選択された項目によってダイアログを設定することも可能です。

font

バインディング

宣言

ユーザがウィンドウのデフォルトフォントを変更した場合、または Size メニューを選んでサイズを変更した後に、オブジェクトはこのメッセージを受け取ります。カレントのサイズは、t_wind の w_fontsize フィールドをチェックすることで確認できます。デフォルトのフォントは w_realfont フィールドに保存されています。font メッセージから直接フォントとサイズの情報を取得するためには、メソッドは上のように宣言されなければなりません。fontnum あるいは size のどちらかが -1 の場合、その値はユーザによって変更されていないため、ウィンドウで選択されている、あるいは選択されていないテキストについて、その特徴を変えるべきではありません。

help

バインディング

宣言

あなたの help メソッドはヘルプファイルを開くか、何か他のヘルプとなるような動作によって応答することができます。

find

バインディング

宣言

ウィンドウの中で現在選択されている内容の代わりを指定している Binbuf。replace が 0 ならば、検索を実行するだけです。

このメッセージは、あなたのウィンドウがアクティブでユーザがFind ダイアログの Find をクリックした後、あるいは、Edit メニューから Find Again や Replace from が選択された後に送られます。もし、あなたが何かを「検索する」場合には、おそらく、次のchkmenu メッセージを受け取ったときに、Find Again...アイテムを有効にしておく必要があるでしょう。

search と replace の両方が０以外ならば、最初の置換のときにウィンドウ内で選択されていたものを、もう一度検索します。検索、あるいは置換の内容をテキストに変換したい時は、binbuf_totext を使います。

okclose

バインディング

宣言

このメッセージを実装することにより、オブジェクトは、ウィンドウの w_dirty フィールドが０以外の場合に、このアラートを表示する標準の動作以上のことを行うことができるようになります。例えば、prompt を修正してアラートの文字を変更することができます。また、アラートをスキップするために特定の値をresult に返したり、ウィンドウを（ウィンドウを所有するオブジェクトが開放されない限り）まったく閉じることができないようにしたりすることができます。後にあげた動作は、もしあなた自身のSave Changes アラートを表示したい場合には適切でしょう。

result がとることのできる値は次のようなものです。

print

バインディング

宣言

ユーザが File メニューから Print... を選択し、標準のプリントダイアログが表示されて、OK がクリックされた時に、このメッセージがウィンドウに送られます。ユーザが印刷したいと思うドキュメントのそれぞれのコピーごとに print メッセージを受け取ります。

このメソッドでは、あなたは、ウィンドウを「ドキュメント」として印刷します。エラーが発生すると、result に０以外の値がセットされます。

次のものは、ウィンドウを１ページに印刷するためのいくつかのシンプルなコードの概要です。これは、ウィンドウサイズが用紙サイズより大きくても心配ありません。プリントマネージャの呼び出しはページの印刷の前後に必要である点に注意して下さい。

void myobject_print (myObject *x, THPrint hp, GrafPtr port, short *res) { TPPrPort printPort; Rect printRect; printPort = PrOpenDoc(hp,0L,0L); SetPort(printPort); TextFont(port->txFont); TextSize(port->txSize); printRect = (**hp).prInfo.rPage; PrOpenPage(printPort,0L); /* ここでウィンドウを印刷します */ PrClosePage(printPort); PrCloseDoc(printPort); *res = 0; }

タイプされたコマンドピリオドをチェックするようなコードをを加えた、より良いものにしようと思うかもしれません。このケースでは、ドキュメントの追加のコピーが印刷されないように、result が０以外の値にセットされなければなりません。

wind_new

wind_new は新しい t_wind オブジェクトを返します。可視フラグ WVIS がセットされない場合、Mac OS や Windows 上での実際のウィンドウは作られません。

wind_vis

wind_vis はウィンドウを見えるようにします。既にウィンドウが可視の状態の場合、wind_vis はSelectWindow を呼び出してウィンドウをアクティブウィンドウにします。MacOS ウィンドウを可視にしたい場合は、syswindow_show を使います。

wind_invis

ウィンドウが可視の場合、wind_invis はウィンドウを隠します。ウィンドウが可視でない場合には、wind_invis は何もしません。wind_invis が実際の OS のウィンドウオブジェクトを破棄してしまうことを覚えておいてください。もし、OS による破棄をせずに、ウィンドウを残したまま見えないようにしたい時には、代わりに wind_syswind の戻り値でsyswindow_hide を使って下さい。wind_invis が Wind 構造体によって占められているメモリを実際に開放するわけではないという点にも注意が必要です。wind_invis を使った後、　wind_vis を呼び出すと、Mac OS または Windows XP の別のウィンドウを作ります。

wind_setgrowbounds

wind_defaultscroll

ウィンドウがスクロールバーを持っている場合、click メソッドの中で wind_defaultscroll を使います。これは、pt がスクロールバー内かどうかをチェックします。スクロールバー内の場合、wind_defalutscroll はデフォルトのスクロールバールーチンを実行し、１を返します。そうでない場合、wind_defaultscroll は０を返します。

wind_dirty

wind_dirty はウィンドウの dirty ビットをセットします。これにより、ウィンドウが閉じられる際に、ユーザに対し、変更したデータを保存するかどうかを尋ねます。ユーザが保存したい場合には、あなたのsaveto メソッドが呼び出されます。

wind_drag

wind_drag の使用によって、通常次のような形の典型的なループプログラムを置き換えます。

do { GetMouse(&pt); /* do something here to track the mouse*/ } while (StillDown());

マウスが動くたびに、呼び出したい関数（dragfun）へのポインタを渡します。これによって、dragfun は指定された引数 arg 、マウスの位置、マウスボタンが押されているかどうか、という情報と共に呼び出されます。マウスボタンが上がると、drag 関数はもう一度呼び出されます。drag 関数は次のように宣言する必要があります。

上で述べたように、wind_drag は通常マウスが移動した場合にだけ、あなたのdrag 関数を呼び出します。マウスが移動していなくてもdrag 関数を呼び出したい場合には、wind_dragの前に、wind_nowoorymove を呼び出します。drag ルーチンはマウスボタンが離された時にもう一度呼び出されます（そして、button が０になります）。ドラッグルーチンは、描画がカレントのグラフポートで行なわれたかどうか確認するために、 wind_setport （下記を参照）を使う必要があります。

。

wind_inhscroll

wind_inhscroll は、pt が水平スクロールバー内にあれば true を、そうでなければ false を返します。これは、クリックが水平スクロールバーで行なわれたものか、垂直スクロールバーで行なわれたものかを識別し、それによって wind_defaultscroll に異なった引数 pagesize を渡すために用いられます。

wind_noworrymove

より詳しい情報は、wind_drag の解説を参照して下さい。

wind_setcursor

wind_setcursor はカーソルが以前どのようにセットされていたかを追跡します。そのため、カーソルに何か変化があると、wind_setcursorに以前の引数をセットしようとしても、新しいカーソルを見ることができないでしょう。これの解決法は、希望するカーソル定数で呼び出す前に、wind_setcursor(0) を呼び出しておくことです。カーソルを独自のカーソルにセットすることを、Max に対して直接知らせる場合には、 wind_setcursor(-1) を使います。

wind_setport

カレントのグラフポートをウィンドウに結びつけられたポートにセットする便利な関数です。成功すると、関数から以前のグラフポートへのポインタが返されます。そうでない場合、wind_setport は NIL を返します。ウィンドウでの描画やイベント処理の前に、この関数を呼び出さなければなりません。そして、終了後に関数の戻り値に対して wind_restoreport を呼び出します。次はその例です。

GrafPtr sp; if (sp = wind_setport(myWind)) { /* ここで描画します */ wind_restoreport(sp); }

注：QuickTime SDK for Windows XP を使う場合、この代わりにXQT_wind_setport を使わなければなりません。（後述）

XQT_wind_setport (QuickTime SDK を使用したWindows XPの場合のみ使用)

QuickTime SDK QuickDraw グラフポートをウィンドウに結び付けられたポートにセットするために便利な関数です。成功すると、関数から以前のグラフポートへのポインタが返されます。そうでない場合、 XQT_wind_setport は NIL を返します。ウィンドウでの描画やイベント処理の前に、この関数を呼び出さなければなりません。そして、終了後に関数の戻り値に対して XQT_SetPort を呼び出します。次はその例です。

GrafPtr sp; if (sp = XQT_wind_setport(myWind)) { /* ここで描画します */ XQT_SetPort(sp); }

wind_syswind

返された t_syswind の使い方は、下のSyswindow API セクションを参照して下さい。

wind_gethwnd (Windows XP のみ)

与えられた HWND に結び付けられた Max の t_wind がない場合、関数は　NIL を返します。

wind_installidletask

wind_installidletask はあなたのオブジェクトのウィンドウのために、アイドルタスクをインストールし、タスクへのポインタを返します。タスクは、あなたが提供するメソッドを呼び出します。これは、flags で示されますが、widle 関数か、ウィンドウのcursor関数、または、両方です。ウィンドウのcursor関数内のタスクを呼び出す場合、タスク関数は 引数 Point も受け取ります。あなたは、おそらくオブジェクト生成関数の中でこの関数を呼び出す必要があるでしょう。そして、オブジェクトのインスタンス消滅関数（free 関数）内で wind_removeidletask によってタスクを取り除く必要があるでしょう。

wind_removeidletask

wind_removeidletask は、渡されたタスクを取り除きます。

wind_setsmax

スクロールバーの最小値はいつも０です。この関数はウィンドウが可視の場合でも、不可視の場合でも使うことができます。

wind_setsval

この関数はウィンドウが可視の場合でも、不可視の場合でも使うことができます。

wind_settitle

この関数は、ウィンドウが可視の場合でも、不可視の場合でも使うことができます。

wind_setundo

wind_filename

この関数はウィンドウのタイトルを変更し、それをファイル名とボリューム名として与えます。これは、ユーザがFileメニューから Save を選択した場合、 savetoメッセージへの引数として自動的に渡されます。

wind_setbin

wind_close

通常、この関数の動作はユーザがクローズボックスをクリックするか、File メニューから Close を選択した場合に行われます。wind_closeはまず、ウィンドウのデータが変更されたかどうかをチェックします。変更されていて、ウィンドウの w_scratch フィールドがセットされていない場合、Save Changes ダイアログが表示され、希望する処理が選ばれます。wind_close が -1 を返した場合、ユーザがSave Changes ダイアログ、もしくはファイル保存ダイアログでキャンセルを選択してダイアログを抜け、ウィンドウが閉じられていないことを表します。

wind_close が 0 を返した場合、ウィンドウが閉じられたことを表します。この場合３つの状況が考えられます。１つめは、保存すべきデータが存在しない場合、２つめは、ユーザが変更を保存するよう指定し、正しく保存が行われた場合、３つめは、ユーザが変更を保存しない指定を行った場合です。

オブジェクトのインスタンス消滅関数（free 間数）が呼び出されたとき、オブジェクトのウィンドウ内のデータを保存するかどうかをユーザに尋ねたいとき、この関数と、次に述べる wind_nocancel とを組み合わせて使用する場合もあるでしょう。

wind_nocancel

wind_nocancel は呼び出された直後に表示される“Save changes?”ダイアログにだけ影響を及ぼします。

syswindow_inlist

ウィンドウが、Max のウィンドウリストに存在すれば TRUE を、そうでない場合は FALSE を返します。

syswindow_isvisible

ウィンドウが可視の状態であるかどうかを調べるために、 syswindow_isvisible を使います。

（訳注：原文は“Use syswindow_isvisible to find if a window is in the Maxwindow list.”となっています）

ウィンドウが可視ならば TRUE を、そうでない場合は FALSE を返します。

syswindow_isfloating

ウィンドウがフロートウィンドウかどうかを調べるために、syswindow_isfloating を使います。（訳注：原文は“Use syswindow_isvisible to find if a window is in the Maxwindow list.”となっています）

ウィンドウがフロートウィンドウならば TRUE を、そうでない場合は FALSE を返します。

syswindow_hide

指定されたウィンドウを隠します。

syswindow_show

指定されたウィンドウを表示させます。

syswindow_move

この関数は、与えられたウィンドウを、ピクセル単位で(x,y) 座標で定義されるスクリーン位置に移動させます。front フラグが０以外の場合、ウィンドウは前面に表示されるでしょう。Windows XP では、ウィンドウがフロートウィンドウでない場合はMax アプリケーションの MDI フレームウィンドウクライアント領域を基準とした位置に移動され、フローティングウィンドウの場合はスクリーン座標を基準として移動される点に注意して下さい。

syswindow_size

この関数は与えられたウィンドウを、ピクセル値で与えられた height とwidth にサイズ変更します。update （訳注：原文は front になっています）フラグが０以外の場合、ウィンドウは続けて更新されます。

syswindow_wind

t_syswind ポインタと結びつけられたMax の t_wind オブジェクトへのポインタを返します。