GridSplitter.ShowsPreview Property

Gets or sets whether the GridSplitter control updates the column or row size as the user drags the control.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:

public bool ShowsPreview { get; set; }
/** @property */
public boolean get_ShowsPreview ()

/** @property */
public void set_ShowsPreview (boolean value)

public function get ShowsPreview () : boolean

public function set ShowsPreview (value : boolean)

<object ShowsPreview="bool" .../>

Property Value

true if a GridSplitter preview is displayed; otherwise, false. The default value is false.

Identifier field


Metadata properties set to true


When the ShowsPreview property is set to true, a preview of the change in the row or column sizes is shown. The actual size changes when the GridSplitter is released. If the property is set to false, the column or row sizes are updated in real time as the user drags the GridSplitter control.

If you use the keyboard to move the GridSplitter control, column or row sizes are updated in real time even if the ShowsPreview property is set to true.

A GridSplitter requires an AdornerDecorator object to be present in its parent tree in order to display drag preview feedback. This requirement is typically met by the AdornerDecorator object that is available in the default style for the Window, or in the AdornerDecorator object that is created by a ScrollViewer object. However, if neither of these is available, the GridSplitter control must define its own AdornerDecorator object.

The following example shows how to set the ShowsPreview property.

myGridSplitter.ShowsPreview = true;

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions