X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4f6aed9c6a21d4bc732579aa564adf4cdb2c9aab..6cbe6d08213d4fa5f9404bd249d93bf0b586e0f5:/docs/latex/wx/array.tex diff --git a/docs/latex/wx/array.tex b/docs/latex/wx/array.tex index e449ca6ad8..8a84b9ad45 100644 --- a/docs/latex/wx/array.tex +++ b/docs/latex/wx/array.tex @@ -125,7 +125,7 @@ WX_DEFINE_SORTED_ARRAY(MyFile *, ArrayOfFiles); \helpref{Container classes overview}{wxcontaineroverview}, \helpref{wxList}{wxlist} -\wxheading{Required headers:} +\wxheading{Include files} for wxArray and wxSortedArray and additionally for wxObjArray. @@ -141,8 +141,10 @@ WX\_DECLARE\_OBJARRAY macros and must be fully declared before you use WX\_DEFINE\_OBJARRAY macro. \helpref{WX\_DEFINE\_ARRAY}{wxdefinearray}\\ +\helpref{WX\_DEFINE\_EXPORTED\_ARRAY}{wxdefinearray}\\ \helpref{WX\_DEFINE\_SORTED\_ARRAY}{wxdefinesortedarray}\\ -\helpref{WX\_DECLARE\_OBJARRAY}{wxdeclareobjarray}\\ +\helpref{WX\_DEFINE\_SORTED\_EXPORTED\_ARRAY}{wxdefinesortedarray}\\ +\helpref{WX\_DECLARE\_EXPORTED\_OBJARRAY}{wxdeclareobjarray}\\ \helpref{WX\_DEFINE\_OBJARRAY}{wxdefineobjarray} \membersection{Constructors and destructors} @@ -220,8 +222,12 @@ does exactly the same as \helpref{Item()}{wxarrayitem} method. \func{}{WX\_DEFINE\_ARRAY}{\param{}{T}, \param{}{name}} +\func{}{WX\_DEFINE\_EXPORTED\_ARRAY}{\param{}{T}, \param{}{name}} + This macro defines a new array class named {\it name} and containing the -elements of type {\it T}. Example: +elements of type {\it T}. The second form is used when compiling DLL +under Windows and array needs to be visible outside the DLL. +Example: \begin{verbatim} WX_DEFINE_ARRAY(int, wxArrayInt); @@ -237,8 +243,14 @@ wxArrayLong and wxArrayPtrVoid. \func{}{WX\_DEFINE\_SORTED\_ARRAY}{\param{}{T}, \param{}{name}} +\func{}{WX\_DEFINE\_SORTED\_EXPORTED\_ARRAY}{\param{}{T}, \param{}{name}} + This macro defines a new sorted array class named {\it name} and containing -the elements of type {\it T}. Example: +the elements of type {\it T}. The second form is used when compiling DLL +under Windows and array needs to be visible outside the DLL. + + +Example: \begin{verbatim} WX_DEFINE_SORTED_ARRAY(int, wxSortedArrayInt); @@ -270,8 +282,13 @@ wxArrayOfMyClass another(CompareMyClassObjects); \func{}{WX\_DECLARE\_OBJARRAY}{\param{}{T}, \param{}{name}} +\func{}{WX\_DECLARE\_EXPORTED\_OBJARRAY}{\param{}{T}, \param{}{name}} + This macro declares a new object array class named {\it name} and containing -the elements of type {\it T}. Example: +the elements of type {\it T}. The second form is used when compiling DLL +under Windows and array needs to be visible outside the DLL. + +Example: \begin{verbatim} class MyClass; @@ -460,6 +477,12 @@ Linear search is used for the wxArray and wxObjArray classes but binary search in the sorted array is used for wxSortedArray (this is why searchFromEnd parameter doesn't make sense for it). +{\bf NB:} even for wxObjArray classes, the operator==() of the elements in the +array is {\bf not} used by this function. It searches exactly the given +element in the array and so will only succeed if this element had been +previously added to the array, but fail even if another, identical, element is +in the array. + \membersection{wxArray::Insert}\label{wxarrayinsert} \func{void}{Insert}{\param{T }{item}, \param{size\_t }{n}}