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

Spotify 1.2.0.1165 - Stream music, creat...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
Thunderbird 102.5.1 - Email client from...
As of July 2012, Thunderbird has transitioned to a new governance model, with new features being developed by the broader free software and open source community, and security fixes and improvements... Read more
Pinegrow 7.03 - Mockup and design web pa...
Pinegrow (was Pinegrow Web Designer) is desktop app that lets you mockup and design webpages faster with multi-page editing, CSS and LESS styling, and smart components for Bootstrap, Foundation,... Read more
Adobe After Effects 2022 23.1 - Create p...
The new, more connected Adobe After Effects can make the impossible possible. Get powerful new features like a Live 3D Pipeline that brings CINEMA 4D scenes in as layers - without intermediate... Read more
SteerMouse 5.6.7 - Powerful third-party...
SteerMouse is an advanced driver for USB and Bluetooth mice. SteerMouse can assign various functions to buttons that Apple's software does not allow, including double-clicks, modifier clicks,... Read more
Wireshark 4.0.2 - Network protocol analy...
Wireshark is one of the world's foremost network protocol analyzers, and is the standard in many parts of the industry. It is the continuation of a project that started in 1998. Hundreds of... Read more
Adobe Premiere Pro 2022 23.1 - Digital v...
Adobe Premiere Pro is available as part of Adobe Creative Cloud for as little as $54.99/month. The price on display is a price for annual by-monthly plan for Adobe Premiere Pro only. Adobe Premiere... Read more
1Password 8.9.10 - Powerful password man...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
FotoMagico 6.3 - Powerful slideshow crea...
FotoMagico lets you create professional slideshows from your photos and music with just a few, simple mouse clicks. It sports a very clean and intuitive yet powerful user interface. High image... Read more
Affinity Photo 1.10.6 - Digital editing...
Affinity Photo - redefines the boundaries for professional photo editing software for the Mac. With a meticulous focus on workflow it offers sophisticated tools for enhancing, editing and retouching... Read more

Latest Forum Discussions

See All

‘Awaken Legends: Idle RPG’ Celebrates th...
Awaken Legends: Idle RPG is adding its first update since the game was soft-launched in November, letting players get their hands on a new hero “Hera Valen". Players can also look forward to the Covenant of the Dark Knight event and the Wishing Well... | Read more »
‘Horizon Chase 2’ Japan World Tour Expan...
Horizon Chase 2 () from Aquiris is getting a major expansion today on Apple Arcade. The Japan World Tour expansion brings in 11 new races across 9 cities and it should be rolling out now as of this writing. I expect it to be available worldwide... | Read more »
Dark Fantasy Visual Novel ‘The 13th Mont...
Originally announced for release in August, The 13th Month from Japanese developer Kobayashimaru and publisher Kodansha released on PC via Steam worldwide this month. The dark fantasy visual novel that reimagines the classic Sleeping Beauty tale, is... | Read more »
Tom Clancey’s The Divison Resurgence ann...
Ubisoft has announced the latest Live Test dates for Tom Clancy’s The Division Resurgence, the hotly anticipated mobile entry in the Divison series. Starting December 8th and ending on the 22nd, the test will offer a huge amount of content for the... | Read more »
‘Easy Come Easy Golf’ New Update Adds St...
Easy Come Easy Golf () from Clap Hanz is one of my favorite games on Apple Arcade. It has been updated quite a bit since launch bringing in new modes and improvements. It recently launched on Nintendo Switch as well. | Read more »
Out Now: ‘Magic vs Metal’, ‘Suzerain’, ‘...
Each and every day new mobile games are hitting the App Store, and so each week we put together a big old list of all the best new releases of the past seven days. Back in the day the App Store would showcase the same games for a week, and then... | Read more »
SwitchArcade Round-Up: Reviews Featuring...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for December 7th, 2022. Today can be accurately described as Mikhail Madness, with a whopping four reviews from our pal-est of pals. Football Manager 2023 Touch, Wobbledogs, Soccer Story... | Read more »
Alchemy Stars celebrates 1 and a half ye...
It has been one and a half years since Alchemy Stars launched, and Level Infinite is celebrating in style with a host of new content. There will be a new story mission and even a store to explore, and a whole new mode for those budding idol... | Read more »
Fighting Game ‘Art of Fighting 2’ ACA Ne...
Last week, side-scrolling shooter Pulstar hit mobile platforms as the newest ACA NeoGeo series release from Hamster and SNK. Read Shaun’s review of it here. Today, fighting game Art of Fighting 2 has launched on iOS and Android. Art of Fighting 2... | Read more »
‘Genshin Impact’ Version 3.3 Update Now...
HoYoverse recently revealed the next major update for Genshin Impact (Free) in the form of version 3.3 ‘All Senses Clear, All Existence Void’. | Read more »

Price Scanner via MacPrices.net

New! Details on Verizon’s Christmas/Holiday p...
Verizon is offering discounts on iPhones, Apple Watch models, and iPads with specific promo codes as part of their Christmas/Holiday 2022 offerings. Codes are valid when adding a new line of service... Read more
Apple MagSafe accessories are back on Holiday...
Amazon has Apple MagSafe Chargers and Apple’s MagSafe Battery on sale for up to 24% off MSRP again as part of their Christmas/Holiday sale. Shipping is free, and all models are in stock: – MagSafe... Read more
13″ M2 MacBook Airs on sale again for the low...
Amazon has 13″ MacBook Airs with M2 CPUs in stock today and on sale for $150 off MSRP as part of their Christmas/Holiday Sale, prices start at $1049. Shipping is free. They are the lowest prices... Read more
Get an Apple 16″ MacBook Pro for $400 off MSR...
16″ MacBook Pros with Apple’s M1 Pro CPUs are in stock and on sale today at B&H Photo for $300-$400 off Apple’s MSRP for a limited time. Prices start at $2099 for M1 Pro models with 512GB or 1TB... Read more
Holiday clearance sale! Previous-generation A...
Amazon has 2nd generation 32GB and 64GB 4K Apple TVs with Siri remotes and 32GB Apple TV HDs on clearance sale for $80-$90 off original MSRP. Shipping is free, and delivery is available in time for... Read more
Christmas sale at Verizon: Apple AirPods Pro...
Verizon has first-generation Apple AirPods Pro on sale for $159.99 on their online store as part of their continuing Christmas/Holiday sale. Their price is $90 off Apple’s original MSRP, and it’s the... Read more
New Christmas/New Years promo at Xfinity Mobi...
Switch to Xfinity Mobile and open a new line of service, and take $400 off the price of a new iPhone, no trade-in required, through January 10, 2023. The $400 is applied to your account as credits... Read more
Apple iPad Smart Keyboard Folio prices drop u...
Apple iPad Smart Keyboard Folio prices have dropped up to $60 off MSRP at Amazon and Walmart as part of their Christmas/Holiday sales. These are the cheapest prices currently available for these iPad... Read more
Today is the final day for Xfinity Mobile’s $...
If you switch to Xfinity Mobile and open a new line of service, they will take $500 off the price of a new iPhone, no trade-in required. This is the best no trade-in Cyber Monday Apple iPhone 14 deal... Read more
Amazon restocks 10.2″ 64GB 9th-generation iPa...
Amazon has Apple’s 9th generation 10.2″ 64GB WiFi iPads (Silver) in stock and on sale for $269.99 shipped as part of their Christmas/Holiday Sale. Their price is $60 off Apple’s MSRP. Free delivery... Read more

Jobs Board

*Apple* Systems Administrator - JAMF - Activ...
…Administration **Duties and Responsibilities** + Configure and maintain the client's Apple Device Management (ADM) solution. The current solution is JAMF supporting Read more
Cashier - *Apple* Blossom Mall - JCPenney (...
Cashier - Apple Blossom Mall Location:Winchester, VA, United States (https://jobs.jcp.com/jobs/location/191170/winchester-va-united-states) - Apple Blossom Mall Read more
Omnichannel Associate - *Apple* Blossom Mal...
Omnichannel Associate - Apple Blossom Mall Location:Winchester, VA, United States (https://jobs.jcp.com/jobs/location/191170/winchester-va-united-states) - Apple Read more
Sephora Beauty Advisor - *Apple* Blossom Ma...
Sephora Beauty Advisor - Apple Blossom Mall Location:Winchester, VA, United States (https://jobs.jcp.com/jobs/location/191170/winchester-va-united-states) - Apple Read more
Operations Associate - *Apple* Blossom Mall...
Operations Associate - Apple Blossom Mall Location:Winchester, VA, United States (https://jobs.jcp.com/jobs/location/191170/winchester-va-united-states) - Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.