/Users/rburkes/Projects/mobile/branches/release-1-2/devices/iphone/core/src/EMLib/EMSearchController.h

/*
Copyright 2001, 2012, Oracle and/or its affiliates. All rights reserved.
Oracle and Java are registered trademarks of Oracle and/or its 
affiliates. Other names may be trademarks of their respective owners.
UNIX is a registered trademark of The Open Group.

This software and related documentation are provided under a license 
agreement containing restrictions on use and disclosure and are 
protected by intellectual property laws. Except as expressly permitted 
in your license agreement or allowed by law, you may not use, copy, 
reproduce, translate, broadcast, modify, license, transmit, distribute, 
exhibit, perform, publish, or display any part, in any form, or by any 
means. Reverse engineering, disassembly, or decompilation of this 
software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice 
and is not warranted to be error-free. If you find any errors, please 
report them to us in writing.
U.S. GOVERNMENT END USERS: Oracle programs, including any operating 
system, integrated software, any programs installed on the hardware, 
and/or documentation, delivered to U.S. Government end users are 
"commercial computer software" pursuant to the applicable Federal 
Acquisition Regulation and agency-specific supplemental regulations. 
As such, use, duplication, disclosure, modification, and adaptation 
of the programs, including any operating system, integrated software, 
any programs installed on the hardware, and/or documentation, shall be 
subject to license terms and license restrictions applicable to the 
programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety 
of information management applications. It is not developed or 
intended for use in any inherently dangerous applications, including 
applications that may create a risk of personal injury. If you use 
this software or hardware in dangerous applications, then you shall 
be responsible to take all appropriate fail-safe, backup, redundancy, 
and other measures to ensure its safe use. Oracle Corporation and its 
affiliates disclaim any liability for any damages caused by use of this 
software or hardware in dangerous applications.
This software or hardware and documentation may provide access to or 
information on content, products, and services from third parties. 
Oracle Corporation and its affiliates are not responsible for and 
expressly disclaim all warranties of any kind with respect to 
third-party content, products, and services. Oracle Corporation and 
its affiliates will not be responsible for any loss, costs, or damages 
incurred due to your access to or use of third-party content, products, 
or services.
*/


#import <UIKit/UIKit.h>
#import <Three20/Three20.h>

@class EMSearchController;

@protocol EMSearchQueryControllerDelegate <NSObject>

- (UIView *)resultsViewForController:(EMSearchController *)controller;

- (UIView *)noResultsViewForController:(EMSearchController *)controller;

- (UIView *)errorViewForController:(EMSearchController *)controller withError:(NSError *)error;

- (UIView *)loadingViewForController:(EMSearchController *)controller;

@end

#pragma mark -

@class EMSearchBar, EMTypeaheadDataSource, EMSearchQueryDataSource, EMSearchQuery;

@interface EMSearchController : UIViewController <UITextFieldDelegate, UIScrollViewDelegate, EMSearchQueryControllerDelegate> {
        
        EMSearchBar *_searchBar;

        TTView *_sortBar;
        UISegmentedControl *_sortControl;
        UIBarButtonItem *_fButton;
        
        
        UIView *_noResultsView, *_errorView, *_loadingView;
        
        UILabel *_errorLabel;
        
        BOOL _showFacetsForEmptyQuery;
        BOOL _showResultsForEmptyQuery;
        
        BOOL _searchBarVisible;
        NSString *_searchKey; // Only relevant if searchBarVisible = YES
        BOOL _searchBarCancelButtonVisible; // Only relevant if searchBarVisible = YES
        BOOL _searchBarFirstResponderEnabled; // Only relevant if searchBarVisible = YES
        
        
        BOOL _sortBarVisible;
        NSArray *_sortOptions; // Only relevant if sortBarVisible = YES
        BOOL _sortBarScrollable; // Only relvant if sortBarVisible = YES
        BOOL _sortBarStartsAboveFold; // Only relevant if sortBarScrollable = YES
        
        BOOL _pushDetailControllerForSingleResult;
        
        NSError *_error;
        
        NSString *_previousSearchBarText;
        
        BOOL _cancellingKeyboard;
        
        BOOL _reload;
        BOOL _showingFilterView;
        BOOL _showingKeyboard;
        
        BOOL _viewDidAppear;
        BOOL _viewDidLoad;
        
        UIView *_currentView;
        
        EMTypeaheadDataSource *_keywordsSource;
        EMSearchQueryDataSource *_dataSource;
        id<EMSearchQueryControllerDelegate> _delegate;

}

- (id) initWithSearchQueryDataSource:(EMSearchQueryDataSource *)searchQueryDataSource;

#pragma mark -
#pragma mark Data Sources / Delegates

@property (nonatomic, retain) EMSearchQuery *query;


@property (nonatomic, retain) EMSearchQueryDataSource *dataSource;

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

#pragma mark -
#pragma mark User Interface Elements


@property (nonatomic, readonly) EMSearchBar *searchBar;

#pragma mark -
#pragma mark Configuration Options

@property (nonatomic, retain) NSString *searchKey;

@property (nonatomic, assign) BOOL searchBarCancelButtonVisible;

@property (nonatomic, assign) BOOL searchBarVisible;

@property (nonatomic, retain) NSArray *sortOptions;

#pragma mark -
#pragma mark For subclass customization

- (void) adjustNavigationItem;

- (void) adjustSortBar;

#pragma mark -
#pragma mark For scroll views to update the sort bar position

- (void) positionSortBar;


@end