Question on widgets for classic mac os

rlawson

6502
So I'm doing the ThinkC study group over at tinkerdifferent (Mac C Programming primer is the book). it's a load of fun.
But I have a question. The basic widgets that come out of the box seem very limited (menus, buttons, text boxes).

What did mac devs back in the day use for things like - displaying sortable tables, progress bars, custom widgets.
I'm imagining there is a piece I am missing. Right now all our examples are of the flavor - draw some text or graphics on the main window and maybe pop up a dialog with some widgets on it.
 
In the Mac C Programming Primer era, you mostly are on my own my friend!

For sortable tables, you can use the List Manager, but everything beyond basic display and scrolling of the table contents (including any sortability implementation) is on you.

For custom controls, the standard approach would have been to write your own CDEF (control definition function resource). See the Control Manager chapter of Inside Macintosh Volume I. This is a nontrivial exercise though.

For progress bars, one would probably just use QuickDraw to draw and update the thing on the screen, or implement a custom draw procedure for a dialog box userItem. See the section on ”user items” in the Dialog Manager chapter of Inside Macintosh Volume I (the upshot is, you use SetDItem and replace the handle argument to that trap with a pointer to a procedure you want to draw the item whenever appropriate).

Some of these types of widgets may have been supported by either MacApp or the THINK Class Library, the two primary development frameworks that emerged by the early ‘90s, but I didn’t use either much myself and don’t think that’s the direction you want to go anyway.
 
Ok thanks! And as far as placing controls on the main window - I would make toolbox calls (like to ListManager)?
I have been using ResEdit to design Dialogs which is slightly visual basic like. But I don't suppose that similar thing exists for the main window?
 
Ok thanks! And as far as placing controls on the main window - I would make toolbox calls (like to ListManager)?
I have been using ResEdit to design Dialogs which is slightly visual basic like. But I don't suppose that similar thing exists for the main window?
ResEdit does windows as well as dialog boxes.

1687527969502.png
 
Right - but I didn't see a way to place controls graphically on it like the DITL editor on dialogs
You're testing my memory... was... it done the same way as with a dialog box, effectively loading a dialog style layout into the window?

Sorry, I'd forgotten it wasn't obvious. Crutch will do a much better job at answering than me.
 
You can just make it a dialog box. The DLOG resource editor lets you use any window definition proc you want, including one that looks like a standard document window. You can go ahead and use that and drop controls wherever you like.

Basically, think of a DLOG resource as just a way to combine (any type of) window with a list of things you want to be prepopulated in the window on load (stored in the corresponding DITL resource). It doesn’t have to represent a “dialog box” really.

Just keep in mind that your “window” is now really a dialog box — you would display it using GetNewDialog, etc. You could then (if you want) use IsDialogEvent and DialogSelect for event handling and just treat it as if it were a modeless dialog box (which is really what it is) — or, you could handle events yourself and use FindControl, TrackControl etc. on a mouseDown exactly as if you’d added the controls yourself with NewControl.

Just remember to draw the dialog items with DrawDialog, and that if it’s a resizable window with scroll bars, you have to move and resize the scroll bars yourself anytime the window size changes.
 
ahh ok I see. I couldn't get my mind past the dialog being something that shows up when you need confirmation from the user.
But just make it the whole window. Got it - thanks!
 
So I'm doing the ThinkC study group over at tinkerdifferent (Mac C Programming primer is the book). it's a load of fun.
But I have a question. The basic widgets that come out of the box seem very limited (menus, buttons, text boxes).

What did mac devs back in the day use for things like - displaying sortable tables, progress bars, custom widgets.
I'm imagining there is a piece I am missing. Right now all our examples are of the flavor - draw some text or graphics on the main window and maybe pop up a dialog with some widgets on it.
Interesting. Please do tell more about the study group if you don’t mind sharing!
 
Yeah it's a hoot. Each week you do a chapter and there is a forum thread for each week. That allows people to drop in and start whenever and you just post screenshots/questions/code to the thread corresponding to the chapter you are on. Others that have already done it answer questions/encourage. It's fun. I develop in Java/Python professionally atho I did C for a few years 20ish years ago so it's fun for me to go back to basics.

 
(Right here on 68Kmla is also a great place to get your vintage macOS dev questions answered, of course!)
 
Yeah it's a hoot. Each week you do a chapter and there is a forum thread for each week. That allows people to drop in and start whenever and you just post screenshots/questions/code to the thread corresponding to the chapter you are on. Others that have already done it answer questions/encourage. It's fun. I develop in Java/Python professionally atho I did C for a few years 20ish years ago so it's fun for me to go back to basics.

Thank you! This is wonderful!
 
For custom controls, the standard approach would have been to write your own CDEF (control definition function resource). See the Control Manager chapter of Inside Macintosh Volume I. This is a nontrivial exercise though.

For progress bars, one would probably just use QuickDraw to draw and update the thing on the screen, or implement a custom draw procedure for a dialog box userItem. See the section on ”user items” in the Dialog Manager chapter of Inside Macintosh Volume I (the upshot is, you use SetDItem and replace the handle argument to that trap with a pointer to a procedure you want to draw the item whenever appropriate).

Some of these types of widgets may have been supported by either MacApp or the THINK Class Library, the two primary development frameworks that emerged by the early ‘90s, but I didn’t use either much myself and don’t think that’s the direction you want to go anyway.
Nice thread exactly on point in what I find myself needing today.

I'm working on an app called FireJam that lets you use these inputs:

* Typing keyboard
* MIDI in (possible thanks to a great quality help I got from here in 2024)
* Mouse click and hold

Leading to these outputs:
* MIDI out
* All 3 variants of the Sound Driver
* Hopefully a real time mix of the freeform buffer with polyphony

My current wish is to reverse highlight the note graphics as they are interacted with and i thought I'd make a Code Resource of a note shape in a rectangle. I read and tried to dig in these materials:

* Original Inside Macintosh vol 1
* Later inside macintosh : control manager
* Think C primer vol 1 and 2
* Ultimate Mac Programming

None carry you all the way with all the steps needed in both ResEdit and Symantec C++ 6.0 which I'm using.

I know I have to:
* Set the project type to code resource
* Set the signature type to either CODE or CDEF
* Set the main function as pascal long main
* Deal with a switch with a short variable to deal with all cases associated with controls
* Add the built resource to my main project's resource fork either as a CDEF directly or a CODE
* Use a ControlHandle with a procID of 16*CDEF_id + variantNb

After all is said and done, I should have 7 rectangles representing my crude octave (white notes only for now) but all I get is a large rounded rectangle surrounding the area I wanted my first test in, as if it reverted to a single normal button.

Questions:
1) must I build a CODE and then resedit-make a CDEV with 0000 0080 (to link it to is 128) or do I build a CDEV directly?

2) should I have used empty text labels with programmed click behavior and bypassed all this mess instead to get my rectangular shapes? And call a FrameRect on their updating?
 
If I bypass custom controls completely and do my own mouseDown and mouseUp event detection, and mathematically figure out what rectangle to invert based on the MIDI note value, I can sorta do what I want with InvertRect.

I just tested it on real hardware and so far, the amount of logical tests isn't enough to make it noticeably slow. It's still very snappy indeed.
It would be a pain to do the whole white note around the black ones, which was the whole point in the beginning to do these as custom CDEF and let the Control Manager deal with all that. I'm still very interested to learn how to do it.1773603916868.png
 
1)
CODE resources are completely different than other types of code resources such as DRVR, CDEF, WDEF, etc.

CODE resources are segments of an application. You split an application into segments to improve memory utilization. i.e. A code segment is not loaded unless code in that segment is to be executed. A code segment can be unloaded by code in another segment when that code segment is no longer needed. Segments are either defined by compiler directives inserted into a source file, or by defining the segments in the project and dividing source files between the segments.
https://developer.apple.com/library/archive/documentation/mac/pdf/Processes/Segment_Manager.pdf

Does Symantec C++ have DRVR, CDEF, WDEF examples?

Generally, a code resource DRVR, CDEF, WDEF, etc is a separate target of a project. The target is a resource. The resource is then made a dependency of the application target so that it will get inserted into the resource fork of the application.

2)
Depends. How much work does the Control Manager do for you?
Drawing controls is not as simple as a single draw. You need a device loop to handle drawing to multiple screens of different pixel depths (if you wanted to support Color QuickDraw).

It would be a pain to do the whole white note around the black ones
White keys of the keyboard are composed of one or two rectangles. Or you can make a region. The region is composed of one or two rectangles so they won't be too large in memory.

It looks like the left edge of your invert rectangle is two pixels too far to the left. Or three pixels if you want the inverting rectangle to be surrounded by white pixels.
The bottom edge is one pixel too far to the bottom. Or two pixels if you want the inverting rectangle to be surrounded by white pixels.

I just tested it on real hardware and so far, the amount of logical tests isn't enough to make it noticeably slow. It's still very snappy indeed.
I think the number of tests needed is one to four, since the keys are mostly equal width.

Divide the mouse horizontal position by the width of the white keys to get the white key index. I suppose the black line dividing white keys should correspond to the white key to the right of the line.

The mouse vertical position determines if you need to test the modulus of the division to determine if a black key is pressed. If the width of a key is 8 then a mod < 3 should test for a black key on the left and a mod > 5 should test for a black key on the right. A mod value in between represents the white key.

For each white key, you should have a bit that states if the right side of the white key has a black key. For the left side of the white key, you would check the value for the white key to the left.

It appears that the position of the black key on the right side of a white key is variable (by one pixel?). An extra bit is required for that info. This extra bit is added to the mod check described above.
 
Back
Top