thr3ads.net - wxruby development - [Wxruby-development] [925] branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl: Improvements to doc from wxWidgets 2.8 [Mar 2007]

If this information is useful, please help other people find it:
Share via:
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&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp2007-03-28
17:26:43 UTC (rev 924)
+++
branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp2007-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>
Reasonably Related Threads

Search for more reasonably related threads
wxruby development - Mar 2007 - [925] branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl: Improvements to doc from wxWidgets 2.8

[Wxruby-development] [925] branches/wxruby2/wxwidgets_282/doc/textile/filedialog.txtl: Improvements to doc from wxWidgets 2.8

Reasonably Related Threads

Wisdom of the Ancients
