TweetFollow Us on Twitter

ResEdit
Volume Number:3
Issue Number:5
Column Tag:Basic School

Windows with ResEdit

By Dave Kelly, MacTutor Editorial Board

Windows are a fundamental of the Macintosh user interface. Back in March of 1985, Vol. 1 No. 4 of MacTutor (for those of you who were around back then) or starting on page 307 in The Best of MacTutor, Vol 1, I cover the basics of creating windows with MS Basic. I refer you back to this reference for details. (You can get Best of MacTutor, Vol 1, through MacTutor for $24.95). Sorry to say, the new version of MS Basic and the MS Basic Compiler has only a small improvement to windows. MS Basic now allows six windows open at once instead of four. ZBasic has added window capabilities such as additional window types available including the ability to specify Zoom windows, go-away box, grow box, and rounded cornered windows. We can only hope that the next version of MS Basic will be more comprehensive. Notwithstanding this there are a few things that can be mentioned relating to windows.

If you recall, a few months back, during our Basic Wars review, PCMacBasic was the only Basic to allow you to use resources to program your application windows. This is still true, however I have come across a method which allows MS Basic to use window resources as a guide for the window that will be used in Basic. This method is very simple and only requires three calls from the ToolLib library. It does not extend the window creation capabilities, however. Languages which fully support the toolbox will usually allow you to create a window using the WIND (window resource) ID number.

Now you can create your own window resources using ResEdit and Basic will read the resource and create a window looking like the one described by the resource. Well, usually. There are still those types of windows that Basic doesn't support such as the ones with rounded corners of different curvatures. ZBasic does support these other types and a similar method could be used to read the WIND resources from ZBasic.

For now I'll explain what to do to implement this method. You might also get some ideas of other resources you could read and apply the same idea to.

First off, in case you don't know how ResEdit can be used to create your own windows I will briefly explain by walking you though an example. Open up ResEdit and choose 'NEW' from the File menu. I chose to use a separate resource file (named 'Window.rsc') for this example just to be safe. You could use any file to store your resource in just like the library CODE resources. Next (with the new file open) open up a new resource by selecting 'NEW' from the File menu. Create a resource of type 'WIND' by selecting or typing the proper type when asked.

At this point ResEdit gives you a default window which can be sized and placed where ever you want it. The move the window drag it near the title bar just like you would move a window when using the Finder. To resize the window you drag the lower right corner of the window to the size you want.

Now select Get Info from the File menu to adjust the window ID# if necessary. Usually you are safe to just use the number that ResEdit assigns the WIND resource. In this example I used 3041 through 3044 for the four windows that I created. You will have to create your own resources to use the example program. Be sure to use the same ID numbers in the program that you use as your resource ID.

There are two ways to view WIND resources with ResEdit. The first is graphically which is the mode you get when you first open a WIND resource. The second way is to display the WIND resource parameters as text. If you want different window types you can select Display text to show the actual window resource parameters.

The ProcID is the parameter which indicates the window type. The ProcID numbers are shown in Inside Macintosh as:

CONST documentProc = 0;
 dBoxProc = 1;
 plainDBox = 2;
 altDBoxProc = 3;
 noGrowDocProc = 4;
 rDocProc = 16;

Since not all of these are supported by MS Basic the example program will ignore those that it doesn't understand and use the default document window. You could probably try this same method using ZBasic and be able to implement all of the features. Another way to view the resource would be to open it up as General instead of using OPEN in the File menu. Using this we can see how the WIND is organized.

From this HEX representation of the WIND resource and Inside Macintosh (pg. I-302) we see:

$00 2E, the first two bytes represent the top of the window where HEX $00 2E = 46 decimal.

$00 0A, the 3rd and 4th bytes represent the left of the window where HEX $00 0A = 10 decimal.

$00 AC, the 5th and 6th bytes represent the bottom of the window where HEX $00 AC = 170 decimal.

$01 4E, the 7th and 8th bytes represent the right side of the window where HEX $01 4E = 202 decimal.

$00 00, the 9th and 10th bytes represent the ProcID parameter.

$01 00, the 11th and 12th bytes represent the visible parameter.

$01 00, the 13th and 14th bytes represent the goAwayFlag parameter.

$00 00 00 00, the 15th through 18th bytes is the refCon parameter.

$08, the 16th byte represents the length of the window title (the next 8 bytes) where $57 69 6E 64 6F 77 20 31 is 'Window 1' when converted via ASCII codes.

The only thing left to finish the new resources now is to close the resource file and quit ResEdit. The example Basic listing below will read the resource file and store it in and array where the information can be used to create a window that looks the same as the one created in ResEdit using the standard MS Basic window command. This is accomplished with the aid of three ToolLib calls. The first is OpenResFile, used to open the desired resource file. The last is CloseResFile, used to close the resource file. The trick comes in using LoadArray to read in data from an open resource and place it in a pre-dimensioned array. Since the data that is read is not in the same format that Basic expects for variables, it is necessary to read each by and decode or convert the data to MS Basic variables which we can use in the Window statement. The subroutine GetResWindow demonstrates which byte to peek to get the desired results. The variable pointer must be explicitly defined in each of the peek statements or the data may not come back correctly. You may only need to read back the parts that will be used in your program.

An optional way of doing this would be to manually write down what the window size and type etc. after creating the window with ResEdit (then you wouldn't need to actually save the window resources) and then use these numbers to create your new window. This would make the Basic code shorter, but might not be quite as accessible to modification after it is compiled (provided you intend to compile your application).

As mentioned last month, there are still some serious problems with HFS and MS Basic. Until this is fixed, the use of resources is somewhat restricted. Since a compiled MS Basic application does not have an automatic way (a way in which the user doesn't have to be aware of what is going on) to find the volume which itself is located, we will have to live with the problem until Microsoft releases an improved version. (Sooner the better).

'WIND Resource Demo ©MacTutor™ 1987 By Dave Kelly

Libname$="Hard Disk:Basic:MS ToolLib:ToolLib"  'full path name
LIBRARY Libname$
WINDResname$="Hard Disk:MacTutor™:May87:Window.rsc"
WIDTH 40
DIM a(40)
FOR i=1 TO 4
ID%=3040+i
CALL GetResWindow(WINDResname$,ID%,top,left,bottom, right,     ProcID, 
TitleLength, Title$)
type=1
IF ProcID= 0 THEN type=1
IF ProcID=1 THEN type=2
IF ProcID=2 THEN type=3
IF ProcID=3 THEN type=4
WINDOW i,Title$,(left,top)-(right,bottom),type
PRINT "Top= ";top,"Left= ";left,"Bottom= ";bottom,"Right=      
 ";right
PRINT "ProcID = ";ProcID
PRINT "TitleLength = ";TitleLength
PRINT "Title = ";Title$
PRINT "Click mouse to continue"
WHILE MOUSE(0)<>1:WEND
NEXT i
END
SUB GetResWindow (WINDResname$,ID%, top,left,bottom,right,     ProcID, 
TitleLength, Title$) STATIC
ref%=0
type$="WIND"
openresfile WINDResname$,ref%
loadArray ref%,ID%,a(1),type$
top=PEEK(VARPTR(a(1)))*256+PEEK(VARPTR(a(1))+1)
left=PEEK(VARPTR(a(1))+2)*256+PEEK(VARPTR(a(1))+3)
bottom=PEEK(VARPTR(a(1))+4)*256+PEEK(VARPTR(a(1))+5)
right=PEEK(VARPTR(a(1))+6)*256+PEEK(VARPTR(a(1))+7)
ProcID=PEEK(VARPTR(a(1))+8)*256+PEEK(VARPTR(a(1))+9)
TitleLength=PEEK(VARPTR(a(1))+18)
closeResFile ref%
Title$=""
FOR i=1 TO TitleLength
    Title$=Title$+CHR$(PEEK(VARPTR(a(1))+i+18))
NEXT
END SUB

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Quicken 4.4.3 - Complete personal financ...
Quicken makes managing your money easier than ever. Whether paying bills, upgrading from Windows, enjoying more reliable downloads, or getting expert product help, Quicken's new and improved features... Read more
Apple Safari 10.0.3 - Apple's Web b...
Note: The direct download link is currently unavailable. It is available in the OS X 10.11.6 release, as well as in the Apple Security Updates. Apple Safari is Apple's web browser that comes with OS... Read more
Apple iTunes 12.5.5 - Play Apple Music a...
Apple iTunes lets you organize and stream Apple Music, download and watch video and listen to Podcasts. It can automatically download new music, app, and book purchases across all your devices and... Read more
Apple macOS Sierra 10.12.3 - The latest...
With Apple macOS Sierra, Siri makes its debut on Mac, with new features designed just for the desktop. Your Mac works with iCloud and your Apple devices in smart new ways, and intelligent... Read more
Lyn 1.8.5 - Lightweight image browser an...
Lyn is a fast, lightweight image browser and viewer designed for photographers, graphic artists, and Web designers. Featuring an extremely versatile and aesthetically pleasing interface, it delivers... Read more
iClock Pro 3.4.7 - Customize your menuba...
iClock Pro is a menu bar replacement clock for Apple's default clock. iClock Pro is an update, total rewrite and improvement to the popular iClock. Have the day, date and time in different fonts and... Read more
Opera 42.0.2393.137 - High-performance W...
Opera is a fast and secure browser trusted by millions of users. With the intuitive interface, Speed Dial and visual bookmarks for organizing favorite sites, news feature with fresh, relevant content... Read more
Apple Security Update 2016-003 Supplemen...
Apple Security Update is recommended for all users and improves the security of OS X. For detailed information about the security content of this update, please visit: http://support.apple.com/kb/... Read more
Apple iOS 10.2.1 - The latest version of...
iOS 10 is the biggest release of iOS ever. A massive update to Messages brings the power of the App Store to your conversations and makes messaging more personal than ever. Find your route with... Read more
BetterTouchTool 1.992 - Customize Multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more

Clash Royale gets some serious balance u...
| Read more »
Ironhide Game Studio prepares for a busy...
Kingdom Rush breathed fresh life into the tired tower defense genre way back in 2012. The game was a robust challenge that somehow managed to lift you up, rather than leaving you feeling crushed and hopeless. The rich array of unit types and... | Read more »
Collect pets and sling arrows in Arcane...
Mobile gaming is a crowded market, but regular updates are a good way to keep us attention-short players keen. The brand new content in Arcane Online is a prime example. Published by Japanese developer Gala, Arcane Online is a fantasy MMO that... | Read more »
Super Mario Run dashes onto Android in M...
Super Mario Run was one of the biggest mobile launches in 2016 before it was met with a lukewarm response by many. While the game itself plays a treat, it's pretty hard to swallow the steep price for the full game. With that said, Android users... | Read more »
WarFriends Beginner's Guide: How to...
Chillingo's new game, WarFriends, is finally available world wide, and so far it's a refreshing change from common mobile game trends. The game's a mix of tower defense, third person shooter, and collectible card game. There's a lot to unpack here... | Read more »
Super Gridland (Entertainment)
Super Gridland 1.0 Device: iOS Universal Category: Entertainment Price: $1.99, Version: 1.0 (iTunes) Description: Match. Build. Survive. "exquisitely tuned" - Rock Paper Shotgun No in-app purches, and no ads! | Read more »
Red's Kingdom (Games)
Red's Kingdom 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Mad King Mac has kidnapped your father and stolen your golden nut! Solve puzzles and battle goons as you explore and battle your... | Read more »
Turbo League Guide: How to tame the cont...
| Read more »
Fire Emblem: Heroes coming to Google Pla...
Nintendo gave us our first look at Fire Emblem: Heroes, the upcoming mobile Fire Emblem game the company hinted at last year. Revealed at the Fire Emblem Direct event held today, the game will condense the series' tactical RPG combat into bite-... | Read more »
ReSlice (Music)
ReSlice 1.0 Device: iOS Universal Category: Music Price: $9.99, Version: 1.0 (iTunes) Description: Audio Slice Machine Slice your audio samples with ReSlice and create flexible musical atoms which can be triggered by MIDI notes or... | Read more »

Price Scanner via MacPrices.net

Deal alert! 13-inch 2.0GHz MacBook Pros for $...
B&H Photo has the new 2016 13″ 2.0GHz non-Touch Bar MacBook Pros in stock today and on sale for $225 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.0GHz MacBook Pro... Read more
Free LibreOffice Portable 5.2.4 Complete Offi...
PortableApps.com and The Document Foundation have announce the release of LibreOffice Portable 5.2.4. LibreOffice Portable is an Open Source full-featured office suite — including a word processor,... Read more
Apple Planning Three New Tablets For 2017 – D...
Digitimes’ Rebecca Kuo and Joseph Tsai say that unnamed insider sources report Apple having three new tablets in the pipeline for 2017 release: a 9.7-inch model with a friendly price range, a new mid... Read more
Roundup of 15-inch Touch Bar MacBook Pro sale...
B&H Photo has the new 2016 15″ Apple Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.7GHz Touch Bar... Read more
Apple refurbished iPad Pros available for up...
Apple has Certified Refurbished 9″ and 12″ Apple iPad Pros available for up to $160 off the cost of new iPads. An Apple one-year warranty is included with each model, and shipping is free: - 32GB 9″... Read more
16GB iPad Air 2, Apple refurbished, available...
Apple has Certified Refurbished 16GB iPad Air 2s available for $319 including free shipping. A standard Apple one-year is included. Their price is $60 off original MSRP for this model. Read more
Apple iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ and 27″ Apple iMacs on sale for up to $120 off MSRP, each including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2199 $100 off MSRP - 27″ 3.2GHz/1TB Fusion iMac... Read more
Apple refurbished Apple TVs available for up...
Apple has Certified Refurbished 32GB and 64GB Apple TVs available for up to $30 off the cost of new models. Apple’s standard one-year warranty is included with each model, and shipping is free: -... Read more
Save up to $350 with Apple Certified Refurbis...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more
2015 12-inch Retina MacBooks, Apple refurbish...
Apple has Certified Refurbished 2015 12″ Retina MacBooks available for up to $410 off original MSRP. Apple will include a standard one-year warranty with each MacBook, and shipping is free. The... Read more

Jobs Board

*Apple* & PC Desktop Support Technician...
Apple & PC Desktop Support Technician job in Manhattan, NY Introduction: We have immediate job openings for several Desktop Support Technicians with one of our most Read more
*Apple* & PC Desktop Support Technician...
Apple & PC Desktop Support Technician job in Stamford, CT We have immediate job openings for several Desktop Support Technicians with one of our most well-known Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Site Security Manager - Apple (Unite...
# Apple Site Security Manager Job Number: 54692472 Culver City, California, United States Posted: Jan. 19, 2017 Weekly Hours: 40.00 **Job Summary** The Apple Read more
*Apple* macOS Systems Integration Administra...
…most exceptional support available in the industry. SCI is seeking an Junior Apple macOS systems integration administrator that will be responsible for providing Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.