/**
 * @file  XTPCalendarDayView.h
 *
 * @copyright
 * (c) 1998-2025 Codejock Software, All Rights Reserved.
 *
 * This source file is the property of Codejock Software and must not be
 * redistributed by any means without the explicit written permission of
 * Codejock Software.
 *
 * The use of this source code is governed by the terms and conditions specified
 * in the Toolkit Pro license agreement. Codejock Software grants you, as a
 * single software developer, the limited right to use this software on one
 * computer only.
 *
 * Contact Information:
 * support@codejock.com
 * http://www.codejock.com
 *
 */

#if !defined(_XTPCALENDARDAYVIEW_H__)
#	define _XTPCALENDARDAYVIEW_H__

#	if _MSC_VER > 1000
#		pragma once
#	endif // _MSC_VER > 1000

#	include "Common/Base/Diagnostic/XTPDisableNoisyWarnings.h"

class CXTPCalendarDayViewTimeScale;
class CXTPCalendarDayViewDay;
class CXTPCalendarTimeZone;
/** @cond */
XTP_DEFINE_SMART_PTR_INTERNAL(CXTPCalendarTimeZone)
/** @endcond */
/**
 * @brief
 * This class implements a specific view portion of the Calendar
 * control - called <b>Day view</b>.
 *
 * @details
 *      The Day view consists of one or more days, placed in a
 *      row. Each day is stretched down by a number of fixed time
 *      intervals. Each day is represented by a CXTPCalendarDayViewDay class.
 *
 *      The Day view also contains two time scales defining those intervals
 *      at the left or right of the view, which is represented by the
 *      CXTPCalendarDayViewTimeScale class. One time scale is the main and
 *      is visible by default, second one is the additional and can be
 *      enabled programmatically. Time scale interval can be changed
 *      using the SetScaleInterval member function. The content of the view
 *      refreshes automatically.
 *
 * @see CXTPCalendarView
 * @see CXTPCalendarWeekView
 * @see CXTPCalendarMonthView
 * @see CXTPCalendarDayViewDay
 * @see CXTPCalendarDayViewEvent
 */
class _XTP_EXT_CLASS CXTPCalendarDayView : public CXTPCalendarViewT<CXTPCalendarDayViewDay>
{
	friend class CXTPCalendarDayViewDay;
	friend class CXTPCalendarDayViewGroup;
	friend class CXTPCalendarDayViewTimeScale;

	friend class CXTPCalendarControl;
	friend class CXTPCalendarControlView;
	friend class CXTPCalendarTheme;
	/** @cond */
	DECLARE_DYNAMIC(CXTPCalendarDayView)
	/** @endcond */
public:
	/**
	 * @details
	 * Base class type definition.
	 */
	typedef CXTPCalendarViewT<CXTPCalendarDayViewDay> TBase;

	/**
	 * @brief
	 * Default object constructor.
	 *
	 * @param pCalendarControl Pointer to CXTPCalendarControl object.
	 *
	 * @see ~CXTPCalendarEvent()
	 */
	CXTPCalendarDayView(CXTPCalendarControl* pCalendarControl);

	/**
	 * @brief
	 * Default class destructor.
	 *
	 * @details
	 * Handles class members deallocation.
	 */
	virtual ~CXTPCalendarDayView();

	/**
	 * @brief
	 * Call this member function to obtain the view type flag.
	 *
	 * @return An XTPCalendarViewType object that contains the view type flag.
	 *
	 * @see XTPCalendarViewType
	 */
	virtual XTPCalendarViewType GetViewType() const;

	/**
	 * @brief
	 * This member function is used to adjust the view's layout
	 * depending on the window's client dimensions and calls.
	 *
	 * @param pDC Pointer to a valid device context.
	 * @param rcView A CRect that contains the bounding rectangle dimensions
	 *               of the view.
	 * @param bCallPostAdjustLayout TRUE for calling additional post-adjustments
	 *
	 * @details
	 * Call Populate() prior adjusting layout. Adjust layout of all
	 * sub-items.
	 * AdjustLayout2 is called by calendar control instead of AdjustLayout
	 * when theme is set.
	 */
	virtual void AdjustLayout(CDC* pDC, const CRect& rcView, BOOL bCallPostAdjustLayout = TRUE);

	/**
	 * @brief
	 * This member function is used to adjust the view's layout
	 * depending on the window's client dimensions and calls.
	 *
	 * @param pDC Pointer to a valid device context.
	 * @param rcView A CRect that contains the bounding rectangle dimensions
	 *               of the view.
	 * @param bCallPostAdjustLayout TRUE for calling additional post-adjustments
	 *
	 * @details
	 * Call Populate() prior adjusting layout. Adjust layout of all
	 * sub-items.
	 * AdjustLayout2 is called by calendar control instead of AdjustLayout
	 * when theme is set.
	 */
	virtual void AdjustLayout2(CDC* pDC, const CRect& rcView, BOOL bCallPostAdjustLayout = TRUE);

	/**
	 * @brief
	 * This member function is used to retrieve information about a
	 * scroll bar's state.
	 *
	 * @param pSI A pointer to scrollbar information structure.
	 *
	 * @return A BOOL.
	 *		  TRUE if the visible row count is not the same as the actual row count.
	 *		  FALSE otherwise.
	 */
	virtual BOOL GetScrollBarInfoV(SCROLLINFO* pSI) const;

	/**
	 * @brief
	 * This member function is used to retrieve information about a
	 * scroll bar's state.
	 *
	 * @param pSI A pointer to scrollbar information structure.
	 * @param pnScrollStep A pointer to int to receive scroll step. Can be NULL.
	 *
	 * @return A BOOL.
	 *		  TRUE if the visible row count is not the same as the actual row count.
	 *		  FALSE otherwise.
	 */
	virtual BOOL GetScrollBarInfoH(SCROLLINFO* pSI, int* pnScrollStep = NULL) const;

	/**
	 * @brief
	 * This member function is used to scroll the content of a view.
	 *
	 * @param nPos Position value.
	 * @param nPos_raw Raw position value. (Not used at this time.)
	 */
	virtual void ScrollV(int nPos, int nPos_raw);

	/**
	 * @brief
	 * This member function is used to scroll the content of a view.
	 *
	 * @param nPos Position value.
	 * @param nPos_raw Raw position value. (Not used at this time.)
	 */
	virtual void ScrollH(int nPos, int nPos_raw);

	/**
	 * @brief
	 * This member function returns values which interpreted as a minimum
	 * column width, where column is a group view object.
	 *
	 * @details
	 * The returned number may be one of the following values:
	 *  [ul]
	 *  [li] 0 means disabled;
	 *  [li] -1 use some default width for multiresources only;
	 *  [li] -N use for multiresources only (internally converted to +N);
	 *  [li] +N used always (in single and multi resources mode).
	 *  [/ul]
	 *
	 * @return Minimum column width in pixels (may be negative) or 0 or -1.
	 *
	 * @see SetMinColumnWidth
	 */
	virtual int GetMinColumnWidth() const;

	/**
	 * @brief
	 * This member function used to set minimum column width, where column
	 * is a group view object.
	 *
	 * @param nWidth [in] Minimum column width in pixels (may be negative) or 0 or -1.
	 *				See remarks section.
	 *
	 * @details
	 * nWidth number may be one of the following values:
	 *  [ul]
	 *  [li] 0 means disabled;
	 *  [li] -1 use some default width for multiresources only;
	 *  [li] -N use for multiresources only (internally converted to +N);
	 *  [li] +N used always (in single and multi resources mode).
	 *  [/ul]
	 *
	 * @see GetMinColumnWidth
	 */
	virtual void SetMinColumnWidth(int nWidth);

	/**
	 * @brief
	 * This member function performs all of the drawing logic of the
	 * calendar view.
	 *
	 * @param pDC Pointer to a valid device context.
	 */
	virtual void OnDraw(CDC* pDC);

	/**
	 * @brief
	 * This member function is used to draw the view content using the
	 * specified device context.
	 *
	 * @param pDC Pointer to a valid device context.
	 *
	 * @details
	 * Call AdjustLayout() before Draw()
	 *
	 * @see AdjustLayout
	 */
	virtual void Draw(CDC* pDC);

	/**
	 * @brief
	 * This member function is used to draw the view content using the
	 * specified device context.
	 *
	 * @param pDC Pointer to a valid device context.
	 *
	 * @details
	 * Call AdjustLayout() before Draw()
	 * Draw2 is called by calendar control instead of Draw when theme
	 * is set.
	 *
	 * @see AdjustLayout
	 */
	virtual void Draw2(CDC* pDC);

	/**
	 * @brief
	 * This member function is used to process left mouse button events.
	 *
	 * @param nFlags Indicates whether various virtual keys are down.
	 * @param point Specifies the x- and y- coordinate of the cursor.
	 *			   These coordinates are always relative to the upper-left corner
	 *			   of the window.
	 *
	 * @return TRUE if the operation is successful, FALSE else.
	 *
	 * @details
	 * This method is called by the CalendarControl when the user
	 * presses the left mouse button.
	 */
	virtual BOOL OnLButtonDown(UINT nFlags, CPoint point);

	/**
	 * @brief
	 * This member function is used to processes left mouse button events.
	 *
	 * @param nFlags A UINT that is used to indicate whether various virtual keys are down.
	 * @param point A CPoint that specifies the x- and y- coordinates of the cursor.
	 *			   These coordinates are always relative to the
	 *			   upper-left corner of the window.
	 *
	 * @return TRUE if the operation is successful, FALSE else.
	 *
	 * @details
	 * This method is called by the CalendarControl when the user
	 * releases the left mouse button.
	 */
	virtual BOOL OnLButtonUp(UINT nFlags, CPoint point);

	/**
	 * @brief
	 * This member function is used to process mouse move events.
	 *
	 * @param nFlags Indicates whether various virtual keys are down.
	 * @param point Specifies the x- and y- coordinate of the cursor.
	 *			   These coordinates are always relative to the upper-left
	 *			   corner of the window.
	 *
	 * @details
	 * This method is called by the CalendarControl when the user
	 * moves the mouse cursor or stylus.
	 */
	virtual void OnMouseMove(UINT nFlags, CPoint point);

	/**
	 * @brief
	 * This member function is used to process keyboard events.
	 *
	 * @param nChar Virtual key code of the given key.
	 * @param nRepCnt Number of times the keystroke is repeated as a result
	 *			     of the user holding down the key.
	 * @param nFlags Scan code, key-transition code, previous key state,
	 *			    and context code.
	 *
	 * @details
	 * This method is called by the CalendarControl when the user
	 * presses keys on the keyboard.
	 */
	virtual void OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags);

	/**
	 * @brief
	 * Call this member function to get the date of a day view by the
	 * day's index.
	 *
	 * @param nIndex Day view index in the view collection.
	 *
	 * @return COleDateTime object with the day view date and time.
	 *
	 * @details
	 * Index number starts at 0 and cannot be negative.
	 *
	 * @see GetViewDayCount()
	 */
	virtual COleDateTime GetViewDayDate(int nIndex) const;

	/**
	 * @brief
	 * This member function is used to determine which view item,
	 * if any, is at a specified position index, and returns
	 * additional info in a XTP_CALENDAR_HITTESTINFO structure.
	 *
	 * @param pt Coordinates of point to test.
	 * @param pHitTest Pointer to a XTP_CALENDAR_HITTESTINFO structure.
	 *
	 * @return TRUE if item found. FALSE otherwise.
	 *
	 * @see XTP_CALENDAR_HITTESTINFO
	 */
	virtual BOOL HitTestEx(CPoint pt, XTP_CALENDAR_HITTESTINFO* pHitTest) const;

	/**
	 * @brief
	 * This member function is used to obtain the visible row count
	 * on the view.
	 *
	 * @return An int containing the count of the visible rows on the view.
	 */
	int GetVisibleRowCount() const;

	/**
	 * @brief
	 * This member function is used to obtain the top visible row on the view.
	 *
	 * @return An int that contains the number of the top visible row on the view.
	 */
	int GetTopRow() const;

	/**
	 * @brief
	 * This member function is used to obtain the total row count on the view.
	 *
	 * @return An int containing the total count of rows on the view.
	 */
	int GetRowCount() const;

	/**
	 * @brief
	 * This member function is used to obtain the time scale item interval.
	 *
	 * @return A COleDateTimeSpan object that contains the time interval of
	 *		  the time scale item.
	 */
	COleDateTimeSpan GetScaleInterval() const;

	/**
	 * @brief
	 * This member function is used to set the time scale item interval.
	 *
	 * @param spScaleInterval A COleDateTimeSpan object that contains the
	 *						 new time scale item interval.
	 */
	void SetScaleInterval(const COleDateTimeSpan spScaleInterval);

	/**
	 * @brief
	 * This member function is used to obtain the minimal time which is
	 * shown on the day view scale.
	 *
	 * @return A COleDateTime object that contains the minimal scale time.
	 */
	COleDateTime GetScaleMinTime() const;

	/**
	 * @brief
	 * This member function is used to set the minimal time which is
	 * shown on the day view scale.
	 *
	 * @details
	 * Only time part of the argument will be used by the control.
	 * It will be used for all dates. Date part of the argument is ignored.
	 *
	 * @param dtNewScaleMinTime A COleDateTime object that contains the
	 *						   new minimal time scale value.
	 */
	void SetScaleMinTime(const COleDateTime dtNewScaleMinTime);

	/**
	 * @brief
	 * This member function is used to obtain the maximal time which is
	 * shown on the day view scale.
	 *
	 * @return A COleDateTime object that contains the maximal scale time.
	 */
	COleDateTime GetScaleMaxTime() const;

	/**
	 * @brief
	 * This member function is used to set the maximal time which is
	 * shown on the day view scale.
	 *
	 * @details
	 * Only time part of the argument will be used by the control.
	 * It will be used for all dates. Date part of the argument is ignored.
	 *
	 * @param dtNewScaleMaxTime A COleDateTime object that contains the
	 *						   new maximal time scale value.
	 */
	void SetScaleMaxTime(const COleDateTime dtNewScaleMaxTime);

	/**
	 * @brief
	 * This member function is used to set the text label for the
	 * default time scale.
	 *
	 * @param strText A CString that contains the new text label for the
	 *				 default time label.
	 */
	void SetScaleText(LPCTSTR strText);

	/**
	 * @brief
	 * This member function is used to obtain the text label of the
	 * default time scale.
	 *
	 * @return A CString object that contains the default time scale text label.
	 */
	CString GetScaleText() const;

	/**
	 * @brief
	 * This member function is used to set the text label for the
	 * additional time scale.
	 *
	 * @param strText A CString that contains the new text label.
	 */
	void SetAdditionalScaleText(LPCTSTR strText);

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(SetAdditionalScaleText)
	void SetScale2Text(LPCTSTR strText)
	{
		SetAdditionalScaleText(strText);
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to obtain the text label of the
	 * additional time scale.
	 *
	 * @return A CString object that contains the additional time scale text label.
	 */
	CString GetAdditionalScaleText() const;

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(GetAdditionalScaleText)
	CString GetScale2Text() const
	{
		return GetAdditionalScaleText();
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to set the time zone information for
	 * the additional time scale.
	 *
	 * @param pTzInfo A pointer to time zone information structure.
	 *
	 * @see MSDN Articles:
	 *      INFO: Retrieving Time-Zone Information
	 *      KB115231, Q115231
	 *
	 *      HOWTO: Change Time Zone Information Using Visual Basic
	 *      KB221542, Q221542
	 *
	 */
	void SetAdditionalScaleTimeZone(const TIME_ZONE_INFORMATION* pTzInfo);

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(SetAdditionalScaleTimeZone)
	void SetScale2TimeZone(const TIME_ZONE_INFORMATION* pTzInfo)
	{
		SetAdditionalScaleTimeZone(pTzInfo);
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to get the time zone information for
	 * the additional time scale.
	 *
	 * @return A reference to time zone information structure.
	 */
	const TIME_ZONE_INFORMATION& GetAdditionalScaleTimeZone() const;

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(GetAdditionalScaleTimeZone)
	const TIME_ZONE_INFORMATION& GetScale2TimeZone() const
	{
		return GetAdditionalScaleTimeZone();
	}
	/** @endcond */

	/**
	 * @brief
	 *  Get full information about current time zone.
	 *
	 * @details
	 *  Retrieve additional information from the registry.
	 *
	 * @return A smart pointer to CXTPCalendarTimeZone object.
	 *
	 * @see GetTimeZoneInformation()
	 * @see CXTPCalendarTimeZone::GetTimeZoneInfo()
	 */
	CXTPCalendarTimeZonePtr GetCurrentTimeZoneInfo() const;

	/**
	 * @brief
	 *  Get full information about additional time scale time zone.
	 *
	 * @details
	 *  Retrieve additional information from the registry.
	 *
	 * @return A smart pointer to CXTPCalendarTimeZone object.
	 *
	 * @see GetTimeZoneInformation()
	 * @see CXTPCalendarTimeZone::GetTimeZoneInfo()
	 */
	CXTPCalendarTimeZonePtr GetAdditionalScaleTimeZoneInfo() const;

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(GetAdditionalScaleTimeZoneInfo)
	CXTPCalendarTimeZonePtr GetScale2TimeZoneInfo() const
	{
		return GetAdditionalScaleTimeZoneInfo();
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to Show or hide the additional
	 * time scale.
	 *
	 * @param bShow A BOOL that contains the new visibility flag value.
	 *			   TRUE - Default value, shows the additional time scale.
	 *			   FALSE - Do not show the default value.
	 */
	void ShowAdditionalScale(BOOL bShow = TRUE);

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(ShowAdditionalScale)
	void ShowScale2(BOOL bShow = TRUE)
	{
		ShowAdditionalScale(bShow);
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to obtain the visibility flag of
	 * left time scale.
	 *
	 * @return A BOOL that contains the visibility flag value.
	 *		  TRUE - If left time scale is visible.
	 *		  FALSE - If left time scale is not visible.
	 */
	BOOL IsScaleLeftVisible() const;

	/**
	 * @brief
	 * This member function is used to obtain the visibility flag of
	 * right time scale.
	 *
	 * @return A BOOL that contains the visibility flag value.
	 *		  TRUE - If right time scale is visible.
	 *		  FALSE - If right time scale is not visible.
	 */
	BOOL IsScaleRightVisible() const;

	/**
	 * @brief
	 * This member function is used to obtain the visibility flag of
	 * the additional left time scale.
	 *
	 * @return A BOOL that contains the visibility flag value.
	 *		  TRUE - If the additional time scale is visible.
	 *		  FALSE - If the additional time scale is not visible.
	 */
	BOOL IsAdditionalScaleLeftVisible() const;

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(IsAdditionalScaleLeftVisible)
	BOOL IsScale2Visible() const
	{
		return IsAdditionalScaleLeftVisible();
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to obtain the visibility flag of
	 * the additional right time scale.
	 *
	 * @return A BOOL that contains the visibility flag value.
	 *		  TRUE - If the additional time scale is visible.
	 *		  FALSE - If the additional time scale is not visible.
	 */
	BOOL IsAdditionalScaleRightVisible() const;

	/**
	 * @brief
	 * This member function is used to obtain the flag of
	 * the now line drawing.
	 *
	 * @return A BOOL that contains the now line drawing.
	 *		  TRUE - If now line over apponitment.
	 *		  FALSE - If now line under apponitment.
	 */
	BOOL IsDrawNowLineOverAppoinment() const;

	/**
	 * @brief
	 * This member function is used to obtain the Expand Up glyph
	 * flag value.
	 *
	 * @return A BOOL that contains the Expand Up glyph flag value.
	 *		  TRUE  - If the Expand Up glyph is visible.
	 *		  FALSE - If the Expand Up glyph is not visible.
	 */
	BOOL IsExpandUp() const;

	/**
	 * @brief
	 * This member function is used to obtain the Expand Down glyph
	 * flag value.
	 *
	 * @return A BOOL that contains the Expand Down flag value.
	 *		  TRUE  - If the Expand Down glyph is visible.
	 *		  FALSE - If the Expand Down glyph is not visible.
	 */
	BOOL IsExpandDown() const;

	/**
	 * @brief
	 * This member function is used to obtain the time value for
	 * the specified cell.
	 *
	 * @param nCell An int that contains a cell number.
	 *
	 * @return A COleDateTime object that contains the specific time value
	 *		  for the cell's beginning coordinate.
	 */
	COleDateTime GetCellTime(int nCell) const;

	/**
	 * @brief
	 * This member function is used to obtain the current cell duration.
	 *
	 * @return A COleDateTimeSpan object that contains the amount of time between
	 *		  a cell's start coordinates and the next cell's starting coordinates.
	 */
	COleDateTimeSpan GetCellDuration() const;

	/**
	 * @brief
	 * This member function is used to calculate the cell number for
	 * the specified time value.
	 *
	 * @param dtTime A COleDateTime object that contains a time
	 *				value to check for.
	 * @param bForEndTime A BOOL that contains the value that indicates if
	 *			         we should consider a split line between cells to
	 *				     belong to the end of the previous
	 *					 cell or to the beginning of the next cell.
	 *
	 * @return Call this member function when you want to retrieve which cell
	 *		  contains a specified time value.
	 */
	int GetCellNumber(COleDateTime dtTime, BOOL bForEndTime) const;

	/**
	 * @brief
	 * This member function is used to calculate the cell number for
	 * the specified time value.
	 *
	 * @param nHour An int that contains the hour part of the time value to check for.
	 * @param nMin An int that contains the minute part of the time value to check for.
	 * @param nSec An int that contains the second part of the time value to check for.
	 * @param bForEndTime A BOOL that contains the value that indicates if
	 *					 we should consider a split line between cells to
	 *					 belong to the end of the previous
	 *					 cell or to the beginning of the next cell.
	 *
	 * @return Call this member function when you want to retrieve which cell
	 *		  contains a specified time value.
	 */
	int GetCellNumber(int nHour, int nMin, int nSec, BOOL bForEndTime) const;

	/**
	 * @brief
	 * This member function is used to obtain the view selection.
	 *
	 * @param pBegin A pointer to the COleDateTime object
	 *               that contains the beginning of the selection.
	 * @param pEnd A pointer to the COleDateTime object
	 *             that contains the ending of the selection.
	 * @param pbAllDayEvent A pointer to the BOOL variable
	 *                      that contains the AllDayEvent attribute of
	 *                      the selection (used in the day view only).
	 * @param pnGroupIndex A pointer to int to receive group index.
	 * @param pspSelectionResolution A pointer to the COleDateTimeSpan
	 *                               object that contains the selection unit
	 *                               length. (i.e. 1 day, 1 Hour, ... 5 min)
	 *
	 * @details
	 * Call this member function to fill provided COleDateTime
	 * objects with the values of the selection beginning, ending,
	 * and selection unit length.
	 *
	 * @return TRUE - If the selection is returned successfully.
	 *		  FALSE otherwise.
	 */
	virtual BOOL GetSelection(COleDateTime* pBegin = NULL, COleDateTime* pEnd = NULL,
							  BOOL* pbAllDayEvent = NULL, int* pnGroupIndex = NULL,
							  COleDateTimeSpan* pspSelectionResolution = NULL) const;

	/**
	 * @brief
	 * This member function is used to show the specified day in the
	 * calendar day view.
	 *
	 * @param date A COleDateTime object that contains the date to show.
	 * @param bSelect TRUE to select the specified day after showing,
	 *			     FALSE otherwise. TRUE is the default value.
	 *
	 * @details
	 * Call this member function to show only the specified day in the
	 * calendar day view.
	 */
	virtual void ShowDay(const COleDateTime& date, BOOL bSelect = TRUE);

	/**
	 * @brief
	 * This member function is used to show the specified day interval
	 * in the calendar day view.
	 *
	 * @param dtBegin A COleDateTime object that contains the beginning
	 *				 interval date to show.
	 * @param dtEnd A COleDateTime object that contains the ending interval
	 *			   date to show.
	 *
	 * @details
	 * Call this member function to show all days from the dtBegin
	 * up to dtEnd inclusive.
	 */
	virtual void ShowDays(const COleDateTime& dtBegin, const COleDateTime& dtEnd);

	/**
	 * @brief
	 * This member function is used to show that working week
	 * in the calendar day view, which includes the specified day.
	 *
	 * @param dtDay A COleDateTime object that contains the date to show.
	 *
	 * @details
	 * Call this member function to show working week
	 * which includes dtDay.
	 */
	virtual void ShowWorkingDays(const COleDateTime& dtDay);

	/**
	 * @brief
	 * This member function is used to add a specified date to the
	 * dates set showing in the current calendar day view.
	 *
	 * @param date A COleDateTime object that contains the date to display.
	 *
	 * @details
	 * Call this member function to display a specific day in the
	 * calendar day view in addition to the days already visible.
	 */
	virtual void AddDay(const COleDateTime& date);

	/**
	 * @brief
	 * This member function is used to ensure that an event view item
	 * is visible.
	 *
	 * @param pViewEvent A CXTPCalendarViewEvent object. A pointer to the
	 *					event view item being made visible.
	 *
	 * @details
	 * If necessary, the function scrolls the day view so that the
	 * event view item is visible.
	 *
	 * @return Returns TRUE if the system scrolled the day view in the
	 *		  Calendar control to ensure that the specified event view item
	 *		  is visible. Otherwise, the return value is FALSE.
	 */
	virtual BOOL EnsureVisible(CXTPCalendarViewEvent* pViewEvent);

	/**
	 * @brief
	 * This member function is used to ensure that an event view item
	 * is visible.
	 *
	 * @param pViewEvent A CXTPCalendarViewEvent object. A pointer to the
	 *					event view item being made visible.
	 *
	 * @details
	 * If necessary, the function scrolls the day view so that the
	 * event view item is visible.
	 *
	 * @return Returns TRUE if the system scrolled the day view in the
	 *		  Calendar control to ensure that the specified event view item
	 *		  is visible. Otherwise, the return value is FALSE.
	 */
	virtual BOOL EnsureVisibleH(CXTPCalendarViewEvent* pViewEvent);

	/**
	 * @brief
	 * This member function is used to ensure that an event view item
	 * is visible.
	 *
	 * @param pViewGroup A CXTPCalendarViewGroup object. A pointer to the
	 *			        group view being made visible.
	 *
	 * @details
	 * If necessary, the function scrolls the day view so that the
	 * event view item is visible.
	 *
	 * @return Returns TRUE if the system scrolled the day view in the
	 *		  Calendar control to ensure that the specified event view item
	 *		  is visible. Otherwise, the return value is FALSE.
	 */
	virtual BOOL EnsureVisibleH(CXTPCalendarViewGroup* pViewGroup);

	/**
	 * @brief
	 * This member function is used to start view from the work day starting time.
	 *
	 * @details
	 * Call this method after set new data provider because new data
	 * provider store other time scale resolution value.
	 */
	virtual void ScrollToWorkDayBegin();

	/**
	 * @brief
	 * This member function is used to determine whether resource group
	 * header should be visible.
	 *
	 * @details
	 * This method returns FALSE when resource groups count is zero and
	 * there is only one schedule used.
	 *
	 * @return TRUE when visible; FALSE otherwise.
	 */
	virtual BOOL IsGroupHeaderVisible() const;

	/**
	 * @brief
	 * This member function is used to get main or additional time scale
	 * object.
	 *
	 * @param nNumber A time scale object number:
	 *                1 - main(left) time scale,
	 *                2 - additional time scale.
	 *                3 - right time scale,
	 *
	 * @details
	 * By default number 1 (main time scale) is used.
	 *
	 * @return Pointer to the CXTPCalendarDayViewTimeScale object.
	 */
	virtual CXTPCalendarDayViewTimeScale* GetTimeScale(int nNumber = 1) const;

	/**
	 * @brief
	 * Call this member function to obtain the CXTPCalendarDayViewDay object
	 * by the day's date.
	 *
	 * @param dtDay A day date to find.
	 *
	 * @details
	 * Returns NULL if no day with the specified date in the days collection.
	 *
	 * @return A pointer to a CXTPCalendarViewDay object.
	 *
	 * @see GetViewDayCount()
	 * @see GetViewDay_
	 * @see GetViewDay
	 */
	virtual CXTPCalendarDayViewDay* GetDay(COleDateTime dtDay);

	/**
	 * @brief
	 * This member function is used to scroll the view back a
	 * specified number of days.
	 *
	 * @param nScrollDaysCount An int that is used to specify the number
	 *						  of days to scroll.
	 *
	 * @details
	 * Call this member function when you want to switch the
	 * number of days back from the current day.
	 *
	 * @see ScrollDaysToNext
	 */
	virtual void ScrollDaysToPrev(int nScrollDaysCount = 1);

	/**
	 * @brief
	 * This member function is used to scroll the view forward a
	 * specified number of days.
	 *
	 * @param nScrollDaysCount An int that is used to specify the number
	 *						  of days to scroll.
	 *
	 * @details
	 * Call this member function to switch the number of days forward
	 * from the current date.
	 *
	 * @see ScrollDaysToPrev
	 */
	virtual void ScrollDaysToNext(int nScrollDaysCount = 1);

	/**
	 * @brief
	 * This member function is used to scroll the view forward a
	 * specified number of columns (schedules).
	 *
	 * @param lColumn columns # to show
	 */
	void ScrollToColumn(long lColumn);

	COleDateTime GetDateTimeDay(const COleDateTime& dt) const;
	COleDateTime GetDateTimeTime(const COleDateTime& dt) const;

	COleDateTime m_dtTimeScaleMin; /**< Time scale minimum value.*/
	COleDateTime m_dtTimeScaleMax; /**< Time scale maximum value.*/

	BOOL m_bDraftMode; /**< flag to set printout to print in B/W without Header and Footer
							to maximize main information space and simplify params set (default =
							FALSE)*/

	BOOL m_bPrintRepeatHeaderFooterMode; /**< flag to set printout to print Header and Footer only
											on first page to maximize main information space
											(default = TRUE)*/

	BOOL m_bDF_mode; /**< Last page print mode flag (FALSE - print last page same size as other,
						  TRUE (default) - can be shorter then others)*/

	BOOL m_bPrintFullScale; /**< print timescale range - if FALSE - print working hours range*/

	int m_nDayViewPrintInterval; /**< interval to use in DayView Printing: 60 or 45 or 30 or 15*/

	BOOL m_bEcoAllDayMode; /**< If True use short AllDay area height*/

	BOOL m_bPreventDragAllDayEventInDayView; /**< default FALSE If True it will be impossible to
												Drag All Day Event In DayView*/

	int m_nDayHeaderPeriod; /**< interval between in multi-scheduled mode Day Header for same date
								 repeated - need for scrolling in very many - schedules case when
							   one day can use few screens*/

	int m_nCurPage; /**< for AllDay event printing control by CXTPCalendarControlView*/

	BOOL m_bUseNewHitTestCode; /**< Tells whether to use new hit test code or not.*/

	BOOL m_bShowLinks;		   /**< flag to show or hide 'virtual' view events*/
	BOOL m_bHideLinkContainer; /**< flag to hide or show 'virtual' view events container column*/

	BOOL m_bShowAllDayEventsOnly; /**< flag that enables showing all-day events only*/

	virtual void AdjustAllDayEvents();

	CRect GetDayHeaderRectangle() const;
	CRect GetAllDayEventsRectangle() const;

	void SetIsHideAllDayEventsArea(BOOL bHide);
	BOOL GetIsHideAllDayEventsArea() const;

	virtual int GetAllDayEventsMaxCount() const;
	virtual int GetTotalGroupsCount() const;
	virtual int RecalcMinColumnWidth() const;

protected:
	/**
	 * @brief
	 * This member function is used to stop vertical scrolling.
	 *
	 * @details
	 * If there is a vertical scroll event in process, then calling
	 * this member function stops the vertical scrolling.
	 */
	virtual void StopVertEventScroll();

	/**
	 * @brief
	 * This member function is used to stop horizontal scrolling.
	 *
	 * @details
	 * If there is a horizontal scroll event in process, then calling
	 * this member function stops the v scrolling.
	 */
	virtual void StopHorzEventScroll();

	/**
	 * @brief
	 * This member function is an utility function used by OnKeyDown
	 * It determines if we can scroll groups left if hscroll is disabled
	 * @param bVKShift The state of the Shift virtual key
	 * @param dtNewSelEnd The last selection date-time.
	 * @return True if can scroll left, false otherwise
	 */
	BOOL GetIsCanHScrollGroupsLeft(COleDateTime dtNewSelEnd, BOOL bVKShift);

	/**
	 * @brief
	 * This member function is an utility function used by OnKeyDown
	 * It determines if we can scroll groups right if hscroll is disabled
	 * @param bVKShift The state of the Shift virtual key
	 * @param dtNewSelEnd The last selection date-time.
	 * @return True if can scroll right, false otherwise
	 */
	BOOL GetIsCanHScrollGroupsRight(COleDateTime dtNewSelEnd, BOOL bVKShift);

	/**
	 * @brief
	 * This member function is used to change the mouse cursor.
	 *
	 * @param bOutOfArea TRUE means out (FALSE - inside) of drag area.
	 *
	 * @details
	 * Call this member function to changes the mouse cursor depending on
	 * which drag mode is currently active. Note: The drag mode is
	 * contained in the XTPCalendarDraggingMode m_eDraggingMode member
	 * variable.
	 */
	virtual void SetMouseOutOfDragArea(BOOL bOutOfArea);

	/**
	 * @brief
	 * This member function is used to determine if the point is in
	 * the drag able rectangle.
	 *
	 * @param pnt A CPoint object that contains the point to test.
	 * @param pHitInfo Pointer to the XTP_CALENDAR_HITTESTINFO structure,
	 *				  which helps to determine the client rectangle.
	 *
	 * @return TRUE if the point is out of the drag able rectangle, FALSE otherwise.
	 */
	virtual BOOL IsOutOfClientRect(CPoint pnt, XTP_CALENDAR_HITTESTINFO* pHitInfo);

	/**
	 * @brief
	 * This member function is used to determine the scroll direction.
	 *
	 * @param pnt Test mouse point.
	 *
	 * @details
	 * This function returns an XTPCalendarDayViewScrollDirection enumeration which defines the
	 * scroll direction.
	 *
	 * @return xtpCalendarDayViewScrollUp/xtpCalendarDayViewScrollDown if scrolling up/down is
	 *needed. xtpCalendarDayViewScrollNotNeeded if scrolling is not needed.
	 */
	virtual XTPCalendarDayViewScrollDirection GetNeededScrollDirection(CPoint pnt) const;

	/**
	 * @brief
	 * This member function is used to vertically scroll an event
	 * in the current view.
	 *
	 * @param bUp A BOOL that contains the direction to scroll:
	 *			 TRUE if up.
	 *			 FALSE if down.
	 *
	 * @return TRUE, if scrolled successfully. FALSE otherwise.
	 */
	virtual BOOL VertEventScroll(BOOL bUp);

	/**
	 * @brief
	 * This member function is used to horizontally scroll an event
	 * in the current view.
	 *
	 * @param bLeft A BOOL that contains the direction to scroll:
	 *			   TRUE if left.
	 *			   FALSE if right.
	 *
	 * @return TRUE, if scrolled successfully. FALSE otherwise.
	 */
	virtual BOOL HorzEventScroll(BOOL bLeft);

	/**
	 * @brief
	 * This member function is used to return the minimum event
	 * duration so that the event is visible in the current view.
	 *
	 * @return A COleDateTimeSpan object that specifies the minimum duration
	 *		  of the event.
	 */
	virtual COleDateTimeSpan GetEventDurationMin() const;

	/**
	 * @brief
	 * This member function is used to select or un-select the provided
	 * day, including all of the day's events.
	 *
	 * @param pDay A pointer to a CXTPCalendarViewDay object.
	 * @param nGroupIndex A group index to select.
	 *
	 * @see CXTPCalendarViewDay
	 * @see SelectDay(COleDateTime dtSelDay, BOOL bSelect)
	 */
	virtual void SelectDay(CXTPCalendarViewDay* pDay, int nGroupIndex);

	/**
	 * @brief
	 * This member function is used to select or un-select the provided
	 * day, including all of the day's events.
	 *
	 * @param pDay A pointer to a CXTPCalendarViewDay object.
	 *
	 * @see CXTPCalendarViewDay
	 * @see SelectDay(COleDateTime dtSelDay, BOOL bSelect)
	 */
	virtual void SelectDay(CXTPCalendarViewDay* pDay);

	using CXTPCalendarViewT<CXTPCalendarDayViewDay>::SelectDay;

	/**
	 * @brief
	 *  Converts Time Zones from both timescales to the minutes shift
	 *  of the second time scale in comparison with the first one.
	 *
	 * @see CXTPCalendarViewDay
	 * @see SelectDay(COleDateTime dtSelDay, BOOL bSelect)
	 */
	virtual void AdjustAdditionalScaleTimeZone();

	/** @cond */
	_XTP_DEPRECATED_IN_FAVOR(AdjustAdditionalScaleTimeZone)
	virtual void AdjustScale2TimeZone()
	{
		AdjustAdditionalScaleTimeZone();
	}
	/** @endcond */

	/**
	 * @brief
	 * This member function is used to scroll the content of a view.
	 *
	 * @param nIndex Position value.
	 * @param nPos_raw Raw position value. (Not used at this time.)
	 */
	virtual void _ScrollV(int nIndex, int nPos_raw);

	int m_nScrollOffsetX; /**< Stores horizontal left offset of visible day view part.*/

	int m_nMinColumnWidth; /**<  0 means disabled;
								 -1 use some default width for multiresources only;
								 -N use for multiresources only (internally converted to +N);
								 +N used always (in single and multi resources mode).*/

	/**
	 * @brief
	 * This member function is used to get time scales area width.
	 *
	 * @return Time scales area width in pixels.
	 */
	int _GetTimeScaleWith() const;

	/**
	 * @brief
	 * This member function is used to get horizontal scroll area rect.
	 *
	 * @return Horizontal scroll area rect.
	 */
	CRect _GetScrollRectClient() const;

	/**
	 * @brief
	 * This member function is used to ensure that an event view item
	 * is visible.
	 *
	 * @param pViewEvent A CXTPCalendarViewEvent object. A pointer to the
	 *					event view item being made visible.
	 *
	 * @details
	 * If necessary, the function scrolls the day view so that the
	 * event view item is visible.
	 *
	 * @return Returns TRUE if the system scrolled the day view in the
	 *		  Calendar control to ensure that the specified event view item
	 *		  is visible. Otherwise, the return value is FALSE.
	 */
	BOOL _EnsureVisibleH(CXTPCalendarViewEvent* pViewEvent);

	/**
	 * @brief
	 * This member function is used to ensure that an event view item
	 * is visible.
	 *
	 * @param pViewEvent A CXTPCalendarViewEvent object. A pointer to the
	 *					event view item being made visible.
	 *
	 * @details
	 * If necessary, the function scrolls the day view so that the
	 * event view item is visible.
	 *
	 * @return Returns TRUE if the system scrolled the day view in the
	 *		  Calendar control to ensure that the specified event view item
	 *		  is visible. Otherwise, the return value is FALSE.
	 */
	BOOL _EnsureVisibleV(CXTPCalendarViewEvent* pViewEvent);

	/**
	 * @brief
	 * This member function is used to ensure that an selection is visible.
	 *
	 * @details
	 * If necessary, the function scrolls the day view horizontally so that
	 * the selection is visible.
	 *
	 * @return Returns TRUE if the system scrolled the day view, otherwise FALSE.
	 */
	BOOL _EnsureVisibleSelectionH();

	XTP_DAY_VIEW_LAYOUT& GetLayout();
	virtual BOOL IsUseCellAlignedDraggingInTimeArea() const;

	virtual void OnStartDragging(CPoint point, XTP_CALENDAR_HITTESTINFO* pHitTest);
	virtual BOOL OnDragging(CPoint point, XTP_CALENDAR_HITTESTINFO* pHitTest);
	virtual BOOL OnEndDragging(CPoint point, XTP_CALENDAR_HITTESTINFO* pHitInfo);

	virtual void ClearDays();

	virtual void _ScrollDays(int nScrollDaysCount, BOOL bPrev);
	virtual void ProcessCellSelection(COleDateTime dtNewSelBegin, BOOL bFixSelEnd,
									  BOOL bAllDayEventSel, int nGroupIndex);

	virtual void ProcessDaySelection(XTP_CALENDAR_HITTESTINFO* pInfo, UINT nFlags);

	virtual CXTPCalendarViewEvent* FindEventToEditByTAB(COleDateTime dtMinStart, BOOL bReverse,
														CXTPCalendarEvent* pAfterEvent = NULL);
	virtual COleDateTime GetNextTimeEditByTAB() const;
	virtual void UpdateNextTimeEditByTAB(COleDateTime dtNext, BOOL bReverse, BOOL bReset = FALSE);

	virtual BOOL OnTimer(UINT_PTR uTimerID);
	virtual void OnActivateView(BOOL bActivate, CXTPCalendarView* pActivateView,
								CXTPCalendarView* pInactiveView);

	void _AddDay(const COleDateTime& date);
	int CalculateHeaderFormatAndHeight(CDC* pDC, int nCellWidth);

	virtual CXTPCalendarData* _GetDataProviderByConnStr(LPCTSTR pcszConnStr,
														BOOL bCompareNoCase = TRUE);

	XTP_DAY_VIEW_LAYOUT m_LayoutX; /**< Layout data.*/

	CXTPCalendarDayViewTimeScale* m_pTimeScaleHeaderLeft;
	CXTPCalendarDayViewTimeScale* m_pTimeScaleHeaderRight;
	CXTPCalendarDayViewTimeScale* m_pTimeScaleHeaderAdditionalLeft;
	CXTPCalendarDayViewTimeScale* m_pTimeScaleHeaderAdditionalRight;

	int m_nAllDayEventsCountMin_WhenDrag;

	COleDateTimeSpan m_spDraggingStartOffset_Time;

	COleDateTime m_dtSelectionStart;

	DWORD m_dwScrollingEventTimerID;
	DWORD m_dwScrollingEventTimerHorID;

	BOOL m_bScrollingEventUp;
	BOOL m_bScrollingEventLeft;

	BOOL m_bMouseOutOfDragArea;
	COleDateTime m_dtDraggingStartPoint;
	CPoint m_ptLastMousePos;

	DWORD m_dwRedrawNowLineTimerID;
	COleDateTime m_dtLastRedrawTime;

	BOOL m_bHideAllDayEventsArea;

#	ifdef _XTP_ACTIVEX
	DECLARE_DISPATCH_MAP()
	DECLARE_INTERFACE_MAP()

	DECLARE_OLETYPELIB_EX(CXTPCalendarDayView);

	void OleShowDays(DATE dtBegin, DATE dtEnd);
	void OleAddDay(DATE dtDay);

	long OleGetScaleInterval();
	void OleSetScaleInterval(long nScalInterval);

	DATE OleGetTimeScaleMinTime();
	void OleSetTimeScaleMinTime(DATE dtNewScaleMinTime);

	DATE OleGetTimeScaleMaxTime();
	void OleSetTimeScaleMaxTime(DATE dtNewScaleMaxTime);

	BSTR OleGetScaleText();
	BSTR OleGetScale2Text();

	BOOL OleIsScale2Visible();
	void OleShowScale2(BOOL bShow);

	BOOL OleGetPreventAutoDropAllDayMode();
	void OleSetPreventAutoDropAllDayMode(BOOL bSet);

	long OleGetCellNumber(DATE dtTime);
	void OleScrollV(long lCell);
	void OleScrollToColumn(long lColumn);
	void OleScrollToWorkDayBegin();

	BOOL OleEnsureVisible(LPDISPATCH pdispViewEvent);
	BOOL OleEnsureVisibleGroup(LPDISPATCH pdispViewGroup);

	int OleGetDayHeaderPeriod();
	void OleSetDayHeaderPeriod(int nDayHeaderPeriod);

	int OleGetDayViewPrintInterval();
	void OleSetDayViewPrintInterval(int nDayViewPrintInterval);
#	endif
};

//================================================================

AFX_INLINE CRect CXTPCalendarDayView::GetDayHeaderRectangle() const
{
	return m_LayoutX.m_rcDayHeader;
}

AFX_INLINE CRect CXTPCalendarDayView::GetAllDayEventsRectangle() const
{
	return m_LayoutX.m_rcAllDayEvents;
}

AFX_INLINE BOOL CXTPCalendarDayView::GetIsHideAllDayEventsArea() const
{
	return m_bHideAllDayEventsArea;
}

AFX_INLINE int CXTPCalendarDayView::GetRowCount() const
{
	return m_LayoutX.m_nRowCount;
}

AFX_INLINE int CXTPCalendarDayView::GetVisibleRowCount() const
{
	return m_LayoutX.m_nVisibleRowCount;
}

AFX_INLINE int CXTPCalendarDayView::GetTopRow() const
{
	return m_LayoutX.m_nTopRow;
}

AFX_INLINE void CXTPCalendarDayView::ProcessDaySelection(XTP_CALENDAR_HITTESTINFO* /*pInfo*/,
														 UINT /*nFlags*/)
{
	UnselectAllEvents();
}

AFX_INLINE CXTPCalendarDayViewTimeScale* CXTPCalendarDayView::GetTimeScale(int nNumber) const
{
	switch (nNumber)
	{
		case 1: return m_pTimeScaleHeaderLeft;
		case 2: return m_pTimeScaleHeaderAdditionalLeft;
		case 3: return m_pTimeScaleHeaderRight;
		case 4: return m_pTimeScaleHeaderAdditionalRight;
		default: break;
	}

	return m_pTimeScaleHeaderLeft;
}

AFX_INLINE XTP_DAY_VIEW_LAYOUT& CXTPCalendarDayView::GetLayout()
{
	return m_LayoutX;
}

AFX_INLINE int CXTPCalendarDayView::GetMinColumnWidth() const
{
	return m_nMinColumnWidth;
}

AFX_INLINE void CXTPCalendarDayView::SetMinColumnWidth(int nWidth)
{
	m_nMinColumnWidth = nWidth;
}

#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
#endif // !defined(_XTPCALENDARDAYVIEW_H__)