Small doc updates.

  Distrib and makefile updates.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@4285 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/Makefile.in b/Makefile.in
index 3470be960624abe6a7a912daec17ae1e9780c619..dadf3f979c7f15223dc6a802abc0723e945cb6bc 100644 (file)
--- a/Makefile.in
+++ b/Makefile.in
@@ -1,5 +1,5 @@
 #
 #

-# This file was automatically generated by tmake at 16:39, 1999/10/31
+# This file was automatically generated by tmake at 18:34, 1999/11/01

 # DO NOT CHANGE THIS FILE, YOUR CHANGES WILL BE LOST! CHANGE UNX.T!
 
 #
 # DO NOT CHANGE THIS FILE, YOUR CHANGES WILL BE LOST! CHANGE UNX.T!
 
 #


@@ -204,6 +204,7 @@ WX_HEADERS = \
                debug.h \
                defs.h \
                dialog.h \
                debug.h \
                defs.h \
                dialog.h \

+               dialup.h \

                dirdlg.h \
                dnd.h \
                docmdi.h \
                dirdlg.h \
                dnd.h \
                docmdi.h \


@@ -2350,6 +2351,10 @@ SAMPLES_DIST:
        cp $(SAMPDIR)/html/help/*.cpp $(DISTDIR)/samples/html/help
        mkdir $(DISTDIR)/samples/html/help/helpfiles
        cp $(SAMPDIR)/html/help/helpfiles/*.??? $(DISTDIR)/samples/html/help/helpfiles
        cp $(SAMPDIR)/html/help/*.cpp $(DISTDIR)/samples/html/help
        mkdir $(DISTDIR)/samples/html/help/helpfiles
        cp $(SAMPDIR)/html/help/helpfiles/*.??? $(DISTDIR)/samples/html/help/helpfiles

+       mkdir $(DISTDIR)/samples/html/helpview
+       cp $(SAMPDIR)/html/helpview/Makefile.in $(DISTDIR)/samples/html/helpview
+       cp $(SAMPDIR)/html/helpview/*.cpp $(DISTDIR)/samples/html/helpview
+       cp $(SAMPDIR)/html/helpview/*.zip $(DISTDIR)/samples/html/helpview

        mkdir $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/Makefile.in $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/*.cpp $(DISTDIR)/samples/html/printing
        mkdir $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/Makefile.in $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/*.cpp $(DISTDIR)/samples/html/printing

diff --git a/configure b/configure
index 27dfb702274754017d6feefce867de468a8a14d5..dbdf38a82d4474c9485ee19afeeefecd3c30bcd6 100755 (executable)
--- a/configure
+++ b/configure
@@ -1411,7 +1411,7 @@ else
   DEFAULT_wxUSE_COMBOBOX=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes
   DEFAULT_wxUSE_COMBOBOX=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes

-  DEFAULT_wxUSE_NEW_GRID=yes
+  DEFAULT_wxUSE_NEW_GRID=no

   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes
   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes


@@ -3869,7 +3869,7 @@ if test "$wxUSE_CONTROLS" = "yes"; then
   DEFAULT_wxUSE_CHOICE=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes
   DEFAULT_wxUSE_CHOICE=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes

-  DEFAULT_wxUSE_NEW_GRID=yes
+  DEFAULT_wxUSE_NEW_GRID=no

   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes
   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes


@@ -11837,6 +11837,7 @@ trap 'rm -fr `echo "
             samples/html/about/Makefile
             samples/html/help/Makefile
             samples/html/printing/Makefile
             samples/html/about/Makefile
             samples/html/help/Makefile
             samples/html/printing/Makefile

+            samples/html/helpview/Makefile

             samples/html/test/Makefile
             samples/html/zip/Makefile
             samples/html/virtual/Makefile
             samples/html/test/Makefile
             samples/html/zip/Makefile
             samples/html/virtual/Makefile


@@ -12051,6 +12052,7 @@ CONFIG_FILES=\${CONFIG_FILES-"wx-config
             samples/html/about/Makefile
             samples/html/help/Makefile
             samples/html/printing/Makefile
             samples/html/about/Makefile
             samples/html/help/Makefile
             samples/html/printing/Makefile

+            samples/html/helpview/Makefile

             samples/html/test/Makefile
             samples/html/zip/Makefile
             samples/html/virtual/Makefile
             samples/html/test/Makefile
             samples/html/zip/Makefile
             samples/html/virtual/Makefile

diff --git a/configure.in b/configure.in
index d2903a1ab71d7d364efa5f23e0caac2d7bafd9f2..42894c540b649793db6718903df8f39ee218c817 100644 (file)
--- a/configure.in
+++ b/configure.in
@@ -793,7 +793,7 @@ else
   DEFAULT_wxUSE_COMBOBOX=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes
   DEFAULT_wxUSE_COMBOBOX=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes

-  DEFAULT_wxUSE_NEW_GRID=yes
+  DEFAULT_wxUSE_NEW_GRID=no

   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes
   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes


@@ -1060,7 +1060,7 @@ if test "$wxUSE_CONTROLS" = "yes"; then
   DEFAULT_wxUSE_CHOICE=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes
   DEFAULT_wxUSE_CHOICE=yes
   DEFAULT_wxUSE_GAUGE=yes
   DEFAULT_wxUSE_GRID=yes

-  DEFAULT_wxUSE_NEW_GRID=yes
+  DEFAULT_wxUSE_NEW_GRID=no

   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes
   DEFAULT_wxUSE_IMAGLIST=yes
   DEFAULT_wxUSE_LISTBOX=yes
   DEFAULT_wxUSE_LISTCTRL=yes

diff --git a/distrib/msw/tmake/filelist.txt b/distrib/msw/tmake/filelist.txt
index 8f5e5a0f2337cd7eb8f4e73417f30a3e19c5eb54..b95e33ca896bf6c44ac14391d304bc8acb3dbc1c 100644 (file)
--- a/distrib/msw/tmake/filelist.txt
+++ b/distrib/msw/tmake/filelist.txt
@@ -461,6 +461,7 @@ dde.h       W
 debug.h        W       B
 defs.h W       B
 dialog.h       W
 debug.h        W       B
 defs.h W       B
 dialog.h       W

+dialup.h       W

 dirdlg.h       W
 dnd.h  W
 docmdi.h       W
 dirdlg.h       W
 dnd.h  W
 docmdi.h       W

diff --git a/distrib/msw/tmake/unx.t b/distrib/msw/tmake/unx.t
index 83cc33e41366a826199a14d90f271986f998d3ff..f91ad229259ccb82566c4046850ad30a1394ca00 100644 (file)
--- a/distrib/msw/tmake/unx.t
+++ b/distrib/msw/tmake/unx.t
@@ -860,6 +860,10 @@ SAMPLES_DIST:
        cp $(SAMPDIR)/html/help/*.cpp $(DISTDIR)/samples/html/help
        mkdir $(DISTDIR)/samples/html/help/helpfiles
        cp $(SAMPDIR)/html/help/helpfiles/*.??? $(DISTDIR)/samples/html/help/helpfiles
        cp $(SAMPDIR)/html/help/*.cpp $(DISTDIR)/samples/html/help
        mkdir $(DISTDIR)/samples/html/help/helpfiles
        cp $(SAMPDIR)/html/help/helpfiles/*.??? $(DISTDIR)/samples/html/help/helpfiles

+       mkdir $(DISTDIR)/samples/html/helpview
+       cp $(SAMPDIR)/html/helpview/Makefile.in $(DISTDIR)/samples/html/helpview
+       cp $(SAMPDIR)/html/helpview/*.cpp $(DISTDIR)/samples/html/helpview
+       cp $(SAMPDIR)/html/helpview/*.zip $(DISTDIR)/samples/html/helpview

        mkdir $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/Makefile.in $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/*.cpp $(DISTDIR)/samples/html/printing
        mkdir $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/Makefile.in $(DISTDIR)/samples/html/printing
        cp $(SAMPDIR)/html/printing/*.cpp $(DISTDIR)/samples/html/printing

diff --git a/docs/gtk/changes.txt b/docs/gtk/changes.txt
index fbcd2e58e18b299f0857cd27a0f86821e9ef21b9..b16b05a11ca488d2516bbbb1e8c0d0aad07d4b00 100644 (file)
--- a/docs/gtk/changes.txt
+++ b/docs/gtk/changes.txt
@@ -1,10 +1,10 @@
 
 1st November '99: wxWindows 2.1.11 released
 
 
 1st November '99: wxWindows 2.1.11 released
 

-There is still a unresolved problem with bitmap to image
+There is still an unresolved problem with bitmap to image

 conversion on big-endian architectures (such as Solaris),
 where color values get exchanged. I'd need help on this
 conversion on big-endian architectures (such as Solaris),
 where color values get exchanged. I'd need help on this

-one.
+one as I have no BE computer.

 
 Enlightment has struck the majority of the developers and
 they have chosen to use the Linux kernel numbering scheme
 
 Enlightment has struck the majority of the developers and
 they have chosen to use the Linux kernel numbering scheme


@@ -13,13 +13,12 @@ release will be called wxWindows 2.2.X, development snapshots
 will be called 2.1.X.
 
 A lot of discussion has been wasted on how to maintain a
 will be called 2.1.X.
 
 A lot of discussion has been wasted on how to maintain a

-once released stable version will be maintained. It was
-almost universally agreed that only a commercial entity
-will have the motivation ($$$) to do that - so far there
-is no wxWindows Inc.
+once released stable version. It was almost universally 
+agreed that only a commercial entity will have the motivation 
+($$$) to do that - so far there is no wxWindows Inc.

 
 Support for GTK 1.0 has been dropped. This version has
 
 Support for GTK 1.0 has been dropped. This version has

-been tested with GTK 1.2.3 and GTK 1.2.6 - it is known
+been tested with GTK 1.2.3 and GTK 1.2.6 - it might

 not work with some other versions.
 
 Rewritten the support for multiple-format Drag'n'Drop and
 not work with some other versions.
 
 Rewritten the support for multiple-format Drag'n'Drop and

diff --git a/docs/gtk/readme.txt b/docs/gtk/readme.txt
index 62b3bb14449afb9fdb7074e45460380b2b4e38c9..daad1328f97ccec9157f547ec3e8c819956c03c0 100644 (file)
--- a/docs/gtk/readme.txt
+++ b/docs/gtk/readme.txt
@@ -39,26 +39,26 @@ make install
 ldconfig
 exit
 
 ldconfig
 exit
 

-When you run into problems, please read the INSTALL.txt and
+When you run into problems, please read the INSTALL.txt and 

 follow those instructions. If you still don't have any success,
 follow those instructions. If you still don't have any success,

-please send a bug report to one of our mailing lists (see
-my homepage) INCLUDING A DESCRIPTION OF YOUR SYSTEM AND 
-YOUR PROBLEM, SUCH AS YOUR VERSION OF GTK, WXGTK, WHAT
-DISTRIBUTION YOU USE AND WHAT ERROR WAS REPORTED. I know 
-this has no effect, but I tried...
+please send a bug report to one of our mailing list, INCLUDING 
+A DESCRIPTION OF YOUR SYSTEM AND YOUR PROBLEM, SUCH AS YOUR 
+VERSION OF GTK, WXGTK, WHAT DISTRIBUTION YOU USE AND WHAT ERROR 
+WAS REPORTED. I know this has no effect, but I tried...

 
 The library produced by the install process will be called 
 
 The library produced by the install process will be called 

-libwx_gtk.a (static) and libwx_gtk-2.1.so.0.0.0 (shared) so that 
-once a binary incompatible version of wxWindows/Gtk comes out 
-we'll augment the library version number to avoid linking problems.
+libwx_gtk.a (static) and libwx_gtk-2.1.so.11.0.0 (shared) so 
+that once a binary incompatible version of wxWindows/Gtk comes 
+out we'll augment the library version number to avoid linking 
+problems.

 
 Please send problems concerning installation, feature requests, 
 bug reports or comments to the wxWindows users list. Information 
 on how to subscribe is available from my homepage.
 
 
 Please send problems concerning installation, feature requests, 
 bug reports or comments to the wxWindows users list. Information 
 on how to subscribe is available from my homepage.
 

-wxWindows/Gtk doesn't come with any guarantee whatsoever. It might 
-crash your harddisk or destroy your monitor. It doesn't claim to be
-suitable for any special or general purpose.
+wxWindows/Gtk doesn't come with any guarantee whatsoever. It 
+might crash your harddisk or destroy your monitor. It doesn't 
+claim to be suitable for any special or general purpose.

 
   Regards,
 
 
   Regards,
 

diff --git a/docs/latex/wx/clipbrd.tex b/docs/latex/wx/clipbrd.tex
index e9b3352026004c561a4a2df21fde406d9c7e90ca..caa772f53bde12097d370f83b3b446437e9427d5 100644 (file)
--- a/docs/latex/wx/clipbrd.tex
+++ b/docs/latex/wx/clipbrd.tex
@@ -6,8 +6,8 @@ clipboard class from wxWindows 1.xx, which has the same name but a different imp
 To use the clipboard, you call member functions of the global {\bf wxTheClipboard} object.
 
 Call \helpref{wxClipboard::Open}{wxclipboardopen} to get ownership of the clipboard. If this operation returns TRUE, you
 To use the clipboard, you call member functions of the global {\bf wxTheClipboard} object.
 
 Call \helpref{wxClipboard::Open}{wxclipboardopen} to get ownership of the clipboard. If this operation returns TRUE, you

-now own the clipboard. Call \helpref{wxClipboard::AddData}{wxclipboardadddata} to put data
-on the clipboard (one or more times), or \helpref{wxClipboard::GetData}{wxclipboardgetdata} to
+now own the clipboard. Call \helpref{wxClipboard::SetData}{wxclipboardsetdata} to put data
+on the clipboard, or \helpref{wxClipboard::GetData}{wxclipboardgetdata} to

 retrieve data from the clipboard. Call \helpref{wxClipboard::Close}{wxclipboardclose} to close
 the clipboard and relinquish ownership. You should keep the clipboard open only momentarily.
 
 retrieve data from the clipboard. Call \helpref{wxClipboard::Close}{wxclipboardclose} to close
 the clipboard and relinquish ownership. You should keep the clipboard open only momentarily.
 


@@ -26,10 +26,10 @@ For example:
   // Read some text
   if (wxTheClipboard->Open())
   {
   // Read some text
   if (wxTheClipboard->Open())
   {

-    if (wxTheClipboard->IsSupported( "STRING" ))
+    if (wxTheClipboard->IsSupported( wxDF_TEXT ))

     {
       wxTextDataObject data;
     {
       wxTextDataObject data;

-      wxTheClipboard->GetData( &data );
+      wxTheClipboard->GetData( data );

       wxMessageBox( data.GetText() );
     }  
     wxTheClipboard->Close();
       wxMessageBox( data.GetText() );
     }  
     wxTheClipboard->Close();


@@ -62,13 +62,6 @@ Constructor.
 
 Destructor.
 
 
 Destructor.
 

-\membersection{wxClipboard::AddData}\label{wxclipboardadddata}
-
-\func{bool}{AddData}{\param{wxDataObject*}{ data}}
-
-Call this function to add a data object to the clipboard. This function can be called several times
-to put different formats on the clipboard.
-

 \membersection{wxClipboard::Clear}\label{wxclipboardclear}
 
 \func{void}{Clear}{\void}
 \membersection{wxClipboard::Clear}\label{wxclipboardclear}
 
 \func{void}{Clear}{\void}


@@ -83,14 +76,14 @@ Call this function to close the clipboard, having opened it with \helpref{wxClip
 
 \membersection{wxClipboard::GetData}\label{wxclipboardgetdata}
 
 
 \membersection{wxClipboard::GetData}\label{wxclipboardgetdata}
 

-\func{bool}{GetData}{\param{wxDataObject*}{ data}}
+\func{bool}{GetData}{\param{wxDataObject\&}{ data}}

 
 Call this function to fill {\it data} with data on the clipboard, if available in the required
 format. Returns TRUE on success.
 
 \membersection{wxClipboard::IsSupported}\label{wxclipboardissupported}
 
 
 Call this function to fill {\it data} with data on the clipboard, if available in the required
 format. Returns TRUE on success.
 
 \membersection{wxClipboard::IsSupported}\label{wxclipboardissupported}
 

-\func{bool}{IsSupported}{\param{wxDataFormat}{ format}}
+\func{bool}{IsSupported}{\param{const wxDataFormat\&}{ format}}

 
 Returns TRUE if the format of the given data object is available on the clipboard.
 
 
 Returns TRUE if the format of the given data object is available on the clipboard.
 

diff --git a/docs/latex/wx/dataobj.tex b/docs/latex/wx/dataobj.tex
index b691ce1c0d081e7c23df07c8645a53c95a6e7f2a..024b7a2de8513bbeb608eb0ff532cec8a5b2182e 100644 (file)
--- a/docs/latex/wx/dataobj.tex
+++ b/docs/latex/wx/dataobj.tex
@@ -1,44 +1,35 @@
 \section{\class{wxDataObject}}\label{wxdataobject}
 
 A wxDataObject represents data that can be copied to or from the clipboard, or
 \section{\class{wxDataObject}}\label{wxdataobject}
 
 A wxDataObject represents data that can be copied to or from the clipboard, or

-dragged and dropped.
+dragged and dropped. There are two classes directly derived from wxDataObject:
+wxDataObjectSimple and wxDataObjectComposite. As you will guess, wxDataObjectSimple
+holds data for a single format (such as HTML or text) and wxDataObjectComposite
+can hold any number of wxDataObjectSimple classes. Please note that this is an
+easy way to use Drag'n'Drop and the clipboard with multiple formats, but not the
+most efficient one as each wxDataObjectSimple would contain the whole data in its
+respective formars. Now imagine that you want to paste 200 pages of text in your
+proprietary format, as well as Word, RTF, HTML, Unicode and plain text to the
+clipboard and even today's computers are in trouble. For this case, you will have
+to derive from wxDataObject directly and make it enumerate its formats and provide
+the data in the requested format on demand.
+
+Note that neither the GTK data transfer mechanisms for the clipboard and Drag'n'Drop
+nor the OLE data transfer copies any data until another application actually
+requests the data. This is in contrast to the "feel" offered to the user of a
+program who would normally think that the data resides in the clipboard after
+having pressed "Copy" - in reality it is only declared to be available.

 
 

-There are several predefined data object classes, such as \helpref{wxFileDataObject}{wxfiledataobject}, 
-\helpref{wxTextDataObject}{wxtextdataobject}, and \helpref{wxBitmapDataObject}{wxbitmapdataobject} which
-can be used without change or can be altered (by deriving a new class from them) in order to deliver
-data and data size on-demand. There is no need to ever use wxDataObject itself or derive directly from it.
+There are several predefined data object classes derived from wxDataObjectSimple:
+\helpref{wxFileDataObject}{wxfiledataobject}, \helpref{wxTextDataObject}{wxtextdataobject} 
+and \helpref{wxBitmapDataObject}{wxbitmapdataobject} which can be used without change.

 
 

-You may also derive your own data object classes from \helpref{wxPrivateDataObject}{wxprivatedataobject} 
+You may also derive your own data object classes from \helpref{wxCustomDataObject}{wxprivatedataobject} 

 for user-defined types. The format of user-defined data is given as mime-type string literal, 
 such as "application/word" or "image/png". These strings are used as they are under Unix (so 
 far only GTK) to identify a format and are translated into their Windows equivalent under 
 Win32 (using the OLE IDataObject for data exchange to and from the clipboard and for Drag'n'Drop).
 Note that the format string translation under Windows is not yet finnished.
 
 for user-defined types. The format of user-defined data is given as mime-type string literal, 
 such as "application/word" or "image/png". These strings are used as they are under Unix (so 
 far only GTK) to identify a format and are translated into their Windows equivalent under 
 Win32 (using the OLE IDataObject for data exchange to and from the clipboard and for Drag'n'Drop).
 Note that the format string translation under Windows is not yet finnished.
 

-As mentioned above, data may be placed into the \helpref{wxClipboard}{wxclipboard} 
-or a \helpref{wxDropSource}{wxdropsource} instance either directly or on-demand. 
-As long as only one format is offerred, putting data directly into the clipboard may 
-be sufficient. But imagine that you paste a large piece of text to the clipboard and 
-offer it in "text/plain", "text/rtf", "text/html", "application/word" and your own 
-format for internal use - here offering data on-demand is required to minimize memory 
-consumption. This would generally get implemented using a central object that
-contains clipboard information in the format with the maximum of information. Note
-that neither the GTK data transfer mechanisms for the clipboard and Drag'n'Drop
-nor the OLE data transfer copies any data until another application actually
-requests the data. This is in contrast to the "feel" offered to the user of a
-program who would normally think that the data resides in the clipboard after
-having pressed "Copy" - in reality it is only declared to be available.
-
-Let's assume that you have written an HTML editor and want it to paste contents
-in the formats "text/plain" and "text/html" to the clipboard. For offering
-data on-demand in "text/plain" you would derive your class from \helpref{wxTextDataObject}{wxtextdataobject} 
-and for offering data on-demand in "text/html" you would derive your own class from 
-\helpref{wxPrivateDataObject}{wxprivatedataobject} and set its ID string
-identifying the format to "text/html" using \helpref{wxPrivateDataObject::SetId}{wxprivatedataobjectsetid}. 
-In your two derived classed you'd then have a pointer or reference to the central
-data container and you'd override the methods returning the size of the
-available data and the WriteData() methods in both classes.
-

 \wxheading{Derived from}
 
 \helpref{wxObject}{wxobject}
 \wxheading{Derived from}
 
 \helpref{wxObject}{wxobject}


@@ -71,18 +62,34 @@ Constructor.
 
 Destructor.
 
 
 Destructor.
 

-\membersection{wxDataObject::WriteData}\label{wxdataobjectwritedata}
+\membersection{wxDataObject::GetFormatCount}\label{wxdataobjectgetformatcount}
+
+\constfunc{virtual size_t}{GetFormatCount}{\void}
+
+Return the number of available formats.
+
+\membersection{wxDataObject::GetDataHere}\label{wxdataobjectgetdatahere}
+
+\constfunc{virtual bool}{GetDataHere}{\param{const wxDataFormat\&}{ format}, \param{void}{*buf} }
+
+The method will write the data of the format {\it format} in the buffer {\it buf}.
+
+\membersection{wxDataObject::GetDataSize}\label{wxdataobjectgetdatasize}
+
+\constfunc{virtual size\_t}{GetDataSize}{\param{const wxDataFormat\&}{ format} }
+
+Returns the data size of the given format {\it format}.
+
+\membersection{wxDataObject::GetPreferredFormat}\label{wxdataobjectgetpreferredformat}

 
 

-\constfunc{virtual void}{WriteData}{\param{void}{*dest} }
+\constfunc{virtual wxDataFormat}{GetPreferredFormat}{\void}

 
 

-Write the data owned by this class to {\it dest}. This method is a pure
-virtual function and must be overridden.
+Returns the preferred format. Usually the first format in the list of available formats.

 
 

-\membersection{wxDataObject::GetSize}\label{wxdataobjectgetdatasize}
+\membersection{wxDataObject::SetData}\label{wxdataobjectsetdata}

 
 

-\constfunc{virtual size\_t}{GetSize}{\void}
+\func{virtual bool}{SetData}{\param{const wxDataFormat\&}{ format}, \param{size_t}{ len}, \param{const void}{*buf} }

 
 

-Returns the data size. This method is a pure
-virtual function and must be overridden.
+Set the data of the format {\it format} and the size {\it len} provided in the buffer {\it buf}.

 
 
 
 

diff --git a/docs/latex/wx/dropsrc.tex b/docs/latex/wx/dropsrc.tex
index 2fc43ea65b2202c4eda239e964ad5009d336eb41..f25dff189895462fc47e71a076a68b55b270bdaf 100644 (file)
--- a/docs/latex/wx/dropsrc.tex
+++ b/docs/latex/wx/dropsrc.tex
@@ -44,14 +44,6 @@ call \helpref{wxDropSource::SetData}{wxdropsourcesetdata} later.
 
 {\it win} is required by wxGTK and therefore should always be set.
 
 
 {\it win} is required by wxGTK and therefore should always be set.
 

-\func{}{wxDropSource}{\param{wxDataObject\& }{data}, \param{wxWindow*}{ win = NULL}}
-
-\wxheading{Parameters}
-
-\docparam{data}{A reference to the \helpref{data object}{wxdataobject} associated with the drop source.}
-
-\docparam{win}{Only used by wxGTK. TODO}
-

 \membersection{wxDropSource::\destruct{wxDropSource}}\label{wxdropsourcedtor}
 
 \func{virtual }{\destruct{wxDropSource}}{\void}
 \membersection{wxDropSource::\destruct{wxDropSource}}\label{wxdropsourcedtor}
 
 \func{virtual }{\destruct{wxDropSource}}{\void}


@@ -64,16 +56,15 @@ Sets the data \helpref{data object}{wxdataobject} associated with the drop sourc
 
 \membersection{wxDropSource::DoDragDrop}\label{wxdropsourcedodragdrop}
 
 
 \membersection{wxDropSource::DoDragDrop}\label{wxdropsourcedodragdrop}
 

-\func{virtual wxDragResult}{DoDragDrop}{\param{bool }{bAllowMove = FALSE}}
+\func{virtual wxDragResult}{DoDragDrop}{\param{bool }{allowMove = FALSE}}

 
 Do it (call this in response to a mouse button press, for example).
 
 
 Do it (call this in response to a mouse button press, for example).
 

-If {\bf bAllowMove} is FALSE, data can only be copied. Under GTK, data
-is always copied.
+If {\bf allowMove} is FALSE, data can only be copied.

 
 \membersection{wxDropSource::GiveFeedback}\label{wxdropsourcegivefeedback}
 
 
 \membersection{wxDropSource::GiveFeedback}\label{wxdropsourcegivefeedback}
 

-\func{virtual bool}{GiveFeedback}{\param{wxDragResult }{effect}, \param{bool }{bScrolling}}
+\func{virtual bool}{GiveFeedback}{\param{wxDragResult }{effect}, \param{bool }{scrolling}}

 
 Overridable: you may give some custom UI feedback during the drag and drop operation
 in this function. It is called on each mouse move, so your implementation must not be too
 
 Overridable: you may give some custom UI feedback during the drag and drop operation
 in this function. It is called on each mouse move, so your implementation must not be too


@@ -81,12 +72,12 @@ slow.
 
 \wxheading{Parameters}
 
 
 \wxheading{Parameters}
 

-\docparam{effect}{The effect to implement. One of wxDragCopy, wxDragMove. MSW only. }
+\docparam{effect}{The effect to implement. One of wxDragCopy, wxDragMove and wxDragNone. }

 
 

-\docparam{bScrolling}{TRUE if the window is scrolling. MSW only. }
+\docparam{scrolling}{TRUE if the window is scrolling. MSW only. }

 
 \wxheading{Return value}
 
 Return FALSE if you want default feedback, or TRUE if you implement your own
 
 \wxheading{Return value}
 
 Return FALSE if you want default feedback, or TRUE if you implement your own

-feedback.
+feedback. The return values is ignored under GTK.

 
 

diff --git a/docs/latex/wx/function.tex b/docs/latex/wx/function.tex
index 0bf399b0797e1483acf7181b380f663f502c596e..66b72d8a8c7fd4cbb983dc8a716d999046e8778b 100644 (file)
--- a/docs/latex/wx/function.tex
+++ b/docs/latex/wx/function.tex
@@ -87,7 +87,7 @@ Returns the Windows directory under Windows; on other platforms returns the empt
 
 Adds some common image format handlers, which, depending on wxWindows
 configuration, can be handlers for BMP (loading) (always installed), GIF
 
 Adds some common image format handlers, which, depending on wxWindows
 configuration, can be handlers for BMP (loading) (always installed), GIF

-(loading and saving), PCX (loading and saving), PNM (loading and saving as raw
+(loading), PCX (loading), PNM (loading and saving as raw

 rgb), PNG (loading and saving), JPEG (loading and saving), file formats.
 
 See also: \helpref{wxImage}{wximage} \helpref{wxImageHandler}{wximagehandler}
 rgb), PNG (loading and saving), JPEG (loading and saving), file formats.
 
 See also: \helpref{wxImage}{wximage} \helpref{wxImageHandler}{wximagehandler}

diff --git a/docs/latex/wx/image.tex b/docs/latex/wx/image.tex
index d6befa064b9f46fe3fa791458f546acbcaff359b..1366f12d048a6e10ae4608ddf77b59376b6631c9 100644 (file)
--- a/docs/latex/wx/image.tex
+++ b/docs/latex/wx/image.tex
@@ -259,6 +259,13 @@ Gets the green value of the mask colour.
 
 Gets the red value of the mask colour.
 
 
 Gets the red value of the mask colour.
 

+\membersection{wxImage::GetSubImage}\label{wximagegetsubimage}
+
+\constfunc{wxImage}{GetSubImage}{\param{const wxRect&}{rect}}
+
+Returns a sub image of the current one as long as the rect belongs entirely to 
+the image.
+

 \membersection{wxImage::GetWidth}\label{wximagegetwidth}
 
 \constfunc{int}{GetWidth}{\void}
 \membersection{wxImage::GetWidth}\label{wximagegetwidth}
 
 \constfunc{int}{GetWidth}{\void}


@@ -458,8 +465,8 @@ Returns a scaled version of the image. This is also useful for
 scaling bitmaps in general as the only other way to scale bitmaps
 is to blit a wxMemoryDC into another wxMemoryDC.
 
 scaling bitmaps in general as the only other way to scale bitmaps
 is to blit a wxMemoryDC into another wxMemoryDC.
 

-NB: although Windows can do such scaling itself but in the GTK port, scaling
-bitmaps is done using this routine internally.
+It may be mentioned that the GTK post uses this function internally
+to scale bitmaps when using mapping mode in wxDC. 

 
 Example:
 
 
 Example:
 


@@ -484,13 +491,6 @@ Example:
 
 \helpref{Rescale}{wximagerescale}
 
 
 \helpref{Rescale}{wximagerescale}
 

-\membersection{wxImage::GetSubImage}\label{wximagegetsubimage}
-
-\constfunc{wxImage}{GetSubImage}{\param{const wxRect&}{rect}}
-
-Returns a sub image of the current one as long as the rect belongs entirely to 
-the image.
-

 \membersection{wxImage::SetData}\label{wximagesetdata}
 
 \func{void}{SetData}{\param{unsigned char*}{data}}
 \membersection{wxImage::SetData}\label{wximagesetdata}
 
 \func{void}{SetData}{\param{unsigned char*}{data}}

diff --git a/docs/latex/wx/menu.tex b/docs/latex/wx/menu.tex
index 62e1684990a6cd020c415056695ccd2305b9250d..43654ca559af9c74cdf9c06a3e8dbba5e5fc5294 100644 (file)
--- a/docs/latex/wx/menu.tex
+++ b/docs/latex/wx/menu.tex
@@ -170,6 +170,24 @@ Checks or unchecks the menu item.
 
 \helpref{wxMenu::IsChecked}{wxmenuischecked}
 
 
 \helpref{wxMenu::IsChecked}{wxmenuischecked}
 

+\membersection{wxMenu::Delete}\label{wxmenudelete}
+
+\func{void}{Delete}{\param{int }{id}}
+
+Deletes the menu item from the menu.
+
+\wxheading{Parameters}
+
+\docparam{id}{Menu item to be deleted.}
+
+\wxheading{Remarks}
+
+Does not delete a sub menu, if any.
+
+\wxheading{See also}
+
+\helpref{wxMenu::FindItemForId}{wxmenufinditemforid}
+

 \membersection{wxMenu::Enable}\label{wxmenuenable}
 
 \func{void}{Enable}{\param{int}{ id}, \param{const bool}{ enable}}
 \membersection{wxMenu::Enable}\label{wxmenuenable}
 
 \func{void}{Enable}{\param{int}{ id}, \param{const bool}{ enable}}


@@ -198,7 +216,7 @@ Finds the menu item id for a menu item string.
 
 \wxheading{Return value}
 
 
 \wxheading{Return value}
 

-Menu item identifier, or -1 if none is found.
+Menu item identifier, or wxNOT_FOUND if none is found.

 
 \wxheading{Remarks}
 
 
 \wxheading{Remarks}
 


@@ -211,14 +229,14 @@ before matching.
 
 \membersection{wxMenu::FindItemForId}\label{wxmenufinditemforid}
 
 
 \membersection{wxMenu::FindItemForId}\label{wxmenufinditemforid}
 

-\constfunc{wxMenuItem*}{FindItemForId}{\param{int}{ id}, \param{wxMenu **}{ menuForItem = NULL}}
+\constfunc{wxMenuItem*}{FindItemForId}{\param{int}{ id}}
+\constfunc{wxMenuItem*}{FindItem}{\param{int}{ id}}

 
 Finds the menu item object associated with the given menu item identifier.
 
 \wxheading{Parameters}
 
 \docparam{id}{Menu item identifier.}
 
 Finds the menu item object associated with the given menu item identifier.
 
 \wxheading{Parameters}
 
 \docparam{id}{Menu item identifier.}

-\docparam{menuForItem}{will be filled with the menu for this item if not NULL.}

 
 \wxheading{Return value}
 
 
 \wxheading{Return value}
 


@@ -515,22 +533,23 @@ Finds the menu item id for a menu name/menu item string pair.
 
 \wxheading{Return value}
 
 
 \wxheading{Return value}
 

-The menu item identifier, or -1 if none was found.
+The menu item identifier, or wxNOT_FOUND if none was found.

 
 \wxheading{Remarks}
 
 Any special menu codes are stripped out of source and target strings
 before matching.
 
 
 \wxheading{Remarks}
 
 Any special menu codes are stripped out of source and target strings
 before matching.
 

-\membersection{wxMenuBar::FindItemForId}\label{wxmenubarfinditemforid}
+\membersection{wxMenuBar::FindItem}\label{wxmenubarfinditem}

 
 

-\constfunc{wxMenuItem *}{FindItemForId}{\param{int}{ id}}
+\constfunc{wxMenuItem *}{FindItem}{\param{int}{ id}, \param{wxMenu}{ **menu = NULL}

 
 

-Finds the menu item object associated with the given menu item identifier,
+Finds the menu item object associated with the given menu item identifier.

 
 \wxheading{Parameters}
 
 \docparam{id}{Menu item identifier.}
 
 \wxheading{Parameters}
 
 \docparam{id}{Menu item identifier.}

+\docparam{menu}{If not NULL, menu will get set to the associated menu.}

 
 \wxheading{Return value}
 
 
 \wxheading{Return value}
 

diff --git a/docs/latex/wx/sizer.tex b/docs/latex/wx/sizer.tex
index c588beb1eba792eef4b4d5ac0481088f5f3e278f..c279758e8db444561f8b92d1758b115b3540c8c3 100644 (file)
--- a/docs/latex/wx/sizer.tex
+++ b/docs/latex/wx/sizer.tex
@@ -77,7 +77,7 @@ to indicate if a child of a sizer can change its size in the main orientation of
 0 stands for not changable and a value of more than zero in interpreted relative to the value of other
 children of the same wxBoxSizer. You might, e.g., have a horizontal wxBoxSizer with three children, two
 of which are supposed to change their size with the sizer, then the two stretchable windows would get a
 0 stands for not changable and a value of more than zero in interpreted relative to the value of other
 children of the same wxBoxSizer. You might, e.g., have a horizontal wxBoxSizer with three children, two
 of which are supposed to change their size with the sizer, then the two stretchable windows would get a

-value of 1 each to make them grow and shrink equally with the sizer's vertical dimension.}
+value of 1 each to make them grow and shrink equally with the sizer's horizontal dimension.}

 
 \docparam{flag}{This parameter can be used to set a number of flags which can be combined using
 the binary OR operator |. Two main behaviours are defined using these flags: One is the border
 
 \docparam{flag}{This parameter can be used to set a number of flags which can be combined using
 the binary OR operator |. Two main behaviours are defined using these flags: One is the border


@@ -89,7 +89,7 @@ if you created a wxBoxSizer with the wxVERTICAL option, these flags will be rele
 sizer changes its horizontal size. A child may get resized to completely fill out the new size (using
 either wxGROW or wxEXPAND), may get centered (wxCENTER or wxCENTRE) or may get aligned to either
 side (wxALIGN\_LEFT and wxALIGN\_TOP are set to 0 and thus represent the default, wxALIGN\_RIGHT and
 sizer changes its horizontal size. A child may get resized to completely fill out the new size (using
 either wxGROW or wxEXPAND), may get centered (wxCENTER or wxCENTRE) or may get aligned to either
 side (wxALIGN\_LEFT and wxALIGN\_TOP are set to 0 and thus represent the default, wxALIGN\_RIGHT and

-wxALIGN\_BOTTOM have their obvious meaning.}
+wxALIGN\_BOTTOM have their obvious meaning).}

 
 \docparam{border}{Determines the border width, if the {\it flag} parameter is set to any border.}
 
 
 \docparam{border}{Determines the border width, if the {\it flag} parameter is set to any border.}
 

diff --git a/src/gtk/dnd.cpp b/src/gtk/dnd.cpp
index 4349abe3486bcc338cfc6993a3df4f1faefdb77e..fec847be174843dddcc5731b5717f2cafeb2b8de 100644 (file)
--- a/src/gtk/dnd.cpp
+++ b/src/gtk/dnd.cpp
@@ -711,7 +711,7 @@ void wxDropSource::PrepareIcon( int hot_x, int hot_y, GdkDragContext *context )
     gtk_drag_set_icon_widget( context, m_iconWindow, hot_x, hot_y );
 }
 
     gtk_drag_set_icon_widget( context, m_iconWindow, hot_x, hot_y );
 }
 

-wxDragResult wxDropSource::DoDragDrop( bool WXUNUSED(bAllowMove) )
+wxDragResult wxDropSource::DoDragDrop( bool allowMove )

 {
     wxASSERT_MSG( m_data, wxT("wxDragSource: no data") );
 
 {
     wxASSERT_MSG( m_data, wxT("wxDragSource: no data") );
 


@@ -764,9 +764,11 @@ wxDragResult wxDropSource::DoDragDrop( bool WXUNUSED(bAllowMove) )
     /* don't start dragging if no button is down */
     if (button_number)
     {
     /* don't start dragging if no button is down */
     if (button_number)
     {

+        GdkDragAction action = GDK_ACTION_COPY;
+       if (allowMove) action = (GdkDragAction)(GDK_ACTION_MOVE|GDK_ACTION_COPY);

         GdkDragContext *context = gtk_drag_begin( m_widget,
                                               target_list,
         GdkDragContext *context = gtk_drag_begin( m_widget,
                                               target_list,

-                                              (GdkDragAction)(GDK_ACTION_COPY|GDK_ACTION_MOVE),
+                                             action,

                                               button_number,  /* number of mouse button which started drag */
                                               (GdkEvent*) &event );
 
                                               button_number,  /* number of mouse button which started drag */
                                               (GdkEvent*) &event );
 

diff --git a/src/gtk1/dnd.cpp b/src/gtk1/dnd.cpp
index 4349abe3486bcc338cfc6993a3df4f1faefdb77e..fec847be174843dddcc5731b5717f2cafeb2b8de 100644 (file)
--- a/src/gtk1/dnd.cpp
+++ b/src/gtk1/dnd.cpp
@@ -711,7 +711,7 @@ void wxDropSource::PrepareIcon( int hot_x, int hot_y, GdkDragContext *context )
     gtk_drag_set_icon_widget( context, m_iconWindow, hot_x, hot_y );
 }
 
     gtk_drag_set_icon_widget( context, m_iconWindow, hot_x, hot_y );
 }
 

-wxDragResult wxDropSource::DoDragDrop( bool WXUNUSED(bAllowMove) )
+wxDragResult wxDropSource::DoDragDrop( bool allowMove )

 {
     wxASSERT_MSG( m_data, wxT("wxDragSource: no data") );
 
 {
     wxASSERT_MSG( m_data, wxT("wxDragSource: no data") );
 


@@ -764,9 +764,11 @@ wxDragResult wxDropSource::DoDragDrop( bool WXUNUSED(bAllowMove) )
     /* don't start dragging if no button is down */
     if (button_number)
     {
     /* don't start dragging if no button is down */
     if (button_number)
     {

+        GdkDragAction action = GDK_ACTION_COPY;
+       if (allowMove) action = (GdkDragAction)(GDK_ACTION_MOVE|GDK_ACTION_COPY);

         GdkDragContext *context = gtk_drag_begin( m_widget,
                                               target_list,
         GdkDragContext *context = gtk_drag_begin( m_widget,
                                               target_list,

-                                              (GdkDragAction)(GDK_ACTION_COPY|GDK_ACTION_MOVE),
+                                             action,

                                               button_number,  /* number of mouse button which started drag */
                                               (GdkEvent*) &event );
 
                                               button_number,  /* number of mouse button which started drag */
                                               (GdkEvent*) &event );