>> That is not really correct.  It has nothing to do with resource file dialogs.  It is any top-level dialog.
 
 Sorry,  I mis-spoke - I meant "resource dialogs" , which I think includes User Dialog, as mentioned in the second para of Chaper 2 "The Dialog Object".
 
--
Oliver Sims


From: Mark Miesfeld [mailto:miesfeld@gmail.com]
Sent: 23 February 2013 18:14
To: Open Object Rexx Users
Subject: Re: [Oorexx-users] Suggested mod to ooDialog text

On Sat, Feb 23, 2013 at 9:46 AM, Oliver Sims <oliver.sims@simsassociates.co.uk> wrote:
 
I initially found it quite difficult to separate out the various kinds of dialogs, sheets, property pages, etc. Maybe it's me. But anyway, after sorting myself out with oyur help, I'd suggest making a coupelk of chnages to the intro to Property Seets and Control Dialogs. The are:
 
Ref Chap 4, "PropertySheet and Control Dialogs", 3rd para in chapter (p.533):
"Windows has a style for dialogs that allows the dialog to work well as a dialog within a top-level dialog."

Suggest adding "also" so that it reads:
"Windows also has a style for dialogs that allows the dialog to work well as a dialog within a top-level dialog."

That can certainly be changed.  It might be even better to use a <variablelist> with 2 terms.  One PropertySheetDialog Dialogs and one Control Dialogs to better separate the 2 discussions.

 
Rationale - this better separates the two "kinds" of property-sheet dialogs.

But there aren't two kinds of property sheet dialogs. There is only one property sheet dialog.  There are 2 approaches to embedding pages in a tab control.  And even that is not technically correct, there are more than 2.  

Maybe: ooDialog supports 2 approaches to embedding pages in a tab control.

 
When I first read this, I thought this was a re-statement, in different words, of the first two paras. It took me a long time to work out that there are two alternatives - "Property Sheet Dialogs" (containing a number of PSP dialogs) and "Resource File Dialogs" (optionally containing a number of Control dialogs). 
 
If you agree, then I'd suggest another change:
"Windows also has a style for dialogs that allows the dialog to work well as a dialog within a top-level or "resource file" dialog."
Maybe the text "resource file" could be linked to Chapter 6.
 

That is not really correct.  It has nothing to do with resource file dialogs.  It is any top-level dialog


 
Finally, after the last para in the intro, I'd suggest another very short para:
"In summary, there are two quite separate approaches to providing nested dialogs: Control Dialogs in normal User-Res-Rc dialogs and Property Sheet Pages in a Property Sheet Dialog." The former allows controls to be specified in the main dialog; the latter does not. 

A summary paragraph is good.  But, I would prefer to talk about dialogs that are used as, or for, the pages of a tab control rather than nested dialogs.

--
Mark Miesfeld