Class: UIEvent

Inherits:
NSObject show all

Overview

A UIEvent object (or, simply, an event object) represents an event in iOS. There are three general types of event: touch events, motion events, and remote-control events. Remote-control events allow a responder object to receive commands from an external accessory or headset so that it can manage manage audio and video—for example, playing a video or skipping to the next audio track. Motion events were introduced in iOS 3.0 and remote-control events in iOS 4.0.

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Methods inherited from NSObject

#!, #!=, #!~, #, #==, #===, #=~, #Rational, #__callee__, #__method__, #__send__, #__type__, `, alloc, allocWithZone:, #autoContentAccessingProxy, autoload, autoload?, autorelease_pool, #awakeAfterUsingCoder:, binding, block_given?, caller, cancelPreviousPerformRequestsWithTarget:, cancelPreviousPerformRequestsWithTarget:selector:object:, catch, class, classFallbacksForKeyedArchiver, #classForCoder, #classForKeyedArchiver, classForKeyedUnarchiver, #clone, conformsToProtocol:, #copy, copyWithZone:, #dealloc, #define_singleton_method, description, display, #doesNotRecognizeSelector:, #dup, #enum_for, #eql?, #equal?, #extend, fail, #finalize, format, #forwardInvocation:, #forwardingTargetForSelector:, framework, #freeze, #frozen?, getpass, gets, global_variables, #init, initialize, #initialize_clone, #initialize_copy, #initialize_dup, #inspect, instanceMethodForSelector:, instanceMethodSignatureForSelector:, #instance_eval, #instance_exec, #instance_of?, #instance_variable_defined?, #instance_variable_get, #instance_variable_set, #instance_variables, instancesRespondToSelector:, isSubclassOfClass:, #is_a?, iterator?, #kind_of?, lambda, load, load_bridge_support_file, load_plist, local_variables, loop, #method, #methodForSelector:, #methodSignatureForSelector:, #methods, #mutableCopy, mutableCopyWithZone:, new, #nil?, open, p, #performSelector:onThread:withObject:waitUntilDone:, #performSelector:onThread:withObject:waitUntilDone:modes:, #performSelector:withObject:afterDelay:, #performSelector:withObject:afterDelay:inModes:, #performSelectorInBackground:withObject:, #performSelectorOnMainThread:withObject:waitUntilDone:, #performSelectorOnMainThread:withObject:waitUntilDone:modes:, print, printf, #private_methods, proc, #protected_methods, #public_method, #public_methods, #public_send, putc, puts, raise, rand, readline, readlines, #replacementObjectForCoder:, #replacementObjectForKeyedArchiver:, require, resolveClassMethod:, resolveInstanceMethod:, #respond_to?, #respond_to_missing?, select, #send, setVersion:, #singleton_methods, sprintf, srand, superclass, #taint, #tainted?, #tap, test, throw, #to_plist, #to_s, trace_var, trap, #trust, #untaint, untrace_var, #untrust, #untrusted?, version

Constructor Details

This class inherits a constructor from NSObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class NSObject

Instance Attribute Details

- (UIEventSubtype) subtype (readonly)

Returns the subtype of the event. (read-only) The UIEventSubtype constant returned by this property indicates the subtype of the event in relation to the general type, which is returned from the type property.

Returns:

- (NSTimeInterval) timestamp (readonly)

The time when the event occurred. (read-only) The property value is the number of seconds since system startup. For a description of this time value, see the description of the systemUptime method of the NSProcessInfo class.

Returns:

  • (NSTimeInterval)

- (UIEventType) type (readonly)

Returns the type of the event. (read-only) The UIEventType constant returned by this property indicates the general type of this event, for example, whether it is a touch or motion event.

Returns:

Instance Method Details

- (NSSet) allTouches

Returns all touch objects associated with the receiver. If the touches of the event originate in different views and windows, the UITouch objects obtained from this method will have different responder objects associated with the touches.

Returns:

  • (NSSet)

    A set of UITouch objects representing all touches associated with an event (represented by the receiver).

- (NSSet) touchesForGestureRecognizer(gesture)

Returns the touch objects that are being delivered to the specified gesture recognizer.

Parameters:

  • gesture (UIGestureRecognizer)

    An instance of a subclass of the abstract base class UIGestureRecognizer. This gesture-recognizer object must be attached to a view to receive the touches hit-tested to that view and its subviews.

Returns:

  • (NSSet)

    A set of UITouch objects representing the touches being delivered to the specified gesture recognizer for the event represented by the receiver.

- (NSSet) touchesForView(view)

Returns the touch objects that belong to a given view for the event represented by the receiver.

Parameters:

  • view (UIView)

    TheUIView object on which the touches related to the event were made.

Returns:

  • (NSSet)

    A set of UITouch objects representing the touches for the specified view related to the event represented by the receiver.

- (NSSet) touchesForWindow(window)

Returns the touch objects that belong to a given window for the event represented by the receiver.

Parameters:

  • window (UIWindow)

    The UIWindow object on which the touches related to the event were made.

Returns:

  • (NSSet)

    A set of UITouch objects representing the touches for the specified window related to the event represented by the receiver.