Class
RedockService

Represents a service that allows a DockWindow state to be saved and restored later on.

Definition

Namespace:Telerik.WinControls.UI.Docking

Assembly:Telerik.WinControls.RadDock.dll

Syntax:

cs-api-definition
public class RedockService : RadDockService, IDisposable, INotifyPropertyChanged, INotifyPropertyChangingEx

Inheritance: objectRadDockObjectRadDockServiceRedockService

Implements: IDisposableINotifyPropertyChangedINotifyPropertyChangingEx

Inherited Members RadDockService.OnDockManagerChanged()RadDockService.OnEnabledChanged()RadDockService.CanOperate()RadDockService.DockManagerDesignModeRadDockService.DockManagerRadDockService.EnabledRadDockObject.Dispose()RadDockObject.Dispose(bool)RadDockObject.DisposeManagedResources()RadDockObject.DisposeUnmanagedResources()RadDockObject.OnPropertyChanging(string)RadDockObject.OnPropertyChanged(string)RadDockObject.ShouldSerializeProperty(string)RadDockObject.EventsRadDockObject.DisposingRadDockObject.IsDisposedRadDockObject.DisposedRadDockObject.PropertyChangingRadDockObject.PropertyChanged

Constructors

RedockService()

Default constructor.

Declaration

cs-api-definition
public RedockService()

Properties

IsCleanUpSuspended

Determines whether clean-up is currently suspended.

Declaration

cs-api-definition
public bool IsCleanUpSuspended { get; }

Property Value

bool

StatesForCleanup

Gets an array with all the states that are currently marked for clean-up.

Declaration

cs-api-definition
protected RedockState[] StatesForCleanup { get; }

Property Value

RedockState[]

Methods

CleanUp()

Removes previous redock states which are no longer valid. For example, if we save a state for a dock window in a Docked state, we need to remove any previous redock state for the Docked state.

Declaration

cs-api-definition
public void CleanUp()

ClearAllStates(DockWindow)

Removes all the redock states saved for the specified window.

Declaration

cs-api-definition
public void ClearAllStates(DockWindow window)

Parameters

window

DockWindow

ClearState(DockWindow, DockState)

Removes previously saved redock state for the specified window for the specified DockState.

Declaration

cs-api-definition
public bool ClearState(DockWindow window, DockState dockState)

Parameters

window

DockWindow

dockState

DockState

Returns

bool

GetNewDockState(DockState)

Retrieves the new DockState for a redock operation, depending on the provided current DockState.

Declaration

cs-api-definition
public static DockState GetNewDockState(DockState currState)

Parameters

currState

DockState

Returns

DockState

GetState(DockWindow, DockState, bool)

Gets a RedockState instance for the specified window and DockState.

Declaration

cs-api-definition
protected RedockState GetState(DockWindow window, DockState state, bool remove)

Parameters

window

DockWindow

The window for which to look-up a state.

state

DockState

The DockState to look-up for.

remove

bool

True to remove the redock state from the list, false otherwise.

Returns

RedockState

IsSaveApplicable(DockWindow)

Determines whether a Save operation is applicable for the specified window. Currently supported states are Docked and Floating.

Declaration

cs-api-definition
public bool IsSaveApplicable(DockWindow window)

Parameters

window

DockWindow

Returns

bool

Redock(DockWindow, RedockTransactionReason, bool)

Performs a redock operation upon specified window.

Declaration

cs-api-definition
public void Redock(DockWindow window, RedockTransactionReason reason, bool defaultAction)

Parameters

window

DockWindow

reason

RedockTransactionReason

defaultAction

bool

True to perform default action if no state is recorded for a window, false otherwise.

Redock(DockWindow, bool)

Declaration

cs-api-definition
public void Redock(DockWindow window, bool defaultAction)

Parameters

window

DockWindow

defaultAction

bool

Redock(IEnumerable<DockWindow>, RedockTransactionReason, bool)

Performs a redock operation upon specified windows.

Declaration

cs-api-definition
public void Redock(IEnumerable<DockWindow> windows, RedockTransactionReason reason, bool defaultAction)

Parameters

windows

IEnumerable<DockWindow>

reason

RedockTransactionReason

defaultAction

bool

True to perform default action if no state is recorded for a window, false otherwise.

Redock(IEnumerable<DockWindow>, bool)

Performs a redock operation upon specified windows.

Declaration

cs-api-definition
public void Redock(IEnumerable<DockWindow> windows, bool defaultAction)

Parameters

windows

IEnumerable<DockWindow>

defaultAction

bool

True to perform default action if no state is recorded for a window, false otherwise.

RemovePreviousState(RedockState)

Releases previous redock state. Current implementation simply notifies the referenced DockTabStrip that it is not a redock target anymore.

Declaration

cs-api-definition
protected void RemovePreviousState(RedockState oldState)

Parameters

oldState

RedockState

RestoreState(DockWindow, DockState, bool)

Attempts to restore the state the window to the desired dock state.

Declaration

cs-api-definition
public void RestoreState(DockWindow window, DockState state, bool defaultAction)

Parameters

window

DockWindow

state

DockState

The target state which is to be restored.

defaultAction

bool

True to perform default action if no state is recorded for a window, false otherwise.

RestoreState(IEnumerable<DockWindow>, DockState, bool)

Attempts to restore the state of each window to the specified one.

Declaration

cs-api-definition
public void RestoreState(IEnumerable<DockWindow> windows, DockState state, bool defaultAction)

Parameters

windows

IEnumerable<DockWindow>

state

DockState

The target state which is to be restored.

defaultAction

bool

True to perform default action if no state is recorded for a window, false otherwise.

ResumeCleanUp(bool)

Resumes previously suspended clean-up.

Declaration

cs-api-definition
public void ResumeCleanUp(bool forceCleanUp)

Parameters

forceCleanUp

bool

True to force a clean-up pass, false otherwise.

SaveState(DockWindow)

Saves the current state of the specified window.

Declaration

cs-api-definition
public virtual bool SaveState(DockWindow window)

Parameters

window

DockWindow

Returns

bool

SaveStateCore(DockWindow)

Preforms the core Save logic.

Declaration

cs-api-definition
protected virtual bool SaveStateCore(DockWindow window)

Parameters

window

DockWindow

Returns

bool

SuspendCleanUp()

Temporary suspends any clean-up operations. Used by the owning RadDock instance to prevent undesired processing during multiple transactions stack.

Declaration

cs-api-definition
public void SuspendCleanUp()