[r8761]: ooDialog / branches / 4.2.1 / trunk / examples / winsystem / displayAnyMenu.rex  Maximize  Restore  History

Download this file

189 lines (166 with data), 8.4 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
/*----------------------------------------------------------------------------*/
/* */
/* Copyright (c) 2008-2013 Rexx Language Association. All rights reserved. */
/* */
/* This program and the accompanying materials are made available under */
/* the terms of the Common Public License v1.0 which accompanies this */
/* distribution. A copy is also available at the following address: */
/* http://www.oorexx.org/license.html */
/* */
/* Redistribution and use in source and binary forms, with or */
/* without modification, are permitted provided that the following */
/* conditions are met: */
/* */
/* Redistributions of source code must retain the above copyright */
/* notice, this list of conditions and the following disclaimer. */
/* Redistributions in binary form must reproduce the above copyright */
/* notice, this list of conditions and the following disclaimer in */
/* the documentation and/or other materials provided with the distribution. */
/* */
/* Neither the name of Rexx Language Association nor the names */
/* of its contributors may be used to endorse or promote products */
/* derived from this software without specific prior written permission. */
/* */
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS */
/* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT */
/* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS */
/* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT */
/* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, */
/* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED */
/* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, */
/* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY */
/* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING */
/* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS */
/* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
/* */
/*----------------------------------------------------------------------------*/
/**
* Name: displayAnyMenu.rex
* Type: Example ooRexx program
*
* Description: Displays the menu hierarchy for a window that the user picks.
*
* The user is prompted for the title of an open, top-level,
* window. This program then parses the details of the menubar
* for that window and displays them graphically.
*
* The example uses a mixture of ooDialog and winsystm.
*
* In addition, the example uses some of the public functions
* provided by the windowsSystem.frm package. That framweowork
* is an example of how to extract common function into a
* package and share that function with any number of ooRexx
* programs.
*
* The table below lists the external functions and classes used in this
* program and shows where to go to examine the source code for them.
*
* External function Source
* ---------------------------------------------------
* RcDialog ooDialog
* errorDialog() ooDialog
* askDialog() ooDialog
* infoDialog() ooDialog
* MenuDetailer windowsSystem.frm
* findTheWindow() windowsSystem.frm
*/
.application~useGlobalConstDir("O", "winSystemDlgs.h")
-- Prompt the user for a window title
dlg = .UserPrompt~new("winSystemDlgs.rc", IDD_USER_PROMPT)
if dlg~initCode <> 0 then do
msg = "Error initializing the UserPrompt dialog." || '0d0a0d0a'x || -
"The dislplayAnyMenu example will have to quit."
j = errorDialog(msg)
return 99
end
-- A return of 2 means the user canceled, and we will just quit.
if dlg~execute("SHOWTOP") == 2 then return 2
-- The UserPrompt dialog validates the data, i.e. it enforces that either a
-- valid WindowObject is obtained, or that the user cancels. Here, we ask the
-- dialog for the window object that the user picked, create a MenuDetailer
-- object using that window object, and then display the menu.
topWnd = dlg~getUserPick
md = .MenuDetailer~new(topWnd)
md~display
-- Return 0 for okay
return 0
::requires 'windowsSystem.frm'
/** class UserPrompt
* Our user prompt dialog subclasses the RcDialog. The RcDialog class takes
* care of all the details of the dialog and we just over-ride the ok method
* to take care of validating the user input. We also add a method,
* getUserPick(), which is used to return the window object representing the
* window the user selected.
*/
::class 'UserPrompt' subclass RcDialog inherit AdvancedControls MessageExtensions
/** ok()
* The over-ride of the ok() method is basically simple. It verifies that the
* user entered something in the edit control and then attempts to contstruct
* a .WindowObject using the text from the edit control as the title of a
* window.
*
* The method will only end the dialog with the 'ok' value if a valid window
* object is constructed. Otherwise it forces the user to either try again,
* or to cancel.
*/
::method ok
expose wnd edit
-- Get the edit control object and then the text the user entered. We only
-- instantiate the edit control object the first time through.
if \ edit~isA(.EditControl) then edit = self~newEdit(IDC_EDIT_NAME)
title = edit~getText~strip
-- Check that the user entered something.
if title~length == 0 then do
msg = "You must enter the title of a window whose menu" || '0d0a'x || -
"you want displayed." || '0d0a0d0a'x || -
"Would you rather cancel?"
if askDialog(msg) then return self~cancel
else return
end
-- Warn the user that constructing the window object may take a little bit of
-- time.
msg = "It may take a second or two find the window" || '0d0a'x || -
"you picked. Be patient." || '0d0a0d0a'x || -
"This dialog will be disabled during the search."
j = infoDialog(msg)
-- Disable the dialog so that an impatient user can not fiddle with it.
self~disable
edit~disable
self~disableItem(IDOK)
self~disableItem(IDCANCEL)
-- The big step, get a window object with the title entered by the user.
wnd = findTheWindow(title)
-- Re-enable the dialog.
self~enable
edit~enable
self~enableItem(IDOK)
self~enableItem(IDCANCEL)
-- If we don't have a window object, give the user a chance to try again, or
-- to cancel. If the user does not want to try again, we end the dialog by
-- invoking our cancel() method.
if wnd == .nil then do
msg = "Failed to find the window with title:" || '0d0a'x || -
" " title || '0d0a0d0a'x || -
"The window title has to match exactly." || '0d0a0d0a'x || -
"Try again?"
if askDialog(msg) then return
else return self~cancel
end
-- Okay, we have a window object. We end the dialog by inoking the superclass
-- ok() method.
return self~ok:super
/** cancel()
* Just to keep things tidy, if the user cancels, we make sure that wnd is .nil.
* Then if getUserPick() is called, .nil is returned. Presumably, if the user
* cancels, getUserPick() would not be invoked. However, if someone were to
* take this dialog class implementation and extend it, this simple detail might
* be overlooked.
*/
::method cancel
expose wnd
wnd = .nil
return self~cancel:super
/** getUserPick() Return the window object to the caller */
::method getUserPick
expose wnd
return wnd

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.





No, thanks