Gewusst wie: Erweitern des Stils von DocumentViewer

Aktualisiert: November 2007

In diesem Beispiel wird veranschaulicht, wie der Standardstil eines DocumentViewer-Steuerelements erweitert wird.

Beispiel

Der folgende Extensible Application Markup Language (XAML)-Code definiert ein Fenster mit einem DocumentViewer-Steuerelement und einem zugehörigen Stil. Im Beispielstil wird das BasedOn-Attribut verwendet, um den DocumentViewer-Standardstil zu erweitern. In diesem Fall spiegelt der Beispielstil einfach den Hintergrundfarbverlauf wider, der vom Standardsymbolleistenstil verwendet wird, und wendet ihn auf den Rahmen und den Hintergrund des Bereichs für die Inhaltsanzeige an.

<Window x:Class="SDKSample.Window1"
        xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml">
  <Window.Resources>
    <Style 
      x:Key="MyDVStyleExtend"
      BasedOn="{StaticResource {x:Type DocumentViewer}}" 
      TargetType="{x:Type DocumentViewer}">
      <Setter Property="Background">
        <Setter.Value>
          <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
            <GradientStop Offset="0.0" Color="#CC99CCFF" />
            <GradientStop Offset="1.0" Color="White" />
          </LinearGradientBrush>
        </Setter.Value>
      </Setter>
    </Style>
  </Window.Resources>
  <Grid>
    <DocumentViewer  Style="{StaticResource MyDVStyleExtend}" Name="MyDocumentViewer"/>
  </Grid>
</Window>

Die folgende Abbildung zeigt, wie der formatierte DocumentViewer in diesem Beispiel (ohne Inhalt) rendert:

Beispiel für ein DocumentViewer-Steuerelement mit dem erweiterten Standardstil.

Aufgabenhinweise

• Da der in diesem Beispiel gezeigte Stil den DocumentViewer-Standardstil erweitert statt ersetzt, werden Benutzeroberfläche (user interface, UI)-Elemente, die vom DocumentViewer-Standardstil definiert werden (z. B. die Symbolleiste und das Kontextmenü), weiterhin angezeigt.

• Ein Stil wird durch Übereinstimmung des Stilschlüssels (x:Key) mit dem Wert, auf den das Style-Attribut eines Elements verweist, angewendet. Im oben stehenden Beispiel heißt der Stilschlüssel "MyDVStyleReplace". Der Schlüssel selbst ist ein beliebiger Zeichenfolgenwert, der innerhalb des aktuellen Bereichs eindeutig sein muss.

• Auf als lokale Ressourcen definierte Stile muss mit der StaticResource-Syntax aus dem oben stehenden Beispiel als statische Ressource verwiesen werden.

• Der Stil und ControlTempate geben mithilfe von TargetType an, dass der Stil nur auf DocumentViewer-Steuerelemente anwendbar ist. Ein Konflikt zwischen dem Zieltyp für den Stil oder die Steuerelementvorlage und dem Element, auf das der Stil angewendet wird, löst eine InvalidOperationException-Ausnahme aus.

Siehe auch

Aufgaben

Gewusst wie: Ersetzen des Stils von DocumentViewer

Referenz

DocumentViewer