CBCGPAppBarWnd

Detailed Description

An application desktop toolbar is a window that attaches itself to an edge of your screen. It registers with the system and reserves a part of the screen.

The CBCGPAppBarWnd class implements the following functionality:

• dock to a screen edge
• switch to autohide mode
• float in the middle of the screen
• free resizing in floating mode and one-dimension resizing when docked
• can be dragged and re-docked with a mouse

To use the application bar you should first call the Create() member function. It's advisable to embed your custom window into the client area of the application bar. Call SetSide() to dock the application bar to the screen edge or Float() to enable floating mode. Use SetAlwaysOnTop() to switch to autohide mode and SetAutoHide() to manage always-on-top state.

The CBCGPAppBarWnd class registers with the system as application toolbar and handles in the AppBarCallback() callback-function all the application bar notification messages that system sent:

• ABN_STATECHANGE
• ABN_FULLSCREENAPP
• ABN_POSCHANGED
• ABN_WINDOWARRANGE

If you need special processing for these notifications, then you can override the appropriate virtual member function (see OnAppBarPosChanged(), OnAppBarFullScreenApp(), OnAppBarWindowArrange(), OnAppBarStateChange()).

To manage the application toolbar and communicate with the system the application bar uses the following system messages:

• ABM_NEW
• ABM_REMOVE
• ABM_QUERYPOS
• ABM_SETPOS
• ABM_GETTASKBARPOS
• ABM_GETSTATE
• ABM_GETAUTOHIDEBAR
• ABM_SETAUTOHIDEBAR
• ABM_ACTIVATE

The CBCGPAppBarWnd class has wrapper functions for all these messages. Usually, you don't need to call directly any wrapper functions, the framework does all necessary calls.

See also

CBCGPAppBarWnd::APPBARSTATE, CBCGPAppBarWnd::AppBarCallback

Inherits CWnd.

Classes
struct	tagAPPBARSTATE

Public Member Functions
	AppBarCallback	Handles application bar notification messages.
	Create	Creates and registers application bar.
	Float	Floats an application bar on the screen.
	Float	Floats an application bar on the screen at specific location.
	GetAlwaysOnTop	Retrieves the current always-on-top state.
	GetAutoHide	Returns the current auto-hide state
	GetAutoHideBar	Retrieve a handle to an autohide application bar associated with an edge of the screen.
	GetPos	Retrieve the bounding rectangle of the Windows task bar.
	GetSide	Returns the edge of the screen where the application bar is currently docked at.
	GetState	Retrieves the auto-hide and always-on-top states of the application bar.
	Hide	Hides an application bar.
	LoadState	Loads application bar state from the registry.
	OnAppBarFullScreenApp	Called by the framework to handle the system ABN_FULLSCREENAPP message.
	OnAppBarPosChanged	Called by the framework to handle the system ABN_POSCHANGED notification.
	OnAppBarStateChange	Called by the framework to handle the system ABN_STATECHANGE message.
	OnAppBarWindowArrange	Called by the framework to handle the system ABN_WINDOWARRANGE message.
	QueryPos	Requests a size and a screen position for an application bar.
	Register	Registers a new application bar.
	SaveState	Saves state of application bar.
	SetAlwaysOnTop	Enables or disables the always-on-top mode.
	SetAutoHide	Enable or disable auto-hiding.
	SetAutoHideBar	Register or unregister an auto-hide application bar
	SetPos	Sets the size and screen position of an application bar.
	SetSide	Docks an application bar at the specified side of the screen.
	UnHide	Shows an application bar.
	UnRegister	Unregisters an application bar.

Protected Types
	APPBARSTATE	The structure holds main application bar settings.

Protected Attributes
	m_abs	Stores the main application bar's settings.
	m_bDisableAnimation	Enables or disables animation.
	m_dwFlags	Combination of flags applied to the application bar.
	m_hEmbeddedBar	Handle of the embedded window.
	m_nCaptionHeight	Specifies the caption height of the application bar window.

Static Protected Attributes
	m_uAppBarNotifyMsg	Specifies the message identifier that the system should use to send the application bar notification messages.