Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы UIKit ссылка на протокол UISearchBarDelegate

Опции
Развертывание Target:

На этой странице
Язык:

UISearchBarDelegate

Наследование


Не применимый

Оператор импорта


Swift

import UIKit

Objective C

@import UIKit;

Доступность


Доступный в iOS 2.0 и позже.

UISearchBarDelegate протокол определяет дополнительные методы, которые Вы реализуете для создания a UISearchBar функциональное управление. A UISearchBar объект обеспечивает пользовательский интерфейс для поля поиска на панели, но это - ответственность приложения реализовать действия, когда касаются кнопки. Как минимум, когда текст введен в текстовом поле, делегат должен выполнить фактический поиск.

  • Говорит делегату, что пользователь изменил искомый текст.

    Объявление

    Swift

    optional func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String)

    Objective C

    - (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText

    Параметры

    searchBar

    Редактирующаяся панель поиска.

    searchText

    Текущий текст в поле искомого текста.

    Обсуждение

    Когда текст очищен от поля искомого текста, этот метод также вызывается.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • Спросите делегата, если текст в указанном диапазоне должен быть заменен данным текстом.

    Объявление

    Swift

    optional func searchBar(_ searchBar: UISearchBar, shouldChangeTextInRange range: NSRange, replacementText text: String) -> Bool

    Objective C

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

    Параметры

    searchBar

    Редактирующаяся панель поиска.

    range

    Диапазон текста, который будет изменен.

    text

    Текст для замены существующего текста в range.

    Возвращаемое значение

    YEStrue если текст в range должен быть заменен text, иначе, NOfalse.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 3.0 и позже.

  • Если редактирование должно начаться в указанной панели поиска, спрашивает делегат.

    Объявление

    Swift

    optional func searchBarShouldBeginEditing(_ searchBar: UISearchBar) -> Bool

    Objective C

    - (BOOL)searchBarShouldBeginEditing:(UISearchBar *)searchBar

    Параметры

    searchBar

    Редактирующаяся панель поиска.

    Возвращаемое значение

    YEStrue если сеанс редактирования должен инициироваться, иначе, NOfalse.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • Когда пользователь начинает редактировать искомый текст, говорит делегату.

    Объявление

    Swift

    optional func searchBarTextDidBeginEditing(_ searchBar: UISearchBar)

    Objective C

    - (void)searchBarTextDidBeginEditing:(UISearchBar *)searchBar

    Параметры

    searchBar

    Редактирующаяся панель поиска.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • Если редактирование должно остановиться в указанной панели поиска, спрашивает делегат.

    Объявление

    Swift

    optional func searchBarShouldEndEditing(_ searchBar: UISearchBar) -> Bool

    Objective C

    - (BOOL)searchBarShouldEndEditing:(UISearchBar *)searchBar

    Параметры

    searchBar

    Редактирующаяся панель поиска.

    Возвращаемое значение

    YEStrue если редактирование должно остановиться, иначе NOfalse.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • Говорит делегату, что пользователь закончил редактировать искомый текст.

    Объявление

    Swift

    optional func searchBarTextDidEndEditing(_ searchBar: UISearchBar)

    Objective C

    - (void)searchBarTextDidEndEditing:(UISearchBar *)searchBar

    Параметры

    searchBar

    Редактирующаяся панель поиска.

    Обсуждение

    Как правило, Вы реализуете этот метод для выполнения основанного на тексте поиска.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • Говорит делегату, что коснулась кнопка закладки.

    Объявление

    Swift

    optional func searchBarBookmarkButtonClicked(_ searchBar: UISearchBar)

    Objective C

    - (void)searchBarBookmarkButtonClicked:(UISearchBar *)searchBar

    Параметры

    searchBar

    Коснувшаяся панель поиска.

    Обсуждение

    Нет никакой автоматической поддержки закладки, предоставленной панелью поиска. Если кнопка закладки касается пользователем, это - ответственность приложения реализовать этот метод для выполнения некоторого действия.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    showsBookmarkButton

  • Говорит делегату, что коснулась кнопка отмены.

    Объявление

    Swift

    optional func searchBarCancelButtonClicked(_ searchBar: UISearchBar)

    Objective C

    - (void)searchBarCancelButtonClicked:(UISearchBar *)searchBar

    Параметры

    searchBar

    Коснувшаяся панель поиска.

    Обсуждение

    Как правило, Вы реализуете этот метод для отклонения панели поиска.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    showsCancelButton

  • Говорит делегату, что коснулась кнопка поиска.

    Объявление

    Swift

    optional func searchBarSearchButtonClicked(_ searchBar: UISearchBar)

    Objective C

    - (void)searchBarSearchButtonClicked:(UISearchBar *)searchBar

    Параметры

    searchBar

    Коснувшаяся панель поиска.

    Обсуждение

    Необходимо реализовать этот метод для начала поиска. Используйте text свойство панели поиска для получения текста. Можно также отправить becomeFirstResponder к панели поиска, чтобы начать редактировать программно.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • Говорит делегату, что коснулась кнопка раскрытия списка результатов поиска.

    Объявление

    Swift

    optional func searchBarResultsListButtonClicked(_ searchBar: UISearchBar)

    Objective C

    - (void)searchBarResultsListButtonClicked:(UISearchBar *)searchBar

    Параметры

    searchBar

    Коснувшаяся панель поиска.

    Оператор импорта

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 3.2 и позже.