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.Composition (in TomsToolbox.Wpf.Composition.dll) Version: 2.21.0+44d18b541fc9419ec3c549350a832394661b2a4d
XMLNS for XAML: Not mapped to an xmlns.
Syntax
Copy
public class ItemsControlCompositionBehavior : VisualCompositionBehavior<ItemsControl>

The ItemsControlCompositionBehavior type exposes the following members.

Constructors
 NameDescription
Public methodItemsControlCompositionBehaviorInitializes 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.
(Inherited from VisualCompositionBehaviorT)
Protected propertyExportProvider Gets or sets the export provider (DI container). The export provider must be registered with the ExportProviderLocator.
(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.
(Inherited from VisualCompositionBehaviorT)
Top
Methods
 NameDescription
Protected methodGetExports Gets the visual composition exports for the specified region.
(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.
(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.
(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.
(Defined by DependencyObjectExtensions)
Public Extension MethodGetExportProvider Gets the active export provider for the specified object.
(Defined by ExportProviderLocator)
Public Extension MethodGetMissingExportProviderMessage Gets the message to show when an export provider could not be located in the visual tree.
(Defined by ExportProviderLocator)
Public Extension MethodGetRootVisual Gets the root visual for the item.
(Defined by DependencyObjectExtensions)
Public Extension MethodGetValueT Gets the value of a dependency property using SafeCastT(Object).
(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.
(Defined by ObjectExtensions)
Public Extension MethodSetExportProvider Sets the export provider.
(Defined by ExportProviderLocator)
Public Extension MethodTryFindAncestorT Returns the first element in the ancestor list that implements the type of the type parameter.
(Defined by DependencyObjectExtensions)
Public Extension MethodTryFindAncestorT Returns the first element in the ancestor list that implements the type of the type parameter.
(Defined by DependencyObjectExtensions)
Public Extension MethodTryFindAncestorOrSelfT Returns the first element in the ancestor list that implements the type of the type parameter.
(Defined by DependencyObjectExtensions)
Public Extension MethodTryFindAncestorOrSelfT Returns the first element in the ancestor list that implements the type of the type parameter.
(Defined by DependencyObjectExtensions)
Public Extension MethodTryGetExportProvider Gets the active export provider for the specified object, or null if no export provider is registered.
(Defined by ExportProviderLocator)
Public Extension MethodTryGetRootVisual Gets the root visual for the item.
(Defined by DependencyObjectExtensions)
Public Extension MethodVisualAncestors Returns an enumeration of the ancestor elements in the visual tree of this element.
(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.
(Defined by DependencyObjectExtensions)
Public Extension MethodVisualChildren Enumerates the immediate children of the specified item.
(Defined by DependencyObjectExtensions)
Public Extension MethodVisualChildrenAndSelf Enumerates the specified item and it's immediate children.
(Defined by DependencyObjectExtensions)
Public Extension MethodVisualDescendants Enumerates all visuals descendants of the specified item.
(Defined by DependencyObjectExtensions)
Public Extension MethodVisualDescendantsAndSelf Enumerates the specified item and all it's visual descendants.
(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