Skip to end of metadata
Go to start of metadata

Remarks

BlockUIContainer enables UIElement elements (i.e. a Button or Image) to be embedded in block elements. InlineUIContainer is used to embed UIElement elements in inline elements. For more information about InlineUIContainer, see InlineUIContainer. BlockUIContainer and InlineUIContainer are important because there is no other way to use a UIElement in flow content unless it is contained within one of these two elements. Note that the UIElement elements inside BlockUIContainer or InlineUIContainer will not flow if the space width is not enough. In that case, the UIElement elements will be clipped.

BlockUIContainer element may host no more than one top-level UIElement. However, other UIElement elements maybe nested within the UIElement contained by the BlockUIContainer element. For example, a StackPanel can be used to host multiple UIElement elements within a BlockUIContainer element.

XAML

When FlowDocument is in page mode and the content inside BlockUIContainer is quite large, it will be shifted to the next page. If it still does not fit in the next page, the content will be clipped. However, if the BlockUIContainer element is the first element of FlowDocument and its content does not fit in the page, it will be clipped in the first page.

Definition

public class BlockUIContainer : Block

Summary

The following table summarizes the members exposed in this class.

Public Constructors

BlockUIContainer Constructor()Initializes a new instance of the BlockUIContainer class.
BlockUIContainer Constructor(UIElement)Initializes a new instance of the BlockUIContainer class.

Public Properties

ChildGets or sets the top-level UIElement as the child of this element.

Fields

ChildPropertyIdentifies the Child dependency property.

Public Constructors

public BlockUIContainer()

Initializes a new instance of the BlockUIContainer class.

public BlockUIContainer(UIElement element)

Initializes a new instance of the BlockUIContainer class.

Parameters

element 

 

Public Properties

public UIElement Child { get; set; }

Gets or sets the top-level UIElement as the child of this element.

Fields

public static readonly DependencyProperty ChildProperty

Identifies the Child dependency property.

  • No labels