removed useless spaces

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@51911 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2008-02-19 13:28:24 +00:00
parent 4411a6b6b5
commit 36c9828f70
71 changed files with 5417 additions and 5409 deletions

View File

@@ -7,18 +7,18 @@
/////////////////////////////////////////////////////////////////////////////
/*!
@page trefcount_overview Reference counting
@ref refcount_overview
@ref refcountequality_overview
@ref refcountdestruct_overview
@ref refcountlist_overview
@ref object_overview
@section refcount Why you shouldn't care about it
Many wxWidgets objects use a technique known as @e reference counting, also known
as @e copy on write (COW).
This means that when an object is assigned to another, no copying really takes place:
@@ -32,9 +32,9 @@
transparently to the class users and that whether an object is shared or not
is not seen from the outside of the class - in any case, the result of any
operation on it is the same.
@section refcountequality Object comparison
The == and != operators of @ref refcountlist_overview
always do a @c deep comparison.
This means that the equality operator will return @true if two objects are
@@ -46,55 +46,55 @@
Also note that if you only need to do a @c shallow comparison between two
#wxObject-derived classes, you should not use the == and != operators
but rather the wxObject::IsSameAs function.
@section refcountdestruct Object destruction
When a COW object destructor is called, it may not delete the data: if it's shared,
the destructor will just decrement the shared data's reference count without destroying it.
Only when the destructor of the last object owning the data is called, the data is really
destroyed. As for all other COW-things, this happens transparently to the class users so
that you shouldn't care about it.
@section refcountlist List of reference-counted wxWidgets classes
The following classes in wxWidgets have efficient (i.e. fast) assignment operators
and copy constructors since they are reference-counted:
#wxAcceleratorTable
#wxAnimation
#wxBitmap
#wxBrush
#wxCursor
#wxFont
#wxIcon
#wxImage
#wxMetafile
#wxPalette
#wxPen
#wxRegion
#wxString
#wxVariant
#wxVariantData
Note that the list above reports the objects which are reference-counted in all ports of
wxWidgets; some ports may use this tecnique also for other classes.
@section wxobjectoverview Make your own reference-counted class
Reference counting can be implemented easily using #wxObject
and #wxObjectRefData classes. Alternatively, you
can also use the #wxObjectDataPtrT template.
@@ -104,18 +104,18 @@
the public interface which will be seen by the user of your class.
You'll probably want to add a function to your class which does the cast from
#wxObjectRefData to your class-specific shared data; e.g.:
@code
MyClassRefData *GetData() const { return wx_static_cast(MyClassRefData*, m_refData); }
@endcode
in fact, all times you'll need to read the data from your wxObject-derived class,
you'll need to call such function.
Very important, all times you need to actually modify the data placed inside your
wxObject-derived class, you must first call the wxObject::UnShare
function to be sure that the modifications won't affect other instances which are
eventually sharing your object's data.
*/