CogToolGroup Class

Cognex VisionPro 9.5

A VisionPro tool that contains a set of VisionPro tools. Running the CogToolGroup implicitly runs each of the tools it contains. The run status and records of the CogToolGroup are based on the aggregate of all its contained tools.

Inheritance Hierarchy

System Object
  System MarshalByRefObject
    System.ComponentModel Component
      Cognex.VisionPro.Implementation CogComponentBase
        Cognex.VisionPro.Implementation CogSerializableComponentBase
          Cognex.VisionPro.Implementation CogSerializableChangedEventComponentBase
            Cognex.VisionPro.Implementation CogToolBase
              Cognex.VisionPro.Implementation.Internal CogUserTool
                Cognex.VisionPro.ToolGroup CogToolGroup
                  Cognex.VisionPro.ToolBlock CogToolBlock

Namespace: Cognex.VisionPro.ToolGroup
Assembly: Cognex.VisionPro.ToolGroup (in Cognex.VisionPro.ToolGroup.dll) Version: 69.0.0.0 (69.0.0.0)

Syntax

C++

Copy to Clipboard Print

[SerializableAttribute]
public class CogToolGroup : CogUserTool, 
	ICogQueryContainerSupport, ICogNetUpgradeOnLoad

[SerializableAttribute]
public class CogToolGroup : CogUserTool, 
	ICogQueryContainerSupport, ICogNetUpgradeOnLoad

<SerializableAttribute>
Public Class CogToolGroup 
	Inherits CogUserTool 
	Implements ICogQueryContainerSupport, ICogNetUpgradeOnLoad

<SerializableAttribute>
Public Class CogToolGroup 
	Inherits CogUserTool 
	Implements ICogQueryContainerSupport, ICogNetUpgradeOnLoad

[SerializableAttribute]
public ref class CogToolGroup : public CogUserTool, 
	ICogQueryContainerSupport, ICogNetUpgradeOnLoad

[SerializableAttribute]
public ref class CogToolGroup : public CogUserTool, 
	ICogQueryContainerSupport, ICogNetUpgradeOnLoad

The CogToolGroup type exposes the following members.

Constructors

	Name	Description
	CogToolGroup	Constructs a new instance of the CogToolGroup class.
	CogToolGroup(CogToolGroup)	Constructs a new instance of the CogToolGroup class.
	CogToolGroup(SerializationInfo, StreamingContext)	Constructs a new instance of the CogToolGroup class.

Top

Methods

	Name	Description
	AddCompositeLastRunRecord	Adds all of the contained tools' last run records to the supplied record. (Inherited from CogUserTool.)
	AddGraphicToRunRecord	Should only be called from tool group script. Adds a graphic to a specified run record. (Inherited from CogUserTool.)
	AddSharedGraphics	Shares all graphics between image records with the same space tree in the passed ICogRecord (Inherited from CogUserTool.)
	BeginInit	Signals the object that initialization is starting. (Inherited from CogUserTool.)
	CheckRunConditions	Check for run conditions including data binding. (Inherited from CogToolBase.)
	CheckRunConditionsNoThrow	Check for run conditions including data binding, returning an exception for the first problem encountered. (Inherited from CogToolBase.)
	Clone	Creates a deep copy of the tool group. (Overrides CogUserTool Clone .)
	CreateCurrentRecord	Creates a new set of records that represents the tool's current state. (Inherited from CogToolBase.)
	CreateLastRunRecord	Creates a new set of records that represents the tool's last-run state. (Inherited from CogToolBase.)
	CreateNewScript	Cognex internal use only. (Inherited from CogUserTool.)
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	DefineScriptTerminal(Object, String, Boolean)	Called from a script's initialize() funciton to define a tool group terminal associated with the script. (Inherited from CogUserTool.)
	DefineScriptTerminal(String, Object, String, Boolean)	Called from a script's initialize() funciton to define a tool group terminal associated with the script. (Inherited from CogUserTool.)
	Dispose	Releases all resources used by the Component. (Inherited from Component.)
	Dispose(Boolean)	Releases the resources used by the CogUserTool instance. (Inherited from CogUserTool.)
	EditExistingScript	Cognex internal use only. (Inherited from CogUserTool.)
	EndInit	Signals the object that initialization is complete. (Inherited from CogUserTool.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
	FindRunRecord	Finds a specific run record in a tree of run records (Inherited from CogUserTool.)
	GetAttributes	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetClassName	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetComponentName	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetConverter	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetDefaultEvent	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetDefaultProperty	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetEditor	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetEvents	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetEvents( Attribute )	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetObjectData	(Inherited from CogUserTool.)
	GetProperties	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetProperties( Attribute )	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetPropertyOwner	Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information. (Inherited from CogComponentBase.)
	GetScriptData	(Inherited from CogUserTool.)
	GetScriptTerminalData(String)	Retrieves the data associated with a terminal. Can be called on both input and output terminals. (Inherited from CogUserTool.)
	GetScriptTerminalData(String, Object )	Retrieves the data associated with a terminal. Can be called on both input and output terminals. (Inherited from CogUserTool.)
	GetService	Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	InternalCreateCurrentRecord	Called by the CreateCurrentRecord method to create a record containing the current state of the tool. (Inherited from CogUserTool.)
	InternalCreateLastRunRecord	Called by the CreateLastRunRecord method to create a record containing the state of the tool after the last call to its Run method. (Inherited from CogUserTool.)
	InternalRun	Called by the Run method to perform the main processing of the tool. (Overrides CogUserTool InternalRun(String ).)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	OnChanged(Int64)	This method should be called internally whenever the object's state may have changed. (Inherited from CogSerializableChangedEventComponentBase.)
	OnChanged(CogChangedEventArgs)	This method may be called internally whenever a derived object's state may have changed and the derived object expresses this change via a derived CogChangedEventArgs class. (Inherited from CogSerializableChangedEventComponentBase.)
	OnDeserialization	Runs when the entire object graph has been deserialized. (Inherited from CogUserTool.)
	OnRan	Raises the Ran event. (Overrides CogToolBase OnRan .)
	OnRunning	Raises the Running event. (Inherited from CogToolBase.)
	PurgeOldScript	(Inherited from CogUserTool.)
	ResumeAndRaiseChangedEvent	Re-enables raising of the Changed event after SuspendChangedEvent has been called, and raises the Changed event if the ChangedEventSuspended count is reduced to zero and any changes were made while events were suspended. Must be called once for each call to SuspendChangedEvent. (Inherited from CogSerializableChangedEventComponentBase.)
	Run	Runs the tool. This method is guaranteed to not throw an exception. Any exception generated in the course of running the tool will be caught and packaged in the tool's RunStatus.Exception. Should this occur, the tool's RunStatus.Result will be set to Error and its RunStatus.Message will reference the message that accompanied the exception. It is the user's responsibility to examine the tool's RunStatus after calling Run. (Inherited from CogToolBase.)
	RunTool	Should only be called from tool group script. Runs a single tool. Will not run the tool if it is currently disabled. (Inherited from CogUserTool.)
	ScriptRefeshRequested	Allows a derived class to be notified when a user requests the auto-genereated portion of the script to be refreshed. (Inherited from CogUserTool.)
	SetRunStatus	Cognex Internal use only. (Inherited from CogToolBase.)
	SetScriptTerminalData	Sets the data associated with a terminal. (Inherited from CogUserTool.)
	SuspendChangedEvent	Temporarily suspends the raising of the Changed event. May be called more than once, and a corresponding call to ResumeAndRaiseChangedEvent must be made for each call to SuspendChangedEvent. (Inherited from CogSerializableChangedEventComponentBase.)
	Tool_Changed	Called when one of the contained tools raises its Changed event. (Inherited from CogUserTool.)
	Tools_Clearing	(Inherited from CogUserTool.)
	ToString	Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
	Upgrade	For internal use only.

Top

Fields

	Name	Description
	CurrentRecordEnable_	Gets or sets the flags specifying the records to include based on the tool's current state. The derived class exposes this as a strongly- typed enum property. (Inherited from CogToolBase.)
	LastRunLastRunRecordDiagEnable_	Gets or sets the flags specifying the records to create during the next invocation of the Run method. (Inherited from CogToolBase.)
	LastRunRecordDiagEnable_	Gets or sets the flags specifying the diagnostics records to include based on the tool's last-run state. The derived class exposes this as a strongly-typed enum property. (Inherited from CogToolBase.)
	LastRunRecordEnable_	Gets or sets the flags specifying the records to include based on the tool's last-run state. The derived class exposes this as a strongly- typed enum property. (Inherited from CogToolBase.)
	ProcessingTimeAdjustment_	Gets or sets the amount to offset reported tool processing time. (Inherited from CogToolBase.)
	SfGarbageCollectionEnabled	State flag for the GarbageCollectionEnabled property.
	SfGarbageCollectionFrequency	State flag for the GarbageCollectionFrequency property.
	SfNextSf	Next state flag to be used in derived classes.
	SfScriptData	State flag for terminal data associated with a script

Top

Properties

	Name	Description
	AbortRunOnToolFailure	Gets or sets a flag indicating if the Run invocation should abort if the Run method of any of its contained tools fails. (Inherited from CogUserTool.)
	AllTools	All the Tools owned by this user tool, includes tools that aren't part of the main tools collection but are still tools owned by this user tool... like ToolBlock Inputs and Outputs. (Inherited from CogUserTool.)
	CanRaiseEvents	Gets a value indicating whether the component can raise an event. (Inherited from Component.)
	ChangedEventSuspended	If nonzero, indicates that the raising of the Changed event has been suspended. This value is incremented when SuspendChangedEvent is called and decremented when ResumeAndRaiseChangedEvent is called. (Inherited from CogSerializableChangedEventComponentBase.)
	Container	Gets the IContainer that contains the Component. (Inherited from Component.)
	DataBindings	Gets the data bindings for the tool. (Inherited from CogToolBase.)
	DesignMode	Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
	DisabledTools	Gets the collection of tools that are omitted from those run by this tool group.
	Events	Gets the list of event handlers that are attached to this Component. (Inherited from Component.)
	ExtraTools	Tools that aren't part of the main tools collection but are still tools owned by this user tool... like ToolBlock Inputs and Outputs. These tools may or may not show up in main ToolTreeView. (Inherited from CogUserTool.)
	FailOnInvalidDataBinding	Specifies that the Run method is to fail if executed while one or more data bindings are invalid. (Inherited from CogToolBase.)
	GarbageCollectionEnabled	Gets or sets the flag indicating that garbage collection is to be run periodically.
	GarbageCollectionFrequency	Gets or sets the frequency at which garbage collection is to be run.
	HasChanged	(Inherited from CogSerializableChangedEventComponentBase.)
	LastRunRecordEnable	Enable creation of records by bitwise ORing the appropriate CogUserToolLastRunRecordConstants. (Inherited from CogUserTool.)
	Name	Gets or sets a user-supplied name for the tool. (Inherited from CogToolBase.)
	RunStatus	Gets general information about the last call to the tool's Run function. Note that serious errors that occur within the tool's Run method may only be detected by examining the RunStatus after calling Run. It is the user's responsibility to examine the tool's RunStatus after calling Run. (Inherited from CogToolBase.)
	Script	Cognex Internal Use Only. (Inherited from CogUserTool.)
	ScriptData	Cognex internal use only.
	ScriptError	Cognex Internal Use Only. (Inherited from CogUserTool.)
	Site	Gets or sets the ISite of the Component. (Inherited from Component.)
	StateFlags	Returns the complete set of state flags supported on this object. The flags may be indexed by name as shown in the following C# code snippet: if (changedObject.StateFlags["Color"] & eventArgs.StateFlags) { ... } (Inherited from CogSerializableChangedEventComponentBase.)
	Tools	Gets the collection of tools within this tool group.
	UserData	Gets a CogDictionary object that can be used to store application-specific information. (Inherited from CogToolBase.)

Top

Events

	Name	Description
	Changed	This event is raised when one or more parts of the object's state may have changed. (Inherited from CogSerializableChangedEventComponentBase.)
	Disposed	Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
	Ran	Event that is raised at the end of the tool's Run method. (Inherited from CogToolBase.)
	Running	Event that is raised at the start of the tool's Run method. (Inherited from CogToolBase.)

Top