nobody at rubyforge.org
2007-Mar-28 17:28 UTC
[Wxruby-development] [925] branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl: Improvements to doc from wxWidgets 2.8
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!-- #msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; } #msg dt { float: left; width: 6em; font-weight: bold; } #msg dt:after { content:'':'';} #msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; } #msg dl a { font-weight: bold} #msg dl a:link { color:#fc3; } #msg dl a:active { color:#ff0; } #msg dl a:visited { color:#cc6; } h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; } #msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; } #msg ul, pre { overflow: auto; } #header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; } #patch { width: 100%; } #patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;} #patch .propset h4, #patch .binary h4 {margin:0;} #patch pre {padding:0;line-height:1.2em;margin:0;} #patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;} #patch .propset .diff, #patch .binary .diff {padding:10px 0;} #patch span {display:block;padding:0 10px;} #patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;} #patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;} #patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;} #patch .lines, .info {color:#888;background:#fff;} --></style> <title>[925] branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl: Improvements to doc from wxWidgets 2.8</title> </head> <body> <div id="msg"> <dl> <dt>Revision</dt> <dd>925</dd> <dt>Author</dt> <dd>brokentoy</dd> <dt>Date</dt> <dd>2007-03-28 13:28:48 -0400 (Wed, 28 Mar 2007)</dd> </dl> <h3>Log Message</h3> <pre>Improvements to doc from wxWidgets 2.8</pre> <h3>Modified Paths</h3> <ul> <li><a href="#brancheswxruby2wxwidgets_282doctextilefiledialogtxtl">branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl</a></li> </ul> </div> <div id="patch"> <h3>Diff</h3> <a id="brancheswxruby2wxwidgets_282doctextilefiledialogtxtl"></a> <div class="modfile"><h4>Modified: branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl (924 => 925)</h4> <pre class="diff"><span> <span class="info">--- branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl        2007-03-28 17:26:43 UTC (rev 924) +++ branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl        2007-03-28 17:28:48 UTC (rev 925) </span><span class="lines">@@ -12,6 +12,27 @@ </span><span class="cx"> </span><span class="cx"> "Object":object.html </span><span class="cx"> </span><ins>+h2. Window styles + + +|@FD_DEFAULT_STYLE@|Equivalent to FD_OPEN.| +|@FD_OPEN@|This is an open dialog; usually this means that the default button''s label of the dialog is "Open". Cannot be combined with FD_SAVE.| +|@FD_SAVE@|This is a save dialog; usually this means that the default button''s label of the dialog is "Save". Cannot be combined with FD_OPEN.| +|@FD_OVERWRITE_PROMPT@|For save dialog only: prompt for a confirmation if a file will be overwritten.| +|@FD_FILE_MUST_EXIST@|For open dialog only: the user may only select files that actually exist.| +|@FD_MULTIPLE@|For open dialog only: allows selecting multiple files.| +|@FD_CHANGE_DIR@|Change the current working directory to the directory where the file(s) chosen by the user are.| +|@FD_PREVIEW@|Show the preview of the selected files (currently only supported by GTK using GTK+ 2.4 or later).| + + +*NB:* Previous versions of Widgets used @FD_CHANGE_DIR@ by default +under MS Windows which allowed the program to simply remember the last +directory where user selected the files to open/save. This (desired) +functionality must be implemented in the program itself now (manually remember +the last path used and pass it to the dialog the next time it is called) or +by using this flag. + + </ins><span class="cx"> h2. See also </span><span class="cx"> </span><span class="cx"> "FileDialog overview":filedialogoverview.html, "FileSelector":fileselector.html </span><span class="lines">@@ -24,9 +45,7 @@ </span><span class="cx"> If path is ``", the current directory will be used. If filename is ``", </span><span class="cx"> no default filename will be supplied. The wildcard determines what files </span><span class="cx"> are displayed in the file selector, and file extension supplies a type </span><del>-extension for the required filename. Flags may be a combination of OPEN, -SAVE, OVERWRITE_PROMPT, HIDE_READONLY, FILE_MUST_EXIST, -MULTIPLE, CHANGE_DIR or 0. </del><ins>+extension for the required filename. </ins><span class="cx"> </span><span class="cx"> Both the X and Windows versions implement a wildcard filter. Typing a </span><span class="cx"> filename containing wildcards (*, ?) in the filename text item, and </span><span class="lines">@@ -57,14 +76,12 @@ </span><span class="cx"> * "FileDialog#get_message":#FileDialog_getmessage </span><span class="cx"> * "FileDialog#get_path":#FileDialog_getpath </span><span class="cx"> * "FileDialog#get_paths":#FileDialog_getpaths </span><del>-* "FileDialog#get_style":#FileDialog_getstyle </del><span class="cx"> * "FileDialog#get_wildcard":#FileDialog_getwildcard </span><span class="cx"> * "FileDialog#set_directory":#FileDialog_setdirectory </span><span class="cx"> * "FileDialog#set_filename":#FileDialog_setfilename </span><span class="cx"> * "FileDialog#set_filter_index":#FileDialog_setfilterindex </span><span class="cx"> * "FileDialog#set_message":#FileDialog_setmessage </span><span class="cx"> * "FileDialog#set_path":#FileDialog_setpath </span><del>-* "FileDialog#set_style":#FileDialog_setstyle </del><span class="cx"> * "FileDialog#set_wildcard":#FileDialog_setwildcard </span><span class="cx"> * "FileDialog#show_modal":#FileDialog_showmodal </span><span class="cx"> </span><span class="lines">@@ -77,8 +94,10 @@ </span><span class="cx"> %(arg-type)String% defaultDir = "", </span><span class="cx"> %(arg-type)String% defaultFile = "", </span><span class="cx"> %(arg-type)String% wildcard = ".*", </span><del>- %(arg-type)Integer% style = 0, - %(arg-type)Point% pos = DEFAULT_POSITION) </del><ins>+ %(arg-type)Integer% style = FD_DEFAULT_STYLE, + %(arg-type)Point% pos = DEFAULT_POSITION, + %(arg-type)Size% sz = DEFAULT_SIZE, + %(arg-type)String% name = "filedlg") </ins><span class="cx"> </span><span class="cx"> Constructor. Use "FileDialog#show_modal":filedialog.html#FileDialog_showmodal to show the dialog. </span><span class="cx"> </span><span class="lines">@@ -92,26 +111,11 @@ </span><span class="cx"> </span><span class="cx"> Note that the native Motif dialog has some limitations with respect to </span><span class="cx"> wildcards; see the Remarks section above. </span><del>-* _style_ A dialog style. A bitlist of: - - - -|*OPEN*|This is an open dialog.| -|*SAVE*|This is a save dialog.| -|*OVERWRITE_PROMPT*|For save dialog only: prompt for a confirmation if a file will be overwritten.| -|*HIDE_READONLY*|Do not display the checkbox to toggle display of read-only files. Deprecated in 2.6; the checkbox is never shown.| -|*FILE_MUST_EXIST*|The user may only select files that actually exist.| -|*MULTIPLE*|For open dialog only: allows selecting multiple files.| -|*CHANGE_DIR*|Change the current working directory to the directory where the file(s) chosen by the user are.| - </del><ins>+* _style_ A dialog style. See FD_* styles for more info. </ins><span class="cx"> * _pos_ Dialog position. Not implemented. </span><ins>+* _size_ Dialog size. Not implemented. +* _name_ Dialog name. Not implemented. </ins><span class="cx"> </span><del>-*NB:* Previous versions of Widgets used @CHANGE_DIR@ by default -under MS Windows which allowed the program to simply remember the last -directory where user selected the files to open/save. This (desired) -functionality must be implemented in the program itself now (manually remember -the last path used and pass it to the dialog the next time it is called) or -by using this flag. </del><span class="cx"> </span><span class="cx"> *destructor*() </span><span class="cx"> </span><span class="lines">@@ -170,12 +174,6 @@ </span><span class="cx"> function should only be used with the dialogs which have @MULTIPLE@ style, </span><span class="cx"> use "get_path":#FileDialog_getpath for the others. </span><span class="cx"> </span><del>-h3(#FileDialog_getstyle). FileDialog#get_style - - Integer *get_style*() - -Returns the dialog style. - </del><span class="cx"> h3(#FileDialog_getwildcard). FileDialog#get_wildcard </span><span class="cx"> </span><span class="cx"> String *get_wildcard*() </span><span class="lines">@@ -212,12 +210,6 @@ </span><span class="cx"> </span><span class="cx"> Sets the path (the combined directory and filename that will be returned when the dialog is dismissed). </span><span class="cx"> </span><del>-h3(#FileDialog_setstyle). FileDialog#set_style - - *set_style*(%(arg-type)Integer% style) - -Sets the dialog style. See "FileDialog.new":filedialog.html#FileDialog_new for details. - </del><span class="cx"> h3(#FileDialog_setwildcard). FileDialog#set_wildcard </span><span class="cx"> </span><span class="cx"> *set_wildcard*(%(arg-type)String% wildCard) </span></span></pre> </div> </div> </body> </html>
Seemingly Similar Threads
- [1020] trunk/wxruby2/swig/classes/FileDialog.i: Added the Wx::FD_XXX constants for FileDialog variants
- Wx::FileDialog and common dialogs
- [ wxruby-Bugs-13457 ] Missing constants for FileDialog
- For the FAQ: FileDialog default file name
- Wx::FileDialog Styles are not working