Fixed wxScrolledWindow references to properly link (and appropriately changed others to wxScrolled).

Initial reviews of a few d* interface headers in this commit as well.


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53241 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Bryan Petty
2008-04-17 07:06:20 +00:00
parent 7e38638c34
commit f09b568121
18 changed files with 902 additions and 783 deletions

View File

@@ -1,6 +1,6 @@
/////////////////////////////////////////////////////////////////////////////
// Name: datstrm.h
// Purpose: interface of wxDataOutputStream
// Purpose: interface of wxDataInputStream and wxDataOutputStream
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
@@ -10,44 +10,48 @@
@class wxDataOutputStream
@wxheader{datstrm.h}
This class provides functions that write binary data types in a
portable way. Data can be written in either big-endian or little-endian
format, little-endian being the default on all architectures.
This class provides functions that write binary data types in a portable
way. Data can be written in either big-endian or little-endian format,
little-endian being the default on all architectures.
If you want to write data to text files (or streams) use
wxTextOutputStream instead.
If you want to write data to text files (or streams) use wxTextOutputStream
instead.
The operator is overloaded and you can use this class like a standard
C++ iostream. See wxDataInputStream for its
usage and caveats.
See also wxDataInputStream.
The "<<" operator is overloaded and you can use this class like a standard
C++ iostream. See wxDataInputStream for its usage and caveats.
@library{wxbase}
@category{streams}
@see wxDataInputStream
*/
class wxDataOutputStream
{
public:
//@{
/**
)
Constructs a datastream object from an output stream. Only write methods will
be available. The second form is only available in Unicode build of wxWidgets.
Constructs a datastream object from an output stream. Only write
methods will be available.
@param stream
The output stream.
*/
wxDataOutputStream(wxOutputStream& stream);
/**
Constructs a datastream object from an output stream. Only write
methods will be available. This constructor is only available in
Unicode builds of wxWidgets.
@param stream
The output stream.
@param conv
Charset conversion object object used to encoding Unicode
strings before writing them to the stream
in Unicode mode (see WriteString()
documentation for detailed description). Note that you must not destroy
conv before you destroy this wxDataOutputStream instance! It is
recommended to use default value (UTF-8).
Charset conversion object object used to encoding Unicode strings
before writing them to the stream in Unicode mode (see
WriteString() for a detailed description). Note that you must not
destroy @a conv before you destroy this wxDataOutputStream
instance! It is recommended to use the default value (UTF-8).
*/
wxDataOutputStream(wxOutputStream& stream);
wxDataOutputStream(wxOutputStream& stream);
//@}
wxDataOutputStream(wxOutputStream& stream,
const wxMBConv& conv = wxConvAuto());
/**
Destroys the wxDataOutputStream object.
@@ -55,67 +59,74 @@ public:
~wxDataOutputStream();
/**
If @a be_order is @true, all data will be written in big-endian
order, e.g. for reading on a Sparc or from Java-Streams (which
always use big-endian order), otherwise data will be written in
little-endian order.
If @a be_order is @true, all data will be written in big-endian order,
e.g. for reading on a Sparc or from Java-Streams (which always use
big-endian order), otherwise data will be written in little-endian
order.
*/
void BigEndianOrdered(bool be_order);
//@{
/**
Writes an array of 16 bit unsigned integer to the stream. The amount of
16 bit unsigned integer to write is specified with the @a size variable.
Writes the single byte @a i8 to the stream.
*/
void Write16(wxUint16 i16);
void Write16(const wxUint16* buffer, size_t size);
//@}
//@{
/**
Writes an array of 32 bit unsigned integer to the stream. The amount of
32 bit unsigned integer to write is specified with the @a size variable.
*/
void Write32(wxUint32 i32);
void Write32(const wxUint32* buffer, size_t size);
//@}
//@{
/**
Writes an array of 64 bit unsigned integer to the stream. The amount of
64 bit unsigned integer to write is specified with the @a size variable.
*/
void Write64(wxUint64 i64);
void Write64(const wxUint64* buffer, size_t size);
//@}
//@{
void Write8(wxUint8 i8);
/**
Writes an array of bytes to the stream. The amount of bytes to write is
specified with the @a size variable.
*/
void Write8(wxUint8 i8);
void Write8(const wxUint8* buffer, size_t size);
//@}
//@{
/**
Writes the 16 bit unsigned integer @a i16 to the stream.
*/
void Write16(wxUint16 i16);
/**
Writes an array of 16 bit unsigned integer to the stream. The amount of
16 bit unsigned integer to write is specified with the @a size variable.
*/
void Write16(const wxUint16* buffer, size_t size);
/**
Writes the 32 bit unsigned integer @a i32 to the stream.
*/
void Write32(wxUint32 i32);
/**
Writes an array of 32 bit unsigned integer to the stream. The amount of
32 bit unsigned integer to write is specified with the @a size variable.
*/
void Write32(const wxUint32* buffer, size_t size);
/**
Writes the 64 bit unsigned integer @a i64 to the stream.
*/
void Write64(wxUint64 i64);
/**
Writes an array of 64 bit unsigned integer to the stream. The amount of
64 bit unsigned integer to write is specified with the @a size variable.
*/
void Write64(const wxUint64* buffer, size_t size);
/**
Writes the double @a f to the stream using the IEEE format.
*/
void WriteDouble(double f);
/**
Writes an array of double to the stream. The amount of double to write is
specified with the @a size variable.
*/
void WriteDouble(double f);
void WriteDouble(const double* buffer, size_t size);
//@}
/**
Writes @a string to the stream. Actually, this method writes the size of
the string before writing @a string itself.
In ANSI build of wxWidgets, the string is written to the stream in exactly
same way it is represented in memory. In Unicode build, however, the string
is first converted to multibyte representation with @e conv object passed
to stream's constructor (consequently, ANSI application can read data
written by Unicode application, as long as they agree on encoding) and this
representation is written to the stream. UTF-8 is used by default.
Writes @a string to the stream. Actually, this method writes the size
of the string before writing @a string itself.
In ANSI build of wxWidgets, the string is written to the stream in
exactly same way it is represented in memory. In Unicode build,
however, the string is first converted to multibyte representation with
@e conv object passed to stream's constructor (consequently, ANSI
applications can read data written by Unicode application, as long as
they agree on encoding) and this representation is written to the
stream. UTF-8 is used by default.
*/
void WriteString(const wxString& string);
};
@@ -126,61 +137,65 @@ public:
@class wxDataInputStream
@wxheader{datstrm.h}
This class provides functions that read binary data types in a
portable way. Data can be read in either big-endian or little-endian
format, little-endian being the default on all architectures.
This class provides functions that read binary data types in a portable
way. Data can be read in either big-endian or little-endian format,
little-endian being the default on all architectures.
If you want to read data from text files (or streams) use
wxTextInputStream instead.
If you want to read data from text files (or streams) use wxTextInputStream
instead.
The operator is overloaded and you can use this class like a standard C++
iostream.
Note, however, that the arguments are the fixed size types wxUint32, wxInt32 etc
and on a typical 32-bit computer, none of these match to the "long" type
(wxInt32
is defined as signed int on 32-bit architectures) so that you cannot use long.
To avoid
problems (here and elsewhere), make use of the wxInt32, wxUint32, etc types.
The ">>" operator is overloaded and you can use this class like a standard
C++ iostream. Note, however, that the arguments are the fixed size types
wxUint32, wxInt32 etc and on a typical 32-bit computer, none of these match
to the "long" type (wxInt32 is defined as signed int on 32-bit
architectures) so that you cannot use long. To avoid problems (here and
elsewhere), make use of the wxInt32, wxUint32, etc types.
For example:
@code
wxFileInputStream input( "mytext.dat" );
wxDataInputStream store( input );
wxUint8 i1;
float f2;
wxString line;
wxDataInputStream store( input );
wxUint8 i1;
float f2;
wxString line;
store i1; // read a 8 bit integer.
store i1 f2; // read a 8 bit integer followed by float.
store line; // read a text line
store >> i1; // read a 8 bit integer.
store >> i1 >> f2; // read a 8 bit integer followed by float.
store >> line; // read a text line
@endcode
See also wxDataOutputStream.
@library{wxbase}
@category{streams}
@see wxDataOutputStream
*/
class wxDataInputStream
{
public:
//@{
/**
)
Constructs a datastream object from an input stream. Only read methods will
be available. The second form is only available in Unicode build of wxWidgets.
Constructs a datastream object from an input stream. Only read methods
will be available.
@param stream
The input stream.
*/
wxDataInputStream(wxInputStream& stream);
/**
Constructs a datastream object from an input stream. Only read methods
will be available. This constructor is only available in Unicode builds
of wxWidgets.
@param stream
The input stream.
@param conv
Charset conversion object object used to decode strings in Unicode
mode (see ReadString()
documentation for detailed description). Note that you must not destroy
conv before you destroy this wxDataInputStream instance!
mode (see ReadString() for a detailed description). Note that you
must not destroy @a conv before you destroy this wxDataInputStream
instance!
*/
wxDataInputStream(wxInputStream& stream);
wxDataInputStream(wxInputStream& stream);
//@}
wxDataInputStream(wxInputStream& stream,
const wxMBConv& conv = wxConvAuto());
/**
Destroys the wxDataInputStream object.
@@ -188,70 +203,77 @@ public:
~wxDataInputStream();
/**
If @a be_order is @true, all data will be read in big-endian
order, such as written by programs on a big endian architecture
(e.g. Sparc) or written by Java-Streams (which always use
big-endian order).
If @a be_order is @true, all data will be read in big-endian order,
such as written by programs on a big endian architecture (e.g. Sparc)
or written by Java-Streams (which always use big-endian order).
*/
void BigEndianOrdered(bool be_order);
//@{
/**
Reads 16 bit unsigned integers from the stream in a specified buffer. the
amount of 16 bit unsigned integer to read is specified by the @a size variable.
*/
wxUint16 Read16();
void Read16(wxUint16* buffer, size_t size);
//@}
//@{
/**
Reads 32 bit unsigned integers from the stream in a specified buffer. the
amount of
32 bit unsigned integer to read is specified by the @a size variable.
*/
wxUint32 Read32();
void Read32(wxUint32* buffer, size_t size);
//@}
//@{
/**
Reads 64 bit unsigned integers from the stream in a specified buffer. the
amount of
64 bit unsigned integer to read is specified by the @a size variable.
*/
wxUint64 Read64();
void Read64(wxUint64* buffer, size_t size);
//@}
//@{
/**
Reads bytes from the stream in a specified buffer. The amount of
bytes to read is specified by the @a size variable.
Reads a single byte from the stream.
*/
wxUint8 Read8();
void Read8(wxUint8* buffer, size_t size);
//@}
//@{
/**
Reads double data (IEEE encoded) from the stream in a specified buffer. the
amount of
double to read is specified by the @a size variable.
Reads bytes from the stream in a specified buffer. The amount of bytes
to read is specified by the @a size variable.
*/
void Read8(wxUint8* buffer, size_t size);
/**
Reads a 16 bit unsigned integer from the stream.
*/
wxUint16 Read16();
/**
Reads 16 bit unsigned integers from the stream in a specified buffer.
The amount of 16 bit unsigned integers to read is specified by the
@a size variable.
*/
void Read16(wxUint16* buffer, size_t size);
/**
Reads a 32 bit unsigned integer from the stream.
*/
wxUint32 Read32();
/**
Reads 32 bit unsigned integers from the stream in a specified buffer.
The amount of 32 bit unsigned integers to read is specified by the
@a size variable.
*/
void Read32(wxUint32* buffer, size_t size);
/**
Reads a 64 bit unsigned integer from the stream.
*/
wxUint64 Read64();
/**
Reads 64 bit unsigned integers from the stream in a specified buffer.
The amount of 64 bit unsigned integers to read is specified by the
@a size variable.
*/
void Read64(wxUint64* buffer, size_t size);
/**
Reads a double (IEEE encoded) from the stream.
*/
double ReadDouble();
/**
Reads double data (IEEE encoded) from the stream in a specified buffer.
The amount of doubles to read is specified by the @a size variable.
*/
void ReadDouble(double* buffer, size_t size);
//@}
/**
Reads a string from a stream. Actually, this function first reads a long
integer specifying the length of the string (without the last null character)
and then reads the string.
In Unicode build of wxWidgets, the fuction first reads multibyte (char*)
string from the stream and then converts it to Unicode using the @e conv
object passed to constructor and returns the result as wxString. You are
responsible for using the same convertor as when writing the stream.
See also wxDataOutputStream::WriteString.
Reads a string from a stream. Actually, this function first reads a
long integer specifying the length of the string (without the last null
character) and then reads the string.
In Unicode build of wxWidgets, the fuction first reads multibyte
(char*) string from the stream and then converts it to Unicode using
the @e conv object passed to constructor and returns the result as
wxString. You are responsible for using the same convertor as when
writing the stream.
@see wxDataOutputStream::WriteString()
*/
wxString ReadString();
};