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

Yasu 4.0.0 β - System maintenance app; p...
Yasu was created with System Administrators who service large groups of workstations in mind, Yasu (Yet Another System Utility) was made to do a specific group of maintenance tasks quickly within a... Read more
Skype 7.37.0.178 - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
EtreCheck 3.0.5 - For troubleshooting yo...
EtreCheck is an app that displays the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support Communities to... Read more
Amadeus Pro 2.3.1 - Multitrack sound rec...
Amadeus Pro lets you use your Mac computer for any audio-related task, such as live audio recording, digitizing tapes and records, converting between a variety of sound formats, etc. Thanks to its... Read more
NeoFinder 6.9.3 - Catalog your external...
NeoFinder (formerly CDFinder) rapidly organizes your data, either on external or internal disks, or any other volumes. It catalogs all your data, so you stay in control of your data archive or disk... Read more
WhatsApp 0.2.1880 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
Hazel 4.0.6 - Create rules for organizin...
Hazel is your personal housekeeper, organizing and cleaning folders based on rules you define. Hazel can also manage your trash and uninstall your applications. Organize your files using a familiar... Read more
Apple iBooks Author 2.5 - Create and pub...
Apple iBooks Author helps you create and publish amazing Multi-Touch books for iPad. Now anyone can create stunning iBooks textbooks, cookbooks, history books, picture books, and more for iPad. All... Read more
MYStuff Pro 2.0.26 - $39.99
MYStuff Pro is the most flexible way to create detail-rich inventories for your home or small business. Add items to MYStuff by dragging and dropping existing information, uploading new images, or... Read more
MarsEdit 3.7.8 - Quick and convenient bl...
MarsEdit is a blog editor for OS X that makes editing your blog like writing email, with spell-checking, drafts, multiple windows, and even AppleScript support. It works with with most blog services... Read more

How to get past Vulture Island's tr...
Vulture Island is a colorful and quirky mish-mash of platforming and puzzles. It’s creative and fresh, but sometimes the game can throw a curveball at you, leaving you stuck as to how you should progress. These tips will help you explore smoothly... | Read more »
The new Clash of Kings is just for Weste...
If you’ve played the original Clash of Kings, you’ll probably recognise the city building, alliance forging and strategic battles in Clash of Kings: The West. What sets this version apart is that it’s tailor made for a Western audience and the... | Read more »
Frost - Survival card game (Games)
Frost - Survival card game 1.12.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.12.1 (iTunes) Description: *Warning: the game will work on iPhone 5C and above and iPad Pro / 4. Other devices are not supported* | Read more »
How to build and care for your team in D...
Before you hit the trail and become a dog sledding legend, there’s actually a fair bit of prep work to be done. In Dog Sled Saga, you’re not only racing, you’re also building and caring for a team of furry friends. There’s a lot to consider—... | Read more »
How to win every race in Dog Sled Saga
If I had to guess, I’d say Dog Sled Saga is the most adorable racing game on the App Store right now. It’s a dog sled racing sim full of adorable, loyal puppies. Just look at those fluffy little tails wagging. Behind that cute, pixelated facade is... | Read more »
Let the war games commence in Gunship Ba...
Buzz Lightyear famously said, “This isn’t flying, this is falling – with style!” In the case of Gunship Battle: Second War, though, this really is flying - with style! The flight simulator app from Joycity puts you in control of 20 faithfully... | Read more »
How to get a high score in Fired Up
Fired Up is Noodlecake Games’ high score chasing, firefighting adventure. You take control of a wayward firefighter who propels himself up the side of a highrise with blasts of water. Sound silly? It is. It’s also pretty difficult. You can’t... | Read more »
NBA 2K17 (Games)
NBA 2K17 1.0 Device: iOS iPhone Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: Following the record-breaking launch of NBA 2K16, the NBA 2K franchise continues to stake its claim as the most authentic sports video... | Read more »
Dog Sled Saga (Games)
Dog Sled Saga 1.0.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.1 (iTunes) Description: A game by Dan + Lisa As a rookie musher, foster a dogsledding team whose skills will grow if they're treated right. Week by... | Read more »
60 Seconds! Atomic Adventure (Games)
60 Seconds! Atomic Adventure 1.2 Device: iOS Universal Category: Games Price: $2.99, Version: 1.2 (iTunes) Description: 60 Seconds! is a dark comedy atomic adventure of scavenge and survival. Collect supplies and rescue your family... | Read more »

Price Scanner via MacPrices.net

21-inch iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ iMacs on sale for up to $120 off MSRP including free shipping plus NY sales tax only: - 21″ 3.1GHz iMac 4K: $1379 $120 off MSRP - 21″ 2.8GHz iMac: $1199.99 $100 off MSRP - 21″ 1... Read more
13-inch 2.7GHz/256GB Retina MacBook Pro on sa...
Amazon.com has the 13″ 2.7GHz/256GB Retina Apple MacBook Pro on sale for $151 off MSRP including free shipping: - 13″ 2.7GHz/256GB Retina MacBook Pro (sku MF840LL/A): $1348 $151 off MSRP Read more
Apple TVs on sale for up to $50 off MSRP
Best Buy has 32GB and 64GB Apple TVs on sale for $40-$50 off MSRP on their online store. Choose free shipping or free local store pickup (if available). Sale prices for online orders only, in-store... Read more
Apple refurbished 13-inch Retina MacBook Pros...
Apple has Certified Refurbished 13″ Retina MacBook Pros available for up to $270 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 13″ 2.7GHz... Read more
Duplicate Sweeper Free On Mac App Store For O...
To celebrate the launch of Apple’s latest macOS Sierra, Stafford, United Kingdom based Wide Angle Software has announced that its duplicate file finder software, Duplicate Sweeper, is now available... Read more
13-inch Retina MacBook Pros on sale for up to...
B&H Photo has 13″ Retina Apple MacBook Pros on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1174.99 $125 off MSRP - 13... Read more
Evidence Surfaces Pointing To New A10X Chip F...
Citing a job description for a Project Lead position at Apple’s Austin, Texas engineering labs, Motley Fool’s Ashraf Eassa deduces that development is progressing well on Apple’s next-generation in-... Read more
Check Print’R for macOS Allows Anyone to Easi...
Delaware-based Match Software has announced the release and immediate availability of Check Print’R 3.21, an important update to their easy-to-use check printing application for macOS. Check Print’R... Read more
Apple refurbished 11-inch MacBook Airs availa...
Apple has Certified Refurbished 11″ MacBook Airs (the latest models), available for up to $170 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is... Read more
Apple refurbished 15-inch Retina MacBook Pros...
Apple has Certified Refurbished 2015 15″ Retina MacBook Pros available for up to $380 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 15″ 2... Read more

Jobs Board

Sr. *Apple* Mac Engineer - Net2Source Inc....
…staffing, training and technology. We have following position open with our client. Sr. Apple Mac Engineer6+ Months CTH Start date : 19th Sept Travelling Job If Read more
*Apple* Retail - Multiple Positions-Norfolk,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
Lead *Apple* Solutions Consultant - Apple (...
# Lead Apple Solutions Consultant Job Number: 51829230 Detroit, Michigan, United States Posted: Sep. 19, 2016 Weekly Hours: 40.00 **Job Summary** The Lead ASC is an Read more
US- *Apple* Store Leader Program - Apple (Un...
…Summary Learn and grow as you explore the art of leadership at the Apple Store. You'll master our retail business inside and out through training, hands-on Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.