If this list is monitored by RealSoftware, please read: Regarding Menu Items (such as File-New),
In the code window under Menu Handlers I notice that FileNew is treated as a function in RB so I go to the LR to determine what I should return and I see: result = Action( ) 'result is boolean Not understanding why a Menu Handler has to be a function (this is my first project using RB and I'm assuming that Action refers to clicking on a menu item) I look at the only other information provided by the LR: "Fires when a MenuItem is selected. Return True to prevent the menu event from proceeding any further in the chain of menu handlers." The first sentence makes sense. The second sentence leaves me asking the following questions: 1. Why would the menu event (FileNew) continue into other menu handlers? After all, I didn't trigger those events (FileOpen, FileSave, FileQuit) I only triggered the FileNew event. Certainly, for my mental well-being if nothing else, RB couldn't possibly be designed so that if a user triggers one menu event, all the rest of the menu events are triggered as well unless the intended menu event returns true. Or does RB indeed behave this way and if so, why? 2. What happens, then, if I return false, the remaining menu events are all triggered, some triggered, the preceeding one triggered on a blue moon? Now, I suppose I could get out my "Test.rbp" program and code it so as to help me understand what happens if I return true versus returning false (like I had to do with the Window.CancelClose event because the LR was insufficiently clear for my purposes.) But I figure that if I'm going to spend $500 for RB, I would like to think that some portion of that money is allocated towards accurate and understandable documentation. Sure, I don't have a formal education in computers, but I think I know when the documentation for the BASIC language is sufficient or adequate and IMHO, RB's documentation is inadequate. My plea: Please allow the userbase to take over the documentation if RealSoftware doesn't have the resources to give it adequate attention. I personally dislike the idea of searching the user guide, the LR, the examples, the tutorial, etc., just so that I don't feel guilty using this list to ask questions of gracious, kind and helpful programmers. Rather, I prefer going to one relatively extensive resource to find what I need because that is the least time consuming and least imposing on other people. I'm finding that keeping up with both email lists just to learn and document RB is very time consuming. So, I don't know why a menu handler is a function, not a sub. I don't understand what happens if I return true or what happens if I return false. I don't understand why the LR can't be better. Any gracious, kind and helpful people care to share their knowledge, please? Thank you. Sincerely, Steven Hedgepeth (Don't get me started on Excite email or I'll probably say something like I Don't Like It Either.) _______________________________________________ Join Excite! - http://www.excite.com The most personalized portal on the Web! _______________________________________________ Unsubscribe or switch delivery mode: <http://www.realsoftware.com/support/listmanager/> Search the archives of this list here: <http://support.realsoftware.com/listarchives/lists.html>
