git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@4136
c3d73ce0-8a6f-49c7-b76d-
6d57e0e08775
\twocolitem{{\bf wxFONTENCODING\_SYSTEM}}{Default system encoding.}
\twocolitem{{\bf wxFONTENCODING\_DEFAULT}}{Default application encoding: this
is the encoding set by calls to
\twocolitem{{\bf wxFONTENCODING\_SYSTEM}}{Default system encoding.}
\twocolitem{{\bf wxFONTENCODING\_DEFAULT}}{Default application encoding: this
is the encoding set by calls to
-\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding} and which may beset to,
+\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding} and which may be set to,
say, KOI8 to create all fonts by default with KOI8 encoding. Initially, the
default application encoding is the same as default system encoding.}
\twocolitem{{\bf wxFONTENCODING\_ISO8859\_1...15}}{ISO8859 encodings.}
say, KOI8 to create all fonts by default with KOI8 encoding. Initially, the
default application encoding is the same as default system encoding.}
\twocolitem{{\bf wxFONTENCODING\_ISO8859\_1...15}}{ISO8859 encodings.}
\helpref{wxFont::SetWeight}{wxfontsetweight}
\helpref{wxFont::SetWeight}{wxfontsetweight}
+\membersection{wxFont::SetDefaultEncoding}\label{wxfontsetdefaultencoding}
+
+\func{static void}{SetDefaultEncoding}{\param{wxFontEncoding }{encoding}}
+
+Sets the default font encoding.
+
\membersection{wxFont::SetFaceName}\label{wxfontsetfacename}
\func{void}{SetFaceName}{\param{const wxString\& }{faceName}}
\membersection{wxFont::SetFaceName}\label{wxfontsetfacename}
\func{void}{SetFaceName}{\param{const wxString\& }{faceName}}
-\membersection{wxBITMAP}\label{wxbitmap}
+\membersection{wxBITMAP}\label{wxbitmapmacro}
\func{}{wxBITMAP}{bitmapName}
\func{}{wxBITMAP}{bitmapName}
-\helpref{Bitmaps and icons overview}{wxbitmapoverview},
-\helpref{wxICON}{wxicon}
+\helpref{Bitmaps and icons overview}{wxbitmapoverview},
+\helpref{wxICON}{wxiconmacro}
\wxheading{Include files}
\wxheading{Include files}
\helpref{RTTI overview}{runtimeclassoverview}
\helpref{RTTI overview}{runtimeclassoverview}
-\membersection{wxICON}\label{wxicon}
+\membersection{wxICON}\label{wxiconmacro}
\func{}{wxICON}{iconName}
\func{}{wxICON}{iconName}
-\helpref{Bitmaps and icons overview}{wxbitmapoverview},
-\helpref{wxBITMAP}{wxbitmap}
+\helpref{Bitmaps and icons overview}{wxbitmapoverview},
+\helpref{wxBITMAP}{wxbitmapmacro}
\wxheading{Include files}
\wxheading{Include files}
\func{bool}{LoadFile}{\param{const wxString\&}{ name}, \param{const wxString\&}{ mimetype}}
Loads an image from a file. If no handler type is provided, the library will
\func{bool}{LoadFile}{\param{const wxString\&}{ name}, \param{const wxString\&}{ mimetype}}
Loads an image from a file. If no handler type is provided, the library will
-try to use wxBITMAP\_TYPE\_BMP or all known handlers previously installed
-through a call to \helpref{wxImage::InitAllHandlers}{wximageinitallhandlers}.
+try to use wxBITMAP\_TYPE\_BMP.
\func{bool}{LoadFile}{\param{wxInputStream\&}{ stream}, \param{long}{ type}}
\func{bool}{LoadFile}{\param{wxInputStream\&}{ stream}, \param{long}{ type}}
-A macro, \helpref{wxICON}{wxicon}, is available which creates an icon using an XPM
+A macro, \helpref{wxICON}{wxiconmacro}, is available which creates an icon using an XPM
on the appropriate platform, or an icon resource on Windows.
\begin{verbatim}
on the appropriate platform, or an icon resource on Windows.
\begin{verbatim}
-There is also a corresponding \helpref{wxBITMAP}{wxbitmap} macro which allows
-to create the bitmaps in much the same way as \helpref{wxICON}{wxicon} creates
+There is also a corresponding \helpref{wxBITMAP}{wxbitmapmacro} macro which allows
+to create the bitmaps in much the same way as \helpref{wxICON}{wxiconmacro} creates
icons. It assumes that bitmaps live in resources under Windows or OS2 and XPM
files under all other platforms (for XPMs, the corresponding file must be
included before this macro is used, of course, and the name of the bitmap
icons. It assumes that bitmaps live in resources under Windows or OS2 and XPM
files under all other platforms (for XPMs, the corresponding file must be
included before this macro is used, of course, and the name of the bitmap
\section{Clipboard and drag and drop overview}\label{wxclipboardonfigoverview}
Classes: \helpref{wxDataObject}{wxdataobject},
\section{Clipboard and drag and drop overview}\label{wxclipboardonfigoverview}
Classes: \helpref{wxDataObject}{wxdataobject},
- \helpref{wxClipboard}{wxclipboard},
- \helpref{wxDataFormat}{wxdataformat},
- \helpref{wxDropSource}{wxdropsource},
- \helpref{wxDropTarget}{wxdroptarget}
+ \helpref{wxClipboard}{wxclipboard},
+ \helpref{wxDataFormat}{wxdataformat},
+ \helpref{wxDropSource}{wxdropsource},
+ \helpref{wxDropTarget}{wxdroptarget}
This overview discusses data transfer through clipboard or drag and drop. In
wxWindows, these two ways to transfer data (either between different
applications or inside one and the same) are very similar which allows to
This overview discusses data transfer through clipboard or drag and drop. In
wxWindows, these two ways to transfer data (either between different
applications or inside one and the same) are very similar which allows to
-implement both of them using almost the same code - or, to say it in other
+implement both of them using almost the same code - or in other
words, if you implement drag and drop support for your application, you get
clipboard support for free and vice versa.
In the heart of both clipboard and drag and drop operations lies the
words, if you implement drag and drop support for your application, you get
clipboard support for free and vice versa.
In the heart of both clipboard and drag and drop operations lies the
-\helpref{wxDataObject}{wxdataobject} class. The objects of this (or, to be
-precise, derived from it) class represent the data which is being carried by
+\helpref{wxDataObject}{wxdataobject} class. The objects of this class (or, to be
+precise, classes derived from it) represent the data which is being carried by
the mouse during drag and drop operation or copied to or pasted from the
the mouse during drag and drop operation or copied to or pasted from the
-clipboard. \helpref{wxDataObject}{wxdataobject} is a "smart" piece of data
-because it knows which \helpref{formats}{wxdataformat} it supports (see
-\helpref{GetFormatCount}{wxdataobjectgetformatcount} and
-\helpref{GetAllFormats}{wxdataobjectgetallformats}) and knows how to render
-itself in any of them (see \helpref{GetDataHere.}{wxdataobjectgetdatahere}).
+clipboard. wxDataObject is a "smart" piece of data
+because it knows which formats it supports (see
+GetFormatCount and GetAllFormats) and knows how to render
+itself in any of them (see GetDataHere).
It can also receive its value from the outside in a format it supports if it
It can also receive its value from the outside in a format it supports if it
-implements \helpref{SetData}{wxdataobjectsetdata} method.
+implements the SetData method.
Both clipboard and drag and drop operations have two sides: the source and
Both clipboard and drag and drop operations have two sides: the source and
-target, the data provider and the data receiver (which may be the same
+target, the data provider and the data receiver. These which may be in the same
application and even the same window when, for example, you drag some text from
application and even the same window when, for example, you drag some text from
-one position to another in a word processor). Let us describe what each of them
+one position to another in a word processor. Let us describe what each of them
should do.
\subsection{The data provider (source) duties}{wxdataobjectsource}
should do.
\subsection{The data provider (source) duties}{wxdataobjectsource}
afterwards and so can be created either on heap or on stack (i.e. as a local
variable).
afterwards and so can be created either on heap or on stack (i.e. as a local
variable).
-Another small difference si that in the case of clipboard operation, the
+Another small difference is that in the case of clipboard operation, the
application usually knows in advance whether it copies or cuts (i.e. copies and
deletes) data - in fact, this usually depends on which menu item the user
chose. But for drag and drop it can only know it after
application usually knows in advance whether it copies or cuts (i.e. copies and
deletes) data - in fact, this usually depends on which menu item the user
chose. But for drag and drop it can only know it after
TRUE}, the data has been successfully transfered to wxDataObject.
{\bf TODO} document drag and drop side when the API is finalised
TRUE}, the data has been successfully transfered to wxDataObject.
{\bf TODO} document drag and drop side when the API is finalised
+% !!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+% Vadim, please remember the new line at the end of each file. Please
+% also remember to compile the .hlp file to check for bad references etc.,
+% before checking in. I have removed references that were unresolved. - JACS
+
Unicode or ANSI strings and which thus makes it unnecessary to ever perform
any convertions in the program).
Unicode or ANSI strings and which thus makes it unnecessary to ever perform
any convertions in the program).
-To get a ANSI string from a wxString, you may use
-\helpref{mb\_str()}{wxstringmbstr} function which always returns an ANSI
+To get a ANSI string from a wxString, you may use the
+mb\_str() function which always returns an ANSI
string (independently of the mode - while the usual
\helpref{c\_str()}{wxstringcstr} returns a pointer to the internal
representation which is either ASCII or Unicode). More rarely used, but still
string (independently of the mode - while the usual
\helpref{c\_str()}{wxstringcstr} returns a pointer to the internal
representation which is either ASCII or Unicode). More rarely used, but still
-useful, is \helpref{wc\_str()}{wxstringwcstr} function which always returns
+useful, is wc\_str() function which always returns
the Unicode string.
% TODO describe fn_str(), wx_str(), wxCharBuf classes, ...
the Unicode string.
% TODO describe fn_str(), wx_str(), wxCharBuf classes, ...
// return TRUE if we support this format in "Get" direction
bool IsSupportedFormat(const wxDataFormat& format) const;
// return TRUE if we support this format in "Get" direction
bool IsSupportedFormat(const wxDataFormat& format) const;
// function to return symbolic name of clipboard format (for debug messages)
static const char *GetFormatName(wxDataFormat format);
// function to return symbolic name of clipboard format (for debug messages)
static const char *GetFormatName(wxDataFormat format);
private:
IDataObject *m_pIDataObject; // pointer to the COM interface
private:
IDataObject *m_pIDataObject; // pointer to the COM interface
const char *wxDataObject::GetFormatName(wxDataFormat format)
{
// case 'xxx' is not a valid value for switch of enum 'wxDataFormat'
const char *wxDataObject::GetFormatName(wxDataFormat format)
{
// case 'xxx' is not a valid value for switch of enum 'wxDataFormat'
#pragma warning(default:4063)
#endif // VC++
}
#pragma warning(default:4063)
#endif // VC++
}
// ----------------------------------------------------------------------------
// wxBitmapDataObject supports CF_DIB format
// ----------------------------------------------------------------------------
// wxBitmapDataObject supports CF_DIB format