/*
    ####             #    #     # #
    #   #            #    #       #          The FreeWare C library for
    #   #  ##   ###  #  # #     # ###             RISC OS machines
    #   # #  # #     # #  #     # #  #   ___________________________________
    #   # ####  ###  ##   #     # #  #
    #   # #        # # #  #     # #  #    Please refer to the accompanying
    ####   ### ####  #  # ##### # ###    documentation for conditions of use
    ________________________________________________________________________

    File:    Pointer.h
    Author:  Copyright  1994 Lee Atkinson
    Version: 1.00 (28 Sep 1994)
    Purpose: high level pointer handling routines
*/

#ifndef __Desk_Pointer_h
#define __Desk_Pointer_h

#ifdef __cplusplus
extern "C" {
#endif

#ifndef __Desk_Core_h
	#include "Desk.Core.h"
#endif

#ifndef __Desk_Icon_h
	#include "Desk.Icon.h"
#endif

#ifndef __Desk_Window_h
	#include "Desk.Window.h"
#endif


extern void	Desk_Pointer_RestrictToWindow(Desk_window_handle window);
/*
  Purpose:  - Restricts pointer to window
  Inputs:   - window - handle of window which is restricted to
  Returns:  - pointer to Desk_os_error
*/


extern void	Desk_Pointer_RestrictToIcon(Desk_window_handle window, Desk_icon_handle icon);
/*
  Purpose:  - Restricts pointer to icon
  Inputs:   - window - handle of window which icon belongs to
              icon   - handle of icon which is restricted to
  Returns:  - pointer to Desk_os_error
*/


extern void	Desk_Pointer_RestrictToRect(Desk_wimp_rect rect);
/*
  Purpose:  - Restricts pointer to rectangle
  Inputs:   - rect - rectangle definition
  Returns:  - pointer to Desk_os_error
*/


extern void	Desk_Pointer_Unrestrict(void);
/*
  Purpose:  - Unrestricts pointer
  Returns:  - pointer to Desk_os_error
*/

#ifdef __cplusplus
}
#endif


#endif
