(root)/iphone/tappity : 46 : tappity/source/BonjourSupport/BonjourBrowser.h

/*

 

    File: BonjourBrowser.h 

Abstract:  A subclass of UINavigationController that handles the UI needed for a user to

browse for Bonjour services.

 It contains list view controllers for domains and service instances.

 It allows the user to add their own domains.

 

 Version: 2.8 

 

*/

 

#import <UIKit/UIKit.h>

#import "BrowserViewController.h"

#import "DomainViewController.h"

 

@class BonjourBrowser;

 

@protocol BonjourBrowserDelegate <UINavigationControllerDelegate>

@required

// This method will be invoked when the user selects one of the service instances from the list.

// The ref parameter will be the selected (already resolved) instance or nil if the user taps the 'Cancel' button (if shown).

- (void) bonjourBrowser:(BonjourBrowser*)browser didResolveInstance:(NSNetService*)ref;

@end

 

@interface BonjourBrowser : UINavigationController <BrowserViewControllerDelegate, DomainViewControllerDelegate> {

        id<BonjourBrowserDelegate> __delegate; // because UINavigationContoller also has a _delegate

        DomainViewController* _dvc;

        BrowserViewController* _bvc;

        NSString* _type;

        NSString* _domain;

        BOOL _showDisclosureIndicators;

        NSString* _searchingForServicesString;

        BOOL _showCancelButton;

        BOOL _showTitleInNavigationBar;

}

 

@property(nonatomic, assign) id<BonjourBrowserDelegate> delegate;

@property(nonatomic, copy, readwrite) NSString* searchingForServicesString; // The string to show when there are no services currently found (but updates are still ongoing)

@property(nonatomic, assign, readwrite) BOOL showTitleInNavigationBar; // If YES, the title of this object will be shown in the navigation bar

 

 

- (id) initForType:(NSString*)type                                // The Bonjour service type to browse for, e.g. @"_http._tcp"

           inDomain:(NSString*)domain                                 // The initial domain to browse in (pass nil to start in domains list)

           customDomains:(NSMutableArray*)customDomains            // An array of domains specified by the user

           showDisclosureIndicators:(BOOL)showDisclosureIndicators // Whether to show discolsure indicators on service instance table cells

                                                                                                                                  // e.g. if you want to push a view controller onto this navigation controller

           showCancelButton:(BOOL)showCancelButton;                // Whether to show a cancel button as the right navigation item

                                                                                                                                  // Pass YES if you are modally showing this BonjourBrowser

@end