Clase ControlTemplate
TOC
Collapse the table of content
Expand the table of content

ControlTemplate Class

Define el árbol de elementos que se aplica como plantilla para un control.

Herencia

Object
  DependencyObject
    FrameworkTemplate
      ControlTemplate

Sintaxis


public sealed class ControlTemplate : FrameworkTemplate


<ControlTemplate ...>
    templateRootElement
</ControlTemplate>

XAML Values

templateRootElement

Un elemento único de un objeto derivado de FrameworkElement. El elemento templateRootElement suele ser un panel que contiene otros elementos.

Atributos

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Members

A continuación se indican los tipos de miembros de ControlTemplate (Clase):

Constructores

A continuación se indican los constructores de ControlTemplate (Clase).

ConstructorDescripción
ControlTemplate Initializes a new instance of the ControlTemplate class.

 

Métodos

The ControlTemplate Clase tiene estos métodos. También hereda métodos de Object Clase.

MétodoDescripción
ClearValue Clears the local value of a dependency property. (Se hereda de DependencyObject)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Se hereda de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Se hereda de DependencyObject)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Se hereda de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Se hereda de DependencyObject)

 

Propiedades

ControlTemplateClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

Dispatcher

De sólo lecturaGets the CoreDispatcher that this object is associated with. (Se hereda de DependencyObject)

TargetType

Lectura/escrituraGets or sets the type to which the ControlTemplate is applied.

 

Comentarios

El contenido de una plantilla como ControlTemplate o DataTemplate no es accesible a través de una API simple en tiempo de ejecución. La definición de una plantilla es un escenario para el uso del lenguaje XAML y el valor se asigna simplemente como una operación de análisis de XAML. Hay algunas maneras de tener acceso al contenido de la plantilla después de que se aplique a un control concreto; vea OnApplyTemplate o GetTemplateChild.

Ejemplos

En el ejemplo siguiente se crea un objeto ControlTemplate simple para un control Button. La plantilla de control contiene un objeto Grid y especifica este comportamiento:

  • Cuando el usuario coloca el mouse sobre Button, Grid cambia de verde a rojo durante medio segundo.

  • Cuando el usuario mueve el mouse fuera del botón, Grid vuelve a cambiar 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>


Requisitos

Cliente mínimo admitido

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadatos

Windows.winmd

Vea también

FrameworkTemplate

 

 

Mostrar:
© 2018 Microsoft