iOS中UISearchBar(搜索框)使用總結

初始化:UISearchBar繼承于UIView,我們可以像創建View那樣創建

searchBarUISearchBar* bar = [[UISearchBaralloc]initWithFrame:CGRectMake(20,100,250,40)]; [self.view addSubview:bar];

@property(nonatomic)? ? ? ? UIBarStyle? ? ? ? ? ? ? barStyle;

這個屬性可以設置searchBar的搜索框的風格,枚舉如下:

typedefNS_ENUM(NSInteger,UIBarStyle) {UIBarStyleDefault=0,//默認風格 白色搜索框,多出的背景為灰色UIBarStyleBlack=1,//黑色風格,黑色的搜索框//下面兩個枚舉已經被禁用,作用和黑色風格一樣UIBarStyleBlackOpaque=1,// Deprecated. Use UIBarStyleBlackUIBarStyleBlackTranslucent=2,// Deprecated. Use UIBarStyleBlack and set the translucent property to YES};

@property(nonatomic,copy)?? NSString?????????????? *text;

設置搜索框中的文字

@property(nonatomic,copy)?? NSString?????????????? *prompt;

這個屬性的官方解釋是在搜索框頂部顯示一行文字,其實就是背景文字,上圖說明:

bar.prompt = @"搜索框";? bar.text=@"321111111111111111111111111"

效果如下:

@property(nonatomic,copy)? NSString? ? ? ? ? ? ? *placeholder;

和其他文本輸入控件的placeholder相同,在輸入文字時就會消失

@property(nonatomic)??????? BOOL??????????????????? showsBookmarkButton;

是否在搜索框右側顯示一個圖書的按鈕,默認為NO,YES的效果如下:


@property(nonatomic)? ? ? ? BOOL? ? ? ? ? ? ? ? ? ? showsCancelButton;

是否顯示取消按鈕,默認為NO,YES的效果如下:

@property(nonatomic)? ? ? ? BOOL? ? ? ? ? ? ? ? ? ? showsSearchResultsButton;

是否顯示搜索結果按鈕,默認為NO,YES效果如下:

@property(nonatomic, getter=isSearchResultsButtonSelected) BOOL searchResultsButtonSelected ;

設置搜索結果按鈕的選中狀態

- (void)setShowsCancelButton:(BOOL)showsCancelButton animated:(BOOL)animated;

設置顯示取消按鈕

@property(nonatomic,retain) UIColor *tintColor;

設置這個顏色值會影響搜索框中的光標的顏色

@property(nonatomic,retain) UIColor *barTintColor;

設置這個顏色會影響搜索框的背景顏色

@property (nonatomic) UISearchBarStyle searchBarStyle;

設置搜索框整體的風格,枚舉如下:

typedefNS_ENUM(NSUInteger,UISearchBarStyle) {UISearchBarStyleDefault,// currently UISearchBarStyleProminentUISearchBarStyleProminent,// 顯示背景UISearchBarStyleMinimal// 不顯示背景}NS_ENUM_AVAILABLE_IOS(7_0);

@property(nonatomic,assign,getter=isTranslucent) BOOL translucent;

設置是否半透明

@property(nonatomic)????? BOOL?????? showsScopeBar ;

是否顯示搜索欄的附件選擇按鈕試圖,要想顯示這個試圖,首先要將這個屬性設置為YES,之后給按鈕數組中添加按鈕,使用下面這個屬性:

@property(nonatomic,copy) NSArray?? *scopeButtonTitles ;

設置選擇按鈕試圖的按鈕標題

@property(nonatomic)????? NSInteger? selectedScopeButtonIndex;

設置一個默認的選中按鈕

bar = [[UISearchBaralloc]initWithFrame:CGRectMake(20,100,250,200)];? ? bar.showsScopeBar=YES;? ? bar.scopeButtonTitles = @[@"12",@"2",@"3",@"4"];

@property (nonatomic, readwrite, retain) UIView *inputAccessoryView;

鍵盤的附屬試圖

@property(nonatomic,retain) UIImage *backgroundImage;

設置搜索框的背景圖案

@property(nonatomic,retain) UIImage *scopeBarBackgroundImage;

設置附屬選擇按鈕視圖的背景圖案

- (void)setBackgroundImage:(UIImage *)backgroundImage forBarPosition:(UIBarPosition)barPosition barMetrics:(UIBarMetrics)barMetrics ;

- (UIImage *)backgroundImageForBarPosition:(UIBarPosition)barPosition barMetrics:(UIBarMetrics)barMetrics

這一對方法可以設置和獲取某個狀態枚舉下的搜索框的背景圖案

- (void)setSearchFieldBackgroundImage:(UIImage *)backgroundImage forState:(UIControlState)state;

- (UIImage *)searchFieldBackgroundImageForState:(UIControlState)state;

這一對方法用于設置和獲取搜索框中TextField的背景圖案

- (void)setImage:(UIImage *)iconImage forSearchBarIcon:(UISearchBarIcon)icon state:(UIControlState)state ;

- (UIImage *)imageForSearchBarIcon:(UISearchBarIcon)icon state:(UIControlState)state ;

這一對方法用于獲取和設置搜索欄icon圖片的圖案

- (void)setScopeBarButtonBackgroundImage:(UIImage *)backgroundImage forState:(UIControlState)state;

- (UIImage *)scopeBarButtonBackgroundImageForState:(UIControlState)state;

這一對方法用于設置和獲取搜索框的附加選擇按鈕視圖的背景圖案

- (void)setScopeBarButtonDividerImage:(UIImage *)dividerImage forLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState;

- (UIImage *)scopeBarButtonDividerImageForLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState;

這一對方法用于獲取和設置附加選擇按鈕視圖中切換按鈕的圖案

- (void)setScopeBarButtonTitleTextAttributes:(NSDictionary *)attributes forState:(UIControlState)state;

- (NSDictionary *)scopeBarButtonTitleTextAttributesForState:(UIControlState)state;

這一對方法用于設置和獲取切換按鈕標題文字的字體屬性字典

@property(nonatomic) UIOffset searchFieldBackgroundPositionAdjustment;

搜索文字在搜索框中的位置偏移

@property(nonatomic) UIOffset searchTextPositionAdjustment;

textfield在搜索框中的位置偏移

- (void)setPositionAdjustment:(UIOffset)adjustment forSearchBarIcon:(UISearchBarIcon)icon;

- (UIOffset)positionAdjustmentForSearchBarIcon:(UISearchBarIcon)icon;

設置搜索欄中圖片的位置偏移,圖片的枚舉如下:

typedefNS_ENUM(NSInteger,UISearchBarIcon) {UISearchBarIconSearch,//搜索圖標UISearchBarIconClear,// 清除圖標UISearchBarIconBookmark,// 書本圖標UISearchBarIconResultsList,// 結果列表圖標};

下面是搜索框控件的一些代理方法:

- (BOOL)searchBarShouldBeginEditing:(UISearchBar *)searchBar;

將要開始編輯時的回調,返回為NO,則不能編輯

- (void)searchBarTextDidBeginEditing:(UISearchBar *)searchBar;

已經開始編輯時的回調

- (BOOL)searchBarShouldEndEditing:(UISearchBar *)searchBar;

將要結束編輯時的回調

- (void)searchBarTextDidEndEditing:(UISearchBar *)searchBar;

已經結束編輯的回調

- (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText;?? 編輯文字改變的回調

- (BOOL)searchBar:(UISearchBar *)searchBar shouldChangeTextInRange:(NSRange)range replacementText:(NSString *)text ;

編輯文字改變前的回調,返回NO則不能加入新的編輯文字

- (void)searchBarSearchButtonClicked:(UISearchBar *)searchBar;

搜索按鈕點擊的回調

- (void)searchBarBookmarkButtonClicked:(UISearchBar *)searchBar;

書本按鈕點擊的回調

- (void)searchBarCancelButtonClicked:(UISearchBar *)searchBar;

取消按鈕點擊的回調

- (void)searchBarResultsListButtonClicked:(UISearchBar *)searchBar;

搜索結果按鈕點擊的回調

- (void)searchBar:(UISearchBar *)searchBar selectedScopeButtonIndexDidChange:(NSInteger)selectedScope;

搜索欄的附加試圖中切換按鈕觸發的回調

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,460評論 6 538
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,067評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,467評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,468評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,184評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,582評論 1 325
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,616評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,794評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,343評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,096評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,291評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,863評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,513評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,941評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,190評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,026評論 3 396
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,253評論 2 375

推薦閱讀更多精彩內容