Esempio di ControlTemplate del controllo ListBox

Aggiornamento: novembre 2007

I controlli disponibili in Windows Presentation Foundation (WPF) includono un oggetto ControlTemplate che contiene la relativa struttura ad albero visuale. È possibile modificare la struttura e l'aspetto di un controllo modificando il relativo oggetto ControlTemplate. Non è possibile sostituire solo una parte della struttura ad albero visuale di un controllo. Per modificare la struttura ad albero visuale di un controllo, è necessario impostare la proprietà Template di tale controllo sul relativo oggetto ControlTemplate nuovo e completo.

In questo argomento viene illustrato l'oggetto ControlTemplate del controllo ListBox di WPF.

Nel presente argomento sono contenute le seguenti sezioni.

  • Prerequisiti
  • Esempio di ControlTemplate del controllo ListBox
  • Argomenti correlati

Prerequisiti

Per eseguire gli esempi di questo argomento, è necessario disporre di conoscenze su come scrivere applicazioni WPF. Per ulteriori informazioni, vedere Guida introduttiva a Windows Presentation Foundation. È inoltre necessario comprendere l'utilizzo degli stili in WPF. Per ulteriori informazioni, vedere Applicazione di stili e modelli.

Esempio di ControlTemplate del controllo ListBox

Anche se questo esempio contiene tutti gli elementi definiti nell'oggetto ControlTemplate di un controllo ListBox per impostazione predefinita, i valori specifici devono essere considerati come esempi.

<Style x:Key="{x:Type ListBox}" TargetType="ListBox">
  <Setter Property="SnapsToDevicePixels" Value="true"/>
  <Setter Property="OverridesDefaultStyle" Value="true"/>
  <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Auto"/>
  <Setter Property="ScrollViewer.VerticalScrollBarVisibility" Value="Auto"/>
  <Setter Property="ScrollViewer.CanContentScroll" Value="true"/>
  <Setter Property="MinWidth" Value="120"/>
  <Setter Property="MinHeight" Value="95"/>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="ListBox">
        <Border 
          Name="Border" 
          Background="{StaticResource WindowBackgroundBrush}"
          BorderBrush="{StaticResource SolidBorderBrush}"
          BorderThickness="1"
          CornerRadius="2">
          <ScrollViewer 
            Margin="0"
            Focusable="false">
            <StackPanel Margin="2" IsItemsHost="True" />
          </ScrollViewer>
        </Border>
        <ControlTemplate.Triggers>
          <Trigger Property="IsEnabled" Value="false">
            <Setter TargetName="Border" Property="Background"
                    Value="{StaticResource DisabledBackgroundBrush}" />
            <Setter TargetName="Border" Property="BorderBrush"
                    Value="{StaticResource DisabledBorderBrush}" />
          </Trigger>
          <Trigger Property="IsGrouping" Value="true">
            <Setter Property="ScrollViewer.CanContentScroll" Value="false"/>
          </Trigger>
        </ControlTemplate.Triggers>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Nell'esempio precedente vengono utilizzate le risorse seguenti.

<SolidColorBrush x:Key="WindowBackgroundBrush" Color="#FFF" />


...


<SolidColorBrush x:Key="SolidBorderBrush" Color="#888" />


...


<SolidColorBrush x:Key="DisabledBackgroundBrush" Color="#EEE" />


...


<SolidColorBrush x:Key="DisabledBorderBrush" Color="#AAA" />

Per l'esempio completo, vedere Esempio di applicazione di stili con ControlTemplate.

Vedere anche

Concetti

Linee guida per la progettazione di controlli a cui è possibile applicare degli stili

Esempio di ControlTemplate del controllo ListBoxItem

Altre risorse

Esempi di ControlTemplate