BlockUIContainer.Child Propiedad

Definición

Obtiene o establece el elemento UIElement hospedado por BlockUIContainer.Gets or sets the UIElement hosted by the BlockUIContainer.

public:
 property System::Windows::UIElement ^ Child { System::Windows::UIElement ^ get(); void set(System::Windows::UIElement ^ value); };
public System.Windows.UIElement Child { get; set; }
member this.Child : System.Windows.UIElement with get, set
Public Property Child As UIElement

Valor de propiedad

Ejemplos

En el ejemplo siguiente se muestra cómo usar BlockUIContainer los elementos para UIElement hospedar elementos dentro del contenido dinámico.The following example shows how to use the BlockUIContainer elements to host UIElement elements within flow content.

<FlowDocument ColumnWidth="400">
  <Section Background="GhostWhite">
    <Paragraph>
      A UIElement element may be embedded directly in flow content
      by enclosing it in a BlockUIContainer element.
    </Paragraph>
    <BlockUIContainer>
      <Button>Click me!</Button>
    </BlockUIContainer>
    <Paragraph>
      The BlockUIContainer element may host no more than one top-level
      UIElement.  However, other UIElements may be nested within the
      UIElement contained by an BlockUIContainer element.  For example,
      a StackPanel can be used to host multiple UIElement elements within
      a BlockUIContainer element.
    </Paragraph>
    <BlockUIContainer>
      <StackPanel>
        <Label Foreground="Blue">Choose a value:</Label>
        <ComboBox>
          <ComboBoxItem IsSelected="True">a</ComboBoxItem>
          <ComboBoxItem>b</ComboBoxItem>
          <ComboBoxItem>c</ComboBoxItem>
        </ComboBox>
        <Label Foreground ="Red">Choose a value:</Label>
        <StackPanel>
          <RadioButton>x</RadioButton>
          <RadioButton>y</RadioButton>
          <RadioButton>z</RadioButton>
        </StackPanel>
        <Label>Enter a value:</Label>
        <TextBox>
          A text editor embedded in flow content.
        </TextBox>
      </StackPanel>
    </BlockUIContainer>
  </Section>
</FlowDocument>

En la ilustración siguiente, se muestra cómo se representa este ejemplo.The following figure shows how this example renders.

![Captura Captura de pantalla de UIElement]Embedded in Flow Content(~/add/media/blockuicontainer.png ": UIElement Embedded en el contenido dinámico")Screenshot: UIElement embedded in flow content

En el ejemplo siguiente se muestra cómo utilizar Child la propiedad mediante programación.The following example shows how to use the Child property programmatically.

Section secx = new Section();
Paragraph par1 = new Paragraph(new Run(" Text to precede the button... "));
Paragraph par2 = new Paragraph(new Run(" Text to follow the button... "));

// Create a new button to be hosted in the section.
Button buttonx = new Button();
buttonx.Content = "Click me!";

// Create a new BlockUIContainer, and assign the button 
// as the UI container's child.
BlockUIContainer uiCont = new BlockUIContainer();
uiCont.Child = buttonx;

// Add the text runs and UI container to the paragraph, in order.
secx.Blocks.Add(par1);
secx.Blocks.Add(uiCont);
secx.Blocks.Add(par2);
Dim secx As New Section()
Dim par1 As New Paragraph(New Run(" Text to precede the button... "))
Dim par2 As New Paragraph(New Run(" Text to follow the button... "))

' Create a new button to be hosted in the section.
Dim buttonx2 As New Button()
buttonx2.Content = "Click me!"

' Create a new BlockUIContainer, and assign the button 
' as the UI container's child.
Dim uiCont2 As New BlockUIContainer()
uiCont2.Child = buttonx2

' Add the text runs and UI container to the paragraph, in order.
secx.Blocks.Add(par1)
secx.Blocks.Add(uiCont2)
secx.Blocks.Add(par2)

Comentarios

Un BlockUIContainer puede hospedar directamente a más de UIElement un elemento secundario.An BlockUIContainer may directly host no more than one UIElement child. Sin embargo, el elemento secundario hospedado BlockUIContainer por puede hospedar elementos secundarios propios.However, the child element hosted by an BlockUIContainer may host children of its own.

En XAMLXAML, el ajuste UIElement de un BlockUIContainer en es equivalente a establecerlo UIElement como el valor de Child la propiedad.In XAMLXAML, wrapping a UIElement in an BlockUIContainer is equivalent to setting that UIElement as the value of the Child property.

Se aplica a