Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

VisualState-Klasse

.NET Framework 4

Stellt das Erscheinungsbild des Steuerelements dar, wenn es sich in einem bestimmten Zustand befindet.

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.VisualState

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
C#
C++
F#
VB
Kopieren 
[ContentPropertyAttribute("Storyboard")]
[RuntimeNamePropertyAttribute("Name")]
public class VisualState : DependencyObject
Verwendung von XAML-Objektelementen
Kopieren 
<VisualState>
  Storyboard
</VisualState>

Der VisualState-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode VisualState Initialisiert eine neue Instanz der VisualState-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft DependencyObjectType Ruft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt.  (Von DependencyObject geerbt.)
Öffentliche Eigenschaft Dispatcher Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
Öffentliche Eigenschaft IsSealed Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.)
Öffentliche Eigenschaft Name Ruft den Namen des VisualState-Objekts ab oder legt diesen fest.
Öffentliche Eigenschaft Storyboard Ruft ein Storyboard ab, das die Darstellung des Steuerelements definiert, wenn es sich in dem durch VisualState dargestellten Zustand befindet, oder legt dieses fest.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode CheckAccess Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
Öffentliche Methode ClearValue(DependencyProperty) Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben. (Von DependencyObject geerbt.)
Öffentliche Methode ClearValue(DependencyPropertyKey) Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyPropertyKey angegeben. (Von DependencyObject geerbt.)
Öffentliche Methode CoerceValue Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Für die Umwandlung wird eine vorhandene CoerceValueCallback-Funktion aufgerufen, die in den Metadaten der Abhängigkeitseigenschaft für das aufrufende DependencyObject angegeben ist. (Von DependencyObject geerbt.)
Öffentliche Methode Equals Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Von DependencyObject geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetHashCode Ruft einen Hashcode für dieses DependencyObject ab. (Von DependencyObject geerbt.)
Öffentliche Methode GetLocalValueEnumerator Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Von DependencyObject geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode GetValue Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft in dieser Instanz eines DependencyObject zurück. (Von DependencyObject geerbt.)
Öffentliche Methode InvalidateProperty Berechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neu (Von DependencyObject geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode OnPropertyChanged Wird immer dann aufgerufen, wenn der tatsächliche Wert einer Abhängigkeitseigenschaft eines DependencyObject aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die sich geändert hat, wird in den Ereignisdaten angegeben. (Von DependencyObject geerbt.)
Öffentliche Methode ReadLocalValue Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück. (Von DependencyObject geerbt.)
Öffentliche Methode SetCurrentValue Legt den Wert einer -Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Von DependencyObject geerbt.)
Öffentliche Methode SetValue(DependencyProperty, Object) Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird. (Von DependencyObject geerbt.)
Öffentliche Methode SetValue(DependencyPropertyKey, Object) Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die über ihren DependencyPropertyKey-Bezeichner angegeben wird. (Von DependencyObject geerbt.)
Geschützte Methode ShouldSerializeProperty Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Von DependencyObject geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche Methode VerifyAccess Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
Zum Seitenanfang

Ein VisualState gibt die Darstellung des Steuerelements in einem bestimmten Zustand an. Wenn z. B. ein Button gedrückt wird, kann er eine andere Rahmenfarbe als sonst aufweisen. Die VisualState-Klasse verfügt über eine Storyboard-Eigenschaft, die die Darstellung des Steuerelements ändert. Wenn das Steuerelement in den von der VisualState.Name-Eigenschaft angegebenen Zustand eintritt, wird das Storyboard gestartet. Wenn das Steuerelement den Zustand verlässt, wird das Storyboard beendet.

Die VisualStateGroup.States-Eigenschaft enthält VisualState-Objekte. VisualStateGroup-Objekte werden zur angefügten VisualStateManager.VisualStateGroups-Eigenschaft hinzugefügt, die in einem FrameworkElement definiert wird. Sie können VisualState-Objekte zu jedem FrameworkElement hinzufügen, sie werden jedoch in der Regel in einer ControlTemplate eines Control verwendet. Weitere Informationen zum Erstellen eines ControlTemplate-Objekts und eines VisualState-Objekts für vorhandene Steuerelemente finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate. Ein Beispiel zur Verwendung von VisualState-Objekten außerhalb einer ControlTemplate finden Sie in der VisualStateManager-Klasse.

Im folgenden Codebeispiel wird eine VisualStateGroup in der ControlTemplate eines Button mit dem Namen CommonStates erstellt, und es werden VisualState-Objekte für die Zustände Normal, Pressed und MouseOver hinzugefügt. Der Button definiert auch einen Zustand mit dem Namen Disabled in der VisualStateGroupCommonStates, dieser wurde aber der Kürze halber im Beispiel weggelassen. Das vollständige Beispiel finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate.

XAML
Kopieren 

  <!--Define the states and transitions for the common states.
      The states in the VisualStateGroup are mutually exclusive to
      each other.-->
  <VisualStateGroup Name="CommonStates">

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.-->
    <VisualState Name="Normal" />

    <!--Change the SolidColorBrush, BorderBrush, to red when the
        mouse is over the button.-->
    <VisualState Name="MouseOver">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color" 
                        To="Red" />
      </Storyboard>
    </VisualState>

    <!--Change the SolidColorBrush, BorderBrush, to Transparent when the
        button is pressed.-->
    <VisualState Name="Pressed">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color"
                        To="Transparent"/>
      </Storyboard>
    </VisualState>

    <!--The Disabled state is omitted for brevity.-->
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

.NET Framework

Unterstützt in: 4

.NET Framework Client Profile

Unterstützt in: 4

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ