/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef nsTouchBar_h_ #define nsTouchBar_h_ #import #include "mozilla/RefPtr.h" #include "nsITouchBarHelper.h" #include "nsITouchBarInput.h" #if !defined(MAC_OS_X_VERSION_10_12) || MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_12 @interface NSButton (NewConstructors) @property(nonatomic) BOOL imageHugsTitle; + (NSButton*)buttonWithTitle:(NSString*)title target:(id)target action:(SEL)action; @end @interface NSColor (DisplayP3Colors) + (NSColor*)colorWithDisplayP3Red:(CGFloat)red green:(CGFloat)green blue:(CGFloat)blue alpha:(CGFloat)alpha; @end #endif #if !defined(MAC_OS_X_VERSION_10_12_2) || MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_12_2 typedef NSString* NSTouchBarItemIdentifier; __attribute__((weak_import)) @interface NSTouchBarItem : NSObject - (instancetype)initWithIdentifier:(NSTouchBarItemIdentifier)aIdentifier; @end __attribute__((weak_import)) @interface NSCustomTouchBarItem : NSTouchBarItem @property(strong) NSView* view; @property(strong) NSString* customizationLabel; @end @protocol NSTouchBarDelegate @end __attribute__((weak_import)) @interface NSTouchBar : NSObject @property(strong) NSArray* defaultItemIdentifiers; @property(strong) id delegate; - (NSTouchBarItem*)itemForIdentifier:(NSTouchBarItemIdentifier)aIdentifier; @end @protocol NSSharingServicePickerTouchBarItemDelegate @end __attribute__((weak_import)) @interface NSSharingServicePickerTouchBarItem : NSTouchBarItem @property(strong) id delegate; @property(strong) NSImage* buttonImage; @end @interface NSButton (TouchBarButton) @property(strong) NSColor* bezelColor; @end #endif /** * NSObject representation of nsITouchBarInput. */ @interface TouchBarInput : NSObject { NSString* mKey; NSString* mTitle; NSImage* mImage; NSString* mType; NSColor* mColor; BOOL mDisabled; NSTouchBarItemIdentifier mNativeIdentifier; nsCOMPtr mCallback; } - (NSString*)key; - (NSString*)title; - (NSImage*)image; - (NSString*)type; - (NSColor*)color; - (BOOL)isDisabled; - (NSTouchBarItemIdentifier)nativeIdentifier; - (nsCOMPtr)callback; - (void)setKey:(NSString*)aKey; - (void)setTitle:(NSString*)aTitle; - (void)setImage:(NSImage*)aImage; - (void)setType:(NSString*)aType; - (void)setColor:(NSColor*)aColor; - (void)setDisabled:(BOOL)aDisabled; - (void)setNativeIdentifier:(NSString*)aNativeIdentifier; - (void)setCallback:(nsCOMPtr)aCallback; - (id)initWithKey:(NSString*)aKey title:(NSString*)aTitle image:(NSString*)aImage type:(NSString*)aType callback:(nsCOMPtr)aCallback color:(uint32_t)aColor disabled:(BOOL)aDisabled; - (TouchBarInput*)initWithXPCOM:(nsCOMPtr)aInput; - (void)dealloc; @end /** * Our TouchBar is its own delegate. This is adequate for our purposes, * since the current implementation only defines Touch Bar buttons for the * main Firefox window. If modals and other windows were to have custom * Touch Bar views, each window would have to be a NSTouchBarDelegate so * they could define their own custom sets of buttons. */ @interface nsTouchBar : NSTouchBar { /** * Link to the frontend API that determines which buttons appear * in the Touch Bar */ nsCOMPtr mTouchBarHelper; } /** * Contains TouchBarInput representations of the inputs currently in * the Touch Bar. Populated in `init` and updated by nsITouchBarUpdater. */ @property(strong) NSMutableDictionary* mappedLayoutItems; /** * Returns an instance of nsTouchBar based on implementation details * fetched from the frontend through nsTouchBarHelper. */ - (instancetype)init; - (void)dealloc; /** * Creates a new NSTouchBarItem and adds it to the Touch Bar. * Reads the passed identifier and creates the * appropriate item type (eg. NSCustomTouchBarItem). * Required as a member of NSTouchBarDelegate. */ - (NSTouchBarItem*)touchBar:(NSTouchBar*)aTouchBar makeItemForIdentifier:(NSTouchBarItemIdentifier)aIdentifier; /** * Updates an input on the Touch Bar by redirecting to one of the specific * TouchBarItem types updaters. */ - (void)updateItem:(TouchBarInput*)aInput; /** * Update or create various subclasses of TouchBarItem. */ - (NSTouchBarItem*)updateButton:(NSCustomTouchBarItem*)aButton input:(TouchBarInput*)aInput; - (NSTouchBarItem*)updateMainButton:(NSCustomTouchBarItem*)aMainButton input:(TouchBarInput*)aInput; - (NSTouchBarItem*)makeShareScrubberForIdentifier:(NSTouchBarItemIdentifier)aIdentifier; /** * Redirects button actions to the appropriate handler and handles telemetry. */ - (void)touchBarAction:(id)aSender; - (NSArray*)itemsForSharingServicePickerTouchBarItem: (NSSharingServicePickerTouchBarItem*)aPickerTouchBarItem; - (NSArray*)sharingServicePicker:(NSSharingServicePicker*)aSharingServicePicker sharingServicesForItems:(NSArray*)aItems proposedSharingServices:(NSArray*)aProposedServices; /** * Retrieves TouchBarInput icons. */ + (NSImage*)getTouchBarIconNamed:(NSString*)aImageName; @end // nsTouchBar #endif // nsTouchBar_h_