mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-30 21:55:31 +00:00
480 lines
15 KiB
C++
480 lines
15 KiB
C++
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public License
|
|
* Version 1.0 (the "NPL"); you may not use this file except in
|
|
* compliance with the NPL. You may obtain a copy of the NPL at
|
|
* http://www.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the NPL is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
|
|
* for the specific language governing rights and limitations under the
|
|
* NPL.
|
|
*
|
|
* The Initial Developer of this code under the NPL is Netscape
|
|
* Communications Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All Rights
|
|
* Reserved.
|
|
*/
|
|
|
|
#ifndef nsGUIEvent_h__
|
|
#define nsGUIEvent_h__
|
|
|
|
#include "nsPoint.h"
|
|
#include "nsRect.h"
|
|
|
|
class nsIRenderingContext;
|
|
class nsIWidget;
|
|
class nsIMenuItem;
|
|
|
|
/**
|
|
* Return status for event processors.
|
|
*/
|
|
|
|
enum nsEventStatus {
|
|
/// The event is ignored, do default processing
|
|
nsEventStatus_eIgnore,
|
|
/// The event is consumed, don't do default processing
|
|
nsEventStatus_eConsumeNoDefault,
|
|
/// The event is consumed, but do default processing
|
|
nsEventStatus_eConsumeDoDefault
|
|
};
|
|
|
|
/**
|
|
* General event
|
|
*/
|
|
|
|
struct nsEvent {
|
|
/// See event struct types
|
|
PRUint8 eventStructType;
|
|
/// See GUI MESSAGES,
|
|
PRUint32 message;
|
|
/// in widget relative coordinates, modified to be relative to current view in layout.
|
|
nsPoint point;
|
|
// in widget relative coordinates, not modified by layout code.
|
|
nsPoint refPoint;
|
|
/// elapsed time, in milliseconds, from the time the system was started to the time the message was created
|
|
PRUint32 time;
|
|
// flags to hold event flow stage and capture/bubble cancellation status
|
|
PRUint32 flags;
|
|
};
|
|
|
|
/**
|
|
* General graphic user interface event
|
|
*/
|
|
|
|
struct nsGUIEvent : public nsEvent {
|
|
/// Originator of the event
|
|
nsIWidget* widget;
|
|
/// Internal platform specific message.
|
|
void* nativeMsg;
|
|
};
|
|
|
|
/**
|
|
* Window resize event
|
|
*/
|
|
|
|
struct nsSizeEvent : public nsGUIEvent {
|
|
/// x,y width, height in pixels (client area)
|
|
nsRect *windowSize;
|
|
/// width of entire window (in pixels)
|
|
PRInt32 mWinWidth;
|
|
/// height of entire window (in pixels)
|
|
PRInt32 mWinHeight;
|
|
};
|
|
|
|
/**
|
|
* Window repaint event
|
|
*/
|
|
|
|
struct nsPaintEvent : public nsGUIEvent {
|
|
/// Context to paint in.
|
|
nsIRenderingContext *renderingContext;
|
|
/// x,y, width, height in pixels of area to paint
|
|
nsRect *rect;
|
|
};
|
|
|
|
/**
|
|
* Scrollbar event
|
|
*/
|
|
|
|
struct nsScrollbarEvent : public nsGUIEvent {
|
|
/// ranges between scrollbar 0 and (maxRange - thumbSize). See nsIScrollbar
|
|
PRUint32 position;
|
|
};
|
|
|
|
|
|
struct nsInputEvent : public nsGUIEvent {
|
|
/// PR_TRUE indicates the shift key in down
|
|
PRBool isShift;
|
|
/// PR_TRUE indicates the control key in down
|
|
PRBool isControl;
|
|
/// PR_TRUE indicates the alt key in down
|
|
PRBool isAlt;
|
|
#ifdef XP_MAC
|
|
/// PR_TRUE indicates the command key in down
|
|
/// For now, it's only used in Widget: not for export
|
|
/// in nsIDOMEvent.h or nsJSEvent.cpp (later maybe)
|
|
PRBool isCommand;
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* Mouse event
|
|
*/
|
|
|
|
struct nsMouseEvent : public nsInputEvent {
|
|
/// The number of mouse clicks
|
|
PRUint32 clickCount;
|
|
};
|
|
|
|
/**
|
|
* Keyboard event
|
|
*/
|
|
|
|
struct nsKeyEvent : public nsInputEvent {
|
|
/// see NS_VK codes
|
|
PRUint32 keyCode;
|
|
/// OS translated Unicode char
|
|
PRUint32 charCode;
|
|
};
|
|
|
|
/**
|
|
* IME Related Events
|
|
*/
|
|
struct nsTextRange {
|
|
PRUint32 mStartOffset;
|
|
PRUint32 mEndOffset;
|
|
PRUint32 mRangeType;
|
|
};
|
|
|
|
typedef struct nsTextRange nsTextRange;
|
|
typedef nsTextRange* nsTextRangeArray;
|
|
|
|
struct nsTextEvent : public nsInputEvent {
|
|
PRUnichar* theText;
|
|
PRUint32 rangeCount;
|
|
nsTextRangeArray rangeArray;
|
|
};
|
|
|
|
struct nsCompositionEvent : public nsInputEvent {
|
|
PRUint32 compositionMessage;
|
|
};
|
|
|
|
/**
|
|
* Tooltip event
|
|
*/
|
|
struct nsTooltipEvent : public nsGUIEvent {
|
|
/// Index of tooltip area which generated the event. @see SetTooltips in nsIWidget
|
|
PRUint32 tipIndex;
|
|
};
|
|
|
|
/**
|
|
* MenuItem event
|
|
*
|
|
* When this event occurs the widget field in nsGUIEvent holds the "target"
|
|
* for the event
|
|
*/
|
|
|
|
struct nsMenuEvent : public nsGUIEvent {
|
|
nsIMenuItem * mMenuItem;
|
|
PRUint32 mCommand;
|
|
};
|
|
|
|
|
|
/**
|
|
* Event status for D&D Event
|
|
*/
|
|
enum nsDragDropEventStatus {
|
|
/// The event is a enter
|
|
nsDragDropEventStatus_eDragEntered,
|
|
/// The event is exit
|
|
nsDragDropEventStatus_eDragExited,
|
|
/// The event is drop
|
|
nsDragDropEventStatus_eDrop
|
|
};
|
|
|
|
/**
|
|
* Event Struct Types
|
|
*/
|
|
#define NS_EVENT 1
|
|
#define NS_GUI_EVENT 2
|
|
#define NS_SIZE_EVENT 3
|
|
#define NS_PAINT_EVENT 4
|
|
#define NS_SCROLLBAR_EVENT 5
|
|
#define NS_INPUT_EVENT 6
|
|
#define NS_KEY_EVENT 7
|
|
#define NS_MOUSE_EVENT 8
|
|
#define NS_TOOLTIP_EVENT 9
|
|
#define NS_MENU_EVENT 10
|
|
#define NS_DRAGDROP_EVENT 11
|
|
#define NS_TEXT_EVENT 12
|
|
#define NS_COMPOSITION_START 13
|
|
#define NS_COMPOSITION_END 14
|
|
|
|
/**
|
|
* GUI MESSAGES
|
|
*/
|
|
//@{
|
|
|
|
#define NS_WINDOW_START 100
|
|
|
|
// Widget is being created
|
|
#define NS_CREATE (NS_WINDOW_START)
|
|
// Widget is being destroyed
|
|
#define NS_DESTROY (NS_WINDOW_START + 1)
|
|
// Widget was resized
|
|
#define NS_SIZE (NS_WINDOW_START + 2)
|
|
// Widget gained focus
|
|
#define NS_GOTFOCUS (NS_WINDOW_START + 3)
|
|
// Widget lost focus
|
|
#define NS_LOSTFOCUS (NS_WINDOW_START + 4)
|
|
// Widget needs to be repainted
|
|
#define NS_PAINT (NS_WINDOW_START + 30)
|
|
// Key is pressed within a window
|
|
#define NS_KEY_PRESS (NS_WINDOW_START + 31)
|
|
// Key is released within a window
|
|
#define NS_KEY_UP (NS_WINDOW_START + 32)
|
|
// Key is pressed within a window
|
|
#define NS_KEY_DOWN (NS_WINDOW_START + 33)
|
|
// Window has been moved to a new location.
|
|
// The events point contains the x, y location in screen coordinates
|
|
#define NS_MOVE (NS_WINDOW_START + 34)
|
|
|
|
// Tab control's selected tab has changed
|
|
#define NS_TABCHANGE (NS_WINDOW_START + 35)
|
|
|
|
// Tooltip should be shown
|
|
#define NS_SHOW_TOOLTIP (NS_WINDOW_START + 36)
|
|
// Tooltip should be hidden
|
|
#define NS_HIDE_TOOLTIP (NS_WINDOW_START + 37)
|
|
// Menu item selected
|
|
#define NS_MENU_SELECTED (NS_WINDOW_START + 38)
|
|
|
|
// Form control changed: currently == combo box selection changed
|
|
// but could be expanded to mean textbox, checkbox changed, etc.
|
|
// This is a GUI specific event that does not necessarily correspond
|
|
// directly to a mouse click or a key press.
|
|
#define NS_CONTROL_CHANGE (NS_WINDOW_START + 39)
|
|
|
|
|
|
#define NS_MOUSE_MESSAGE_START 300
|
|
#define NS_MOUSE_MOVE (NS_MOUSE_MESSAGE_START)
|
|
#define NS_MOUSE_LEFT_BUTTON_UP (NS_MOUSE_MESSAGE_START + 1)
|
|
#define NS_MOUSE_LEFT_BUTTON_DOWN (NS_MOUSE_MESSAGE_START + 2)
|
|
#define NS_MOUSE_MIDDLE_BUTTON_UP (NS_MOUSE_MESSAGE_START + 10)
|
|
#define NS_MOUSE_MIDDLE_BUTTON_DOWN (NS_MOUSE_MESSAGE_START + 11)
|
|
#define NS_MOUSE_RIGHT_BUTTON_UP (NS_MOUSE_MESSAGE_START + 20)
|
|
#define NS_MOUSE_RIGHT_BUTTON_DOWN (NS_MOUSE_MESSAGE_START + 21)
|
|
#define NS_MOUSE_ENTER (NS_MOUSE_MESSAGE_START + 22)
|
|
#define NS_MOUSE_EXIT (NS_MOUSE_MESSAGE_START + 23)
|
|
#define NS_MOUSE_LEFT_DOUBLECLICK (NS_MOUSE_MESSAGE_START + 24)
|
|
#define NS_MOUSE_MIDDLE_DOUBLECLICK (NS_MOUSE_MESSAGE_START + 25)
|
|
#define NS_MOUSE_RIGHT_DOUBLECLICK (NS_MOUSE_MESSAGE_START + 26)
|
|
#define NS_MOUSE_LEFT_CLICK (NS_MOUSE_MESSAGE_START + 27)
|
|
#define NS_MOUSE_MIDDLE_CLICK (NS_MOUSE_MESSAGE_START + 28)
|
|
#define NS_MOUSE_RIGHT_CLICK (NS_MOUSE_MESSAGE_START + 29)
|
|
|
|
#define NS_SCROLLBAR_MESSAGE_START 1000
|
|
#define NS_SCROLLBAR_POS (NS_SCROLLBAR_MESSAGE_START)
|
|
#define NS_SCROLLBAR_PAGE_NEXT (NS_SCROLLBAR_MESSAGE_START + 1)
|
|
#define NS_SCROLLBAR_PAGE_PREV (NS_SCROLLBAR_MESSAGE_START + 2)
|
|
#define NS_SCROLLBAR_LINE_NEXT (NS_SCROLLBAR_MESSAGE_START + 3)
|
|
#define NS_SCROLLBAR_LINE_PREV (NS_SCROLLBAR_MESSAGE_START + 4)
|
|
|
|
#define NS_STREAM_EVENT_START 1100
|
|
#define NS_PAGE_LOAD (NS_STREAM_EVENT_START)
|
|
#define NS_PAGE_UNLOAD (NS_STREAM_EVENT_START + 1)
|
|
#define NS_IMAGE_LOAD (NS_STREAM_EVENT_START + 2)
|
|
#define NS_IMAGE_ABORT (NS_STREAM_EVENT_START + 3)
|
|
#define NS_IMAGE_ERROR (NS_STREAM_EVENT_START + 4)
|
|
|
|
#define NS_FORM_EVENT_START 1200
|
|
#define NS_FORM_SUBMIT (NS_FORM_EVENT_START)
|
|
#define NS_FORM_RESET (NS_FORM_EVENT_START + 1)
|
|
#define NS_FORM_CHANGE (NS_FORM_EVENT_START + 2)
|
|
|
|
//Need separate focus/blur notifications for non-native widgets
|
|
#define NS_FOCUS_EVENT_START 1300
|
|
#define NS_FOCUS_CONTENT (NS_FOCUS_EVENT_START)
|
|
#define NS_BLUR_CONTENT (NS_FOCUS_EVENT_START + 1)
|
|
|
|
|
|
#define NS_DRAGDROP_EVENT_START 1400
|
|
#define NS_DRAGDROP_ENTER (NS_DRAGDROP_EVENT_START)
|
|
#define NS_DRAGDROP_OVER (NS_DRAGDROP_EVENT_START + 1)
|
|
#define NS_DRAGDROP_EXIT (NS_DRAGDROP_EVENT_START + 2)
|
|
#define NS_DRAGDROP_DROP (NS_DRAGDROP_EVENT_START + 3)
|
|
|
|
// Events for popups
|
|
#define NS_POPUP_EVENT_START 1500
|
|
#define NS_POPUP_CONSTRUCT (NS_POPUP_EVENT_START)
|
|
#define NS_POPUP_DESTRUCT (NS_POPUP_EVENT_START+1)
|
|
|
|
//@}
|
|
|
|
|
|
#define NS_IS_MOUSE_EVENT(evnt) \
|
|
(((evnt)->message == NS_MOUSE_LEFT_BUTTON_DOWN) || \
|
|
((evnt)->message == NS_MOUSE_LEFT_BUTTON_UP) || \
|
|
((evnt)->message == NS_MOUSE_LEFT_CLICK) || \
|
|
((evnt)->message == NS_MOUSE_LEFT_DOUBLECLICK) || \
|
|
((evnt)->message == NS_MOUSE_MIDDLE_BUTTON_DOWN) || \
|
|
((evnt)->message == NS_MOUSE_MIDDLE_BUTTON_UP) || \
|
|
((evnt)->message == NS_MOUSE_MIDDLE_CLICK) || \
|
|
((evnt)->message == NS_MOUSE_MIDDLE_DOUBLECLICK) || \
|
|
((evnt)->message == NS_MOUSE_RIGHT_BUTTON_DOWN) || \
|
|
((evnt)->message == NS_MOUSE_RIGHT_BUTTON_UP) || \
|
|
((evnt)->message == NS_MOUSE_RIGHT_CLICK) || \
|
|
((evnt)->message == NS_MOUSE_RIGHT_DOUBLECLICK) || \
|
|
((evnt)->message == NS_MOUSE_ENTER) || \
|
|
((evnt)->message == NS_MOUSE_EXIT) || \
|
|
((evnt)->message == NS_MOUSE_MOVE))
|
|
|
|
#define NS_IS_KEY_EVENT(evnt) \
|
|
(((evnt)->message == NS_KEY_DOWN) || \
|
|
((evnt)->message == NS_KEY_PRESS) || \
|
|
((evnt)->message == NS_KEY_UP))
|
|
|
|
/*
|
|
* Virtual key bindings for keyboard events
|
|
* NOTE: These are repeated in nsIDOMEvent.h and must be kept in sync
|
|
*/
|
|
|
|
#define NS_VK_CANCEL 0x03
|
|
#define NS_VK_BACK 0x08
|
|
#define NS_VK_TAB 0x09
|
|
#define NS_VK_CLEAR 0x0C
|
|
#define NS_VK_RETURN 0x0D
|
|
#define NS_VK_ENTER 0x0E
|
|
#define NS_VK_SHIFT 0x10
|
|
#define NS_VK_CONTROL 0x11
|
|
#define NS_VK_ALT 0x12
|
|
#define NS_VK_PAUSE 0x13
|
|
#define NS_VK_CAPS_LOCK 0x14
|
|
#define NS_VK_ESCAPE 0x1B
|
|
#define NS_VK_SPACE 0x20
|
|
#define NS_VK_PAGE_UP 0x21
|
|
#define NS_VK_PAGE_DOWN 0x22
|
|
#define NS_VK_END 0x23
|
|
#define NS_VK_HOME 0x24
|
|
#define NS_VK_LEFT 0x25
|
|
#define NS_VK_UP 0x26
|
|
#define NS_VK_RIGHT 0x27
|
|
#define NS_VK_DOWN 0x28
|
|
#define NS_VK_PRINTSCREEN 0x2C
|
|
#define NS_VK_INSERT 0x2D
|
|
#define NS_VK_DELETE 0x2E
|
|
|
|
// NS_VK_0 - NS_VK_9 match their ascii values
|
|
#define NS_VK_0 0x30
|
|
#define NS_VK_1 0x31
|
|
#define NS_VK_2 0x32
|
|
#define NS_VK_3 0x33
|
|
#define NS_VK_4 0x34
|
|
#define NS_VK_5 0x35
|
|
#define NS_VK_6 0x36
|
|
#define NS_VK_7 0x37
|
|
#define NS_VK_8 0x38
|
|
#define NS_VK_9 0x39
|
|
|
|
#define NS_VK_SEMICOLON 0x3B
|
|
#define NS_VK_EQUALS 0x3D
|
|
|
|
// NS_VK_A - NS_VK_Z match their ascii values
|
|
#define NS_VK_A 0x41
|
|
#define NS_VK_B 0x42
|
|
#define NS_VK_C 0x43
|
|
#define NS_VK_D 0x44
|
|
#define NS_VK_E 0x45
|
|
#define NS_VK_F 0x46
|
|
#define NS_VK_G 0x47
|
|
#define NS_VK_H 0x48
|
|
#define NS_VK_I 0x49
|
|
#define NS_VK_J 0x4A
|
|
#define NS_VK_K 0x4B
|
|
#define NS_VK_L 0x4C
|
|
#define NS_VK_M 0x4D
|
|
#define NS_VK_N 0x4E
|
|
#define NS_VK_O 0x4F
|
|
#define NS_VK_P 0x50
|
|
#define NS_VK_Q 0x51
|
|
#define NS_VK_R 0x52
|
|
#define NS_VK_S 0x53
|
|
#define NS_VK_T 0x54
|
|
#define NS_VK_U 0x55
|
|
#define NS_VK_V 0x56
|
|
#define NS_VK_W 0x57
|
|
#define NS_VK_X 0x58
|
|
#define NS_VK_Y 0x59
|
|
#define NS_VK_Z 0x5A
|
|
|
|
#define NS_VK_NUMPAD0 0x60
|
|
#define NS_VK_NUMPAD1 0x61
|
|
#define NS_VK_NUMPAD2 0x62
|
|
#define NS_VK_NUMPAD3 0x63
|
|
#define NS_VK_NUMPAD4 0x64
|
|
#define NS_VK_NUMPAD5 0x65
|
|
#define NS_VK_NUMPAD6 0x66
|
|
#define NS_VK_NUMPAD7 0x67
|
|
#define NS_VK_NUMPAD8 0x68
|
|
#define NS_VK_NUMPAD9 0x69
|
|
#define NS_VK_MULTIPLY 0x6A
|
|
#define NS_VK_ADD 0x6B
|
|
#define NS_VK_SEPARATOR 0x6C
|
|
#define NS_VK_SUBTRACT 0x6D
|
|
#define NS_VK_DECIMAL 0x6E
|
|
#define NS_VK_DIVIDE 0x6F
|
|
#define NS_VK_F1 0x70
|
|
#define NS_VK_F2 0x71
|
|
#define NS_VK_F3 0x72
|
|
#define NS_VK_F4 0x73
|
|
#define NS_VK_F5 0x74
|
|
#define NS_VK_F6 0x75
|
|
#define NS_VK_F7 0x76
|
|
#define NS_VK_F8 0x77
|
|
#define NS_VK_F9 0x78
|
|
#define NS_VK_F10 0x79
|
|
#define NS_VK_F11 0x7A
|
|
#define NS_VK_F12 0x7B
|
|
#define NS_VK_F13 0x7C
|
|
#define NS_VK_F14 0x7D
|
|
#define NS_VK_F15 0x7E
|
|
#define NS_VK_F16 0x7F
|
|
#define NS_VK_F17 0x80
|
|
#define NS_VK_F18 0x81
|
|
#define NS_VK_F19 0x82
|
|
#define NS_VK_F20 0x83
|
|
#define NS_VK_F21 0x84
|
|
#define NS_VK_F22 0x85
|
|
#define NS_VK_F23 0x86
|
|
#define NS_VK_F24 0x87
|
|
|
|
#define NS_VK_NUM_LOCK 0x90
|
|
#define NS_VK_SCROLL_LOCK 0x91
|
|
|
|
#define NS_VK_COMMA 0xBC
|
|
#define NS_VK_PERIOD 0xBE
|
|
#define NS_VK_SLASH 0xBF
|
|
#define NS_VK_BACK_QUOTE 0xC0
|
|
#define NS_VK_OPEN_BRACKET 0xDB
|
|
#define NS_VK_BACK_SLASH 0xDC
|
|
#define NS_VK_CLOSE_BRACKET 0xDD
|
|
#define NS_VK_QUOTE 0xDE
|
|
|
|
#define NS_EVENT_FLAG_NONE 0x0000
|
|
#define NS_EVENT_FLAG_INIT 0x0001
|
|
#define NS_EVENT_FLAG_BUBBLE 0x0002
|
|
#define NS_EVENT_FLAG_CAPTURE 0x0004
|
|
#define NS_EVENT_FLAG_STOP_DISPATCH 0x0008
|
|
#define NS_EVENT_FLAG_NO_DEFAULT 0x0010
|
|
|
|
// IME Constants -- keep in synch with nsIDOMTextRange.h
|
|
#define NS_TEXTRANGE_CARETPOSITION 0x01
|
|
#define NS_TEXTRANGE_RAWINPUT 0X02
|
|
#define NS_TEXTRANGE_SELECTEDRAWTEXT 0x03
|
|
#define NS_TEXTRANGE_CONVERTEDTEXT 0x04
|
|
#define NS_TEXTRANGE_SELECTEDCONVERTEDTEXT 0x05
|
|
|
|
#endif // nsGUIEvent_h__
|
|
|