Click or drag to resize

ItemsControlCompositionBehavior Class

Retrieves all exported items with the VisualCompositionExportAttribute that match the RegionId from the composition container and assigns them as the items source of the associated ItemsControl

If the items control is a Selector, and the composable object implement ISelectableComposablePart, the selection of the selector is synchronized with the IsSelected property.

Inheritance Hierarchy
SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.WindowsFreezable
        System.Windows.Media.AnimationAnimatable
          Behavior
            BehaviorItemsControl
              TomsToolbox.Wpf.InteractivityFrameworkElementBehaviorItemsControl
                TomsToolbox.Wpf.CompositionVisualCompositionBehaviorItemsControl
                  TomsToolbox.Wpf.CompositionItemsControlCompositionBehavior

Namespace:  TomsToolbox.Wpf.Composition
Assembly:  TomsToolbox.Wpf (in TomsToolbox.Wpf.dll) Version: 1.0.75.0
Syntax
public class ItemsControlCompositionBehavior : VisualCompositionBehavior<ItemsControl>

The ItemsControlCompositionBehavior type exposes the following members.

Constructors
  NameDescription
Public methodItemsControlCompositionBehavior
Initializes a new instance of the ItemsControlCompositionBehavior class
Top
Properties
  NameDescription
Public propertyCompositionContext
Gets or sets the composition context.
(Inherited from VisualCompositionBehaviorT.)
Public propertyCompositionContextBinding
Gets or sets the composition context binding. the binding will be applied to the RegionId property only after the behavior is attached to the logical tree, so you don't get misleading binding errors.

[CanBeNull]

(Inherited from VisualCompositionBehaviorT.)
Protected propertyExportProvider
Gets or sets the export provider (IOC). The export provider must be registered with the ExportProviderLocator.

[CanBeNull]

(Inherited from VisualCompositionBehaviorT.)
Public propertyForceSelection
Gets or sets a value indicating whether the behavior will force the selection of the first element after applying the content.

This will ensure that e.g. a tab-control will show the first tab instead of empty content.

The default value is true.

Protected propertyIsLoaded
Gets a value indicating whether the associated object is loaded.
(Inherited from FrameworkElementBehaviorT.)
Public propertyRegionId
Gets or sets the id of the region. The region id is used to select candidates for composition.
(Inherited from VisualCompositionBehaviorT.)
Public propertyRegionIdBinding
Gets or sets the region identifier binding; the binding will be applied to the RegionId property only after the behavior is attached to the logical tree, so you don't get misleading binding errors.

[CanBeNull]

(Inherited from VisualCompositionBehaviorT.)
Top
Methods
  NameDescription
Protected methodGetExports
Gets the visual composition exports for the specified region.

[CanBeNull, ItemNotNull]

(Inherited from VisualCompositionBehaviorT.)
Protected methodGetTarget
Gets the target object for the item. If the item implements IComposablePartFactory, the element returned by the factory is returned; otherwise the item itself is returned.

[CanBeNull]

(Inherited from VisualCompositionBehaviorT.)
Protected methodOnAssociatedObjectLoaded
Called when the associated object is loaded.
(Inherited from VisualCompositionBehaviorT.)
Protected methodOnAssociatedObjectUnloaded
Called when the associated object is unloaded.
(Inherited from VisualCompositionBehaviorT.)
Protected methodOnAttached
Called after the behavior is attached to an AssociatedObject.
(Inherited from VisualCompositionBehaviorT.)
Protected methodOnDetaching
Called when the behavior is being detached from its AssociatedObject, but before it has actually occurred.
(Overrides FrameworkElementBehaviorTOnDetaching.)
Protected methodOnUpdate
Updates this instance.
(Overrides VisualCompositionBehaviorTOnUpdate.)
Protected methodUpdate
Called when any of the constraints have changed and the target needs to be updated.
(Inherited from VisualCompositionBehaviorT.)
Top
Extension Methods
  NameDescription
Public Extension MethodAncestors
Returns an enumeration of the ancestor elements in the logical tree of this element.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodAncestorsAndSelf
Returns an enumeration of elements that contain this element, and the ancestors in the logical tree of this element.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodGetExportProvider
Gets the active export provider for the specified object.

[NotNull]

(Defined by ExportProviderLocator.)
Public Extension MethodGetRootVisual
Gets the root visual for the item.

[NotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodGetValueT (Defined by DependencyObjectExtensions.)
Public Extension MethodGetWindowHandle
Gets the window handle of the HwndSource hosting this item.
(Defined by DependencyObjectExtensions.)
Public Extension MethodSafeCastT
Performs a cast from object to T, avoiding possible null violations if T is a value type.

[CanBeNull]

(Defined by ObjectExtensions.)
Public Extension MethodSetExportProvider
Sets the export provider.
(Defined by ExportProviderLocator.)
Public Extension MethodTryFindAncestorTOverloaded.
Returns the first element in the ancestor list that implements the type of the type parameter.

[CanBeNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodTryFindAncestorT(FuncT, Boolean)Overloaded.
Returns the first element in the ancestor list that implements the type of the type parameter.

[CanBeNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodTryFindAncestorOrSelfTOverloaded.
Returns the first element in the ancestor list that implements the type of the type parameter.

[CanBeNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodTryFindAncestorOrSelfT(FuncT, Boolean)Overloaded.
Returns the first element in the ancestor list that implements the type of the type parameter.

[CanBeNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodTryGetExportProvider
Gets the active export provider for the specified object, or null if no export provider is registered.

[CanBeNull]

(Defined by ExportProviderLocator.)
Public Extension MethodTryGetRootVisual
Gets the root visual for the item.

[CanBeNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodVisualAncestors
Returns an enumeration of the ancestor elements in the visual tree of this element.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodVisualAncestorsAndSelf
Returns an enumeration of elements that contains this element, and the ancestors in the visual tree of this element.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodVisualChildren
Enumerates the immediate children of the specified item.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodVisualChildrenAndSelf
Enumerates the specified item and it's immediate children.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodVisualDescendants
Enumerates all visuals descendants of the specified item.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Public Extension MethodVisualDescendantsAndSelf
Enumerates the specified item and all it's visual descendants.

[NotNull, ItemNotNull]

(Defined by DependencyObjectExtensions.)
Top
Remarks
ViewModels declare themselves as candidates for visual composition by adding the VisualCompositionExportAttribute, and the visual composition behaviors dynamically link the view models to the views with the matching region ids.
See Also