[r9359]: ooDialog / trunk / doc / ooDialog_ReleaseNotes.txt Maximize Restore History

Download this file

ooDialog_ReleaseNotes.txt    288 lines (168 with data), 7.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
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
Release Notes ooDialog 4.2.3
============================
The ooDialog 4.2.3 release is ?
ooDialog 4.2.3 can be installed to any ooRexx installation, 4.1.0 or
later.
Beginning with the release of ooDialog 4.2.0, the installation of
ooDialog has been decoupled from the interpreter. ooDialog 4.2.2
installs over the top of any ooRexx installation. It replaces the
version of ooDialog in the ooRexx installation with ooDialog 4.2.2.
This type of ooDialog installation is called an "independent" ooDialog
installation to indicate the ooDialog installation is independent of an
ooRexx installation and, to a degree, the version of ooRexx installed.
ooDialog 4.2.3 requires a minimum ooRexx version of 4.1.0.
Installation
========================================================================
Installation is simple, done through a typical Windows installer. Pick
the installation package that matches the bitness of the ooRexx
installation. I.e., a 32-bit package for a 32-bit ooRexx and a 64-bit
package for a 64-bit ooRexx.
The installer will detect the installed ooRexx, location and version.
If the ooRexx version is less than 4.1.0, or if there is no installed
ooRexx, the installer will abort with a message explaining the problem.
Otherwise the installer will replace the current ooDialog with ooDialog
4.2.3.
Note that the actions of the installer are dependent on the version of
ooRexx, not the version of the installed ooDialog. For instance, if the
installed ooDialog is version 4.3.0, but for some reason the user is not
happy with that version, running the ooDialog 4.2.3 installer will
replace the 4.3.0 version with the 4.2.3 version.
At the time of the installation, *all* ooDialog programs must be halted
and the ooDialog PDFs must be closed if they happen to be opened.
Changes in ooDialog 4.2.3 since the release of ooDialog 4.2.2
========================================================================
Bug Fixes in ooDialog:
----------------------
* #1175 Incorrect super class initialization can bypass DynamicDialog
init
* #1176 ooDialog - the SingleSelection class has the potential of not
executing
DocumentationBug Fixes in ooDialog:
----------------------------------
* #201 getTextAlign(), getTextExtent(), setTextAlign() not documented
* #202 ooDialog Reference 4.2.3 - Text errors in Section 8.1 "Method
Table"
Feature Requests in ooDialog:
-----------------------------
* #508 ooDialog - index for tree-view state images
* #537 Add FIle Open Dialog to allow more options than available with
the FileNameDialog
* #540 Add a stand alone ooDialog program launcher
* #549 The setColor() method does not work well with comboboxes
Miscellaneous Fixes:
--------------------
* Fixed a problem detecting a ComboBox control in the .rc files
produced by some resource editors.
New Functionality in ooDialog:
------------------------------
?
New dialog classes:
-------------------
CommonItemDialog class
OpenFileDialog class
SaveFileDialog class
New utility classes:
--------------------
CommonDialogCustomizations class
ComConstants class
ShellItemFilter class
CommonDialogEvents class
New Public Routines:
--------------------
?
New Methods:
------------
In the Application class:
requiredOS() Checks that the current operating system is at least
the minmum specified.
In the ComboBox class:
removeFullColor() Restores the color of the combo box to its default
color if the setFullColor() method has previousl been
invoked.
setFullColor() Sets the color of a combo box for all parts of the
combo box.
In the DlgUtil class:
getGUID() Generates a GUID and returns it in the converntional
string format.
In the TreeView class:
getStateImage() Retrieves the state image index in the image list
for the specified item.
setStateImage() Assigns the state image index in the image list for
the specified item.
New Attributes:
---------------
In the ?? class:
??
Enhanced Methods:
-----------------
In the TreeView class:
getImageList() Enhanced to take a keyword for the type of image
list in addition to the raw number.
setImageList() Enhanced to take a keyword for the type of image
list in addition to the raw number.
Enhanced Public Routines:
-------------------------
?() ??
Deprecated Methods:
-------------------
In the ? class:
??() ??
New samples:
------------
* oodialog\controls\ComboBox\comboBoxTypes.rex
Demonstrates what the 3 types of combo boxes look like. Shows how to
use the removeFullColor() and setFullColor() methods of the ComboBox
class.
* oodialog\controls\ListBox\incrementalSearch.rex
Shows how to implement an incremental search feature for the items in a
list box and over-ride the list box control's internal incremental
search.
* oodialog\examples\genGUID.rex
An example showing how to use the .DlgUtil's genGUID() method. Also
provides a simple application that can be used to generate GUIDs for any
use.
* oodialog\examples\openSaveFileDemo.rex
An example showing a number of different uses of both the Open File
Dialog and the Save File Dialog. Demonstrates the most common usage
patterns.
* oodialog\examples\saveFileWithFilter.rex
An example showing how to use the Common Item Dialog in file save mode.
This example shows 2 things. 1.) How to use a filter with the dialog.
This is done with the .ShellItemFilter class. 2.) How to connect event
notifications. This is done with the .CommonDialogEvents class.
Enhanced samples:
-----------------
oodialog\???.rex
Documentation:
--------------
???
Known Problems, "Gotchas," and Solutions with Independent Installations
========================================================================
* Problem:
The ooRexx installer creates a log of the files it installs. When the
uninstaller runs, the user can select to only uninstall files logged
during installtion. An indpendent ooDialog installation may install
some example programs, documentation files, and shortcuts not recorded
in the log file. When ooRexx is uninstalled or upgraded, these files
and shortcuts may not be deleted.
Solution 1:
Before uninstalling ooRexx, install the independent ooDialog that
matches the ooRexx installation. I.e., if the ooRexx installation is
any 4.0.x, or 4.1.x ooRexx version, install the ooDialog 4.1.0
indpendent installation. Then when ooRexx is uninstalled, all ooDialog
files and shortcuts will be removed because the files and shortcuts
exactly match what was installed during the ooRexx installation.
Solution 2:
After uninstalling ooRexx, manually delete any files in the old ooRexx
installation directory.
* Gotcha:
The independent ooDialog installation deletes the entire ooDialog
samples subdirectory tree. This will delete any personal files
that may have been put there after ooRexx was installed.
Solution 1:
Do not put personal files in the %REXX_HOME%\samples\ooDialog
subdirectory tree.
Solution 2:
Before executing the independent ooDialog installer, move or back up
any personal files that may be in %REXX_HOME%\samples\ooDialog
subdirectory tree.