SoSFTrigger(3IV)

NAME
     SoSFTrigger - field used to trigger engines or connection networks

INHERITS FROM
     SoField > SoSField > SoSFTrigger

SYNOPSIS
     #include <Inventor/fields/SoSFTrigger.h>

          Methods from class SoSFTrigger:

     void                setValue()
     void                getValue()
     int                 operator ==(const SoSFTrigger &t) const
     int                 operator !=(const SoSFTrigger &t) const

          Methods from class SoSField:

     static SoType       getClassTypeId()

          Methods from class SoField:

     void                setIgnored(SbBool ignore)
     SbBool              isIgnored() const
     SbBool              isDefault() const
     virtual SoType      getTypeId() const
     virtual SbBool      isOfType(SoType type) const
     SbBool              set(const char *valueString)
     void                get(SbString &valueString)
     void                touch()
     SbBool              connectFrom(SoField *fromField)
     SbBool              connectFrom(SoEngineOutput *fromEngine)
     void                disconnect()
     SbBool              isConnected() const
     SbBool              isConnectedFromField() const
     SbBool              getConnectedField(SoField *&writingField) const
     SbBool              isConnectedFromEngine() const
     SbBool              getConnectedEngine(SoEngineOutput *&engineOutput)
                              const
     void                enableConnection(SbBool flag)
     SbBool              isConnectionEnabled() const
     int                 getForwardConnections(SoFieldList &list) const
     SoFieldContainer *  getContainer() const


DESCRIPTION
     This class can be used to start or to synchronize a network of field
     connections. It is the "null" field - a field with no values. It is
     typically used as the "start button" for engines that change over time.

     Triggers can be connected from any other type of field, and will notify
     any engines or nodes they are part of (or any other triggers they are
     connected to) whenever the value of the field is set (even if it is set
     to its current value) or the field is touch()'ed.

     Since they have no value, SoSFTriggers are not written to file. A node or
     engine containing an SoSFTrigger field will write only the field's name.

METHODS
     void                setValue()
          Starts the notification process; this is equivalent to calling
          touch().

     void                getValue()
          Forces any connected engines or fields to evaluate themselves.

     int                 operator ==(const SoSFTrigger &t) const
     int                 operator !=(const SoSFTrigger &t) const
          All trigger fields are equal; these methods always return TRUE and
          FALSE, respectively.


SEE ALSO
     SoSFBool, SoMFBool