path: root/mmc_updater/depends/win32cpp/taskdialog.h

// Win32++   Version 7.2
// Released: 5th AUgust 2011
//
//      David Nash
//      email: dnash@bigpond.net.au
//      url: https://sourceforge.net/projects/win32-framework
//
//
// Copyright (c) 2005-2011  David Nash
//
// Permission is hereby granted, free of charge, to
// any person obtaining a copy of this software and
// associated documentation files (the "Software"),
// to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify,
// merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom
// the Software is furnished to do so, subject to the
// following conditions:
//
// The above copyright notice and this permission notice
// shall be included in all copies or substantial portions
// of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
// ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
// TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
// PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
// SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
// ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
// OR OTHER DEALINGS IN THE SOFTWARE.
//
////////////////////////////////////////////////////////


////////////////////////////////////////////////////////
// taskdialog.h
//  Declaration of the CTaskDialog class

// A task dialog is a dialog box that can be used to display information 
// and receive simple input from the user. Like a message box, it is 
// formatted by the operating system according to parameters you set. 
// However, a task dialog has many more features than a message box.

// NOTES:  
//  Task Dialogs are only supported on Windows Vista and above.
//  Task Dialogs require XP themes enabled (use version 6 of Common Controls)
//  Task Dialogs are always modal.


#ifndef _WIN32XX_TASKDIALOG_H_
#define _WIN32XX_TASKDIALOG_H_

#include "wincore.h"

namespace Win32xx
{

	class CTaskDialog : public CWnd
	{
	public:
		CTaskDialog();
		virtual ~CTaskDialog() {}

		void AddCommandControl(int nButtonID, LPCTSTR pszCaption);
		void AddRadioButton(int nRadioButtonID, LPCTSTR pszCaption);
		void AddRadioButtonGroup(int nIDRadioButtonsFirst, int nIDRadioButtonsLast);
		void ClickButton(int nButtonID) const;
		void ClickRadioButton(int nRadioButtonID) const;
		LRESULT DoModal(CWnd* pParent = NULL);
		void ElevateButton(int nButtonID, BOOL bElevated);
		void EnableButton(int nButtonID, BOOL bEnabled);
		void EnableRadioButton(int nButtonID, BOOL bEnabled);
		TASKDIALOGCONFIG GetConfig() const;
		TASKDIALOG_FLAGS GetOptions() const;
		int GetSelectedButtonID() const;
		int GetSelectedRadioButtonID() const;
		BOOL GetVerificationCheckboxState() const;
		static BOOL IsSupported();
		void NavigateTo(CTaskDialog& TaskDialog) const;
		void RemoveAllButtons();
		void RemoveAllRadioButtons();
		void Reset();
		void SetCommonButtons(TASKDIALOG_COMMON_BUTTON_FLAGS dwCommonButtons);
		void SetContent(LPCTSTR pszContent);
		void SetDefaultButton(int nButtonID);
		void SetDefaultRadioButton(int nRadioButtonID);
		void SetDialogWidth(UINT nWidth = 0);
		void SetExpansionArea(LPCTSTR pszExpandedInfo, LPCTSTR pszExpandedLabel = _T(""), LPCTSTR pszCollapsedLabel = _T(""));
		void SetFooterIcon(HICON hFooterIcon);
		void SetFooterIcon(LPCTSTR lpszFooterIcon);
		void SetFooterText(LPCTSTR pszFooter);
		void SetMainIcon(HICON hMainIcon);
		void SetMainIcon(LPCTSTR lpszMainIcon);
		void SetMainInstruction(LPCTSTR pszMainInstruction);
		void SetOptions(TASKDIALOG_FLAGS dwFlags);
		void SetProgressBarMarquee(BOOL bEnabled = TRUE, int nMarqueeSpeed = 0);
		void SetProgressBarPosition(int nProgressPos);
		void SetProgressBarRange(int nMinRange, int nMaxRange);
		void SetProgressBarState(int nNewState = PBST_NORMAL);
		void SetVerificationCheckbox(BOOL bChecked);
		void SetVerificationCheckboxText(LPCTSTR pszVerificationText);
		void SetWindowTitle(LPCTSTR pszWindowTitle);
		static HRESULT CALLBACK StaticTaskDialogProc(HWND hWnd, UINT uNotification, WPARAM wParam, LPARAM lParam, LONG_PTR dwRefData);
		void StoreText(std::vector<WCHAR>& vWChar, LPCTSTR pFromTChar);
		void UpdateElementText(TASKDIALOG_ELEMENTS eElement, LPCTSTR pszNewText);
		

	protected:
		// Override these functions as required
		virtual BOOL OnTDButtonClicked(int nButtonID);
		virtual void OnTDConstructed();
		virtual void OnTDCreated();
		virtual void OnTDDestroyed();
		virtual void OnTDExpandButtonClicked(BOOL bExpanded);
		virtual void OnTDHelp();
		virtual void OnTDHyperlinkClicked(LPCTSTR pszHref);
		virtual void OnTDNavigatePage();
		virtual BOOL OnTDRadioButtonClicked(int nRadioButtonID);
		virtual BOOL OnTDTimer(DWORD dwTickCount);
		virtual void OnTDVerificationCheckboxClicked(BOOL bChecked);
		virtual LRESULT TaskDialogProc(UINT uMsg, WPARAM wParam, LPARAM lParam);
		virtual LRESULT TaskDialogProcDefault(UINT uMsg, WPARAM wParam, LPARAM lParam);

	private:
		CTaskDialog(const CTaskDialog&);				// Disable copy construction
		CTaskDialog& operator = (const CTaskDialog&);	// Disable assignment operator

		std::vector<TASKDIALOG_BUTTON> m_vButtons;
		std::vector<TASKDIALOG_BUTTON> m_vRadioButtons;

		std::vector< std::vector<WCHAR> > m_vButtonsText;		// A vector of WCHAR vectors
		std::vector< std::vector<WCHAR> > m_vRadioButtonsText;	// A vector of WCHAR vectors

		std::vector<WCHAR> m_vWindowTitle;
		std::vector<WCHAR> m_vMainInstruction;
		std::vector<WCHAR> m_vContent;
		std::vector<WCHAR> m_vVerificationText;
		std::vector<WCHAR> m_vExpandedInformation;
		std::vector<WCHAR> m_vExpandedControlText;
		std::vector<WCHAR> m_vCollapsedControlText;
		std::vector<WCHAR> m_vFooter;

		TASKDIALOGCONFIG m_tc;
		int		m_SelectedButtonID;
		int		m_SelectedRadioButtonID;
		BOOL	m_VerificationCheckboxState;
	};

}


//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


namespace Win32xx
{

	inline CTaskDialog::CTaskDialog() : m_SelectedButtonID(0), m_SelectedRadioButtonID(0), m_VerificationCheckboxState(FALSE)
	{
		ZeroMemory(&m_tc, sizeof(m_tc));
		m_tc.cbSize = sizeof(m_tc);
		m_tc.pfCallback = CTaskDialog::StaticTaskDialogProc;
	}

	inline void CTaskDialog::AddCommandControl(int nButtonID, LPCTSTR pszCaption)
	// Adds a command control or push button to the Task Dialog.
	{
		assert (m_hWnd == NULL);

		std::vector<WCHAR> vButtonText;
		StoreText(vButtonText, pszCaption);
		m_vButtonsText.push_back(vButtonText);	// m_vButtonsText is a vector of vector<WCHAR>'s

		TASKDIALOG_BUTTON tdb;
		tdb.nButtonID = nButtonID;
		tdb.pszButtonText = &m_vButtonsText.back().front();

		m_vButtons.push_back(tdb);
	}

	inline void CTaskDialog::AddRadioButton(int nRadioButtonID, LPCTSTR pszCaption)
	// Adds a radio button to the Task Dialog.
	{
		assert (m_hWnd == NULL);

		std::vector<WCHAR> vRadioButtonText;
		StoreText(vRadioButtonText, pszCaption);
		m_vRadioButtonsText.push_back(vRadioButtonText);	// m_vRadioButtonsText is a vector of vector<WCHAR>'s

		TASKDIALOG_BUTTON tdb;
		tdb.nButtonID = nRadioButtonID;
		tdb.pszButtonText = &m_vRadioButtonsText.back().front();

		m_vRadioButtons.push_back(tdb);
	}

	inline void CTaskDialog::AddRadioButtonGroup(int nIDRadioButtonsFirst, int nIDRadioButtonsLast)
	// Adds a range of radio buttons to the Task Dialog.
	// Assumes the resource ID of the button and it's string match 
	{
		assert (m_hWnd == NULL);
		assert(nIDRadioButtonsFirst > 0);
		assert(nIDRadioButtonsLast > nIDRadioButtonsFirst);

		TASKDIALOG_BUTTON tdb;
		for (int nID = nIDRadioButtonsFirst; nID <= nIDRadioButtonsLast; ++nID)
		{
			tdb.nButtonID = nID;
			tdb.pszButtonText = MAKEINTRESOURCEW(nID);
			m_vRadioButtons.push_back(tdb);			
		}
	}

	inline void CTaskDialog::ClickButton(int nButtonID) const
	// Simulates the action of a button click in the Task Dialog.
	{
		assert(m_hWnd);
		SendMessage(TDM_CLICK_BUTTON, (WPARAM)nButtonID, 0); 
	}

	inline void CTaskDialog::ClickRadioButton(int nRadioButtonID) const
	// Simulates the action of a radio button click in the TaskDialog.
	{
		assert(m_hWnd);
		SendMessage(TDM_CLICK_RADIO_BUTTON, (WPARAM)nRadioButtonID, 0);
	}

	inline LRESULT CTaskDialog::DoModal(CWnd* pParent /* = NULL */)
	// Creates and displays the Task Dialog.
	{
		assert (m_hWnd == NULL);

		m_tc.cbSize = sizeof(m_tc);
		m_tc.pButtons = m_vButtons.empty()? NULL : &m_vButtons.front();
		m_tc.cButtons = m_vButtons.size();
		m_tc.pRadioButtons = m_vRadioButtons.empty()? NULL : &m_vRadioButtons.front();
		m_tc.cRadioButtons = m_vRadioButtons.size();
		m_tc.hwndParent = pParent? pParent->GetHwnd() : NULL;

		// Ensure this thread has the TLS index set
		TLSData* pTLSData = GetApp()->SetTlsIndex();

		// Store the CWnd pointer in thread local storage
		pTLSData->pCWnd = this;

		// Declare a pointer to the TaskDialogIndirect function
		HMODULE hComCtl = ::LoadLibrary(_T("COMCTL32.DLL"));
		assert(hComCtl);
		typedef HRESULT WINAPI TASKDIALOGINDIRECT(const TASKDIALOGCONFIG*, int*, int*, BOOL*);
		TASKDIALOGINDIRECT* pTaskDialogIndirect = (TASKDIALOGINDIRECT*)::GetProcAddress(hComCtl, "TaskDialogIndirect");

		// Call TaskDialogIndirect through our function pointer
		LRESULT lr = (*pTaskDialogIndirect)(&m_tc, &m_SelectedButtonID, &m_SelectedRadioButtonID, &m_VerificationCheckboxState);

		FreeLibrary(hComCtl);
		return lr;
	}
	
	inline void CTaskDialog::ElevateButton(int nButtonID, BOOL bElevated)
	// Adds a shield icon to indicate that the button's action requires elevated privilages. 
	{
		assert(m_hWnd);
		SendMessage(TDM_SET_BUTTON_ELEVATION_REQUIRED_STATE, (WPARAM)nButtonID, (LPARAM)bElevated);
	}
	
	inline void CTaskDialog::EnableButton(int nButtonID, BOOL bEnabled)
	// Enables or disables a push button in the TaskDialog.
	{
		assert(m_hWnd);
		SendMessage(TDM_ENABLE_BUTTON, (WPARAM)nButtonID, (LPARAM)bEnabled);
	}
	inline void CTaskDialog::EnableRadioButton(int nRadioButtonID, BOOL bEnabled)
	// Enables or disables a radio button in the TaskDialog.
	{
		assert(m_hWnd);
		SendMessage(TDM_ENABLE_RADIO_BUTTON, (WPARAM)nRadioButtonID, (LPARAM)bEnabled);
	}

	inline TASKDIALOGCONFIG CTaskDialog::GetConfig() const
	// Returns the TASKDIALOGCONFIG structure for the Task Dialog.
	{
		return m_tc;
	}

	inline TASKDIALOG_FLAGS CTaskDialog::GetOptions() const
	// Returns the Task Dialog's options. These are a combination of:
	//  TDF_ENABLE_HYPERLINKS
	//  TDF_USE_HICON_MAIN
	//  TDF_USE_HICON_FOOTER
	//  TDF_ALLOW_DIALOG_CANCELLATION
	//  TDF_USE_COMMAND_LINKS
	//  TDF_USE_COMMAND_LINKS_NO_ICON
	//  TDF_EXPAND_FOOTER_AREA
	//  TDF_EXPANDED_BY_DEFAULT
	//  TDF_VERIFICATION_FLAG_CHECKED
	//  TDF_SHOW_PROGRESS_BAR
	//  TDF_SHOW_MARQUEE_PROGRESS_BAR
	//  TDF_CALLBACK_TIMER
	//  TDF_POSITION_RELATIVE_TO_WINDOW
	//  TDF_RTL_LAYOUT
	//  TDF_NO_DEFAULT_RADIO_BUTTON
	//  TDF_CAN_BE_MINIMIZED
	{
		return m_tc.dwFlags;
	}

	inline int CTaskDialog::GetSelectedButtonID() const
	// Returns the ID of the selected button. 
	{
		assert (m_hWnd == NULL);
		return m_SelectedButtonID;
	}

	inline int CTaskDialog::GetSelectedRadioButtonID() const 
	// Returns the ID of the selected radio button.
	{
		assert (m_hWnd == NULL);
		return m_SelectedRadioButtonID; 
	}
		
	inline BOOL CTaskDialog::GetVerificationCheckboxState() const
	// Returns the state of the verification check box.
	{
		assert (m_hWnd == NULL);
		return m_VerificationCheckboxState;
	}

	inline BOOL CTaskDialog::IsSupported()
	// Returns true if TaskDialogs are supported on this system.
	{
		HMODULE hModule = ::LoadLibrary(_T("COMCTL32.DLL"));
		assert(hModule);
		
		BOOL bResult = (BOOL)::GetProcAddress(hModule, "TaskDialogIndirect");
		
		::FreeLibrary(hModule);
		return bResult;
	}

	inline void CTaskDialog::NavigateTo(CTaskDialog& TaskDialog) const
	// Replaces the information displayed by the task dialog.
	{
		assert(m_hWnd);
		TASKDIALOGCONFIG tc = TaskDialog.GetConfig();
		SendMessage(TDM_NAVIGATE_PAGE, 0, (LPARAM)&tc);
	}

	inline BOOL CTaskDialog::OnTDButtonClicked(int nButtonID)
	// Called when the user selects a button or command link.
	{ 
		UNREFERENCED_PARAMETER(nButtonID);
		
		// return TRUE to prevent the task dialog from closing
		return FALSE;
	}

	inline void CTaskDialog::OnTDConstructed()
	// Called when the task dialog is constructed, before it is displayed.
	{}

	inline void CTaskDialog::OnTDCreated()
	// Called when the task dialog is displayed.
	{}
	
	inline void CTaskDialog::OnTDDestroyed()
	// Called when the task dialog is destroyed.
	{
	}
	
	inline void CTaskDialog::OnTDExpandButtonClicked(BOOL bExpanded)
	// Called when the expand button is clicked.
	{
		UNREFERENCED_PARAMETER(bExpanded);
	}
	
	inline void CTaskDialog::OnTDHelp()
	// Called when the user presses F1 on the keyboard.
	{}

	inline void CTaskDialog::OnTDHyperlinkClicked(LPCTSTR pszHref)
	// Called when the user clicks on a hyperlink.
	{
		UNREFERENCED_PARAMETER(pszHref);
	}
	
	inline void CTaskDialog::OnTDNavigatePage()
	// Called when a navigation has occurred.
	{}
	
	inline BOOL CTaskDialog::OnTDRadioButtonClicked(int nRadioButtonID)
	// Called when the user selects a radio button.
	{
		UNREFERENCED_PARAMETER(nRadioButtonID);
		return TRUE; 
	}
	
	inline BOOL CTaskDialog::OnTDTimer(DWORD dwTickCount) 
	// Called every 200 milliseconds (aproximately) when the TDF_CALLBACK_TIMER flag is set. 
	{
		UNREFERENCED_PARAMETER(dwTickCount);

		// return TRUE to reset the tick count 
		return FALSE;
	}
	
	inline void CTaskDialog::OnTDVerificationCheckboxClicked(BOOL bChecked)
	// Called when the user clicks the Task Dialog verification check box.
	{
		UNREFERENCED_PARAMETER(bChecked);
	}

	inline void CTaskDialog::RemoveAllButtons()
	// Removes all push buttons from the task dialog.
	{
		assert (m_hWnd == NULL);
		m_vButtons.clear();
		m_vButtonsText.clear();
	}

	inline void CTaskDialog::RemoveAllRadioButtons()
	// Removes all radio buttons from the task dialog.
	{
		assert (m_hWnd == NULL);
		m_vRadioButtons.clear();
		m_vRadioButtonsText.clear();
	}

	inline void CTaskDialog::Reset()
	// Returns the dialog to its default state.
	{
		assert (m_hWnd == NULL);

		RemoveAllButtons();
		RemoveAllRadioButtons();
		ZeroMemory(&m_tc, sizeof(m_tc));
		m_tc.cbSize = sizeof(m_tc);
		m_tc.pfCallback = CTaskDialog::StaticTaskDialogProc;

		m_SelectedButtonID = 0;
		m_SelectedRadioButtonID = 0;
		m_VerificationCheckboxState = FALSE;

		m_vWindowTitle.clear();
		m_vMainInstruction.clear();
		m_vContent.clear();
		m_vVerificationText.clear();
		m_vExpandedInformation.clear();
		m_vExpandedControlText.clear();
		m_vCollapsedControlText.clear();
		m_vFooter.clear();
	}

	inline void CTaskDialog::SetCommonButtons(TASKDIALOG_COMMON_BUTTON_FLAGS dwCommonButtons)
	// The dwCommonButtons parameter can be a combination of:
	//	TDCBF_OK_BUTTON			OK button
	//	TDCBF_YES_BUTTON		Yes button	
	//	TDCBF_NO_BUTTON			No button
	//	TDCBF_CANCEL_BUTTON		Cancel button
	//	TDCBF_RETRY_BUTTON		Retry button
	//	TDCBF_CLOSE_BUTTON		Close button
	{
		assert (m_hWnd == NULL);
		m_tc.dwCommonButtons = dwCommonButtons; 
	}

	inline void CTaskDialog::SetContent(LPCTSTR pszContent)
	// Sets the task dialog's primary content.
	{
		StoreText(m_vContent, pszContent);
		m_tc.pszContent = &m_vContent.front(); 

		if (IsWindow())
			SendMessage(TDM_SET_ELEMENT_TEXT, (WPARAM)TDE_CONTENT, (LPARAM)(LPCWSTR)T2W(pszContent));
	}

	inline void CTaskDialog::SetDefaultButton(int nButtonID) 
	// Sets the task dialog's default button.
	// Can be either a button ID or one of the common buttons
	{
		assert (m_hWnd == NULL);
		m_tc.nDefaultButton = nButtonID;
	}

	inline void CTaskDialog::SetDefaultRadioButton(int nRadioButtonID) 
	// Sets the default radio button.
	{
		assert (m_hWnd == NULL);
		m_tc.nDefaultRadioButton = nRadioButtonID;
	}

	inline void CTaskDialog::SetDialogWidth(UINT nWidth /*= 0*/)
	// The width of the task dialog's client area. If 0, the 
	// task dialog manager will calculate the ideal width.
	{
		assert (m_hWnd == NULL);
		m_tc.cxWidth = nWidth;
	}

	inline void CTaskDialog::SetExpansionArea(LPCTSTR pszExpandedInfo, LPCTSTR pszExpandedLabel /* = _T("")*/, LPCTSTR pszCollapsedLabel /* = _T("")*/)
	// Sets the text in the expandable area of the Task Dialog.
	{
		StoreText(m_vExpandedInformation, pszExpandedInfo);
		m_tc.pszExpandedInformation = &m_vExpandedInformation.front();
		
		StoreText(m_vExpandedControlText, pszExpandedLabel);
		m_tc.pszExpandedControlText = &m_vExpandedControlText.front();
		
		StoreText(m_vCollapsedControlText, pszCollapsedLabel);
		m_tc.pszCollapsedControlText = &m_vCollapsedControlText.front();

		if (IsWindow())
			SendMessage(TDM_SET_ELEMENT_TEXT, (WPARAM)TDE_EXPANDED_INFORMATION, (LPARAM)(LPCWSTR)T2W(pszExpandedInfo));
	}

	inline void CTaskDialog::SetFooterIcon(HICON hFooterIcon) 
	// Sets the icon that will be displayed in the Task Dialog's footer.
	{
		m_tc.hFooterIcon = hFooterIcon;

		if (IsWindow())
			SendMessage(TDM_UPDATE_ICON, (WPARAM)TDIE_ICON_FOOTER, (LPARAM)hFooterIcon);
	}

	inline void CTaskDialog::SetFooterIcon(LPCTSTR lpszFooterIcon) 
	// Sets the icon that will be displayed in the Task Dialog's footer.
	// Possible icons:
	// TD_ERROR_ICON		A stop-sign icon appears in the task dialog.
	// TD_WARNING_ICON		An exclamation-point icon appears in the task dialog.
	// TD_INFORMATION_ICON	An icon consisting of a lowercase letter i in a circle appears in the task dialog.
	// TD_SHIELD_ICON		A shield icon appears in the task dialog.
	//  or a value passed via MAKEINTRESOURCE
	{
		m_tc.pszFooterIcon = (LPCWSTR)lpszFooterIcon;

		if (IsWindow())
			SendMessage(TDM_UPDATE_ICON, (WPARAM)TDIE_ICON_FOOTER, (LPARAM)lpszFooterIcon);
	}

	inline void CTaskDialog::SetFooterText(LPCTSTR pszFooter)
	// Sets the text that will be displayed in the Task Dialog's footer.
	{
		StoreText(m_vFooter, pszFooter);
		m_tc.pszFooter = &m_vFooter.front();

		if (IsWindow())
			SendMessage(TDM_SET_ELEMENT_TEXT, (WPARAM)TDE_FOOTER, (LPARAM)(LPCWSTR)T2W(pszFooter));
	}

	inline void CTaskDialog::SetMainIcon(HICON hMainIcon) 
	// Sets Task Dialog's main icon.
	{
		m_tc.hMainIcon = hMainIcon;

		if (IsWindow())
			SendMessage(TDM_UPDATE_ICON, (WPARAM)TDIE_ICON_MAIN, (LPARAM)hMainIcon);
	}

	inline void CTaskDialog::SetMainIcon(LPCTSTR lpszMainIcon)
	// Sets Task Dialog's main icon.
	// Possible icons:
	// TD_ERROR_ICON		A stop-sign icon appears in the task dialog.
	// TD_WARNING_ICON		An exclamation-point icon appears in the task dialog.
	// TD_INFORMATION_ICON	An icon consisting of a lowercase letter i in a circle appears in the task dialog.
	// TD_SHIELD_ICON		A shield icon appears in the task dialog.
	//  or a value passed via MAKEINTRESOURCE
	//
	// Note: Some values of main icon will also generate a MessageBeep when the TaskDialog is created.
	{
		m_tc.pszMainIcon = (LPCWSTR)lpszMainIcon;
		
		if (IsWindow())
			SendMessage(TDM_UPDATE_ICON, (WPARAM)TDIE_ICON_MAIN, (LPARAM)lpszMainIcon);
	}

	inline void CTaskDialog::SetMainInstruction(LPCTSTR pszMainInstruction) 
	// Sets the Task Dialog's main instruction text.
	{
		StoreText(m_vMainInstruction, pszMainInstruction);
		m_tc.pszMainInstruction = &m_vMainInstruction.front();

		if (IsWindow())
			SendMessage(TDM_SET_ELEMENT_TEXT, (WPARAM)TDE_FOOTER, (LPARAM)(LPCWSTR)T2W(pszMainInstruction));
	}

	inline void CTaskDialog::SetOptions(TASKDIALOG_FLAGS dwFlags)
	// Sets the Task Dialog's options. These are a combination of:
	//  TDF_ENABLE_HYPERLINKS
	//  TDF_USE_HICON_MAIN
	//  TDF_USE_HICON_FOOTER
	//  TDF_ALLOW_DIALOG_CANCELLATION
	//  TDF_USE_COMMAND_LINKS
	//  TDF_USE_COMMAND_LINKS_NO_ICON
	//  TDF_EXPAND_FOOTER_AREA
	//  TDF_EXPANDED_BY_DEFAULT
	//  TDF_VERIFICATION_FLAG_CHECKED
	//  TDF_SHOW_PROGRESS_BAR
	//  TDF_SHOW_MARQUEE_PROGRESS_BAR
	//  TDF_CALLBACK_TIMER
	//  TDF_POSITION_RELATIVE_TO_WINDOW
	//  TDF_RTL_LAYOUT
	//  TDF_NO_DEFAULT_RADIO_BUTTON
	//  TDF_CAN_BE_MINIMIZED
	{
		assert (m_hWnd == NULL);
		m_tc.dwFlags = dwFlags;
	}

	inline void CTaskDialog::SetProgressBarMarquee(BOOL bEnabled /* = TRUE*/, int nMarqueeSpeed /* = 0*/) 
	// Starts and stops the marquee display of the progress bar, and sets the speed of the marquee.
	{
		assert(m_hWnd);
		SendMessage(TDM_SET_PROGRESS_BAR_MARQUEE, (WPARAM)bEnabled, (LPARAM)nMarqueeSpeed);
	}

	inline void CTaskDialog::SetProgressBarPosition(int nProgressPos) 
	// Sets the current position for a progress bar.
	{
		assert(m_hWnd);
		SendMessage(TDM_SET_PROGRESS_BAR_POS, (WPARAM)nProgressPos, 0);
	}

	inline void CTaskDialog::SetProgressBarRange(int nMinRange, int nMaxRange) 
	// Sets the minimum and maximum values for the hosted progress bar.
	{
		assert(m_hWnd);
		SendMessage(TDM_SET_PROGRESS_BAR_RANGE, 0, MAKELPARAM(nMinRange, nMaxRange)); 
	}

	inline void CTaskDialog::SetProgressBarState(int nNewState /* = PBST_NORMAL*/)
	// Sets the current state of the progress bar. Possible states are:
	//  PBST_NORMAL
	//  PBST_PAUSE
	//  PBST_ERROR
	{
		assert(m_hWnd);
		SendMessage(TDM_SET_PROGRESS_BAR_STATE, (WPARAM)nNewState, 0);
	} 

	inline void CTaskDialog::SetVerificationCheckbox(BOOL bChecked)
	// Simulates a click on the verification checkbox of the Task Dialog, if it exists.
	{
		assert(m_hWnd);
		SendMessage(TDM_CLICK_VERIFICATION, (WPARAM)bChecked, (LPARAM)bChecked);
	}

	inline void CTaskDialog::SetVerificationCheckboxText(LPCTSTR pszVerificationText)
	// Sets the text for the verification check box.
	{
		assert (m_hWnd == NULL);
		StoreText(m_vVerificationText, pszVerificationText);
		m_tc.pszVerificationText = &m_vVerificationText.front();
	}

	inline void CTaskDialog::SetWindowTitle(LPCTSTR pszWindowTitle)
	// Sets the Task Dialog's window title.
	{
		assert (m_hWnd == NULL);
		StoreText(m_vWindowTitle, pszWindowTitle);
		m_tc.pszWindowTitle = &m_vWindowTitle.front(); 
	}

	inline HRESULT CALLBACK CTaskDialog::StaticTaskDialogProc(HWND hWnd, UINT uNotification, WPARAM wParam, LPARAM lParam, LONG_PTR dwRefData)
	// TaskDialogs direct their messages here.
	{
		UNREFERENCED_PARAMETER(dwRefData);

		assert( GetApp() );

		try
		{
			CTaskDialog* t = (CTaskDialog*)GetApp()->GetCWndFromMap(hWnd);
			if (0 == t)
			{
				// The CTaskDialog pointer wasn't found in the map, so add it now

				// Retrieve the pointer to the TLS Data
				TLSData* pTLSData = (TLSData*)TlsGetValue(GetApp()->GetTlsIndex());
				if (NULL == pTLSData)
					throw CWinException(_T("Unable to get TLS"));

				// Retrieve pointer to CTaskDialog object from Thread Local Storage TLS
				t = (CTaskDialog*)(pTLSData->pCWnd);
				if (NULL == t)
					throw CWinException(_T("Failed to route message"));

				pTLSData->pCWnd = NULL;

				// Store the CTaskDialog pointer in the HWND map
				t->m_hWnd = hWnd;
				t->AddToMap();
			}

			return t->TaskDialogProc(uNotification, wParam, lParam);
		}

		catch (const CWinException &e)
		{
			// Most CWinExceptions will end up here unless caught earlier.
			e.what();
		}

		return 0L;

	} // LRESULT CALLBACK StaticTaskDialogProc(...)

	inline void CTaskDialog::StoreText(std::vector<WCHAR>& vWChar, LPCTSTR pFromTChar)
	{
		// Stores a TChar string in a WCHAR vector

		std::vector<TCHAR> vTChar;
		
		if (IS_INTRESOURCE(pFromTChar))		// support MAKEINTRESOURCE
		{
			tString ts = LoadString((UINT)pFromTChar);
			int len = pFromTChar? ts.length() + 1 : 1;
			vTChar.assign(len, _T('\0'));
			vWChar.assign(len, _T('\0'));
			if (pFromTChar)
				lstrcpy( &vTChar.front(), ts.c_str());
			
		}
		else
		{
			int len = lstrlen(pFromTChar) +1;
			vTChar.assign(len, _T('\0'));
			vWChar.assign(len, _T('\0'));	
			lstrcpy( &vTChar.front(), pFromTChar);
		}
		
		lstrcpyW(&vWChar.front(), T2W(&vTChar.front()) );
	}

	inline LRESULT CTaskDialog::TaskDialogProcDefault(UINT uMsg, WPARAM wParam, LPARAM lParam)
	// Handles the Task Dialog's notificaions.
	{
		switch(uMsg)
		{
		case TDN_BUTTON_CLICKED:
			return OnTDButtonClicked((int)wParam);

		case TDN_CREATED:
			OnTDCreated();
			break;
		case TDN_DESTROYED:		
			Cleanup();			// Prepare this CWnd to be reused. 
			OnTDDestroyed();
			break;
		case TDN_DIALOG_CONSTRUCTED:
			OnTDConstructed();
			break;
		case TDN_EXPANDO_BUTTON_CLICKED:
			OnTDExpandButtonClicked((BOOL)wParam);
			break;
		case TDN_HELP:
			OnTDHelp();
			break;
		case TDN_HYPERLINK_CLICKED:
			OnTDHyperlinkClicked(W2T((LPCWSTR)lParam));
			break;
		case TDN_NAVIGATED:
			OnTDNavigatePage();
			break;
		case TDN_RADIO_BUTTON_CLICKED:
			OnTDRadioButtonClicked((int)wParam);
			break;
		case TDN_TIMER:
			return OnTDTimer((DWORD)wParam);

		case TDN_VERIFICATION_CLICKED:
			OnTDVerificationCheckboxClicked((BOOL)wParam);
			break;
		}

		return S_OK;
	}

	inline LRESULT CTaskDialog::TaskDialogProc(UINT uMsg, WPARAM wParam, LPARAM lParam)
	{
		// Override this function in your class derrived from CDialog if you wish to handle messages
		// A typical function might look like this:

		//	switch (uMsg)
		//	{
		//	case MESSAGE1:		// Some Windows API message
		//		OnMessage1();	// A user defined function
		//		break;			// Also do default processing
		//	case MESSAGE2:
		//		OnMessage2();
		//		return x;		// Don't do default processing, but instead return
		//						//  a value recommended by the Windows API documentation
		//	}

		// Always pass unhandled messages on to TaskDialogProcDefault
		return TaskDialogProcDefault(uMsg, wParam, lParam);
	}

	inline void CTaskDialog::UpdateElementText(TASKDIALOG_ELEMENTS eElement, LPCTSTR pszNewText)
	// Updates a text element on the Task Dialog.
	{
		assert(m_hWnd);
		SendMessage(TDM_UPDATE_ELEMENT_TEXT, (WPARAM)eElement, (LPARAM)(LPCWSTR)T2W(pszNewText));
	}

}



#endif // _WIN32XX_TASKDIALOG_H_