Child Property (BlockUIContainer)

Visual Basic (Declaration)
Visual Basic (Usage)
C#
C++/CLI

Public Property Child As UIElement

Dim instance As BlockUIContainer
Dim value As UIElement
 
instance.Child = value
 
value = instance.Child

public UIElement Child {get; set;}

public:
property UIElement^ Child {
   UIElement^ get();
   void set (    UIElement^ value);
}

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	Copy Code
<Intersoft:FlowDocument> <Intersoft:BlockUIContainer> <StackPanel> <Image Source="/Assets/Images/john.jpg"/> <TextBlock Text="My name is John Doe."/> </StackPanel> </Intersoft:BlockUIContainer> </Intersoft:FlowDocument>

XAML

Copy Code

<Intersoft:FlowDocument>
    <Intersoft:BlockUIContainer>
        <StackPanel>
            <Image Source="/Assets/Images/john.jpg"/>
            <TextBlock Text="My name is John Doe."/>
        </StackPanel>
    </Intersoft:BlockUIContainer>
</Intersoft:FlowDocument>

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.

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

BlockUIContainer Class
BlockUIContainer Members