chiark - git - mdw - mgLib/blob

1 /* -*-c-*-

2 *

3 * $Id: cancel.h,v 1.5 2004/04/08 01:36:14 mdw Exp $

4 *

5 * Handle Escape keypresses, directing them to cancel buttons

6 *

8 */

10 /*----- Licensing notice --------------------------------------------------*

11 *

12 * This file is part of the mgLib GTK utilities library.

13 *

14 * mgLib is free software; you can redistribute it and/or modify

15 * it under the terms of the GNU Library General Public License as

16 * published by the Free Software Foundation; either version 2 of the

17 * License, or (at your option) any later version.

18 *

19 * mgLib is distributed in the hope that it will be useful,

20 * but WITHOUT ANY WARRANTY; without even the implied warranty of

21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

22 * GNU Library General Public License for more details.

23 *

24 * You should have received a copy of the GNU Library General Public

25 * License along with mgLib; if not, write to the Free

26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,

27 * MA 02111-1307, USA.

28 */

30 #ifndef MGLIB_CANCEL_H

31 #define MGLIB_CANCEL_H

33 #ifdef __cplusplus

34 extern "C" {

35 #endif

37 /*----- Header files ------------------------------------------------------*/

39 #include <gtk/gtk.h>

41 /*----- Functions provided ------------------------------------------------*/

43 /* --- @cancel@ --- *

44 *

45 * Arguments: @GtkWindow *win@ = window in which this is happening

46 * @GtkWidget *w@ = widget to activate, or null

47 *

48 * Returns: ---

49 *

50 * Use: Sets up @win@ so that a press of `escape' will activate

51 * @w@ or destroy @win@.

52 */

54 extern void cancel(GtkWindow */*win*/, GtkWidget */*w*/);

56 /*----- That's all, folks -------------------------------------------------*/

58 #ifdef __cplusplus

59 }

60 #endif

62 #endif