CDockState::GetVersionĬall this function to retrieve the version number of the stored bar state. This includes not only whether the bar is docked or not, but the bar's size and position and whether or not it is visible. Inheritance HierarchyĬall this function to clear all docking information stored in the CDockState object. If you later want to restore the state of the control bars in the frame window, you can load the state with Serialize or CDockState::LoadState, then use CFrameWnd::SetDockState to apply the saved state to the frame window's control bars.įor more information on docking control bars, see the articles Control Bars, Toolbars: Docking and Floating, and Frame Windows. You can then write the contents of the CDockState object to storage with Serialize or CDockState::SaveState. CDockState objects are written and read to or from a file via a CArchive object.ĬFrameWnd::GetDockState retrieves the state information of all the frame window's CControlBar objects and puts it into the CDockState object. The bar can be any dockable control bar, including a toolbar, status bar, or dialog bar. INI file, or in binary form as part of a CArchive object's contents. The main purpose of CDockState is to hold the entire state of a number of control bars and to allow that state to be saved and loaded either to the registry, the application's. When retrieving the stored dock state, CDockState checks the bar's position and, if the bar is not visible with the current screen settings, CDockState scales the bar's position so that it is visible. The dock state includes the size and position of the bar and whether or not it is docked. Saves state information to the registry or INI file.Īrray of pointers to the stored dock state information with one entry for each control bar. Retrieves state information from the registry or.

Retrieves the version number of the stored bar state. A serialized CObject class that loads, unloads, or clears the state of one or more docking control bars in persistent memory (a file).

Cdock themes