ControlTemplate Clase

Definición

public ref class ControlTemplate sealed : FrameworkTemplate

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class ControlTemplate final : FrameworkTemplate

/// [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.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ControlTemplate final : FrameworkTemplate

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class ControlTemplate : FrameworkTemplate

[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.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ControlTemplate : FrameworkTemplate

Public NotInheritable Class ControlTemplate
Inherits FrameworkTemplate

<ControlTemplate ...>
    templateRootElement
</ControlTemplate>

Herencia

Object Platform::Object IInspectable DependencyObject FrameworkTemplate ControlTemplate

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Ejemplos

En el ejemplo siguiente se crea un controlTemplate simple para un button. La plantilla de control contiene una cuadrícula y especifica este comportamiento:

• Cuando el usuario coloca el mouse sobre el botón, la cuadrícula cambia de verde a rojo a medio segundo.
• Cuando el usuario mueve el mouse fuera del botón, grid cambia inmediatamente a verde.

<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to transition to the PointerOver state.-->
          <VisualTransition To="PointerOver" 
                              GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>
        
        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            Pointer is over the button.-->
        <VisualState x:Name="PointerOver">
          <Storyboard>
            <ColorAnimation Storyboard.TargetName="ButtonBrush" 
                            Storyboard.TargetProperty="Color" To="Red" />
          </Storyboard>
        </VisualState>
      </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Grid.Background>
      <SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
    </Grid.Background>
  </Grid>
</ControlTemplate>

Puedes ver la plantilla completa para cada control XAML en el archivo generic.xaml . Este archivo se encuentra en la carpeta (Archivos de programa)\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP<SDK version>\Generic.

Comentarios

Para obtener más información y ejemplos, consulta Plantillas de control XAML.

ControlTemplate se usa como valor de la propiedad Control.Template , que define los objetos visuales de un control aplicando la plantilla. Casi siempre defines un ControlTemplate como un recurso XAML, usando una clave implícita TargetType que sea la misma que un Estilo que establece Control.Template con un Establecedor. Rara vez si alguna vez asigna un valor para Control.Template directamente en una instancia de control.

En realidad, solo hay dos propiedades que se usan al definir un ControlTemplate: TargetType y el contenido XAML implícito. ControlTemplate hereda el comportamiento de contenido XAML implícito de su elemento primario FrameworkTemplate . Básicamente, el elemento contenido en un ControlTemplate tal y como se define en XAML está asignando un elemento raíz para una estructura adicional de elementos XAML que definen la plantilla. Se establece una propiedad "Template" que no se puede examinar posteriormente mediante código y que solo tiene significado para cómo el analizador XAML asigna contenido a los controles en función de aplicar esa plantilla.

Para que su contenido se establezca desde un ControlTemplate, un elemento de control debe ser una subclase Control true, de modo que tenga la propiedad Control.Template . Hay otros casos en los que las plantillas aplican contenido, pero esto normalmente implica una de las otras clases de plantilla derivadas de FrameworkTemplate (DataTemplate o ItemsPanelTemplate).

Las plantillas de control proporcionan los objetos visuales y los elementos que componen una instancia de un control tal como aparece en la interfaz de usuario de una aplicación. En tiempo de ejecución, la plantilla ya se ha aplicado, por lo que todas las partes que se crearon a partir de la plantilla ahora son partes verdaderas del control, y se puede acceder a ellas mediante técnicas como examinar los ámbitos de nombres XAML desde el contenido de control o mediante la clase VisualTreeHelper . Eventos como los eventos de entrada a veces exponen las partes de un control que proceden de la plantilla de control aplicada.

Hay maneras de acceder al contenido definido por la plantilla antes o después de aplicar la plantilla a una instancia de control específica; consulte OnApplyTemplate o GetTemplateChild.

El momento real en el que se aplica un ControlTemplate a una instancia de control se puede detectar porque invoca el método virtual protegido OnApplyTemplate . Siempre que el control no esté sellado, puede subclase un control para que tenga la oportunidad de invalidar OnApplyTemplate. Esta invalidación se puede escribir para realizar acciones que no serían posibles antes de aplicar la plantilla. Por ejemplo, puede conectar controladores de eventos para controlar elementos o establecer propiedades de control para hacer referencia a elementos de objeto creados fuera de la plantilla, pero que no comenzaron con un valor de extensión de marcado {TemplateBinding} .

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

• FrameworkTemplate
• DataTemplate
• OnApplyTemplate()
• Template
• Control
• Style
• Inicio rápido: Plantillas de control
• Plantillas de control XAML