components/AppBar/src/MDCAppBarNavigationController.h - external/github.com/material-components/material-components-ios - Git at Google


            
            // Copyright 2018-present the Material Components for iOS authors. All Rights Reserved.

            
            //

            
            // Licensed under the Apache License, Version 2.0 (the "License");

            
            // you may not use this file except in compliance with the License.

            
            // You may obtain a copy of the License at

            
            //

            
            // http://www.apache.org/licenses/LICENSE-2.0

            
            //

            
            // Unless required by applicable law or agreed to in writing, software

            
            // distributed under the License is distributed on an "AS IS" BASIS,

            
            // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

            
            // See the License for the specific language governing permissions and

            
            // limitations under the License.


            #import <UIKit/UIKit.h>


            // TODO(b/151929968): Delete import of MDCAppBarNavigationControllerToBeDeprecatedDelegate.h when

            
            // client code has been migrated to no longer import

            
            // MDCAppBarNavigationControllerToBeDeprecatedDelegate as a transitive dependency.

            
            #import "MDCAppBarNavigationControllerToBeDeprecatedDelegate.h"


            @class MDCAppBar;

            
            @class MDCAppBarViewController;

            
            @class MDCAppBarNavigationController;

            
            @class MDCFlexibleHeaderViewController;

            
            @protocol MDCAppBarNavigationControllerToBeDeprecatedDelegate;


            /**

            
             Defines the events that an MDCAppBarNavigationController may send to a delegate.

            
             */

            
            @protocol

            
                MDCAppBarNavigationControllerDelegate <UINavigationControllerDelegate,

            
                                                       MDCAppBarNavigationControllerToBeDeprecatedDelegate>

            
            @optional


            /**

            
             Informs the receiver that the given App Bar will be added as a child of the given view controller.


             This event is primarily intended to allow any configuration or theming of the App Bar to occur

            
             before it becomes part of the view controller hierarchy.


             By the time this event has fired, the navigation controller will already have attempted to infer

            
             the tracking scroll view from the provided view controller.


             @note This method will only be invoked if a new App Bar instance is about to be added to the view

            
             controller. If a flexible header is already present in the view controller, this method will not

            
             be invoked.

            
             */

            
            - (void)appBarNavigationController:(nonnull MDCAppBarNavigationController *)navigationController

            
                   willAddAppBarViewController:(nonnull MDCAppBarViewController *)appBarViewController

            
                       asChildOfViewController:(nonnull UIViewController *)viewController;


            /**

            
             Asks the receiver to determine the tracking scroll view for a given view controller.


             If this method is not implemented, the app bar navigation controller will extract the first

            
             UIScrollView instance in the view controller's view hierarchy using a depth-first view traversal.


             Implement this method when you need to change the default behavior of the tracking scroll view

            
             detection. The suggested tracking scroll view will contain the scroll view that would have been

            
             used; you can ignore this value.


             Your implementation will likely return the suggested tracking scroll view by default, with custom

            
             logic being implemented for specific view controllers that require it.


             @param navigationController The app bar navigation controller instance that owns the view

            
             controller.

            
             @param viewController The view controller for which the tracking scroll view should be determined.

            
             @param scrollView A suggested tracking scroll view. This is the first UIScrollView instance

            
             detected by a depth-first view traversal of @c viewController's view hierarchy. This suggestion

            
             can be ignored.

            
             @return The tracking scroll view to be used for this view controller. If nil is returned then no

            
             tracking scroll view will be set.


             @note This method will only be invoked if a new App Bar instance is about to be added to the view

            
             controller. If a flexible header is already present in the view controller, this method will not

            
             be invoked.

            
             */

            
            - (nullable UIScrollView *)appBarNavigationController:

            
                                           (nonnull MDCAppBarNavigationController *)navigationController

            
                              trackingScrollViewForViewController:(nonnull UIViewController *)viewController

            
                                      suggestedTrackingScrollView:(nullable UIScrollView *)scrollView;


            @end


            /**

            
             A custom navigation controller instance that auto-injects App Bar instances into pushed view

            
             controllers.


             If a pushed view controller already has an App Bar or a Flexible Header then the navigation

            
             controller will not inject a new App Bar.


             To theme the injected App Bar, implement the delegate's

            
             -appBarNavigationController:willAddAppBar:asChildOfViewController: API.


             @note If you use the initWithRootViewController: API you will not have been able to provide a

            
             delegate yet. In this case, use the -appBarForViewController: API to retrieve the injected App Bar

            
             for your root view controller and execute your delegate logic on the returned result, if any.

            
             */

            
            __attribute__((objc_subclassing_restricted)) @interface MDCAppBarNavigationController

            
                : UINavigationController


            #pragma mark - Changing app bar visibility


            /**

            
             This property's getter and setter behavior are defined by the value of

            
             @c shouldSetNavigationBarHiddenHideAppBar.


             ## Getter behavior


             When @c shouldSetNavigationBarHiddenHideAppBar is enabled, this property will return the visibility

            
             of the current view controller's injected app bar, if one exists. Otherwise it will always return

            
             YES.


             When @c shouldSetNavigationBarHiddenHideAppBar is disabled, this property will return the

            
             visibility of the UINavigationBar.


             ## Setter behavior


             When @c shouldSetNavigationBarHiddenHideAppBar is enabled, invocations of this method will change

            
             the visibility of the currently visible view controller's App Bar. This only affects visibility of

            
             injected App Bar view controllers.


             When @c shouldSetNavigationBarHiddenHideAppBar is disabled, invocations of this method

            
             will always result in the UIKit navigation bar being hidden, regardless of the provided value of @c

            
             hidden, and the currently visible view controller's App Bar visibility will not be affected.

            
             Attempting to set this property to @c YES will result in a runtime assertion.

            
             */

            
            @property(nonatomic, getter=isNavigationBarHidden) BOOL navigationBarHidden;


            #pragma mark - Reacting to state changes


            /**

            
             An extension of the UINavigationController's delegate.

            
             */

            
            @property(nonatomic, weak, nullable) id<MDCAppBarNavigationControllerDelegate> delegate;


            #pragma mark - Behavioral flags


            /**

            
             Controls whether the @c setNavigationBarHidden: and @c setNavigationBarHidden:animated: methods

            
             will toggle visiblity of the currently visible injected App Bar.


             When enabled, invocations to @c setNavigationBarHidden: and @c setNavigationBarHidden:animated:

            
             will change the visibility of the currently visible view controller's App Bar. This only affects

            
             visibility of injected App Bar view controllers.


             When disabled, invocations to @c setNavigationBarHidden: and @c setNavigationBarHidden:animated:

            
             will always result in the UIKit navigation bar being hidden, regardless of the provided value of @c

            
             hidden, and the currently visible view controller's App Bar visibility will not be affected.


             The result of changing this property after app bars have already been presented and/or hidden is

            
             undefined.


             Default value is NO.

            
             */

            
            @property(nonatomic, assign) BOOL shouldSetNavigationBarHiddenHideAppBar;


            #pragma mark - Getting App Bar view controller instances


            /**

            
             Returns the injected App Bar view controller for a given view controller, if an App Bar was

            
             injected.

            
             */

            
            - (nullable MDCAppBarViewController *)appBarViewControllerForViewController:

            
                (nonnull UIViewController *)viewController;


            /**

            
             A block that is assigned to each injected @c MDCAppBarViewController's

            
             @c traitCollectionDidChangeBlock property. The block will be executed when the injected

            
             @c MDCAppBarViewController's @c -traitCollectionDidChange: is called.

            
             */

            
            @property(nonatomic, copy, nullable) void (^traitCollectionDidChangeBlockForAppBarController)

            
                (MDCFlexibleHeaderViewController *_Nonnull flexibleHeaderViewController,

            
                 UITraitCollection *_Nullable previousTraitCollection);


            @end


            @interface MDCAppBarNavigationController (Deprecated)


            /**

            
             Returns the injected App Bar for a given view controller, if an App Bar was injected.


             @warning This method will eventually be deprecated. Use -appBarViewControllerForViewController:

            
             instead. Learn more at

            
             https://github.com/material-components/material-components-ios/blob/develop/components/AppBar/docs/migration-guide-appbar-appbarviewcontroller.md

            
             */

            
            - (nullable MDCAppBar *)appBarForViewController:(nonnull UIViewController *)viewController

            
                __deprecated_msg("Use -appBarViewControllerForViewController: instead.");


            @end
	// Copyright 2018-present the Material Components for iOS authors. All Rights Reserved.
	//
	// Licensed under the Apache License, Version 2.0 (the "License");
	// you may not use this file except in compliance with the License.
	// You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing, software
	// distributed under the License is distributed on an "AS IS" BASIS,
	// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	// See the License for the specific language governing permissions and
	// limitations under the License.

	#import <UIKit/UIKit.h>

	// TODO(b/151929968): Delete import of MDCAppBarNavigationControllerToBeDeprecatedDelegate.h when
	// client code has been migrated to no longer import
	// MDCAppBarNavigationControllerToBeDeprecatedDelegate as a transitive dependency.
	#import "MDCAppBarNavigationControllerToBeDeprecatedDelegate.h"

	@class MDCAppBar;
	@class MDCAppBarViewController;
	@class MDCAppBarNavigationController;
	@class MDCFlexibleHeaderViewController;
	@protocol MDCAppBarNavigationControllerToBeDeprecatedDelegate;

	/**
	Defines the events that an MDCAppBarNavigationController may send to a delegate.
	*/
	@protocol
	MDCAppBarNavigationControllerDelegate <UINavigationControllerDelegate,
	MDCAppBarNavigationControllerToBeDeprecatedDelegate>
	@optional

	/**
	Informs the receiver that the given App Bar will be added as a child of the given view controller.

	This event is primarily intended to allow any configuration or theming of the App Bar to occur
	before it becomes part of the view controller hierarchy.

	By the time this event has fired, the navigation controller will already have attempted to infer
	the tracking scroll view from the provided view controller.

	@note This method will only be invoked if a new App Bar instance is about to be added to the view
	controller. If a flexible header is already present in the view controller, this method will not
	be invoked.
	*/
	- (void)appBarNavigationController:(nonnull MDCAppBarNavigationController *)navigationController
	willAddAppBarViewController:(nonnull MDCAppBarViewController *)appBarViewController
	asChildOfViewController:(nonnull UIViewController *)viewController;

	/**
	Asks the receiver to determine the tracking scroll view for a given view controller.

	If this method is not implemented, the app bar navigation controller will extract the first
	UIScrollView instance in the view controller's view hierarchy using a depth-first view traversal.

	Implement this method when you need to change the default behavior of the tracking scroll view
	detection. The suggested tracking scroll view will contain the scroll view that would have been
	used; you can ignore this value.

	Your implementation will likely return the suggested tracking scroll view by default, with custom
	logic being implemented for specific view controllers that require it.

	@param navigationController The app bar navigation controller instance that owns the view
	controller.
	@param viewController The view controller for which the tracking scroll view should be determined.
	@param scrollView A suggested tracking scroll view. This is the first UIScrollView instance
	detected by a depth-first view traversal of @c viewController's view hierarchy. This suggestion
	can be ignored.
	@return The tracking scroll view to be used for this view controller. If nil is returned then no
	tracking scroll view will be set.

	@note This method will only be invoked if a new App Bar instance is about to be added to the view
	controller. If a flexible header is already present in the view controller, this method will not
	be invoked.
	*/
	- (nullable UIScrollView *)appBarNavigationController:
	(nonnull MDCAppBarNavigationController *)navigationController
	trackingScrollViewForViewController:(nonnull UIViewController *)viewController
	suggestedTrackingScrollView:(nullable UIScrollView *)scrollView;

	@end

	/**
	A custom navigation controller instance that auto-injects App Bar instances into pushed view
	controllers.

	If a pushed view controller already has an App Bar or a Flexible Header then the navigation
	controller will not inject a new App Bar.

	To theme the injected App Bar, implement the delegate's
	-appBarNavigationController:willAddAppBar:asChildOfViewController: API.

	@note If you use the initWithRootViewController: API you will not have been able to provide a
	delegate yet. In this case, use the -appBarForViewController: API to retrieve the injected App Bar
	for your root view controller and execute your delegate logic on the returned result, if any.
	*/
	__attribute__((objc_subclassing_restricted)) @interface MDCAppBarNavigationController
	: UINavigationController

	#pragma mark - Changing app bar visibility

	/**
	This property's getter and setter behavior are defined by the value of
	@c shouldSetNavigationBarHiddenHideAppBar.

	## Getter behavior

	When @c shouldSetNavigationBarHiddenHideAppBar is enabled, this property will return the visibility
	of the current view controller's injected app bar, if one exists. Otherwise it will always return
	YES.

	When @c shouldSetNavigationBarHiddenHideAppBar is disabled, this property will return the
	visibility of the UINavigationBar.

	## Setter behavior

	When @c shouldSetNavigationBarHiddenHideAppBar is enabled, invocations of this method will change
	the visibility of the currently visible view controller's App Bar. This only affects visibility of
	injected App Bar view controllers.

	When @c shouldSetNavigationBarHiddenHideAppBar is disabled, invocations of this method
	will always result in the UIKit navigation bar being hidden, regardless of the provided value of @c
	hidden, and the currently visible view controller's App Bar visibility will not be affected.
	Attempting to set this property to @c YES will result in a runtime assertion.
	*/
	@property(nonatomic, getter=isNavigationBarHidden) BOOL navigationBarHidden;

	#pragma mark - Reacting to state changes

	/**
	An extension of the UINavigationController's delegate.
	*/
	@property(nonatomic, weak, nullable) id<MDCAppBarNavigationControllerDelegate> delegate;

	#pragma mark - Behavioral flags

	/**
	Controls whether the @c setNavigationBarHidden: and @c setNavigationBarHidden:animated: methods
	will toggle visiblity of the currently visible injected App Bar.

	When enabled, invocations to @c setNavigationBarHidden: and @c setNavigationBarHidden:animated:
	will change the visibility of the currently visible view controller's App Bar. This only affects
	visibility of injected App Bar view controllers.

	When disabled, invocations to @c setNavigationBarHidden: and @c setNavigationBarHidden:animated:
	will always result in the UIKit navigation bar being hidden, regardless of the provided value of @c
	hidden, and the currently visible view controller's App Bar visibility will not be affected.

	The result of changing this property after app bars have already been presented and/or hidden is
	undefined.

	Default value is NO.
	*/
	@property(nonatomic, assign) BOOL shouldSetNavigationBarHiddenHideAppBar;

	#pragma mark - Getting App Bar view controller instances

	/**
	Returns the injected App Bar view controller for a given view controller, if an App Bar was
	injected.
	*/
	- (nullable MDCAppBarViewController *)appBarViewControllerForViewController:
	(nonnull UIViewController *)viewController;

	/**
	A block that is assigned to each injected @c MDCAppBarViewController's
	@c traitCollectionDidChangeBlock property. The block will be executed when the injected
	@c MDCAppBarViewController's @c -traitCollectionDidChange: is called.
	*/
	@property(nonatomic, copy, nullable) void (^traitCollectionDidChangeBlockForAppBarController)
	(MDCFlexibleHeaderViewController *_Nonnull flexibleHeaderViewController,
	UITraitCollection *_Nullable previousTraitCollection);

	@end

	@interface MDCAppBarNavigationController (Deprecated)

	/**
	Returns the injected App Bar for a given view controller, if an App Bar was injected.

	@warning This method will eventually be deprecated. Use -appBarViewControllerForViewController:
	instead. Learn more at
	https://github.com/material-components/material-components-ios/blob/develop/components/AppBar/docs/migration-guide-appbar-appbarviewcontroller.md
	*/
	- (nullable MDCAppBar )appBarForViewController:(nonnull UIViewController )viewController
	__deprecated_msg("Use -appBarViewControllerForViewController: instead.");

	@end