Path: utzoo!utgpu!jarvis.csri.toronto.edu!rutgers!usc!wuarchive!decwrl!ucbvax!dewey.soe.berkeley.edu!oster
From: oster@dewey.soe.berkeley.edu (David Phillip Oster)
Newsgroups: comp.sys.mac.programmer
Subject: Re: ModalDialog filterprocs
Message-ID: <33385@ucbvax.BERKELEY.EDU>
Date: 27 Dec 89 10:47:53 GMT
References: <10125@saturn.ucsc.edu>
Sender: usenet@ucbvax.BERKELEY.EDU
Reply-To: oster@dewey.soe.berkeley.edu.UUCP (David Phillip Oster)
Organization: School of Education, UC-Berkeley
Lines: 64

In article <10125@saturn.ucsc.edu> sirkm@ssyx.ucsc.edu (Greg Anderson) writes:
>I wrote a filterproc for ModalDialog that allows the user to cut, copy
>and paste to fields in a modal dialog box by pressing command-c, command-x
>and command-v, respectively.  The filterproc works great--cutting and
>pasting work as expected.  However, if the user presses <Return>,
>ModalDialog no longer returns with itemHit = 1.

>pascal int cutPasteFilter( DialogPtr dlog, EventRecord *theEvent, int *itemHit )
        ^^^
Should be:
pascal Boolean cutPasteFilter( ...

remember, in pascal a Boolean and an "int" are not the same, or even
compatible. A pascal Boolean TRUE looks like 0x01?? as an integer on the
stack.

In addition, your filterProc should also:
1.) handle <Command>-. or <Escape> as synonyms for Cancel.
2.) handle <Clear> as a synonym for clear (from the edit menu.)
3.) handle the <undo> <cut> <copy> & <paste> keys on the extended keyboard.
4.) handle <Shift>Tab to tab backwards  through the fields.
5.) On synonyms for Edit commands, flash the word "Edit" on the menu bar.
6.) On synonyms for buttons, flash the button for a fraction of a second
	before disposing the dialog.
7.) handle <Command>-Z as a synonym for undo.
8.) support undo of the Edit commands, and of typing.
9.) if the dialog includes any scrollbars, then the <home> <end> <page up>
and <page down> keys one the extended keyboard apply to the scrollbar. If
there are more than one scrollbar, they apply to the one with data that
was most recently acted upon.
10.)  <Option>-<UpArrow> is a synonym for <Page Up>, <Option>-<Down
Arrow> is a synonym for page down. <Command>-<UpArrow> is a synonym for
<home> and <Command>-<DownArrow> is a synonym for <end>.
11.) Scrollbars are governed in a processor-speed-independent manner, so
they won't scroll too fast on fast machines.

At least, that is what _my_ filterProcs do. For an example, see my program
"Address Book Plus", from Power-Up! software of San Mateo, CA.

I am currently adding:
12.) Handle the <help> button, on the extended keyboard to bring up help
about this dialog.
13.) Handle <Command>-?  or <Command>-/  (on the same key in the U.S.)
as synonyms for the <help> button.

There is some justification for all of the above points in the user
interface guidlines. Have I left anything reasonable out?

Do you think we should have:
a.) smart quotes? (i.e., replace  "'" and '"' by the appropriate opening
and closing left and right quote marks.)

b.) smart cut & paste? (i.e., when you cut text, it remembers whether the
text ended or began on a word boundary, and deletes extra white space if
so. When you paste, if deletes or inserts white space as necessary.) (This
is documented in the User Interface Guidelines. Few programs bother with
it.)

c.) transform <Capital-Oh> to <Zero> and <Small-El> to <One> in numeric
only fields?

--- David Phillip Oster            --  No, I come from Boston. I just work
Arpa: oster@dewey.soe.berkeley.edu --  in cyberspace.
Uucp: {uwvax,decvax}!ucbvax!oster%dewey.soe.berkeley.edu