GridSplitter.ShowsPreview Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft einen Wert ab, der angibt, ob das GridSplitter-Steuerelement die Größe der Spalte oder der Zeile aktualisiert, wenn der Benutzer das Steuerelement zieht, oder legt diesen Wert fest.

public:
 property bool ShowsPreview { bool get(); void set(bool value); };

public bool ShowsPreview { get; set; }

member this.ShowsPreview : bool with get, set

Public Property ShowsPreview As Boolean

Eigenschaftswert

Boolean

true, wenn eine GridSplitter-Vorschau angezeigt wird, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird das Festlegen der ShowsPreview-Eigenschaft veranschaulicht.

myGridSplitter.ShowsPreview = true;

myGridSplitter.ShowsPreview = True

<GridSplitter ShowsPreview="True" Width="5"
              Grid.Column="4" Grid.RowSpan="2"/>

Hinweise

Ein GridSplitter erfordert, dass ein AdornerDecorator Objekt in seiner übergeordneten Struktur vorhanden ist, um Feedback zum Ziehen der Vorschau anzuzeigen. Diese Anforderung wird in der Regel durch das AdornerDecorator Objekt erfüllt, das im Standardformat für oder in dem Window Objekt verfügbar ist, das AdornerDecorator von einem ScrollViewer Objekt erstellt wird. Wenn jedoch keiner dieser Elemente verfügbar ist, muss das GridSplitter Steuerelement sein eigenes AdornerDecorator Objekt definieren.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	ShowsPreviewProperty
Metadateneigenschaften auf true festgelegt	Keine

Wenn die ShowsPreview -Eigenschaft auf truefestgelegt ist, wird eine Vorschau der Änderung der Zeilen- oder Spaltengrößen angezeigt. Die tatsächliche Größe ändert sich, wenn das GridSplitter freigegeben wird. Wenn die -Eigenschaft auf falsefestgelegt ist, werden die Spalten- oder Zeilengrößen in Echtzeit aktualisiert, während der Benutzer das GridSplitter Steuerelement zieht.

Wenn die Tastatur zum Verschieben des Steuerelements verwendet wird, werden spalten GridSplitter - oder zeilengrößen in Echtzeit aktualisiert, auch wenn die ShowsPreview -Eigenschaft auf truefestgelegt ist.