Intersoft ClientUI Documentation
BlockUIContainer Class
Members  See Also  Send Feedback
Intersoft.Client.Documents Namespace : BlockUIContainer Class






A block-level flow content element which enables UIElement elements (i.e. a Button) to be embedded (hosted) in flow content.

Object Model

BlockUIContainer Class

Syntax

Visual Basic (Declaration) 
<ContentPropertyAttribute("Child")>
Public Class BlockUIContainer 
   Inherits Block
Visual Basic (Usage)Copy Code
Dim instance As BlockUIContainer
C# 
[ContentPropertyAttribute("Child")]
public class BlockUIContainer : Block
Delphi 
public class BlockUIContainer = class(Block)
JScript 
ContentPropertyAttribute("Child")
public class BlockUIContainer extends Block
Managed Extensions for C++ 
[ContentPropertyAttribute("Child")]
public __gc class BlockUIContainer : public Block
C++/CLI 
[ContentPropertyAttribute("Child")]
public ref class BlockUIContainer : public Block

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 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.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      Intersoft.Client.Documents.TextElement
         Intersoft.Client.Documents.Block
            Intersoft.Client.Documents.BlockUIContainer

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.