Returns the movement of the mouse on the X axis. @@ -556,7 +494,7 @@ static Class eventClass;
This method is only valid for NSMouseMoved, NS*MouseDragged and NSScrollWheel events, otherwise it will raise an - NSInvalidArgumentException. + NSInternalInconsistencyException.
*/ - (float)deltaX @@ -564,7 +502,7 @@ static Class eventClass; if (event_type != NSScrollWheel && (event_type < NSMouseMoved || event_type > NSRightMouseDragged)) - [NSException raise: NSInvalidArgumentException + [NSException raise: NSInternalInconsistencyException format: @"deltaX requested for invalid event type"]; return event_data.scrollWheel.deltaX; @@ -577,7 +515,7 @@ static Class eventClass;This method is only valid for NSMouseMoved, NS*MouseDragged and NSScrollWheel events, otherwise it will raise an - NSInvalidArgumentException. + NSInternalInconsistencyException.
*/ - (float)deltaY @@ -585,7 +523,7 @@ static Class eventClass; if (event_type != NSScrollWheel && (event_type < NSMouseMoved || event_type > NSRightMouseDragged)) - [NSException raise: NSInvalidArgumentException + [NSException raise: NSInternalInconsistencyException format: @"deltaY requested for invalid event type"]; return event_data.scrollWheel.deltaY; @@ -598,7 +536,7 @@ static Class eventClass;This method is only valid for NSMouseMoved, NS*MouseDragged and NSScrollWheel events, otherwise it will raise an - NSInvalidArgumentException. + NSInternalInconsistencyException.
The value returned is 0.0 in most cases.
@@ -609,154 +547,12 @@ static Class eventClass;
if (event_type != NSScrollWheel
&& (event_type < NSMouseMoved
|| event_type > NSRightMouseDragged))
- [NSException raise: NSInvalidArgumentException
+ [NSException raise: NSInternalInconsistencyException
format: @"deltaZ requested for invalid event type"];
return event_data.scrollWheel.deltaZ;
}
-/*
- * NSCoding protocol
- */
-- (void) encodeWithCoder: (NSCoder*)aCoder
-{
- [aCoder encodeValueOfObjCType: @encode(NSEventType) at: &event_type];
- [aCoder encodePoint: location_point];
- [aCoder encodeValueOfObjCType: @encode(unsigned) at: &modifier_flags];
- [aCoder encodeValueOfObjCType: @encode(NSTimeInterval) at: &event_time];
- [aCoder encodeValueOfObjCType: @encode(unsigned) at: &window_num];
-
- switch (event_type)
- {
- case NSLeftMouseDown:
- case NSLeftMouseUp:
- case NSOtherMouseDown:
- case NSOtherMouseUp:
- case NSRightMouseDown:
- case NSRightMouseUp:
- [aCoder encodeValuesOfObjCTypes: "iif", &event_data.mouse.event_num,
- &event_data.mouse.click, &event_data.mouse.pressure];
- break;
-
- case NSMouseEntered:
- case NSMouseExited:
- case NSCursorUpdate:
- // Can't do anything with the user_data!?
- [aCoder encodeValuesOfObjCTypes: "ii", &event_data.tracking.event_num,
- &event_data.tracking.tracking_num];
- break;
-
- case NSKeyDown:
- case NSKeyUp:
- [aCoder encodeValueOfObjCType: @encode(BOOL)
- at: &event_data.key.repeat];
- [aCoder encodeObject: event_data.key.char_keys];
- [aCoder encodeObject: event_data.key.unmodified_keys];
- [aCoder encodeValueOfObjCType: "S" at: &event_data.key.key_code];
- break;
-
- case NSFlagsChanged:
- case NSPeriodic:
- case NSAppKitDefined:
- case NSSystemDefined:
- case NSApplicationDefined:
- [aCoder encodeValuesOfObjCTypes: "sii", &event_data.misc.sub_type,
- &event_data.misc.data1, &event_data.misc.data2];
- break;
- case NSScrollWheel:
- case NSMouseMoved:
- case NSLeftMouseDragged:
- case NSOtherMouseDragged:
- case NSRightMouseDragged:
- [aCoder encodeValuesOfObjCTypes: "fff",
- &event_data.scrollWheel.deltaX,
- &event_data.scrollWheel.deltaY,
- &event_data.scrollWheel.deltaZ];
- break;
- }
-}
-
-- (id) initWithCoder: (NSCoder*)aDecoder
-{
- [aDecoder decodeValueOfObjCType: @encode(NSEventType) at: &event_type];
- location_point = [aDecoder decodePoint];
- [aDecoder decodeValueOfObjCType: @encode(unsigned) at: &modifier_flags];
- [aDecoder decodeValueOfObjCType: @encode(NSTimeInterval) at: &event_time];
- [aDecoder decodeValueOfObjCType: @encode(unsigned) at: &window_num];
-
- // Decode the event date based upon the event type
- switch (event_type)
- {
- case NSLeftMouseDown:
- case NSLeftMouseUp:
- case NSOtherMouseDown:
- case NSOtherMouseUp:
- case NSRightMouseDown:
- case NSRightMouseUp:
- [aDecoder decodeValuesOfObjCTypes: "iif", &event_data.mouse.event_num,
- &event_data.mouse.click, &event_data.mouse.pressure];
- break;
-
- case NSMouseEntered:
- case NSMouseExited:
- case NSCursorUpdate:
- // Can't do anything with the user_data!?
- [aDecoder decodeValuesOfObjCTypes: "ii", &event_data.tracking.event_num,
- &event_data.tracking.tracking_num];
- break;
-
- case NSKeyDown:
- case NSKeyUp:
- [aDecoder decodeValueOfObjCType: @encode(BOOL)
- at: &event_data.key.repeat];
- event_data.key.char_keys = [aDecoder decodeObject];
- event_data.key.unmodified_keys = [aDecoder decodeObject];
- [aDecoder decodeValueOfObjCType: "S" at: &event_data.key.key_code];
- break;
-
- case NSFlagsChanged:
- case NSPeriodic:
- case NSAppKitDefined:
- case NSSystemDefined:
- case NSApplicationDefined:
- [aDecoder decodeValuesOfObjCTypes: "sii", &event_data.misc.sub_type,
- &event_data.misc.data1, &event_data.misc.data2];
- break;
-
- case NSScrollWheel:
- case NSMouseMoved:
- case NSLeftMouseDragged:
- case NSOtherMouseDragged:
- case NSRightMouseDragged:
- [aDecoder decodeValuesOfObjCTypes: "fff",
- &event_data.scrollWheel.deltaX,
- &event_data.scrollWheel.deltaY,
- &event_data.scrollWheel.deltaZ];
- break;
- }
-
- return self;
-}
-
-/*
- * Copying protocol
- */
-
-- (id) copyWithZone: (NSZone*)zone
-{
- NSEvent *e = (NSEvent*)NSCopyObject (self, 0, zone);
-
- if ((event_type == NSKeyUp) || (event_type == NSKeyDown))
- {
- event_data.key.char_keys = [event_data.key.char_keys copyWithZone: zone];
- event_data.key.unmodified_keys = [event_data.key.unmodified_keys copyWithZone: zone];
- }
- else if (event_type == NSCursorUpdate)
- event_data.tracking.user_data = (void *)[(id)event_data.tracking.user_data copyWithZone: zone];
-
- return e;
-}
-
- (NSString*) description
{
const char* eventTypes[] = {
@@ -863,4 +659,294 @@ static Class eventClass;
return [super description];
}
+/* FIXME ... handle all the data!
+ */
+- (void) encodeWithCoder: (NSCoder*)aCoder
+{
+ [aCoder encodeValueOfObjCType: @encode(NSEventType) at: &event_type];
+ [aCoder encodePoint: location_point];
+ [aCoder encodeValueOfObjCType: @encode(unsigned) at: &modifier_flags];
+ [aCoder encodeValueOfObjCType: @encode(NSTimeInterval) at: &event_time];
+ [aCoder encodeValueOfObjCType: @encode(unsigned) at: &window_num];
+
+ switch (event_type)
+ {
+ case NSLeftMouseDown:
+ case NSLeftMouseUp:
+ case NSOtherMouseDown:
+ case NSOtherMouseUp:
+ case NSRightMouseDown:
+ case NSRightMouseUp:
+ [aCoder encodeValuesOfObjCTypes: "iif", &event_data.mouse.event_num,
+ &event_data.mouse.click, &event_data.mouse.pressure];
+ break;
+
+ case NSMouseEntered:
+ case NSMouseExited:
+ case NSCursorUpdate:
+ // Can't do anything with the user_data!?
+ [aCoder encodeValuesOfObjCTypes: "ii", &event_data.tracking.event_num,
+ &event_data.tracking.tracking_num];
+ break;
+
+ case NSKeyDown:
+ case NSKeyUp:
+ [aCoder encodeValueOfObjCType: @encode(BOOL)
+ at: &event_data.key.repeat];
+ [aCoder encodeObject: event_data.key.char_keys];
+ [aCoder encodeObject: event_data.key.unmodified_keys];
+ [aCoder encodeValueOfObjCType: "S" at: &event_data.key.key_code];
+ break;
+
+ case NSFlagsChanged:
+ case NSPeriodic:
+ case NSAppKitDefined:
+ case NSSystemDefined:
+ case NSApplicationDefined:
+ [aCoder encodeValuesOfObjCTypes: "sii", &event_data.misc.sub_type,
+ &event_data.misc.data1, &event_data.misc.data2];
+ break;
+ case NSScrollWheel:
+ case NSMouseMoved:
+ case NSLeftMouseDragged:
+ case NSOtherMouseDragged:
+ case NSRightMouseDragged:
+ [aCoder encodeValuesOfObjCTypes: "fff",
+ &event_data.scrollWheel.deltaX,
+ &event_data.scrollWheel.deltaY,
+ &event_data.scrollWheel.deltaZ];
+ break;
+ }
+}
+
+/**
+ * Returns the event number associated with any mouse event or tracking
+ * event. Event numbers are allocated sequentially when the system
+ * creates these events.
+ *
Raises an NSInternalInconsistencyException if applied to any
+ * other type of event.
+ */
+- (int) eventNumber
+{
+ /* Make sure it is one of the right event types */
+ if (event_type < NSLeftMouseDown || event_type > NSMouseExited)
+ [NSException raise: NSInternalInconsistencyException
+ format: @"eventNumber requested for non-mouse event"];
+
+ if ((event_type == NSMouseEntered) || (event_type == NSMouseExited))
+ return event_data.tracking.event_num;
+ else
+ return event_data.mouse.event_num;
+}
+
+/* FIXME ... handle all the data!
+ */
+- (id) initWithCoder: (NSCoder*)aDecoder
+{
+ [aDecoder decodeValueOfObjCType: @encode(NSEventType) at: &event_type];
+ location_point = [aDecoder decodePoint];
+ [aDecoder decodeValueOfObjCType: @encode(unsigned) at: &modifier_flags];
+ [aDecoder decodeValueOfObjCType: @encode(NSTimeInterval) at: &event_time];
+ [aDecoder decodeValueOfObjCType: @encode(unsigned) at: &window_num];
+
+ // Decode the event date based upon the event type
+ switch (event_type)
+ {
+ case NSLeftMouseDown:
+ case NSLeftMouseUp:
+ case NSOtherMouseDown:
+ case NSOtherMouseUp:
+ case NSRightMouseDown:
+ case NSRightMouseUp:
+ [aDecoder decodeValuesOfObjCTypes: "iif", &event_data.mouse.event_num,
+ &event_data.mouse.click, &event_data.mouse.pressure];
+ break;
+
+ case NSMouseEntered:
+ case NSMouseExited:
+ case NSCursorUpdate:
+ // Can't do anything with the user_data!?
+ [aDecoder decodeValuesOfObjCTypes: "ii", &event_data.tracking.event_num,
+ &event_data.tracking.tracking_num];
+ break;
+
+ case NSKeyDown:
+ case NSKeyUp:
+ [aDecoder decodeValueOfObjCType: @encode(BOOL)
+ at: &event_data.key.repeat];
+ event_data.key.char_keys = [aDecoder decodeObject];
+ event_data.key.unmodified_keys = [aDecoder decodeObject];
+ [aDecoder decodeValueOfObjCType: "S" at: &event_data.key.key_code];
+ break;
+
+ case NSFlagsChanged:
+ case NSPeriodic:
+ case NSAppKitDefined:
+ case NSSystemDefined:
+ case NSApplicationDefined:
+ [aDecoder decodeValuesOfObjCTypes: "sii", &event_data.misc.sub_type,
+ &event_data.misc.data1, &event_data.misc.data2];
+ break;
+
+ case NSScrollWheel:
+ case NSMouseMoved:
+ case NSLeftMouseDragged:
+ case NSOtherMouseDragged:
+ case NSRightMouseDragged:
+ [aDecoder decodeValuesOfObjCTypes: "fff",
+ &event_data.scrollWheel.deltaX,
+ &event_data.scrollWheel.deltaY,
+ &event_data.scrollWheel.deltaZ];
+ break;
+ }
+
+ return self;
+}
+
+/**
+ * Returns a flag to say if this is a keyboard repeat event.
+ *
Raises an NSInternalInconsistencyException if applied to any
+ * other type of event than an NSKeyUp or NSKeyDown.
+ */
+- (BOOL) isARepeat
+{
+ if ((event_type != NSKeyUp) && (event_type != NSKeyDown))
+ [NSException raise: NSInternalInconsistencyException
+ format: @"isARepeat requested for non-keyboard event"];
+
+ return event_data.key.repeat;
+}
+
+/**
+ * Returns the numeric key code of a keyboard event.
+ *
Raises an NSInternalInconsistencyException if applied to any
+ * other type of event than an NSKeyUp or NSKeyDown.
+ */
+- (unsigned short) keyCode
+{
+ if ((event_type != NSKeyUp) && (event_type != NSKeyDown)
+ && (event_type != NSFlagsChanged))
+ [NSException raise: NSInternalInconsistencyException
+ format: @"keyCode requested for non-keyboard event"];
+
+ return event_data.key.key_code;
+}
+
+/**
+ * Returns the window location for which this event was generated (in the
+ * base coordinate system of the window).
+ */
+- (NSPoint) locationInWindow
+{
+ return location_point;
+}
+
+/**
+ * Returns the modifier flag bits associated with the event.
+ */
+- (unsigned int) modifierFlags
+{
+ return modifier_flags;
+}
+
+/**
+ * Returns the pressure associated with a mouse event. This is a value
+ * in the range 0.0 to 1.0 and for mormal mouse events should be set to
+ * one of those extremes. This is used by pressure sensitive input devices.
+ *
Raises an NSInternalInconsistencyException if applied to any
+ * other type of event than a mouse event.
+ */
+- (float) pressure
+{
+ /* Make sure it is one of the right event types */
+ if (event_type < NSLeftMouseDown || event_type > NSRightMouseDragged)
+ [NSException raise: NSInternalInconsistencyException
+ format: @"pressure requested for non-mouse event"];
+
+ return event_data.mouse.pressure;
+}
+
+/**
+ * Returns the 'subtype' item associated with the event.
+ *
Raises NSInternalInconsistencyException if the event is not
+ * of type NSAppKitDefined, NSSystemDefined, NSApplicationDefined,
+ * or NSPeriodic
+ */
+- (short) subtype
+{
+ if (event_type < NSAppKitDefined || event_type > NSPeriodic)
+ [NSException raise: NSInternalInconsistencyException
+ format: @"subtype requested for invalid event type"];
+
+ return event_data.misc.sub_type;;
+}
+
+/**
+ * Returns the time interval since system startup at which this
+ * event was generated.
+ */
+- (NSTimeInterval) timestamp
+{
+ return event_time;
+}
+
+/**
+ * Returns a number identifying the tracking rectangle entered or exited.
+ *
Raises an NSInternalInconsistencyException if applied to any
+ * other type of event than a mouse entered or exited event.
+ */
+- (int) trackingNumber
+{
+ if (event_type != NSMouseEntered && event_type != NSMouseExited
+ && event_type != NSCursorUpdate)
+ [NSException raise: NSInternalInconsistencyException
+ format: @"trackingNumber requested for non-tracking event"];
+
+ return event_data.tracking.tracking_num;
+}
+
+/**
+ * returns the type of this event.
+ */
+- (NSEventType) type
+{
+ return event_type;
+}
+
+/**
+ * Returns usder data associated with a tracking event... the data assigned to
+ * the tracking rectangle concerned when it was created..
+ *
Raises an NSInternalInconsistencyException if applied to any
+ * other type of event than a mouse entered or exited event.
+ */
+- (void *) userData
+{
+ if (event_type != NSMouseEntered && event_type != NSMouseExited
+ && event_type != NSCursorUpdate)
+ [NSException raise: NSInternalInconsistencyException
+ format: @"userData requested for non-tracking event"];
+
+ return event_data.tracking.user_data;
+}
+
+/**
+ * Returns the window for which this event was generated.
+ * Periodic events have no associated window, and you should not call
+ * this method for those events.
+ */
+- (NSWindow *) window
+{
+ return GSWindowWithNumber(window_num);
+}
+
+/**
+ * Returns the window number of the window for which this event was generated.
+ *
Periodic events have no associated window, and you should not call
+ * this method for those events.
+ */
+- (int) windowNumber
+{
+ return window_num;
+}
+
@end