InlineUIContainer Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Documents

Proporciona un elemento de contenido insertado que permite que los tipos UIElement se inserten en el contenido de un RichTextBlock.

public ref class InlineUIContainer sealed : Inline

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Child")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InlineUIContainer final : Inline

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Child")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InlineUIContainer : Inline

Public NotInheritable Class InlineUIContainer
Inherits Inline

<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
  singleChild
</InlineUIContainer>

Herencia

Object Platform::Object IInspectable DependencyObject TextElement Inline InlineUIContainer

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo de código siguiente se muestra cómo se puede insertar una imagen en un RichTextBlock mediante InlineUIContainer.

<RichTextBlock>
    <Paragraph>
        <Italic>This is an inline image.</Italic>

        <InlineUIContainer>
            <Image Source="Assets/SmallLogo.png" Height="30" Width="30"/>
        </InlineUIContainer>

        Mauris auctor tincidunt auctor.
    </Paragraph>
</RichTextBlock>

Comentarios

El escenario más común para usar un objeto InlineUIContainer es introducir una imagen en el contenido de texto. Use un nuevo objeto Image para la imagen, como contenido secundario para un inlineUIContainer. Establezca Alto y Ancho en la imagen si no quiere que se escale al tamaño de la imagen natural.

Si desea más de un elemento insertado en la misma posición, considere la posibilidad de usar un panel como el único elemento secundario InlineUIContainer y, a continuación, colocar los varios elementos dentro de ese panel.

Si se coloca dentro de un inlineUIContainer, un control que se puede centrar sigue apareciendo en la secuencia de pestañas de nivel superior.

Si desea texto interactivo, considere la posibilidad de usar un elemento Hyperlink (un tipo de Inline) en lugar de usar InlineUIContainer con un Button o similar dentro de él. Consulte Directrices para obtener vínculos.

InlineUIContainer hereda las propiedades de la clase TextElement . Sin embargo, la mayoría de estas propiedades no tienen ningún efecto visible. Es más común declarar un elemento de objeto InlineUIContainer en XAML sin que haya ningún conjunto de atributos (excepto posiblemente x:Name) con el único elemento secundario que se va a insertar como contenido del elemento de objeto InlineUIContainer.

Establecer propiedades en InlineUIContainer que, de lo contrario, afectan al alto de línea de caracteres de un elemento de texto (como FontSize, FontFamily) no tiene ningún efecto en la representación y apariencia. El contenido determina su tamaño y los tamaños InlineUIContainer para ajustarse a él.

Si hay más texto dentro del contenido secundario (como TextBlock.Text u otros elementos de texto dentro de un RichTextBlock anidado), las propiedades de elemento de texto del elemento primario InlineUIContainer no heredarán en el contenido, se omitirán.

Constructores

InlineUIContainer()

Inicializa una nueva instancia de la clase InlineUIContainer .

Propiedades

AccessKey	Obtiene o establece la clave de acceso de este elemento. (Heredado de TextElement)
AccessKeyScopeOwner	Obtiene o establece un elemento de origen que proporciona el ámbito de la clave de acceso para este elemento, aunque no esté en el árbol visual del elemento de origen. (Heredado de TextElement)
AllowFocusOnInteraction	Obtiene o establece un valor que indica si el elemento obtiene automáticamente el foco cuando el usuario interactúa con él. (Heredado de TextElement)
CharacterSpacing	Obtiene o establece el espaciado uniforme entre caracteres, en unidades de 1/1000 de un elemento em. (Heredado de TextElement)
Child	Obtiene o establece el UIElement hospedado por InlineUIContainer.
ContentEnd	Obtiene un TextPointer que representa el final del contenido del elemento . (Heredado de TextElement)
ContentStart	Obtiene un TextPointer que representa el inicio del contenido en el elemento . (Heredado de TextElement)
Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
ElementEnd	Obtiene un TextPointer que representa la posición justo después del final del elemento. (Heredado de TextElement)
ElementStart	Obtiene un TextPointer que representa la posición justo antes del inicio del elemento. (Heredado de TextElement)
ExitDisplayModeOnAccessKeyInvoked	Obtiene o establece un valor que especifica si se descarta la presentación de la clave de acceso cuando se invoca una clave de acceso. (Heredado de TextElement)
FontFamily	Obtiene o establece la familia de fuentes de nivel superior preferida para el contenido del elemento. (Heredado de TextElement)
FontSize	Obtiene o establece el tamaño de fuente para el contenido del elemento. (Heredado de TextElement)
FontStretch	Obtiene o establece el ancho del glifo de la fuente de una familia que se va a seleccionar. (Heredado de TextElement)
FontStyle	Obtiene o establece el estilo de fuente para el contenido de este elemento. (Heredado de TextElement)
FontWeight	Obtiene o establece el peso de fuente de nivel superior que se va a seleccionar en la familia de fuentes del contenido de este elemento. (Heredado de TextElement)
Foreground	Obtiene o establece el pincel que se va a aplicar al contenido de este elemento. (Heredado de TextElement)
IsAccessKeyScope	Obtiene o establece un valor que indica si un elemento define su propio ámbito de clave de acceso. (Heredado de TextElement)
IsTextScaleFactorEnabled	Obtiene o establece si la ampliación automática del texto, para reflejar la configuración del tamaño de texto del sistema, está habilitada. (Heredado de TextElement)
KeyTipHorizontalOffset	Obtiene o establece un valor que indica la distancia izquierda o derecha que se coloca la información sobre claves en relación con el elemento de texto. (Heredado de TextElement)
KeyTipPlacementMode	Obtiene o establece un valor que indica dónde se coloca la información sobre claves en relación con el elemento de texto. (Heredado de TextElement)
KeyTipVerticalOffset	Obtiene o establece un valor que indica la distancia hacia arriba o hacia abajo de la información sobre claves en relación con el elemento de texto. (Heredado de TextElement)
Language	Obtiene o establece información de idioma de localización o globalización que se aplica a un TextElement. (Heredado de TextElement)
Name	Obtiene o establece una identificación única para el objeto . El nombre solo se puede establecer a partir del análisis inicial de XAML. (Heredado de TextElement)
TextDecorations	Obtiene o establece un valor que indica qué decoraciones se aplican al texto. (Heredado de TextElement)
XamlRoot	Obtiene o establece el xamlRoot en el que se está viendo este elemento. (Heredado de TextElement)

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
FindName(String)	Recupera un objeto en el gráfico de objetos en tiempo de ejecución o modelo de objetos haciendo referencia al valor del atributo x:Name o Name del objeto. (Heredado de TextElement)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
OnDisconnectVisualChildren()	Invalide este método para implementar cómo debe comportarse el diseño y la lógica cuando los elementos se quitan de una propiedad secundaria o contenido específico de clase. (Heredado de TextElement)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Eventos

AccessKeyDisplayDismissed	Se produce cuando la secuencia de claves de acceso se completa para notificar a los controles que deben ocultar los objetos visuales de clave de acceso. (Heredado de TextElement)
AccessKeyDisplayRequested	Se produce cuando se inicia la secuencia de claves de acceso para notificar a los controles que deben mostrar objetos visuales de clave de acceso. (Heredado de TextElement)
AccessKeyInvoked	Se produce cuando un usuario completa una secuencia de claves de acceso para notificar al elemento que se debe invocar la acción de clave de acceso. (Heredado de TextElement)

Consulte también

• Inline
• RichTextBlock
• UIElement