mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-06 12:43:58 +00:00
90 lines
2.8 KiB
Objective-C
90 lines
2.8 KiB
Objective-C
//
|
|
// ASVisibilityProtocols.h
|
|
// Pods
|
|
//
|
|
// Created by Garrett Moon on 4/27/16.
|
|
//
|
|
//
|
|
|
|
#import "ASLayoutRangeType.h"
|
|
|
|
@class UIViewController;
|
|
|
|
ASLayoutRangeMode ASLayoutRangeModeForVisibilityDepth(NSUInteger visibilityDepth);
|
|
|
|
@protocol ASVisibilityDepth <NSObject>
|
|
|
|
/**
|
|
* @abstract Represents the number of user actions necessary to reach the view controller. An increased visibility
|
|
* depth indicates a higher number of user interactions for the view controller to be visible again. For example,
|
|
* an onscreen navigation controller's top view controller should have a visibility depth of 0. The view controller
|
|
* one from the top should have a visibility deptch of 1 as should the root view controller in the stack (because
|
|
* the user can hold the back button to pop to the root view controller).
|
|
*
|
|
* Visibility depth is used to automatically adjust ranges on range controllers (and thus free up memory) and can
|
|
* be used to reduce memory usage of other items as well.
|
|
*/
|
|
- (NSInteger)visibilityDepth;
|
|
|
|
|
|
- (void)visibilityDepthDidChange;
|
|
|
|
@end
|
|
|
|
/**
|
|
* @abstract Container view controllers should adopt this protocol to indicate that they will manage their child's
|
|
* visibilityDepth. For example, ASNavigationController adopts this protocol and manages its childrens visibility
|
|
* depth.
|
|
*
|
|
* If you adopt this protocol, you *must* also emit visibilityDepthDidChange messages to child view controllers.
|
|
*
|
|
* @param childViewController Expected to return the visibility depth of the child view controller.
|
|
*/
|
|
@protocol ASManagesChildVisibilityDepth <ASVisibilityDepth>
|
|
|
|
- (NSInteger)visibilityDepthOfChildViewController:(UIViewController *)childViewController;
|
|
|
|
@end
|
|
|
|
#define ASVisibilityDepthImplementation \
|
|
- (NSInteger)visibilityDepth \
|
|
{ \
|
|
if (self.parentViewController && _parentManagesVisibilityDepth == NO) { \
|
|
_parentManagesVisibilityDepth = [self.parentViewController conformsToProtocol:@protocol(ASManagesChildVisibilityDepth)]; \
|
|
} \
|
|
\
|
|
if (_parentManagesVisibilityDepth) { \
|
|
return [(id <ASManagesChildVisibilityDepth>)self.parentViewController visibilityDepthOfChildViewController:self]; \
|
|
} \
|
|
return _visibilityDepth; \
|
|
}
|
|
|
|
#define ASVisibilityViewDidDisappearImplementation \
|
|
- (void)viewDidDisappear:(BOOL)animated \
|
|
{ \
|
|
[super viewDidDisappear:animated]; \
|
|
\
|
|
if (_parentManagesVisibilityDepth == NO) { \
|
|
_visibilityDepth = 1; \
|
|
[self visibilityDepthDidChange]; \
|
|
} \
|
|
}
|
|
|
|
#define ASVisibilityViewWillAppear \
|
|
- (void)viewWillAppear:(BOOL)animated \
|
|
{ \
|
|
[super viewWillAppear:animated]; \
|
|
\
|
|
if (_parentManagesVisibilityDepth == NO) { \
|
|
_visibilityDepth = 0; \
|
|
[self visibilityDepthDidChange]; \
|
|
} \
|
|
}
|
|
|
|
#define ASVisibilityDidMoveToParentViewController \
|
|
- (void)didMoveToParentViewController:(UIViewController *)parent \
|
|
{ \
|
|
[super didMoveToParentViewController:parent]; \
|
|
[self visibilityDepthDidChange]; \
|
|
}
|