SimGroup Class Reference

#include <simSet.h>

Inheritance diagram for SimGroup:

Detailed Description

A group of SimObjects.

A SimGroup is a stricter form of SimSet. SimObjects may only be a member of a single SimGroup at a time.

The SimGroup will automatically enforce the single-group-membership rule.

      // From engine/sim/simPath.cc - getting a pointer to a SimGroup
      SimGroup* pMissionGroup = dynamic_cast<SimGroup*>(Sim::findObject("MissionGroup"));

      // From game/trigger.cc:46 - iterating over a SimObject's group.
      SimObject* trigger = ...;
      SimGroup* pGroup = trigger->getGroup();
      for (SimGroup::iterator itr = pGroup->begin(); itr != pGroup->end(); itr++)
      {
         // do something with *itr
      }

Public Member Functions

~SimGroup ()

virtual void addObject (SimObject *)

Add an object to the group.

void addObject (SimObject *, SimObjectId)

void addObject (SimObject *, const char *name)

virtual void removeObject (SimObject *)

Remove an object from the group.

virtual void onRemove ()

Called when the object is removed from the sim.

virtual SimObject * findObject (const char *name)

Find an object in the group.

bool processArguments (S32 argc, const char **argv)

Process constructor options. (ie, new SimObject(1,2,3)).

DECLARE_CONOBJECT (SimGroup)

Private Types

typedef SimSet Parent

Private Attributes

SimNameDictionary nameDictionary

Friends

class SimManager

class SimObject

Member Typedef Documentation

typedef SimSet SimGroup::Parent [private]

Reimplemented from SimSet.

Reimplemented in GuiTSCtrl, GuiBitmapButtonCtrl, GuiBitmapButtonTextCtrl, GuiButtonBaseCtrl, GuiButtonCtrl, GuiCheckBoxCtrl, GuiIconButtonCtrl, GuiRadioCtrl, GuiToggleButtonCtrl, GuiToolboxButtonCtrl, GuiAutoScrollCtrl, GuiContainer, GuiControlArrayControl, GuiDragAndDropControl, GuiDynamicCtrlArrayControl, GuiFormCtrl, GuiFrameSetCtrl, GuiPaneControl, GuiPanel, GuiRolloutCtrl, GuiScrollCtrl, GuiSplitContainer, GuiStackControl, GuiTabBookCtrl, GuiWindowCtrl, GuiBackgroundCtrl, GuiBitmapCtrl, GuiColorPickerCtrl, GuiConsole, GuiConsoleEditCtrl, GuiConsoleTextCtrl, GuiDirectoryFileListCtrl, GuiDirectoryTreeCtrl, GuiFileTreeCtrl, GuiGameListMenuCtrl, GuiGameListOptionsCtrl, GuiListBoxCtrl, GuiMLTextCtrl, GuiMLTextEditCtrl, GuiPopupTextListCtrl, GuiPopUpMenuCtrl, GuiPopupTextListCtrlEx, GuiPopUpMenuCtrlEx, GuiSliderCtrl, GuiTabPageCtrl, GuiTextCtrl, GuiTextEditCtrl, GuiTextEditSliderCtrl, GuiTextListCtrl, GuiTreeViewCtrl, GuiArrayCtrl, GuiCanvas, GuiControl, GuiScriptNotifyCtrl, DbgFileView, GuiEditCtrl, GuiFilterCtrl, GuiGraphCtrl, GuiInspector, GuiInspectorTypeEnum, GuiInspectorTypeCheckBox, GuiInspectorTypeGuiProfile, GuiInspectorTypeFileName, GuiInspectorTypeColor, GuiInspectorTypeColorI, GuiInspectorTypeColorF, GuiInspectorTypeString, GuiInspectorTypeS32, GuiMenuBackgroundCtrl, GuiSubmenuBackgroundCtrl, GuiMenuTextListCtrl, GuiMenuBar, GuiSeparatorCtrl, GuiInspectorDatablockField, GuiInspectorDynamicField, GuiInspectorDynamicGroup, GuiInspectorField, GuiInspectorGroup, GuiAviBitmapCtrl, GuiMessageVectorCtrl, GuiProgressCtrl, CreatorTree, EditManager, EditTSCtrl, GuiTerrPreviewCtrl, MissionAreaEditor, TerrainEditor, WorldEditor, GuiTheoraCtrl, GuiTickCtrl, GuiAtlasMonitorCtrl, GuiBubbleTextCtrl, GuiInputCtrl, GuiMouseEventCtrl, sgGuiTexTestCtrl, DInputManager, UInputManager, Path, NetConnection, AIClient, AIConnection, GameConnection, GameTSCtrl, and GuiObjectView.

Constructor & Destructor Documentation

SimGroup::~SimGroup ( )

Member Function Documentation

virtual void SimGroup::addObject ( SimObject * ) [virtual]

Add an object to the group.

Reimplemented from SimSet.

Reimplemented in GuiContainer, GuiDynamicCtrlArrayControl, GuiFormCtrl, GuiFrameSetCtrl, GuiRolloutCtrl, GuiScrollCtrl, GuiStackControl, GuiControl, and Path.

void SimGroup::addObject	(	SimObject *	,
		SimObjectId
	)			`[inline]`

void SimGroup::addObject	(	SimObject *	,
		const char *	name
	)			`[inline]`

virtual void SimGroup::removeObject ( SimObject * ) [virtual]

Remove an object from the group.

Reimplemented from SimSet.

Reimplemented in GuiContainer, GuiFrameSetCtrl, GuiRolloutCtrl, GuiStackControl, GuiControl, and Path.

virtual void SimGroup::onRemove ( ) [virtual]

Called when the object is removed from the sim.

Reimplemented from SimSet.

Reimplemented in GuiTSCtrl, GuiTabBookCtrl, GuiTextListCtrl, GuiCanvas, GuiControl, GuiEditCtrl, GuiMessageVectorCtrl, GuiAtlasMonitorCtrl, DInputManager, UInputManager, Path, NetConnection, and GameConnection.

virtual SimObject* SimGroup::findObject ( const char * name ) [virtual]

Find an object in the group.

Reimplemented from SimSet.

bool SimGroup::processArguments	(	S32	argc,
		const char **	argv
	)			`[virtual]`

Process constructor options. (ie, new SimObject(1,2,3)).

Reimplemented from SimObject.

Reimplemented in GuiControl.

SimGroup::DECLARE_CONOBJECT ( SimGroup )

Friends And Related Function Documentation

friend class SimManager [friend]

Reimplemented from SimObject.

friend class SimObject [friend]

Member Data Documentation

SimNameDictionary SimGroup::nameDictionary [private]