home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #26 / NN_1992_26.iso / spool / comp / sys / mac / programm / 18241 < prev    next >
Encoding:
Text File  |  1992-11-10  |  4.5 KB  |  105 lines
  1. Newsgroups: comp.sys.mac.programmer
  2. Path: sparky!uunet!think.com!ames!data.nas.nasa.gov!taligent!kip-16.taligent.com!user
  3. From: keith@taligent.com (Keith Rollin)
  4. Subject: Re: Spurious invalidation
  5. Message-ID: <keith-101192141340@kip-16.taligent.com>
  6. Followup-To: comp.sys.mac.programmer
  7. Sender: usenet@taligent.com (More Bytes Than You Can Read)
  8. Organization: Taligent
  9. References: <1992Nov6.170232.21241@alw.nih.gov> <absurd-061192133636@seuss.apple.com> <1992Nov7.172136.7170@athena.mit.edu>,<1992Nov7.221521.21889@samba.oit.unc.edu> <1992Nov10.155449.14655@alw.nih.gov>
  10. Date: Tue, 10 Nov 1992 22:22:10 GMT
  11. Lines: 92
  12.  
  13. In article <1992Nov10.155449.14655@alw.nih.gov>, fixer@faxcsl.dcrt.nih.gov
  14. (Chris Spiral Catfish Tate) wrote:
  15. > 
  16. > Thanks to everyone who responded, either on the net or via email.
  17. > 
  18. > In summary, what's happening is that indeed, SetCTitle() is *both* redrawing
  19. > the control with its new title *and* causing an update event in the dialog.
  20. > I'm not quite clear on why it has to generate the update event, but that's
  21. > beside the point.
  22.  
  23. I looked into this when working on "Macintosh Programming Secrets." What
  24. happens when you call SetCTitle is the following:
  25.  
  26.     _HideControl
  27.     change the title of the control
  28.     _ShowControl
  29.  
  30. _HideControl calls _EraseControl and then invalidates the area under the
  31. control's bounds. This is correct behaviour for _HideControl. When
  32. _ShowControl is called, the control is redrawn, but the area is still
  33. marked invalid in the window's update region. The second drawing of the
  34. control is the dialog manager responding to the update.
  35.  
  36. > If you're absolutely sure you don't have to update anything else when the
  37. > control changes its title, you can also call ValidRect() on its rectangle
  38. > immediately following the call to SetCTitle(), and the update will be
  39. > "cancelled."
  40.  
  41. Right. Here's the section for MPS that deals with this issue. Note that it
  42. assumes that, if a dialog item is not a static or edit text item, that it
  43. is a control. This is not a valid assumption in all cases (as in the
  44. original poster's, who had user items in his dialog).
  45.  
  46. /*******************************************************************************
  47.  
  48.     SetDialogItemTitle
  49.  
  50.     Change the text associated with a particular dialog item. This is a little
  51.     tricky since there are two ways to change the text. If you are dealing
  52.     with an EditText or StatText (static text) item, you must call SetIText.
  53.     If you are dealing with a dialog item that is backed up by a Control
  54.     Manager control (like a simple button, radio button, or checkbox), you
  55.     must call SetCTitle.
  56.  
  57.     We determine what kind of dialog item we are dealing with by calling
  58.     GetDItem. Returned in the ╥kind╙ parameter is a number that identifies
  59.     what sort of item we are handling. First, we strip off the upper bit,
  60.     which identifies the item as being enabled or disabled. Once that bit is
  61.     removed, we can examine the kind of the item and act accordingly.
  62.  
  63.     Notice the special handling we give to controls when we call SetCTitle.
  64.     This is to take care of ╥excessive flashing╙ as Online Companion puts it.
  65.     When you call SetCTitle, the control manager first calls HideControl to
  66.     remove the control with its old text from the screen. It then changes the
  67.     control╒s title in the ControlRecord, and reshows the control by calling
  68.     ShowControl. At this point, the control is properly shown on the screen
  69.     with its correct, new title.
  70.  
  71.     However, there╒s a little time bomb lurking in the works. When HideControl
  72.     was called, the Control Manager called InvalRect on the area the control
  73.     occupied. Even though ShowControl was later called on the same area and
  74.     everything is drawn correctly, that rectangle is still marked as invalid
  75.     and is incorporated into the update region for the dialog. The event loop
  76.     at the heart of ModalDialog will then get an update event for that area
  77.     and redraw the button _again_! This can cause the button to flicker and
  78.     flash more than we would like. We already know that that area is
  79.     adequately drawn, so we tell the Event Manager to hoof it by validating it
  80.     with a call to ValidRect.
  81.  
  82. *******************************************************************************/
  83. void    SetDialogItemTitle(DialogPtr dlg, short item, Str255 *newTitle)
  84. {
  85.     short    iKind;
  86.     Handle    iHandle;
  87.     Rect    iRect;
  88.  
  89.     GetDItem(dlg, item, &iKind, &iHandle, &iRect);
  90.     iKind &= ~itemDisable;                // Strip off the enable/disable bit
  91.     if ((iKind == statText) || (iKind == editText)) {
  92.         SetIText(iHandle, *newTitle);
  93.     } else {
  94.         SetCTitle((ControlHandle) iHandle, *newTitle);
  95.         SetPort(dlg);
  96.         ValidRect(&iRect);
  97.     }
  98. }
  99.  
  100.  
  101. -----
  102. Keith Rollin
  103. Phantom Programmer
  104. Taligent, Inc.
  105.