?? wxlist.h
字號:
}
CNode *pn = (CNode *) pos;
return (POSITION) pn->Prev();
} //Prev
/* Return the first position in *this which holds the given
pointer. Return NULL if the pointer was not not found.
*/
protected:
POSITION FindI( void * pObj) const;
/* Remove the first node in *this (deletes the pointer to its
object from the list, does not free the object itself).
Return the pointer to its object.
If *this was already empty it will harmlessly return NULL.
*/
void *RemoveHeadI();
/* Remove the last node in *this (deletes the pointer to its
object from the list, does not free the object itself).
Return the pointer to its object.
If *this was already empty it will harmlessly return NULL.
*/
void *RemoveTailI();
/* Remove the node identified by p from the list (deletes the pointer
to its object from the list, does not free the object itself).
Asking to Remove the object at NULL will harmlessly return NULL.
Return the pointer to the object removed.
*/
void *RemoveI(POSITION p);
/* Add single object *pObj to become a new last element of the list.
Return the new tail position, NULL if it fails.
If you are adding a COM objects, you might want AddRef it first.
Other existing POSITIONs in *this are still valid
*/
POSITION AddTailI(void * pObj);
public:
/* Add all the elements in *pList to the tail of *this.
This duplicates all the nodes in *pList (i.e. duplicates
all its pointers to objects). It does not duplicate the objects.
If you are adding a list of pointers to a COM object into the list
it's a good idea to AddRef them all it when you AddTail it.
Return TRUE if it all worked, FALSE if it didn't.
If it fails some elements may have been added.
Existing POSITIONs in *this are still valid
If you actually want to MOVE the elements, use MoveToTail instead.
*/
BOOL AddTail(CBaseList *pList);
/* Mirror images of AddHead: */
/* Add single object to become a new first element of the list.
Return the new head position, NULL if it fails.
Existing POSITIONs in *this are still valid
*/
protected:
POSITION AddHeadI(void * pObj);
public:
/* Add all the elements in *pList to the head of *this.
Same warnings apply as for AddTail.
Return TRUE if it all worked, FALSE if it didn't.
If it fails some of the objects may have been added.
If you actually want to MOVE the elements, use MoveToHead instead.
*/
BOOL AddHead(CBaseList *pList);
/* Add the object *pObj to *this after position p in *this.
AddAfter(NULL,x) adds x to the start - equivalent to AddHead
Return the position of the object added, NULL if it failed.
Existing POSITIONs in *this are undisturbed, including p.
*/
protected:
POSITION AddAfterI(POSITION p, void * pObj);
public:
/* Add the list *pList to *this after position p in *this
AddAfter(NULL,x) adds x to the start - equivalent to AddHead
Return TRUE if it all worked, FALSE if it didn't.
If it fails, some of the objects may be added
Existing POSITIONs in *this are undisturbed, including p.
*/
BOOL AddAfter(POSITION p, CBaseList *pList);
/* Mirror images:
Add the object *pObj to this-List after position p in *this.
AddBefore(NULL,x) adds x to the end - equivalent to AddTail
Return the position of the new object, NULL if it fails
Existing POSITIONs in *this are undisturbed, including p.
*/
protected:
POSITION AddBeforeI(POSITION p, void * pObj);
public:
/* Add the list *pList to *this before position p in *this
AddAfter(NULL,x) adds x to the start - equivalent to AddHead
Return TRUE if it all worked, FALSE if it didn't.
If it fails, some of the objects may be added
Existing POSITIONs in *this are undisturbed, including p.
*/
BOOL AddBefore(POSITION p, CBaseList *pList);
/* Note that AddAfter(p,x) is equivalent to AddBefore(Next(p),x)
even in cases where p is NULL or Next(p) is NULL.
Similarly for mirror images etc.
This may make it easier to argue about programs.
*/
/* The following operations do not copy any elements.
They move existing blocks of elements around by switching pointers.
They are fairly efficient for long lists as for short lists.
(Alas, the Count slows things down).
They split the list into two parts.
One part remains as the original list, the other part
is appended to the second list. There are eight possible
variations:
Split the list {after/before} a given element
keep the {head/tail} portion in the original list
append the rest to the {head/tail} of the new list.
Since After is strictly equivalent to Before Next
we are not in serious need of the Before/After variants.
That leaves only four.
If you are processing a list left to right and dumping
the bits that you have processed into another list as
you go, the Tail/Tail variant gives the most natural result.
If you are processing in reverse order, Head/Head is best.
By using NULL positions and empty lists judiciously either
of the other two can be built up in two operations.
The definition of NULL (see Next/Prev etc) means that
degenerate cases include
"move all elements to new list"
"Split a list into two lists"
"Concatenate two lists"
(and quite a few no-ops)
!!WARNING!! The type checking won't buy you much if you get list
positions muddled up - e.g. use a POSITION that's in a different
list and see what a mess you get!
*/
/* Split *this after position p in *this
Retain as *this the tail portion of the original *this
Add the head portion to the tail end of *pList
Return TRUE if it all worked, FALSE if it didn't.
e.g.
foo->MoveToTail(foo->GetHeadPosition(), bar);
moves one element from the head of foo to the tail of bar
foo->MoveToTail(NULL, bar);
is a no-op, returns NULL
foo->MoveToTail(foo->GetTailPosition, bar);
concatenates foo onto the end of bar and empties foo.
A better, except excessively long name might be
MoveElementsFromHeadThroughPositionToOtherTail
*/
BOOL MoveToTail(POSITION pos, CBaseList *pList);
/* Mirror image:
Split *this before position p in *this.
Retain in *this the head portion of the original *this
Add the tail portion to the start (i.e. head) of *pList
e.g.
foo->MoveToHead(foo->GetTailPosition(), bar);
moves one element from the tail of foo to the head of bar
foo->MoveToHead(NULL, bar);
is a no-op, returns NULL
foo->MoveToHead(foo->GetHeadPosition, bar);
concatenates foo onto the start of bar and empties foo.
*/
BOOL MoveToHead(POSITION pos, CBaseList *pList);
/* Reverse the order of the [pointers to] objects in *this
*/
void Reverse();
/* set cursor to the position of each element of list in turn */
#define TRAVERSELIST(list, cursor) \
for ( cursor = (list).GetHeadPosition() \
; cursor!=NULL \
; cursor = (list).Next(cursor) \
)
/* set cursor to the position of each element of list in turn
in reverse order
*/
#define REVERSETRAVERSELIST(list, cursor) \
for ( cursor = (list).GetTailPosition() \
; cursor!=NULL \
; cursor = (list).Prev(cursor) \
)
}; // end of class declaration
template<class OBJECT> class CGenericList : public CBaseList
{
public:
CGenericList(TCHAR *pName,
INT iItems,
BOOL bLock = TRUE,
BOOL bAlert = FALSE) :
CBaseList(pName, iItems) {
UNREFERENCED_PARAMETER(bAlert);
UNREFERENCED_PARAMETER(bLock);
};
CGenericList(TCHAR *pName) :
CBaseList(pName) {
};
POSITION GetHeadPosition() const { return (POSITION)m_pFirst; }
POSITION GetTailPosition() const { return (POSITION)m_pLast; }
int GetCount() const { return m_Count; }
OBJECT *GetNext(POSITION& rp) const { return (OBJECT *) GetNextI(rp); }
OBJECT *Get(POSITION p) const { return (OBJECT *) GetI(p); }
OBJECT *GetHead() const { return Get(GetHeadPosition()); }
OBJECT *RemoveHead() { return (OBJECT *) RemoveHeadI(); }
OBJECT *RemoveTail() { return (OBJECT *) RemoveTailI(); }
OBJECT *Remove(POSITION p) { return (OBJECT *) RemoveI(p); }
POSITION AddBefore(POSITION p, OBJECT * pObj) { return AddBeforeI(p, pObj); }
POSITION AddAfter(POSITION p, OBJECT * pObj) { return AddAfterI(p, pObj); }
POSITION AddHead(OBJECT * pObj) { return AddHeadI(pObj); }
POSITION AddTail(OBJECT * pObj) { return AddTailI(pObj); }
BOOL AddTail(CGenericList<OBJECT> *pList)
{ return CBaseList::AddTail((CBaseList *) pList); }
BOOL AddHead(CGenericList<OBJECT> *pList)
{ return CBaseList::AddHead((CBaseList *) pList); }
BOOL AddAfter(POSITION p, CGenericList<OBJECT> *pList)
{ return CBaseList::AddAfter(p, (CBaseList *) pList); };
BOOL AddBefore(POSITION p, CGenericList<OBJECT> *pList)
{ return CBaseList::AddBefore(p, (CBaseList *) pList); };
POSITION Find( OBJECT * pObj) const { return FindI(pObj); }
}; // end of class declaration
/* These define the standard list types */
typedef CGenericList<CBaseObject> CBaseObjectList;
typedef CGenericList<IUnknown> CBaseInterfaceList;
#endif /* __WXLIST__ */
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -