The GwxPickMenuItem type exposes the following members.

Constructors

  NameDescription
Public methodGwxPickMenuItem
Creates a dynamic pick menu item with default properties.

Methods

  NameDescription
Public methodCheckAccess
Determines whether the calling thread has access to this DispatcherObject.
(Inherited from DispatcherObject.)
Public methodClearValue(DependencyProperty)
Clears the local value of a property. The property to be cleared is specified by a DependencyProperty identifier.
(Inherited from DependencyObject.)
Public methodClearValue(DependencyPropertyKey)
Clears the local value of a read-only property. The property to be cleared is specified by a DependencyPropertyKey.
(Inherited from DependencyObject.)
Public methodClone
Creates a modifiable clone of the Freezable, making deep copies of the object's values. When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.
(Inherited from Freezable.)
Protected methodCloneCore (Inherited from FreezableFilteredCustomTypeDescriptorBase.)
Public methodCloneCurrentValue
Creates a modifiable clone (deep copy) of the Freezable using its current values.
(Inherited from Freezable.)
Protected methodCloneCurrentValueCore (Inherited from FreezableFilteredCustomTypeDescriptorBase.)
Public methodCoerceValue
Coerces the value of the specified dependency property. This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.
(Inherited from DependencyObject.)
Public methodEquals
Determines whether a provided DependencyObject is equivalent to the current DependencyObject.
(Inherited from DependencyObject.)
Public methodFreeze
Makes the current object unmodifiable and sets its IsFrozen property to true.
(Inherited from Freezable.)
Public methodGetAsFrozen
Creates a frozen copy of the Freezable, using base (non-animated) property values. Because the copy is frozen, any frozen sub-objects are copied by reference.
(Inherited from Freezable.)
Protected methodGetAsFrozenCore (Inherited from FreezableFilteredCustomTypeDescriptorBase.)
Public methodGetCurrentValueAsFrozen
Creates a frozen copy of the Freezable using current property values. Because the copy is frozen, any frozen sub-objects are copied by reference.
(Inherited from Freezable.)
Protected methodGetCurrentValueAsFrozenCore (Inherited from FreezableFilteredCustomTypeDescriptorBase.)
Public methodGetHashCode
Gets a hash code for this DependencyObject.
(Inherited from DependencyObject.)
Public methodGetHighLimitValue
During runtime, gets the current value of the high limit used by this dynamic animation.
(Inherited from GwxDynamic.)
Public methodGetLastWrittenValue
Gets the last data value that was written via this dynamic, or null if no data value has been written.
(Inherited from GwxDynamic.)
Public methodGetLocalValueEnumerator
Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.
(Inherited from DependencyObject.)
Public methodGetLowLimitValue
During runtime, gets the current value of the low limit used by this dynamic animation.
(Inherited from GwxDynamic.)
Public methodGetParentDocument
Gets the document to which this dynamic object belongs.
(Inherited from GwxDynamic.)
Public methodGetParentDynamicGroup
Gets the group of dynamic objects (attached to a target object) to which this dynamic object belongs.
(Inherited from GwxDynamic.)
Public methodGetParentElement
Gets the parent DependencyObject with which this dynamic is associated In other words, this method returns the visual object that is animated by this dynamic.
(Inherited from GwxDynamic.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodGetValue
Returns the current effective value of a dependency property on this instance of a DependencyObject.
(Inherited from DependencyObject.)
Public methodGetValueOfPrimaryDataSource
During runtime, gets the current value of the data provided by the DataSource property.
(Inherited from GwxDynamic.)
Public methodInvalidateProperty
Re-evaluates the effective value for the specified dependency property
(Inherited from DependencyObject.)
Public methodReadLocalValue
Returns the local value of a dependency property, if it exists.
(Inherited from DependencyObject.)
Public methodRefreshPrimaryDataSource
During runtime, for the data value of the DataSource property, invokes asynchronous reading on the data server so that the client application gets a new update
(Inherited from GwxDynamic.)
Public methodSetCurrentValue
Sets the value of a dependency property without changing its value source.
(Inherited from DependencyObject.)
Public methodSetValue(DependencyProperty, Object)
Sets the local value of a dependency property, specified by its dependency property identifier.
(Inherited from DependencyObject.)
Public methodSetValue(DependencyPropertyKey, Object)
Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.
(Inherited from DependencyObject.)
Protected methodShouldSerializeProperty (Inherited from FreezableFilteredCustomTypeDescriptorBase.)
Public methodSimulateKeystroke(Key)
Simulates the behavior of the user executing this pick dynamic via a shortcut key.
(Inherited from GwxPick.)
Public methodSimulateKeystroke(Key, ModifierKeys)
Simulates the behavior of the user executing this pick dynamic via a shortcut key.
(Inherited from GwxPick.)
Public methodSimulateMouseClick(MouseButton)
Simulates the behavior of the user clicking on this pick dynamic.
(Inherited from GwxPick.)
Public methodSimulateMouseClick(MouseButton, ModifierKeys)
Simulates the behavior of the user clicking on this pick dynamic.
(Inherited from GwxPick.)
Public methodToString
Overrides ToString()()()()
(Overrides GwxDynamic..::..ToString()()()().)
Public methodVerifyAccess
Enforces that the calling thread has access to this DispatcherObject.
(Inherited from DispatcherObject.)
Public methodWriteValueToPrimaryDataSource
During runtime, writes the specified value to the data value of the DataSource property.
(Inherited from GwxDynamic.)
Public methodWriteValueToPrimaryDataSourceNoConfirm
During runtime, writes the specified value to the data value of the DataSource property. This method will not prompt the user to confirm the written value even if the dynamic is configured to do so.
(Inherited from GwxDynamic.)

Fields

  NameDescription
Public fieldStatic memberBackgroundProperty
DependencyProperty for the Background property.
Public fieldStatic memberForegroundProperty
DependencyProperty for the Foreground property.
Public fieldStatic memberMenuTextProperty
DependencyProperty for the MenuText property.

Properties

  NameDescription
Public propertyAccelerationRatio
The percentage of the animation's Duration spent accelerating the passage of time from zero to its maximum rate (range: 0.0 to 1.0).
(Inherited from GwxDynamic.)
Public propertyAnimateWhenTrue
Causes the animation to be active when the datasource comparison yields a result of "true" (after applying reverse compare logic if specified).
(Inherited from GwxDynamic.)
Public propertyAnimationMode
Indicates the animation behavior of this dynamic.
(Inherited from GwxDynamic.)
Public propertyAutoReverse
Causes the animation to automatically play in reverse after its forward iteration has finished.
(Inherited from GwxDynamic.)
Public propertyBackground
Specifies the background color of this menu item.
Public propertyCanFreeze
Gets a value that indicates whether the object can be made unmodifiable.
(Inherited from Freezable.)
Public propertyCommandName
A name that identifies what command should be executed by this GwxPick object.
(Inherited from GwxPick.)
Public propertyCommandParameters
Parameters specific to the selected CommandName.
(Inherited from GwxPick.)
Public propertyComment
When this property is true, if Confirm is also true, this property indicates that the confirmation message will provide the user with field to enter a comment to be logged for the written value. This property is unused when the Confirm property is false.
(Inherited from GwxDynamic.)
Public propertyCommentRequired
When this property is true, if Confirm and Comment are also true, this property indicates that the user must enter a non-empty comment to be logged for the written value. This property is unused when either the Confirm or Comment properties are false.
(Inherited from GwxDynamic.)
Public propertyConfirm
When true, this property indicates that a warning message should be displayed prior to performing a data write that has been initiated via user interaction (the warning message allows the user to cancel the pending data write, or to proceed with the write). When false, the data write occurs without a confirmation message. This property is unused when the dynamic is not controllable.
(Inherited from GwxDynamic.)
Public propertyContinuousWrite
When true, this property indicates that the dynamic should continuously write new values while the user is interacting with the dynamic control (as in the case of dragging a slider). When false, this property indicates that the dynamic should only write a value when the user has finished interacting with the dynamic control (as in the case of releasing a slider after having dragged it to a new position).
(Inherited from GwxDynamic.)
Public propertyControl
When this property is true, this target object associated with this dynamic can be clicked on by the user to perform some action (i.e. slider, dial, button, dataentry). Usually, controllable objects are used to write data values.
(Inherited from GwxDynamic.)
Public propertyCustomConfirmMessage
A custom confirmation message.
(Inherited from GwxDynamic.)
Public propertyCustomData
A string field for custom data. The purpose of this field is defined by the user; it can be used to hold any extra configuration data in string format.
(Inherited from GwxDynamic.)
Public propertyDataComparison
Type of comparison for DataSource and Limit(s) (or zero).

For Discrete Animations - animation will activate when comparison is true.

For Analog Animation - animation will be skipped when comparison is false (if not specified, animation is always active).

For GwxProcessPoint - designates type of range validation for data entry.

(Inherited from GwxDynamic.)
Public propertyDataSource
The primary data connection for this dynamic object. Datasources can be an OPC tag, expression, constant value, or local variable.
(Inherited from GwxDynamic.)
Public propertyDecelerationRatio
The percentage of the animation's Duration spent decelerating the passage of time from zero to its maximum rate (range: 0.0 to 1.0).
(Inherited from GwxDynamic.)
Public propertyDependencyObjectType
Gets the DependencyObjectType that wraps the CLR type of this instance. 
(Inherited from DependencyObject.)
Public propertyDescription
A user defined description string for this dynamic.
(Inherited from GwxDynamic.)
Public propertyDispatcher
Gets the Dispatcher this DispatcherObject is associated with.
(Inherited from DispatcherObject.)
Public propertyDragDropDataSource
Indicates that the DataSource of this dynamic can be drag/dropped during runtime into another component such as the Trend viewer.
(Inherited from GwxDynamic.)
Public propertyDuration
In general this property represents the time it takes for an animation to complete a cycle. This time is expressed in milliseconds.
(Inherited from GwxDynamic.)
Public propertyDynamicConnectionList
This list is used internally to compose a list of multiple dynamics to a single more complex/powerful dynamic object. A prime example of this is the GwxPickMenuItem dynamic configured to display a popup menu. In this case, the DynamicConnectionList is used to create a tree of child GwxPick objects, each representing a different command item on the menu. Other dynamics that use this list are GwxStateSelector, GwxRangeSelector, and GwxProcessPoint.
(Inherited from GwxDynamic.)
Public propertyDynamicStateWhenToggleOff
This property indicates that when this dynamic is not toggling, the alternate state of the dynamic (rather than the default state) should be used. For instance, if toggle (flash) is specified for a GwxHide dynamic, when this property is true, the associated static object will be hidden when not flashing (when this property is false, the object will be visible when not flashing).
(Inherited from GwxDynamic.)
Public propertyEnableControlEvents
True to enable execution of commmands when events occur.
(Inherited from GwxDynamic.)
Public propertyEnabled
When this property is false, the control behavior for this dynamic is disabled.
(Inherited from GwxDynamic.)
Public propertyEndPercent
Used to specify an ending magnitude for the animation (range: 0.0 to 1.0).
(Inherited from GwxDynamic.)
Public propertyExecuteOnDoubleClick
Designates that this pick action is executed when the configured mouse-button is double-clicked. This only applies to "normal" buttons.
(Inherited from GwxPick.)
Public propertyExecuteOnDown
Designates that this pick action is executed when the configured mouse-button/shortcut-key initially goes down. For checkboxes/radiobuttons this means "execute-when-checked".
(Inherited from GwxPick.)
Public propertyExecuteOnMouseEnter
Designates that this pick action is executed when the mouse is moved onto the associated object.
(Inherited from GwxPick.)
Public propertyExecuteOnMouseLeave
Designates that this pick action is executed when the mouse is moved away from the associated object.
(Inherited from GwxPick.)
Public propertyExecuteOnMouseMove
Designates that this pick action is executed when the mouse is moved while it is over the associated object.
(Inherited from GwxPick.)
Public propertyExecuteOnUp
Designates that this pick action is executed when the configured mouse-button/shortcut-key is released. For checkboxes/radiobuttons this means execute-when-unchecked.
(Inherited from GwxPick.)
Public propertyExecuteWhileDown
Designates that this pick action is executed while the configured mouse-button/shortcut-key is held down. The action periodically executes at a rate specified in the PeriodicToggleRate property. For checkboxes/radiobuttons this means "execute-while-checked".
(Inherited from GwxPick.)
Public propertyFillBehavior
When the value is FillBehavior.Stop, this property indicates that the animated object returns to its default state when the animation's duration (including repeats) has expired. When the value is FillBehavior.HoldEnd, this property indicates that the animated object stays in its current state when the animation's duration has expired.

The default value is FillBehavior.HoldEnd. This property has no effect if the repeat count is infinite, or if there is no Duration.

(Inherited from GwxDynamic.)
Public propertyForeground
Specifies the foreground color of the text of this menu item.
Public propertyFreezeWhenNotAnimating
When false, this property indicates that the animated object returns to its default state when the animation is stopped. When true, this property indicates that the animated object stays in its current state when an animation is stopped.
(Inherited from GwxDynamic.)
Public propertyGroupName
A name that identifies a radiobutton group. All other radiobuttons in a display with the same GroupName are included in the radiobutton behavior. This property is unused for normal buttons and check buttons.
(Inherited from GwxPick.)
Public propertyHighLimitSource
This property specifies a high limit for value used in the analog animation.
(Inherited from GwxDynamic.)
Public propertyInitialClick
When true, simulates the action of a user clicking on this pick when entering runtime mode. This can be used to initially select a checkbox or radiobutton, or to perform an initial action when entering runtime.
(Inherited from GwxPick.)
Public propertyInitialValue
Initial value to be written.
(Inherited from GwxDynamic.)
Public propertyIsFrozen
Gets a value that indicates whether the object is currently modifiable.
(Inherited from Freezable.)
Public propertyIsSealed
Gets a value that indicates whether this instance is currently sealed (read-only).
(Inherited from DependencyObject.)
Public propertyLeftMouseButton
True, if the left mouse button should trigger the pick command.
(Inherited from GwxPick.)
Public propertyLowLimitSource
This property specifies a low limit for value used in the analog animation.
(Inherited from GwxDynamic.)
Public propertyMenuText
Text that is shown for the menu item. May be a data source.
Public propertyMiddleMouseButton
True, if the middle mouse button should trigger the pick command.
(Inherited from GwxPick.)
Public propertyMouseModifierKeys
Mouse modifier keys (used in conjunction with mouse buttons) that specify when to execute this GwxPick.
(Inherited from GwxPick.)
Public propertyName
For internal use only. Not for customer use.

A unique user-friendly name that can be used to identify the object.

(Inherited from GwxDynamic.)
Public propertyPartitionMode
Indicates how to define the "partition" behavior of this analog dynamic. This feature is used to divide an analog range into a specified number of steps (useful for providing "tick" behavior in sliders, for example).
(Inherited from GwxDynamic.)
Public propertyPartitionOrigin
This property specifies the starting analog value from which subsequent steps are calculated. This value is only used when partitionmode="DeltaValue".
(Inherited from GwxDynamic.)
Public propertyPartitionValue
When partitionmode="NumberOfPartitions" this property specifies the number of steps to subdivide the analog value’s range into.

When partitionmode="DeltaValue" this property specifies an increment/decrement value between each step within the range.

(Inherited from GwxDynamic.)
Public propertyPeriodicToggleRate
If this property is specified, when the discrete state of the primary datasource would activate this dynamic, rather then simply activate the dynamic, the dynamic’s activation state will be periodically toggled on and off. This property represents the time interval between toggle state changes (i.e. for GwxHide and GwxColor dynamics, this represents the flash rate). This time is expressed in milliseconds.
(Inherited from GwxDynamic.)
Public propertyPickMode
Designates the type of pick behavior to use: normal button, check button, or radio button.
(Inherited from GwxPick.)
Public propertyRepeatCount
This property causes a discrete state animation to run/repeat the specified number of times. If this value is less than zero, the animation repeats infinitely.
(Inherited from GwxDynamic.)
Public propertyResolveAliasesInDragDropDataSource
True to resolve global aliases in the DataSource before dropping the DataSource on another component. False to leave the global aliases unresolved (to be resolved by the component that receives the dropped DataSource). Default to use the document-level setting for ResolveAliasesInDragDropDataSources.
(Inherited from GwxDynamic.)
Public propertyReverseAnimateWhenFalse
Causes the animation to be active (in the reverse direction) when the datasource comparison yields a result of "false" (after applying reverse compare logic if specified).
(Inherited from GwxDynamic.)
Public propertyRightMouseButton
True, if the right mouse button should trigger the pick command.
(Inherited from GwxPick.)
Public propertySafeTouch
When true, this property indicates that the user must be touching a "safe zone" in order to use this control in runtime mode. This property only applies to "Touch" interaction - mouse and keyboard interactions are not affected by this property.
(Inherited from GwxDynamic.)
Public propertyShortcutKey
Shortcut key used to activate this GwxPick.
(Inherited from GwxPick.)
Public propertyShortcutModifierKeys
Shortcut modifier keys (used in conjunction with ShortcutKey) used to activate this GwxPick.
(Inherited from GwxPick.)
Public propertyShowDataSourceNameInToolTip
Determines whether or not to include the DataSource Name for this dynamic in tooltips.
(Inherited from GwxDynamic.)
Public propertyShowDataSourceValueInToolTip
Determines whether or not to include the DataSource Value for this dynamic in tooltips.
(Inherited from GwxDynamic.)
Public propertyShowDescriptionInToolTip
Determines whether or not to include the Description for this dynamic in tooltips.
(Inherited from GwxDynamic.)
Public propertyShowErrorInformationInToolTip
Determines whether or not to include the error information for this dynamic in tooltips.
(Inherited from GwxDynamic.)
Public propertyShowToolTip
Determines whether or not to include information for this dynamic in tooltips.
(Inherited from GwxDynamic.)
Public propertySkipInitialDuration
Indicates that the duration of a time-based dynamic will be skipped for the first data update.

This is useful, for example, for a time-based Hide dynamic that uses both AnimateWhenTrue and ReverseAnimateWhenFalse, to prevent an initial fade-out.

(Inherited from GwxDynamic.)
Public propertyStartDelay
This property represents a delay time before an activated animation will begin. This time is expressed in milliseconds.
(Inherited from GwxDynamic.)
Public propertyStartPercent
Used to specify a starting magnitude for the animation (range: 0.0 to 1.0).
(Inherited from GwxDynamic.)
Public propertyUpdate
When true, this property indicates that the dynamic updates whenever the value of the associated DataSource changes. When false, this property indicates that the dynamic updates only when new values are written. Useful for sliders, dials, and data-entries.
(Inherited from GwxDynamic.)
Public propertyUseCustomConfirmMessage
True to specify a custom confirmation message.
(Inherited from GwxDynamic.)
Public propertyVoiceCommand
A name that identifies what voice command should trigger the pick action execution in this GwxPick object.
(Inherited from GwxPick.)
Public propertyVoiceFeedback
A name that identifies what voice command should trigger the pick action execution in this GwxPick object.
(Inherited from GwxPick.)
Public propertyWriteInitialValue
Indicates that this dynamic will write an initial value after its datasource has been requested.
(Inherited from GwxDynamic.)

Events

  NameDescription
Public eventChanged
Occurs when the Freezable or an object it contains is modified.
(Inherited from Freezable.)
Public eventCommandExecuted
Occurs after a pick command is executed.
(Inherited from GwxPick.)
Public eventCommandExecuting
Occurs before a pick command is executed.
(Inherited from GwxPick.)
Public eventDataUpdated
Occurs when this dynamic has been updated for a data change.
(Inherited from GwxDynamic.)

See Also