TweetFollow Us on Twitter

Selective Color
Volume Number:10
Issue Number:1
Column Tag:C Workshop

Related Info: Dialog Manager

Selective Color

Using custom color buttons on color and black and white Macs

By Mark W. Batten, Washington, D.C.

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Custom color buttons enliven any application, but if the programmer is writing software that must run on both black-and-white and color machines (as most of us are), it may seem daunting to write code that will draw the button different ways on differently configured machines. This article demonstrates a simple scheme to create buttons that are smart enough to be custom-drawn on color machines, and as regular Toolbox buttons on black-and-white machines.

The key to the technique is the Toolbox routine SetDItem. Although generally used only to change a dialog item’s rectangle, SetDItem is actually quite powerful; it lets you change just about everything associated with a dialog item. In this example, we’ll use it to point the Mac to our own CDEF to draw the button on color machines.

Setting Up The Resources

First, you need to create the CDEF that draws the color button. At the end of this article is source code for a sample button with a nice 3-D appearance.

(This particular CDEF uses an “auxiliary control record” (as described in Inside Macintosh, Vol. 5, pp. 216-18) to tell it what colors to draw the control in. If you’ve never encountered these arcane things, don’t worry; you don’t need to understand them to implement the scheme described in the article).

Second, create a dialog (DLOG) and a dialog item list (DITL) for your application as you normally would. Be sure that your DLOG will not be displayed when it’s loaded (in ResEdit, be sure the “Initially visible” box is unchecked). The DITL should use normal, vanilla buttons for OK and Cancel. That way, the resource is all set up to run normally on black-and-white machine, without any more work.

For this example, you also need to create two other resources: a dialog color table (‘dctb’) and a control color table (‘cctb’). (The correct values for the sample are listed at the end of this article). The ‘dctb’ serves two functions here: first, when you call GetNewDialog to read in a dialog, the Mac will automatically make it a color dialog, based on a CGrafPort, if the Mac finds a ‘dctb’ with the same ID as the DLOG resource. Second, the ‘dctb’ colors the content area of the dialog, which makes our button look better. The CDEF uses the ‘cctb’ resource to determine what colors to use when drawing the custom button.

Making The Switch

On a black-and-white Mac, the dialog will perform as it’s supposed to, without any special code in your application. To do something fancier on color machines, your application just has to alert the Dialog Manager to use our custom CDEF instead of the standard one. Here are the necessary steps.

1. In your application’s initialization routines, load the CDEF resource and the cctb color table into variables, like this:


/* 1 */

 Handle myCDEF;  /* handle to our custom CDEF */
 CTabHandle CtrlCTab;/* handle to colors for our control */

 myCDEF=GetResource('CDEF',32); 
 CtrlCTab=(CTabHandle)GetResource('cctb',128);

2. When you’re ready to create the dialog, load it with GetNewDialog (or build it from scratch with NewDialog). Then call the following routine, which uses SetDItem to tell the Mac where to find our custom code. Pass the DialogPtr in d and the item number of the button you want to convert in i:

/* 2 */

ConvertToColorButtons(d,i)
DialogPtr d;
int i; 
{
 int j; 
 Handle tItem; 
 Rect box; 
 char n[31];

 GetDItem(d,i,&j,&tItem,&box);
 if(j==ctrlItem+btnCtrl || 
 j==ctrlItem+btnCtrl+itemDisable){
 SetCtlColor(tItem,CtrlCTab);
 (**((ControlHandle)tItem)).contrlDefProc=myCDEF;
 j&=127;
 SetDItem(d,i,j,tItem,&box); 
 }
}
 Here's the CDEF code.

pascal long main(var,CH,msg,par)
int msg,var;
ControlHandle CH;
long par;
{
 long l;

 l=0L;
 switch(msg){
 case 0: 
 doDraw(CH); 
 break;
 case 1: 
 l=(long)doTest(par,CH); 
 break;
 case 2: 
 doCalc(par,CH); 
 break;
 }
 return l;
}

doTest(par,CH)
long par;
ControlHandle CH;
{
 Point pt;

 pt.v=HiWord(par); 
 pt.h=LoWord(par);
 return (int)PtInRect(pt,&((**CH).contrlRect));
}

doCalc(par,CH)
RgnHandle par;
ControlHandle CH;
{
 par=(RgnHandle)((long)par&0x7FFFFFFF);
 RectRgn(par,&((**CH).contrlRect));
}

doDraw(CH)
ControlHandle CH;
{
 int j,k,*p;
 Handle tItem;
 Rect r;
 RGBColor rgb,rgb1,rgb2; 
 AuxCtlHandle ax;
 FontInfo inf;
 
 r=(**CH).contrlRect; 
 j=StringWidth((**CH).contrlTitle); 
 GetFontInfo(&inf); 
 k=inf.ascent+inf.descent;
 k=(r.top+r.bottom+k)/2;
 MoveTo((r.left+r.right-j)/2,k-inf.descent);
 DrawString((**CH).contrlTitle);
 GetAuxCtl(CH,&ax);
 
 p=(int *)&(**(**ax).acCTable).ctTable[0].rgb.red; 
 rgb.red=p[0];   /* 21845, 0x5555*/
 rgb.green=p[1]; /* 21845, 0x5555*/
 rgb.blue=p[2];  /* 21845, 0x5555*/
 rgb1.red=p[4];  /* 34952, 0x8888*/
 rgb1.green=p[5];/* 34952, 0x8888*/
 rgb1.blue=p[6]; /* 34952, 0x8888*/
 rgb2.red=rgb2.green=rgb2.blue=0xFFFF;
 
 PenSize(2,2);
 RGBForeColor(&rgb);
 MoveTo(r.right-2,r.top); 
 LineTo(r.left,r.top);
 LineTo(r.left,r.bottom-2); 
 RGBForeColor(&rgb2);
 MoveTo(r.right-2,r.top+1);
 LineTo(r.right-2,r.bottom-2);
 LineTo(r.left,r.bottom-2); 
 rgb2.red=rgb2.green=rgb2.blue=0;
 RGBForeColor(&rgb2);
 InsetRect(&r,2,2);
 FrameRect(&r);

 InsetRect(&r,2,2);
 if(!(**CH).contrlHilite){
 PenSize(1,1);
 RGBForeColor(&rgb);
 MoveTo(r.left,r.top);
 LineTo(r.left,r.bottom-2);
 PenSize(2,2); 
 LineTo(r.right-2,r.bottom-2);
 Move(0,-1);
 PenSize(1,1);
 RGBForeColor(&rgb1);
 LineTo(r.left+1,r.bottom-3);
 LineTo(r.left+1,r.top);
 LineTo(r.right-1,r.top);
 Move(0,1);
 rgb2.red=rgb2.green=rgb2.blue=0xFFFF; 
 RGBForeColor(&rgb2);
 LineTo(r.left+2,r.top+1);
 }
 else {
 MoveTo(r.right-2,r.top);
 RGBForeColor(&rgb);
 LineTo(r.left,r.top);
 PenSize(1,1);
 LineTo(r.left,r.bottom-3);
 PenSize(3,3);
 LineTo(r.right-3,r.bottom-3); 
 PenSize(1,1);
 Move(2,-1);
 RGBForeColor(&rgb1); 
 LineTo(r.left+1,r.bottom-4);
 LineTo(r.left+1,r.top+2);
 LineTo(r.right-1,r.top+2);
 }
 rgb2.red=rgb2.green=rgb2.blue=0;
 RGBForeColor(&rgb2); 
}

The values for the color table resources for the example are as follows:

The control color table (type 'cctb') has two entries. The part codes are just 0 and 1 (the CDEF doesn't really use these) and the colors are { 0x5555,0x5555,0x5555 } and { 0x8888,0x8888,0x8888 }.

The dialog color table (type 'dctb') must have five entries, with part codes of 0-4, and colors as follows: { 0xAAAA,0xAAAA,0xAAAA }, { 0x5555,0x5555, 0x5555 }, { 0,0,0 }, { 0,0,0 }, { 0,0,0 }.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Bookends 13.2.5 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
Quicken 2019 5.11.2 - Complete personal...
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
Dashlane 6.1927.0 - Password manager and...
Dashlane is an award-winning service that revolutionizes the online experience by replacing the drudgery of everyday transactional processes with convenient, automated simplicity - in other words,... Read more
Capo 3.7.4 - Slow down and learn to play...
Capo lets you slow down your favorite songs so you can hear the notes and learn how they are played. With Capo, you can quickly tab out your songs atop a highly-detailed OpenCL-powered spectrogram... Read more
BetterTouchTool 3.153 - 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
calibre 3.46.0 - Complete e-book library...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
Firefox 68.0.1 - Fast, safe Web browser.
Firefox offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and casual... Read more
Vivaldi 2.6.1566.49 - An advanced browse...
Vivaldi is a browser for our friends. We live in our browsers. Choose one that has the features you need, a style that fits and values you can stand by. From the look and feel, to how you interact... Read more
Daylite 6.7.3.1 - Dynamic business organ...
Daylite helps businesses organize themselves with tools such as shared calendars, contacts, tasks, projects, notes, and more. Enable easy collaboration with features such as task and project... Read more
Vivaldi 2.6.1566.49 - An advanced browse...
Vivaldi is a browser for our friends. We live in our browsers. Choose one that has the features you need, a style that fits and values you can stand by. From the look and feel, to how you interact... Read more

Latest Forum Discussions

See All

Void Tyrant guide - Tips and tricks for...
Void Tyrant continues to get a lot of play in these parts. Probably because the game is just so deep and varied. The next stop on our guide series for Void Tyrant is class-specific guides. First up is the Knight, as it’s the first class anyone has... | Read more »
Summon beasts and battle evil in epic re...
Imagine a tale of conlict between factions of good and evil, where rogueish heroes summon beasts to aid them in them in warfare and courageously battle dragons over fields of scorched earth and brimstone - that's exactly the essence of epic fantasy... | Read more »
Upcoming visual novel Arranged shines a...
If you’re in the market for a new type of visual novel designed to inform and make you think deeply about its subject matter, then Arranged by Kabuk Games could be exactly what you’re looking for. It’s a wholly unique take on marital traditions in... | Read more »
TEPPEN guide - The three best decks in T...
TEPPEN’s unique take on the collectible card game genre is exciting. It’s just over a week old, but that isn’t stopping lots of folks from speculating about the long-term viability of the game, as well as changes and additions that will happen over... | Read more »
Intergalactic puzzler Silly Memory serve...
Recently released matching puzzler Silly Memory is helping its fans with their intergalactic journeys this month with some very special offers on in-app purchases. In case you missed it, Silly Memory is the debut title of French based indie... | Read more »
TEPPEN guide - Tips and tricks for new p...
TEPPEN is a wild game that nobody asked for, but I’m sure glad it exists. Who would’ve thought that a CCG featuring Capcom characters could be so cool and weird? In case you’re not completely sure what TEPPEN is, make sure to check out our review... | Read more »
Dr. Mario World guide - Other games that...
We now live in a post-Dr. Mario World world, and I gotta say, things don’t feel too different. Nintendo continues to squirt out bad games on phones, causing all but the most stalwart fans of mobile games to question why they even bother... | Read more »
Strategy RPG Brown Dust introduces its b...
Epic turn-based RPG Brown Dust is set to turn 500 days old next week, and to celebrate, Neowiz has just unveiled its biggest and most exciting update yet, offering a host of new rewards, increased gacha rates, and a brand new feature that will... | Read more »
Dr. Mario World is yet another disappoin...
As soon as I booted up Dr. Mario World, I knew I wasn’t going to have fun with it. Nintendo’s record on phones thus far has been pretty spotty, with things trending downward as of late. [Read more] | Read more »
Retro Space Shooter P.3 is now available...
Shoot-em-ups tend to be a dime a dozen on the App Store, but every so often you come across one gem that aims to shake up the genre in a unique way. Developer Devjgame’s P.3 is the latest game seeking to do so this, working as a love letter to the... | Read more »

Price Scanner via MacPrices.net

Flash sale! New 11″ 1TB WiFi iPad Pros for th...
Amazon has the 11″ 1TB WiFi iPad Pro on sale today for only $1199.99 including free shipping. Their price is $350 off Apple’s MSRP for this model, and it’s the lowest price ever for a 1TB 11″ iPad... Read more
Weekend Deal: 2018 13″ MacBook Airs starting...
B&H Photo has clearance 2018 13″ MacBook Airs available starting at only $999 with all models now available for $200 off Apple’s original MSRP. Overnight shipping, or expedited shipping, is free... Read more
Apple has clearance 10.5″ iPad Pros available...
Apple has Certified Refurbished 2017 10.5″ iPad Pros available starting at $469. An Apple one-year warranty is included with each iPad, outer shells are new, and shipping is free: – 64GB 10″ iPad Pro... Read more
Apple restocks refurbished iPad mini 4 models...
Apple has restocked Certified Refurbished 32GB iPad mini 4 WiFi models for $229 shipped. That’s $70 off original MSRP for the iPad mini 4. Space Gray, Silver, and Gold colors are available. Read more
Apple, Yet Again, Is Missing An Ultraportable...
EDITORIAL: 07.19.19 Prior to the decision made by Apple earlier this month to retire the thin and light MacBook model with a 12-inch retina display, the Cupertino, California-based company offered,... Read more
Verizon is offering a 50% discount on iPhone...
Verizon is offering 50% discounts on Apple iPhone 8 and iPhone 8 Plus models though July 24th, plus save 50% on activation fees. New line required. The fine print: “New device payment & new... Read more
Get a new 21″ iMac for under $1000 today at t...
B&H Photo has new 21″ Apple iMacs on sale for up to $100 off MSRP with models available starting at $999. These are the same iMacs offered by Apple in their retail and online stores. Shipping is... Read more
Clearance 2017 15″ 2.8GHz Touch Bar MacBook P...
Apple has Certified Refurbished 2017 15″ 2.8GHz Space Gray Touch Bar MacBook Pros available for $1809. Apple’s refurbished price is currently the lowest available for a 15″ MacBook Pro. An standard... Read more
Clearance 12″ 1.2GHz MacBook on sale for $899...
Focus Camera has clearance 12″ 1.2GHz Space Gray MacBooks available for $899.99 shipped. That’s $400 off Apple’s original MSRP. Focus charges sales tax for NY & NJ residents only. Read more
Get a new 2019 13″ 2.4GHz 4-Core MacBook Pro...
B&H Photo has new 2019 13″ 2.4GHz MacBook Pros on sale for up to $150 off Apple’s MSRP. Overnight shipping is free to many addresses in the US: – 2019 13″ 2.4GHz/256GB 6-Core MacBook Pro Silver... Read more

Jobs Board

Best Buy *Apple* Computing Master - Best Bu...
**707083BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000045-Rockford-Store **Job Description:** **What does a Read more
Geek Squad *Apple* Master Consultation Agen...
**702908BR** **Job Title:** Geek Squad Apple Master Consultation Agent **Job Category:** Services/Installation/Repair **Location Number:** 000360-Williston-Store Read more
Best Buy *Apple* Computing Master - Best Bu...
**711023BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000012-St Cloud-Store **Job Description:** **What does a Read more
*Apple* Systems Architect/Engineer, Vice Pre...
…its vision to be the world's most trusted financial group. **Summary:** Apple Systems Architect/Engineer with strong knowledge of products and services related to Read more
Best Buy *Apple* Computing Master - Best Bu...
**696259BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 001076-Temecula-Store **Job Description:** The Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.