mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-08-16 18:40:05 +00:00
a35c109a08
Summary: * Fixes #3 * Ordering: atomicity, then [optional] readonly, then value semantics (retain/copy/assign) * Removed redundant `readwrite` * No spaces between "getter = name" ("getter=name" instead) * Property method overrides renamed as well * self.isBlah, while technically not entirely correct, still resolves to [self blah], so left alone (@kimon had advice on this sort of naming issue last summer), and largely inconsequential Test Plan: * Compile and run
102 lines
5.3 KiB
Objective-C
102 lines
5.3 KiB
Objective-C
/* Copyright (c) 2014-present, Facebook, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This source code is licensed under the BSD-style license found in the
|
|
* LICENSE file in the root directory of this source tree. An additional grant
|
|
* of patent rights can be found in the PATENTS file in the same directory.
|
|
*/
|
|
|
|
#import <AsyncDisplayKit/ASDisplayNode.h>
|
|
|
|
/**
|
|
@abstract Kinds of events possible for control nodes.
|
|
@discussion These events are identical to their UIControl counterparts.
|
|
*/
|
|
enum _ASControlNodeEvent
|
|
{
|
|
ASControlNodeEventTouchDown = 1 << 0,
|
|
ASControlNodeEventTouchDownRepeat = 1 << 1,
|
|
ASControlNodeEventTouchDragInside = 1 << 2,
|
|
ASControlNodeEventTouchDragOutside = 1 << 3,
|
|
ASControlNodeEventTouchUpInside = 1 << 4,
|
|
ASControlNodeEventTouchUpOutside = 1 << 5,
|
|
ASControlNodeEventTouchCancel = 1 << 6,
|
|
|
|
ASControlNodeEventAllEvents = 0xFFFFFFFF
|
|
};
|
|
typedef NSUInteger ASControlNodeEvent;
|
|
|
|
/**
|
|
@abstract ASControlNode is the base class for control nodes (such as buttons), or nodes that track touches to invoke targets with action messages.
|
|
@discussion ASControlNode cannot be used directly. It instead defines the common interface and behavior structure for all its subclasses. Subclasses should import "ASControlNode+Subclasses.h" for information on methods intended to be overriden.
|
|
*/
|
|
@interface ASControlNode : ASDisplayNode
|
|
|
|
#pragma mark - Control State
|
|
|
|
/**
|
|
@abstract Indicates whether or not the receiver is enabled.
|
|
@discussion Specify YES to make the control enabled; otherwise, specify NO to make it disabled. The default value is YES. If the enabled state is NO, the control ignores touch events and subclasses may draw differently.
|
|
*/
|
|
@property (nonatomic, assign, getter=isEnabled) BOOL enabled;
|
|
|
|
/**
|
|
@abstract Indicates whether or not the receiver is highlighted.
|
|
@discussion This is set automatically when the there is a touch inside the control and removed on exit or touch up. This is different from touchInside in that it includes an area around the control, rather than just for touches inside the control.
|
|
*/
|
|
@property (nonatomic, readonly, assign, getter=isHighlighted) BOOL highlighted;
|
|
|
|
#pragma mark - Tracking Touches
|
|
/**
|
|
@abstract Indicates whether or not the receiver is currently tracking touches related to an event.
|
|
@discussion YES if the receiver is tracking touches; NO otherwise.
|
|
*/
|
|
@property (nonatomic, readonly, assign, getter=isTracking) BOOL tracking;
|
|
|
|
/**
|
|
@abstract Indicates whether or not a touch is inside the bounds of the receiver.
|
|
@discussion YES if a touch is inside the receiver's bounds; NO otherwise.
|
|
*/
|
|
@property (nonatomic, readonly, assign, getter=isTouchInside) BOOL touchInside;
|
|
|
|
#pragma mark - Action Messages
|
|
/**
|
|
@abstract Adds a target-action pair for a particular event (or events).
|
|
@param target The object to which the action message is sent. If this is nil, the responder chain is searched for an object willing to respond to the action message. target is not retained.
|
|
@param action A selector identifying an action message. May optionally include the sender and the event as parameters, in that order. May not be NULL.
|
|
@param controlEvents A bitmask specifying the control events for which the action message is sent. May not be 0. See "Control Events" for bitmask constants.
|
|
@discussion You may call this method multiple times, and you may specify multiple target-action pairs for a particular event.
|
|
*/
|
|
- (void)addTarget:(id)target action:(SEL)action forControlEvents:(ASControlNodeEvent)controlEvents;
|
|
|
|
/**
|
|
@abstract Returns the actions that are associated with a target and a particular control event.
|
|
@param target The target object. May not be nil.
|
|
@param controlEvent A single constant of type ASControlNodeEvent that specifies a particular user action on the control; for a list of these constants, see "Control Events". May not be 0 or ASControlNodeEventAllEvents.
|
|
@result An array of selector names as NSString objects, or nil if there are no action selectors associated with controlEvent.
|
|
*/
|
|
- (NSArray *)actionsForTarget:(id)target forControlEvent:(ASControlNodeEvent)controlEvent;
|
|
|
|
/**
|
|
@abstract Returns all target objects associated with the receiver.
|
|
@result A set of all targets for the receiver. The set may include NSNull to indicate at least one nil target (meaning, the responder chain is searched for a target.)
|
|
*/
|
|
- (NSSet *)allTargets;
|
|
|
|
/**
|
|
@abstract Removes a target-action pair for a particular event.
|
|
@param target The target object. Pass nil to remove all targets paired with action and the specified control events.
|
|
@param action A selector identifying an action message. Pass NULL to remove all action messages paired with target.
|
|
@param controlEvents A bitmask specifying the control events associated with target and action. See "Control Events" for bitmask constants. May not be 0.
|
|
*/
|
|
- (void)removeTarget:(id)target action:(SEL)action forControlEvents:(ASControlNodeEvent)controlEvents;
|
|
|
|
/**
|
|
@abstract Sends the actions for the control events for a particular event.
|
|
@param controlEvents A bitmask specifying the control events for which to send actions. See "Control Events" for bitmask constants. May not be 0.
|
|
@param event The event which triggered these control actions. May be nil.
|
|
*/
|
|
- (void)sendActionsForControlEvents:(ASControlNodeEvent)controlEvents withEvent:(UIEvent *)event;
|
|
|
|
@end
|