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

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

Разработчик

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

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

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

UITableViewController

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


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


Swift

import UIKit

Objective C

@import UIKit;

Доступность


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

UITableViewController класс создает объект контроллера, управляющий табличным представлением. Это реализует следующее поведение:

  • Если файл пера указан через initWithNibName:bundle: метод (который объявляется суперклассом UIViewController), UITableViewController загружает табличное представление, заархивированное в файле пера. Иначе, это создает несконфигурированный UITableView объект с корректными размерностями и автоизменяет размеры маски. Можно получить доступ к этому представлению через tableView свойство.

  • Если файл пера, содержащий табличное представление, загружается, источник данных и делегат становятся теми объектами, определенными в файле пера (если таковые имеются). Если файл пера не определяет источника данных или делегата, если никакой файл пера не указан или UITableViewController устанавливает источник данных и делегата табличного представления к self.

  • Когда табличное представление собирается появиться в первый раз, когда оно загружается, контроллер табличного представления перезагружает данные табличного представления. Это также очищает свой выбор (с или без анимации, в зависимости от запроса) каждый раз, когда табличное представление выведено на экран. UITableViewController класс реализует это в методе суперкласса viewWillAppear:. Можно отключить это поведение путем изменения значения в clearsSelectionOnViewWillAppear свойство.

  • Когда табличное представление появилось, контроллер высвечивает индикаторы прокрутки табличного представления. UITableViewController класс реализует это в методе суперкласса viewDidAppear:.

  • Это реализует метод суперкласса setEditing:animated: так, чтобы, если пользователь касается кнопки Edit|Done в панели навигации, контроллер переключил режим редактирования таблицы.

Вы создаете пользовательский подкласс UITableViewController для каждого табличного представления, что Вы хотите управлять. Когда Вы инициализируете контроллер в initWithStyle:, необходимо указать стиль табличного представления (плоскость или сгруппированный), которым должен управлять контроллер. Поскольку первоначально создаваемое табличное представление без табличных размерностей (т.е. число разделов и число строк на раздел) или содержание, источник данных табличного представления и делегат — т.е. UITableViewController возразите себе — должен обеспечить табличные размерности, содержание ячейки и любые желаемые конфигурации (как обычно). Можно переопределить loadView или любой другой метод суперкласса, но если Вы действительно, несомненно, вызовете реализацию суперкласса метода, обычно как первый вызов метода.

  • init (стиль:) - initWithStyle: Определяемый инициализатор

    Инициализирует контроллер табличного представления для управления табличным представлением данного стиля.

    Объявление

    Swift

    init(style style: UITableViewStyle)

    Objective C

    - (instancetype)initWithStyle:(UITableViewStyle)style

    Параметры

    style

    Константа, указывающая стиль табличного представления, что объект контроллера состоит в том, чтобы управлять (UITableViewStylePlain или UITableViewStyleGrouped).

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

    Инициализированный UITableViewController объект.

    Обсуждение

    Если Вы используете стандарт init метод для инициализации a UITableViewController объект, табличное представление в стандартном стиле создается.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • tableView Свойство

    Возвращает табличное представление, которым управляет объект контроллера.

    Объявление

    Swift

    var tableView: UITableView!

    Objective C

    @property(nonatomic, retain) UITableView *tableView

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • Булево значение, указывающее, очищает ли контроллер выбор, когда появляется таблица.

    Объявление

    Swift

    var clearsSelectionOnViewWillAppear: Bool

    Objective C

    @property(nonatomic) BOOL clearsSelectionOnViewWillAppear

    Обсуждение

    Значение по умолчанию этого свойства YEStrue. Когда YEStrue, контроллер табличного представления очищает текущий выбор таблицы, когда это получает a viewWillAppear: сообщение. Установка этого свойства к NOfalse сохраняет выбор.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • refreshControl Свойство

    Управление обновлением раньше обновляло табличное содержание.

    Объявление

    Swift

    var refreshControl: UIRefreshControl?

    Objective C

    @property(nonatomic, retain) UIRefreshControl *refreshControl

    Обсуждение

    Значение по умолчанию этого свойства nil.

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

    Контроллер табличного представления автоматически не обновляет содержание таблицы в ответ на взаимодействие с пользователем с управлением обновлением. Когда пользователь инициирует работу обновления, управление генерирует a UIControlEventValueChanged событие. Необходимо связать целевой метод и метод действия с этим событием и использовать их для обновления содержания таблицы.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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