a:26:{s:9:"#provides";s:25:"dijit.tree.TreeStoreModel";s:9:"#resource";s:22:"tree/TreeStoreModel.js";s:25:"dijit.tree.TreeStoreModel";a:7:{s:4:"type";s:8:"Function";s:7:"summary";s:46:"Passed the arguments listed above (store, etc)";s:8:"examples";a:1:{i:0;s:14:"

	{id:'ROOT'}";}s:10:"parameters";a:1:{s:4:"args";a:1:{s:4:"type";s:6:"Object";}}s:6:"source";s:579:"			dojo.mixin(this, args);


			this.connects = [];


			var store = this.store;
			if(!store.getFeatures()['dojo.data.api.Identity']){
				throw new Error("dijit.Tree: store must support dojo.data.Identity");
			}


			// if the store supports Notification, subscribe to the notification events
			if(store.getFeatures()['dojo.data.api.Notification']){
				this.connects = this.connects.concat([
					dojo.connect(store, "onNew", this, "_onNewItem"),
					dojo.connect(store, "onDelete", this, "_onDeleteItem"),
					dojo.connect(store, "onSet", this, "_onSetItem")
				]);
			}";s:4:"tags";s:7:"private";s:9:"classlike";b:1;}s:31:"dijit.tree.TreeStoreModel.store";a:3:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:15:"dojo.data.Store";s:7:"summary";s:16:"Underlying store";}s:39:"dijit.tree.TreeStoreModel.childrenAttrs";a:3:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:7:"String[";s:7:"summary";s:96:"One or more attribute names (attributes in the dojo.data item) that specify that item's children";}s:35:"dijit.tree.TreeStoreModel.labelAttr";a:3:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:6:"String";s:7:"summary";s:98:"If specified, get label for tree node from this attribute, rather
than by calling store.getLabel()";}s:30:"dijit.tree.TreeStoreModel.root";a:5:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:8:"instance";s:25:"dijit.tree.TreeStoreModel";s:4:"tags";a:1:{i:0;s:8:"readonly";}s:4:"type";s:14:"dojo.data.Item";s:7:"summary";s:53:"Pointer to the root item (read only, not a parameter)";}s:31:"dijit.tree.TreeStoreModel.query";a:3:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"anything";s:7:"summary";s:148:"Specifies datastore query to return the root item for the tree.
Must only return a single item.   Alternately can just pass in pointer
to root item.";}s:33:"dijit.tree.TreeStoreModel.destroy";a:4:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:6:"source";s:129:"			dojo.forEach(this.connects, dojo.disconnect);
			// TODO: should cancel any in-progress processing of getRoot(), getChildren()";s:7:"summary";s:0:"";}s:33:"dijit.tree.TreeStoreModel.getRoot";a:5:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:6:"onItem";a:1:{s:4:"type";s:0:"";}s:7:"onError";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:449:"			if(this.root){
				onItem(this.root);
			}else{
				this.store.fetch({
					query: this.query,
					onComplete: dojo.hitch(this, function(items){
						if(items.length != 1){
							throw new Error(this.declaredClass + ": query " + dojo.toJson(this.query) + " returned " + items.length +
							 	" items, but must return exactly one item");
						}
						this.root = items[0];
						onItem(this.root);
					}),
					onError: onError
				});
			}";s:7:"summary";s:97:"Calls onItem with the root item for the tree, possibly a fabricated item.
Calls onError on error.";}s:41:"dijit.tree.TreeStoreModel.mayHaveChildren";a:5:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:14:"dojo.data.Item";}}s:6:"source";s:116:"			return dojo.some(this.childrenAttrs, function(attr){
				return this.store.hasAttribute(item, attr);
			}, this);";s:7:"summary";s:264:"Tells if an item has or may have children.  Implementing logic here
avoids showing +/- expando icon for nodes that we know don't have children.
(For efficiency reasons we may not want to check if an element actually
has children until user clicks the expando node)";}s:37:"dijit.tree.TreeStoreModel.getChildren";a:5:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:3:{s:10:"parentItem";a:1:{s:4:"type";s:14:"dojo.data.Item";}s:10:"onComplete";a:1:{s:4:"type";s:15:"function(items)";}s:7:"onError";a:1:{s:4:"type";s:8:"function";}}s:6:"source";s:961:"			var store = this.store;


			// get children of specified item
			var childItems = [];
			for (var i=0; i<this.childrenAttrs.length; i++){
				var vals = store.getValues(parentItem, this.childrenAttrs[i]);
				childItems = childItems.concat(vals);
			}


			// count how many items need to be loaded
			var _waitCount = 0;
			dojo.forEach(childItems, function(item){ if(!store.isItemLoaded(item)){ _waitCount++; } });


			if(_waitCount == 0){
				// all items are already loaded.  proceed...
				onComplete(childItems);
			}else{
				// still waiting for some or all of the items to load
				var onItem = function onItem(item){
					if(--_waitCount == 0){
						// all nodes have been loaded, send them to the tree
						onComplete(childItems);
					}
				}
				dojo.forEach(childItems, function(item){
					if(!store.isItemLoaded(item)){
						store.loadItem({
							item: item,
							onItem: onItem,
							onError: onError
						});
					}
				});
			}";s:7:"summary";s:78:"Calls onComplete() with array of child items of given parent item, all loaded.";}s:37:"dijit.tree.TreeStoreModel.getIdentity";a:6:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:4:"item";}}s:6:"source";s:49:"			return this.store.getIdentity(item);	// Object";s:7:"returns";s:6:"Object";s:7:"summary";s:0:"";}s:34:"dijit.tree.TreeStoreModel.getLabel";a:6:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:14:"dojo.data.Item";}}s:6:"source";s:148:"			if(this.labelAttr){
				return this.store.getValue(item,this.labelAttr);	// String
			}else{
				return this.store.getLabel(item);	// String
			}";s:7:"summary";s:25:"Get the label for an item";s:7:"returns";s:6:"String";}s:33:"dijit.tree.TreeStoreModel.newItem";a:5:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:4:"args";a:2:{s:8:"optional";b:1;s:4:"type";s:6:"Object";}s:6:"parent";a:1:{s:4:"type";s:4:"Item";}}s:6:"source";s:109:"			var pInfo = {parent: parent, attribute: this.childrenAttrs[0]};
			return this.store.newItem(args, pInfo);";s:7:"summary";s:142:"Creates a new item.   See `dojo.data.api.Write` for details on args.
Used in drag &amp; drop when item from external source dropped onto tree.";}s:35:"dijit.tree.TreeStoreModel.pasteItem";a:5:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:5:{s:9:"childItem";a:1:{s:4:"type";s:4:"Item";}s:13:"oldParentItem";a:1:{s:4:"type";s:4:"Item";}s:13:"newParentItem";a:1:{s:4:"type";s:4:"Item";}s:5:"bCopy";a:1:{s:4:"type";s:7:"Boolean";}s:11:"insertIndex";a:2:{s:8:"optional";b:1;s:4:"type";s:3:"int";}}s:6:"source";s:1028:"			var store = this.store,
				parentAttr = this.childrenAttrs[0];	// name of "children" attr in parent item


			// remove child from source item, and record the attributee that child occurred in	
			if(oldParentItem){
				dojo.forEach(this.childrenAttrs, function(attr){
					if(store.containsValue(oldParentItem, attr, childItem)){
						if(!bCopy){
							var values = dojo.filter(store.getValues(oldParentItem, attr), function(x){
								return x != childItem;
							});
							store.setValues(oldParentItem, attr, values);
						}
						parentAttr = attr;
					}
				});
			}


			// modify target item's children attribute to include this item
			if(newParentItem){
				if(typeof insertIndex == "number"){
					var childItems = store.getValues(newParentItem, parentAttr);
					childItems.splice(insertIndex, 0, childItem);
					store.setValues(newParentItem, parentAttr, childItems);
				}else{
				store.setValues(newParentItem, parentAttr,
					store.getValues(newParentItem, parentAttr).concat(childItem));
			}
			}";s:7:"summary";s:77:"Move or copy an item from one parent item to another.
Used in drag &amp; drop";}s:34:"dijit.tree.TreeStoreModel.onChange";a:6:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:14:"dojo.data.Item";}}s:6:"source";s:283:"			// summary:
			//		Callback whenever an item has changed, so that Tree
			//		can update the label, icon, etc.   Note that changes
			//		to an item's children or parent(s) will trigger an
			//		onChildrenChange() so you can ignore those changes here.
			// tags:
			//		callback";s:7:"summary";s:212:"Callback whenever an item has changed, so that Tree
can update the label, icon, etc.   Note that changes
to an item's children or parent(s) will trigger an
onChildrenChange() so you can ignore those changes here.";s:4:"tags";s:8:"callback";}s:42:"dijit.tree.TreeStoreModel.onChildrenChange";a:6:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:6:"parent";a:1:{s:4:"type";s:14:"dojo.data.Item";}s:15:"newChildrenList";a:1:{s:4:"type";s:16:"dojo.data.Item[]";}}s:6:"source";s:116:"			// summary:
			//		Callback to do notifications about new, updated, or deleted items.
			// tags:
			//		callback";s:7:"summary";s:66:"Callback to do notifications about new, updated, or deleted items.";s:4:"tags";s:8:"callback";}s:34:"dijit.tree.TreeStoreModel.onDelete";a:7:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:6:"parent";a:1:{s:4:"type";s:14:"dojo.data.Item";}s:15:"newChildrenList";a:1:{s:4:"type";s:16:"dojo.data.Item[]";}}s:6:"source";s:211:"			// summary:
			//		Callback when an item has been deleted.
			// description:
			//		Note that there will also be an onChildrenChange() callback for the parent
			//		of this item.
			// tags:
			//		callback";s:7:"summary";s:39:"Callback when an item has been deleted.";s:11:"description";s:88:"Note that there will also be an onChildrenChange() callback for the parent
of this item.";s:4:"tags";s:8:"callback";}s:36:"dijit.tree.TreeStoreModel._onNewItem";a:7:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:4:"item";a:1:{s:4:"type";s:14:"dojo.data.Item";}s:10:"parentInfo";a:1:{s:4:"type";s:6:"Object";}}s:6:"source";s:8127:"dojo.provide("dijit.tree.TreeStoreModel");


dojo.declare(
		"dijit.tree.TreeStoreModel",
		null,
	{
		// summary:
		//		Implements dijit.Tree.model connecting to a store with a single
		//		root item.  Any methods passed into the constructor will override
		//		the ones defined here.


		// store: dojo.data.Store
		//		Underlying store
		store: null,


		// childrenAttrs: String[]
		//		One or more attribute names (attributes in the dojo.data item) that specify that item's children
		childrenAttrs: ["children"],


		// labelAttr: String
		//		If specified, get label for tree node from this attribute, rather
		//		than by calling store.getLabel()
		labelAttr: "",

	 
	 	// root: [readonly] dojo.data.Item
		//		Pointer to the root item (read only, not a parameter)
		root: null,


		// query: anything
		//		Specifies datastore query to return the root item for the tree.
		//		Must only return a single item.   Alternately can just pass in pointer
		//		to root item.
		// example:
		//	|	{id:'ROOT'}
		query: null,


		constructor: function(/* Object */ args){
			// summary:
			//		Passed the arguments listed above (store, etc)
			// tags:
			//		private


			dojo.mixin(this, args);


			this.connects = [];


			var store = this.store;
			if(!store.getFeatures()['dojo.data.api.Identity']){
				throw new Error("dijit.Tree: store must support dojo.data.Identity");
			}


			// if the store supports Notification, subscribe to the notification events
			if(store.getFeatures()['dojo.data.api.Notification']){
				this.connects = this.connects.concat([
					dojo.connect(store, "onNew", this, "_onNewItem"),
					dojo.connect(store, "onDelete", this, "_onDeleteItem"),
					dojo.connect(store, "onSet", this, "_onSetItem")
				]);
			}
		},


		destroy: function(){
			dojo.forEach(this.connects, dojo.disconnect);
			// TODO: should cancel any in-progress processing of getRoot(), getChildren()
		},


		// =======================================================================
		// Methods for traversing hierarchy


		getRoot: function(onItem, onError){
			// summary:
			//		Calls onItem with the root item for the tree, possibly a fabricated item.
			//		Calls onError on error.
			if(this.root){
				onItem(this.root);
			}else{
				this.store.fetch({
					query: this.query,
					onComplete: dojo.hitch(this, function(items){
						if(items.length != 1){
							throw new Error(this.declaredClass + ": query " + dojo.toJson(this.query) + " returned " + items.length +
							 	" items, but must return exactly one item");
						}
						this.root = items[0];
						onItem(this.root);
					}),
					onError: onError
				});
			}
		},


		mayHaveChildren: function(/*dojo.data.Item*/ item){
			// summary:
			//		Tells if an item has or may have children.  Implementing logic here
			//		avoids showing +/- expando icon for nodes that we know don't have children.
			//		(For efficiency reasons we may not want to check if an element actually
			//		has children until user clicks the expando node)
			return dojo.some(this.childrenAttrs, function(attr){
				return this.store.hasAttribute(item, attr);
			}, this);
		},


		getChildren: function(/*dojo.data.Item*/ parentItem, /*function(items)*/ onComplete, /*function*/ onError){
			// summary:
			// 		Calls onComplete() with array of child items of given parent item, all loaded.


			var store = this.store;


			// get children of specified item
			var childItems = [];
			for (var i=0; i<this.childrenAttrs.length; i++){
				var vals = store.getValues(parentItem, this.childrenAttrs[i]);
				childItems = childItems.concat(vals);
			}


			// count how many items need to be loaded
			var _waitCount = 0;
			dojo.forEach(childItems, function(item){ if(!store.isItemLoaded(item)){ _waitCount++; } });


			if(_waitCount == 0){
				// all items are already loaded.  proceed...
				onComplete(childItems);
			}else{
				// still waiting for some or all of the items to load
				var onItem = function onItem(item){
					if(--_waitCount == 0){
						// all nodes have been loaded, send them to the tree
						onComplete(childItems);
					}
				}
				dojo.forEach(childItems, function(item){
					if(!store.isItemLoaded(item)){
						store.loadItem({
							item: item,
							onItem: onItem,
							onError: onError
						});
					}
				});
			}
		},


		// =======================================================================
		// Inspecting items


		getIdentity: function(/* item */ item){
			return this.store.getIdentity(item);	// Object
		},


		getLabel: function(/*dojo.data.Item*/ item){
			// summary:
			//		Get the label for an item
			if(this.labelAttr){
				return this.store.getValue(item,this.labelAttr);	// String
			}else{
				return this.store.getLabel(item);	// String
			}
		},


		// =======================================================================
		// Write interface


		newItem: function(/* Object? */ args, /*Item*/ parent){
			// summary:
			//		Creates a new item.   See `dojo.data.api.Write` for details on args.
			//		Used in drag & drop when item from external source dropped onto tree.
			var pInfo = {parent: parent, attribute: this.childrenAttrs[0]};
			return this.store.newItem(args, pInfo);
		},


		pasteItem: function(/*Item*/ childItem, /*Item*/ oldParentItem, /*Item*/ newParentItem, /*Boolean*/ bCopy, /*int?*/ insertIndex){
			// summary:
			//		Move or copy an item from one parent item to another.
			//		Used in drag & drop
			var store = this.store,
				parentAttr = this.childrenAttrs[0];	// name of "children" attr in parent item


			// remove child from source item, and record the attributee that child occurred in	
			if(oldParentItem){
				dojo.forEach(this.childrenAttrs, function(attr){
					if(store.containsValue(oldParentItem, attr, childItem)){
						if(!bCopy){
							var values = dojo.filter(store.getValues(oldParentItem, attr), function(x){
								return x != childItem;
							});
							store.setValues(oldParentItem, attr, values);
						}
						parentAttr = attr;
					}
				});
			}


			// modify target item's children attribute to include this item
			if(newParentItem){
				if(typeof insertIndex == "number"){
					var childItems = store.getValues(newParentItem, parentAttr);
					childItems.splice(insertIndex, 0, childItem);
					store.setValues(newParentItem, parentAttr, childItems);
				}else{
				store.setValues(newParentItem, parentAttr,
					store.getValues(newParentItem, parentAttr).concat(childItem));
			}
			}
		},


		// =======================================================================
		// Callbacks

		
		onChange: function(/*dojo.data.Item*/ item){
			// summary:
			//		Callback whenever an item has changed, so that Tree
			//		can update the label, icon, etc.   Note that changes
			//		to an item's children or parent(s) will trigger an
			//		onChildrenChange() so you can ignore those changes here.
			// tags:
			//		callback
		},


		onChildrenChange: function(/*dojo.data.Item*/ parent, /*dojo.data.Item[]*/ newChildrenList){
			// summary:
			//		Callback to do notifications about new, updated, or deleted items.
			// tags:
			//		callback
		},


		onDelete: function(/*dojo.data.Item*/ parent, /*dojo.data.Item[]*/ newChildrenList){
			// summary:
			//		Callback when an item has been deleted.
			// description:
			//		Note that there will also be an onChildrenChange() callback for the parent
			//		of this item.
			// tags:
			//		callback
		},


		// =======================================================================
		///Events from data store


		_onNewItem: function(/* dojo.data.Item */ item, /* Object */ parentInfo){
			// summary:
			//		Handler for when new items appear in the store.


			//	In this case there's no correspond onSet() call on the parent of this
			//	item, so need to get the new children list of the parent manually somehow.
			if(!parentInfo){
				return;
			}
			this.getChildren(parentInfo.item, dojo.hitch(this, function(children){
				// NOTE: maybe can be optimized since parentInfo contains the new and old attribute value
				this.onChildrenChange(parentInfo.item, children);
			}));";s:7:"returns";s:13:"Object|String";s:7:"private";b:1;s:7:"summary";s:0:"";}s:39:"dijit.tree.TreeStoreModel._onDeleteItem";a:6:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:6:"Object";}}s:6:"source";s:23:"			this.onDelete(item);";s:7:"summary";s:54:"Handler for delete notifications from underlying store";s:7:"private";b:1;}s:36:"dijit.tree.TreeStoreModel._onSetItem";a:6:{s:9:"prototype";s:25:"dijit.tree.TreeStoreModel";s:4:"type";s:8:"Function";s:10:"parameters";a:4:{s:4:"item";a:1:{s:4:"type";s:4:"item";}s:9:"attribute";a:1:{s:4:"type";s:21:"attribute-name-string";}s:8:"oldValue";a:1:{s:4:"type";s:14:"object | array";}s:8:"newValue";a:1:{s:4:"type";s:14:"object | array";}}s:6:"source";s:384:"			if(dojo.indexOf(this.childrenAttrs, attribute) != -1){
				// item's children list changed
				this.getChildren(item, dojo.hitch(this, function(children){
					// NOTE: maybe can be optimized since parentInfo contains the new and old attribute value
					this.onChildrenChange(item, children);
				}));
			}else{
				// item's label/icon/etc. changed.
				this.onChange(item);
			}";s:7:"summary";s:38:"Set data event on an item in the store";s:7:"private";b:1;}s:34:"dijit.tree.TreeStoreModel.connects";a:2:{s:8:"instance";s:25:"dijit.tree.TreeStoreModel";s:7:"summary";s:0:"";}s:4:"this";a:2:{s:6:"mixins";a:1:{s:6:"normal";a:1:{i:0;s:4:"args";}}s:7:"summary";s:0:"";}s:10:"dijit.tree";a:2:{s:4:"type";s:6:"Object";s:7:"summary";s:0:"";}s:5:"dijit";a:2:{s:4:"type";s:6:"Object";s:7:"summary";s:0:"";}}