UITableView
Наследование
-
NSObject -
UIResponder -
UIView -
UIScrollView -
UITableView
-
NSObject -
UIResponder -
UIView -
UIScrollView -
UITableView
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCoding -
NSObjectProtocol -
Печатаемый -
Reflectable -
UIAccessibilityIdentification -
UIAppearance -
UIAppearanceContainer -
UICoordinateSpace -
UIDynamicItem -
UITraitEnvironment -
NSCoding -
NSObject -
UIAppearance -
UIAppearanceContainer -
UICoordinateSpace -
UIDynamicItem -
UITraitEnvironment
Оператор импорта
Swift
import UIKit
Objective C
@import UIKit;
Доступность
Доступный в iOS 2.0 и позже.
Экземпляр UITableView (или просто, табличное представление), средние значения для отображения и редактирования иерархических списков информации.
Табличное представление выводит на экран список элементов в отдельном столбце. UITableView подкласс UIScrollView, который позволяет пользователям просматривать таблицу путем прокрутки, несмотря на то, что UITableView позволяет вертикальную прокрутку только. Ячейки, включающие отдельные элементы таблицы, UITableViewCell объекты; UITableView использование эти объекты нарисовать видимые строки таблицы. Ячейки имеют содержание — заголовки и изображения — и могут иметь, около правого края, представлений аксессуара. Стандартные представления аксессуара являются индикаторами раскрытия или детализируют кнопки раскрытия; прежний приводит к следующему уровню в иерархии данных, и последний приводит к подробному представлению выбранного пункта. Представления аксессуара могут также быть средствами управления платформой, такими как переключатели и ползунки, или могут быть пользовательскими представлениями. Табличные представления могут ввести режим редактирования, где пользователи могут вставить, удалить и переупорядочить строки таблицы.
Табличное представление составлено из нуля или большего количества разделов, каждого с его собственными строками. Разделы идентифицируются их индексом в табличном представлении, и строки идентифицируются их индексом в разделе. Любому разделу может дополнительно предшествовать заголовок раздела, и дополнительно следовать нижним колонтитулом раздела.
Табличные представления могут иметь один из двух стилей, UITableViewStylePlain и UITableViewStyleGrouped. Когда Вы создаете a UITableView экземпляр необходимо указать стиль таблицы и этот стиль, не может быть изменен. В стандартном стиле разделите плавание заголовков и нижних колонтитулов выше содержания, если часть полного раздела видима. Табличное представление может иметь индекс, появляющийся как панель на правой стороне таблицы (например, через «Z»). Можно коснуться определенной метки для перехода к целевому разделу. Сгруппированный стиль табличного представления обеспечивает цвет фона по умолчанию и фоновое представление по умолчанию для всех ячеек. Фоновое представление обеспечивает визуальную группировку для всех ячеек в определенном разделе. Например, одна группа могла быть именем и заголовком лица, другой группой для телефонных номеров, которые лицо использует, и другая группа для почтовых ящиков и т.д. См. приложение Настроек для примеров сгруппированных таблиц. Табличные представления в сгруппированном стиле не могут иметь индекса.
Много методов UITableView взять NSIndexPath объекты как параметры и возвращаемые значения. UITableView объявляет категорию на NSIndexPath это позволяет Вам получить представленный индекс строки (row свойство) и индекс раздела (section свойство), и создать индексный путь из данного индекса строки и индекса раздела (indexPathForRow:inSection: метод). Особенно в табличных представлениях с многократными разделами, необходимо оценить индекс раздела прежде, чем идентифицировать строку ее индексом.
A UITableView объект должен иметь объект, действующий как источник данных и объект, действующий как делегат; обычно эти объекты являются или делегатом приложения или, более часто, пользовательское UITableViewController объект. Источник данных должен принять UITableViewDataSource протокол и делегат должны принять UITableViewDelegate протокол. Источник данных предоставляет информацию это UITableView когда строки таблицы вставлены, удалены или переупорядочены, потребности создать таблицы и управляют моделью данных. Делегат управляет конфигурацией строки таблицы и выбором, переупорядочением строки, выделением, представлениями аксессуара и редактированием операций.
Когда отправлено a setEditing:animated: сообщение (с первым параметром YEStrue), табличное представление вводит в режим редактирования, где это показывает редактирование или переупорядочение средств управления каждой видимой строки, в зависимости от editingStyle из каждого связался UITableViewCell. Щелчок по вставке или управлению удалением заставляет источник данных получать a tableView:commitEditingStyle:forRowAtIndexPath: сообщение. Вы фиксируете удаление или вставку путем вызова deleteRowsAtIndexPaths:withRowAnimation: или insertRowsAtIndexPaths:withRowAnimation:, как надлежащий. Также в режиме редактирования, если ячейка табличного представления имеет showsReorderControl набор свойств к YEStrue, источник данных получает a tableView:moveRowAtIndexPath:toIndexPath: сообщение. Источник данных может выборочно удалить управление переупорядочением для ячеек путем реализации tableView:canMoveRowAtIndexPath:.
UITableView ячейки табличного представления кэшей для видимых строк. Можно создать пользовательский UITableViewCell объекты с довольным или поведенческими характеристиками, отличающимися, чем ячейки по умолчанию; Более внимательное рассмотрение в Ячейках Табличного представления объясняет как.
UITableView переопределения layoutSubviews метод UIView так, чтобы это вызвало reloadData только, когда Вы создаете новый экземпляр UITableView или когда Вы присваиваете новый источник данных. Перезагрузка табличного представления очищает текущее состояние, включая текущий выбор. Однако, если Вы явно вызываете reloadData, это очищает это состояние и любой последующий прямой или непрямой вызов layoutSubviews не инициировал перезагрузку.
Для получения информации об основных способах поведения представления см. Руководство по программированию Представления для iOS.
Сохранение состояния
В iOS 6 и позже, если Вы присваиваете значение табличному представлению restorationIdentifier свойство, это пытается сохранить в настоящее время выбираемые строки и первую видимую строку. Источник данных таблицы может принять UIDataSourceModelAssociation протокол, обеспечивающий способ идентифицировать содержание строки, независимое от позиции той строки в таблице. Если источник данных таблицы принимает UIDataSourceModelAssociation протокол, с источником данных будут консультироваться при сохранении состояния для преобразования индексных путей для главной видимой строки и любых выбранных ячеек к идентификаторам. Во время восстановления с источником данных будут консультироваться для преобразования тех идентификаторов назад, чтобы индексировать пути и восстановить главную видимую строку и повторно выбрать ячейки. Если источник данных таблицы не реализует UIDataSourceModelAssociation протокол, позиция прокрутки будет сохранена и восстановлена непосредственно, как будет индексные пути для выбранных ячеек.
Для получения дополнительной информации, о как сохранение состояния и реставрационные работы, см. Руководство по программированию Приложения для iOS.
Для получения дополнительной информации о появлении и конфигурации поведения, посмотрите Табличные представления.
-
Инициализирует и возвращает объект табличного представления, имеющий данный кадр и стиль.
Объявление
Swift
init(frameframe: CGRect, stylestyle: UITableViewStyle)Objective C
- (instancetype)initWithFrame:(CGRect)framestyle:(UITableViewStyle)styleПараметры
frameПрямоугольник, указывающий начальное расположение и размер табличного представления в его суперпредставлении’ s координаты. Кадр изменений табличного представления как ячейки таблицы добавлен и удален.
styleКонстанта, указывающая стиль табличного представления. Посмотрите Стиль Табличного представления для описаний допустимых констант.
Возвращаемое значение
Возвращает инициализированный
UITableViewобъект, илиnilесли не мог бы быть успешно инициализирован объект.Обсуждение
Необходимо указать стиль табличного представления, когда Вы создаете его, и Вы не можете после того изменить стиль. Если Вы инициализируете табличное представление с
UIViewметодinitWithFrame:,UITableViewStylePlainстиль используется в качестве значения по умолчанию.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
styleСвойствоВозвращает стиль табличного представления. (только для чтения)
Объявление
Swift
var style: UITableViewStyle { get }Objective C
@property(nonatomic, readonly) UITableViewStyle styleОбсуждение
Посмотрите, что Стиль Табличного представления для описаний констант раньше указывал стиль табличного представления.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает число строк (ячейки таблицы) в указанном разделе.
Объявление
Параметры
sectionИндекс, идентифицирующий раздел таблицы. Табличные представления в стандартном стиле имеют индекс раздела нуля.
Возвращаемое значение
Число строк в разделе.
Обсуждение
UITableViewвозвратили значение этим методом от его источника данных и кэширует его.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает число разделов в табличном представлении.
Возвращаемое значение
Число разделов в табличном представлении.
Обсуждение
UITableViewвозвратили значение этим методом от его источника данных и кэширует его.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
rowHeightСвойствоВысота каждой строки (ячейка таблицы) в табличном представлении.
Обсуждение
Высота строки является неотрицательной и выражена в точках. Если делегат не реализует, можно установить высоту строки для ячеек
tableView:heightForRowAtIndexPath:метод. Если Вы явно не устанавливаете высоту строки,UITableViewнаборы это к стандартному значению.Существуют импликации производительности к использованию
tableView:heightForRowAtIndexPath:вместоrowHeight. Каждый раз, когда табличное представление выведено на экран, оно вызываетtableView:heightForRowAtIndexPath:на делегате к каждой из его строк, которые могут привести к значительной проблеме производительности с табличными представлениями, имеющими большое количество строк (приблизительно 1000 или больше).Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
separatorStyleСвойствоСтиль для ячеек таблицы, используемых в качестве разделителей.
Объявление
Swift
var separatorStyle: UITableViewCellSeparatorStyleObjective C
@property(nonatomic) UITableViewCellSeparatorStyle separatorStyleОбсуждение
Значение этого свойства является одной из констант стиля разделителя, описанных в Ссылке класса UITableViewCell.
UITableViewиспользование это свойство для установки стиля разделителя на ячейке возвратилось от делегата вtableView:cellForRowAtIndexPath:.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
separatorColorСвойствоЦвет строк разделителя в табличном представлении.
Объявление
Swift
var separatorColor: UIColor!Objective C
@property(nonatomic, retain) UIColor *separatorColorОбсуждение
Цвет по умолчанию является серым.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
separatorEffectСвойствоЭффект применился к табличным разделителям.
Объявление
Swift
@NSCopying var separatorEffect: UIVisualEffect?Objective C
@property(nonatomic, copy) UIVisualEffect *separatorEffectОператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 8.0 и позже.
-
backgroundViewСвойствоФоновое представление табличного представления.
Объявление
Swift
var backgroundView: UIView?Objective C
@property(nonatomic, readwrite, retain) UIView *backgroundViewОбсуждение
Фоновое представление табличного представления автоматически изменено для соответствия размера табличного представления. Это представление помещается как подпредставление табличного представления позади всех ячеек, представления заголовка и представления нижнего колонтитула.
Необходимо установить это свойство в
nilвыбирать цвет фона табличного представления.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 3.2 и позже.
-
separatorInsetСвойствоУказывает вставку по умолчанию разделителей ячейки.
Объявление
Swift
var separatorInset: UIEdgeInsetsObjective C
@property(nonatomic) UIEdgeInsets separatorInsetОбсуждение
В iOS 7 и позже, разделители ячейки не расширяются полностью на край табличного представления. Это наборы свойств вставка по умолчанию для всех ячеек в таблице, очень как
rowHeightустанавливает высоту по умолчанию для ячеек. Это также используется для управления «дополнительными» разделителями, нарисованными у основания таблиц стандартного стиля.Например, для указания табличного представления, где значение по умолчанию левая вставка разделителя является 3 точками и правильной вставкой разделителя по умолчанию, - 11, Вы записали бы:
tableView.separatorInset = UIEdgeInsetsMake(0, 3, 0, 11);
Специальные замечания
Только левые и правые вставки соблюдают.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
Регистрирует объект пера, содержащий ячейку с табличным представлением под указанным идентификатором.
Объявление
Параметры
nibОбъект пера, указывающий файл пера для использования для создания ячейки. Этот параметр не может быть
nil.identifierИдентификатор повторного использования для ячейки. Этот параметр не должен быть
nilи не должна быть пустая строка.Обсуждение
Перед исключением из очереди любые ячейки вызовите этот метод или
registerClass:forCellReuseIdentifier:метод для сообщения табличного представления, как создать новые ячейки. Если ячейка указанного типа в настоящее время не находится в очереди повторного использования, табличное представление использует предоставленную информацию для создания нового объекта ячейки автоматически.При предыдущей регистрации класса или файла пера с тем же идентификатором повторного использования, перо, Вы указываете в
nibпараметр заменяет старую запись. Можно указатьnilдляnibесли Вы хотите не зарегистрировать перо от указанного идентификатора повторного использования.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
См. также
tableView:cellForRowAtIndexPath:(UITableViewDataSource) -
Регистрирует класс для использования в создании новых ячеек таблицы.
Объявление
Swift
func registerClass(_cellClass: AnyClass, forCellReuseIdentifieridentifier: String)Objective C
- (void)registerClass:(Class)cellClassforCellReuseIdentifier:(NSString *)identifierПараметры
cellClassКласс ячейки, которую Вы хотите использовать в таблице.
identifierИдентификатор повторного использования для ячейки. Этот параметр не должен быть
nilи не должна быть пустая строка.Обсуждение
До исключения из очереди любые ячейки вызовите этот метод или
registerNib:forCellReuseIdentifier:метод для сообщения табличного представления, как создать новые ячейки. Если ячейка указанного типа в настоящее время не находится в очереди повторного использования, табличное представление использует предоставленную информацию для создания нового объекта ячейки автоматически.При предыдущей регистрации класса или файла пера с тем же идентификатором повторного использования, класс, Вы указываете в
cellClassпараметр заменяет старую запись. Можно указатьnilдляcellClassесли Вы хотите не зарегистрировать класс от указанного идентификатора повторного использования.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
dequeueReusableCellWithIdentifier (_: forIndexPath:) - dequeueReusableCellWithIdentifier:forIndexPath:Возвращает допускающий повторное использование объект ячейки табличного представления для указанного идентификатора повторного использования.
Объявление
Swift
func dequeueReusableCellWithIdentifier(_identifier: String, forIndexPathindexPath: NSIndexPath) -> AnyObjectObjective C
- (id)dequeueReusableCellWithIdentifier:(NSString *)identifierforIndexPath:(NSIndexPath *)indexPathПараметры
identifierСтрока, идентифицирующая ячейку, возражает, чтобы быть снова использованной. Этот параметр не должен быть
nil.indexPathИндексный путь, указывающий расположение ячейки. Источник данных получает эту информацию, когда это просят относительно ячейки и должно просто провести его. Этот метод использует индексный путь для выполнения дополнительной конфигурации на основе позиции ячейки в табличном представлении.
Возвращаемое значение
A
UITableViewCellобъект со связанным идентификатором повторного использования. Этот метод всегда возвращает допустимую ячейку.Обсуждение
По причинам производительности табличное представление’ s источник данных должно обычно снова использовать
UITableViewCellобъекты, когда это присваивает ячейки строкам вtableView:cellForRowAtIndexPath:метод. Табличное представление поддерживает очередь или списокUITableViewCellобъекты, которые источник данных отметил для повторного использования. Вызовите этот метод от своего объекта источника данных, когда спросили обеспечить новую ячейку для табличного представления. Этот метод исключает существующую ячейку из очереди, если Вы доступны или создаете нового на основе класса, или перо регистрируют Вас ранее зарегистрированный.Если Вы зарегистрировали класс для указанного
identifierи новая ячейка должна быть создана, этот метод инициализирует ячейку путем вызоваinitWithStyle:reuseIdentifier:метод. Для основанных на пере ячеек этот метод загружает объект ячейки из предоставленного файла пера. Если существующая ячейка была доступна для повторного использования, это вызовы метода ячейкаprepareForReuseметод вместо этого.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Возвращает допускающий повторное использование объект ячейки табличного представления, расположенный его идентификатором.
Объявление
Swift
func dequeueReusableCellWithIdentifier(_identifier: String) -> AnyObject?Objective C
- (id)dequeueReusableCellWithIdentifier:(NSString *)identifierПараметры
identifierСтрока, идентифицирующая ячейку, возражает, чтобы быть снова использованной. Этот параметр не должен быть
nil.Возвращаемое значение
A
UITableViewCellобъект со связаннымidentifierилиnilесли никакой такой объект не существует в очереди допускающей повторное использование ячейки.Обсуждение
По причинам производительности табличное представление’ s источник данных должно обычно снова использовать
UITableViewCellобъекты, когда это присваивает ячейки строкам вtableView:cellForRowAtIndexPath:метод. Табличное представление поддерживает очередь или списокUITableViewCellобъекты, которые источник данных отметил для повторного использования. Вызовите этот метод от своего объекта источника данных, когда спросили обеспечить новую ячейку для табличного представления. Этот метод исключает существующую ячейку из очереди, если Вы доступны или создаете нового с помощью класса, или перо регистрируют Вас ранее зарегистрированный. Если никакая ячейка не доступна для повторного использования, и Вы не регистрировали класс или файл пера, этот метод возвратыnil.Если Вы зарегистрировали класс для указанного
identifierи новая ячейка должна быть создана, этот метод инициализирует ячейку путем вызоваinitWithStyle:reuseIdentifier:метод. Для основанных на пере ячеек этот метод загружает объект ячейки из предоставленного файла пера. Если существующая ячейка была доступна для повторного использования, это вызовы метода ячейкаprepareForReuseметод вместо этого.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
registerNib (_: forHeaderFooterViewReuseIdentifier:) - registerNib:forHeaderFooterViewReuseIdentifier:Регистрирует объект пера, содержащий заголовок или нижний колонтитул с табличным представлением под указанным идентификатором.
Объявление
Параметры
nibОбъект пера, указывающий файл пера для использования для создания представления нижнего колонтитула или заголовка. Этот параметр не может быть
nil.identifierИдентификатор повторного использования для заголовка или представления нижнего колонтитула. Этот параметр не должен быть
nilи не должна быть пустая строка.Обсуждение
Перед исключением из очереди любой заголовок или представления нижнего колонтитула, вызовите этот метод или
registerClass:forHeaderFooterViewReuseIdentifier:метод для сообщения табличного представления, как создать новые экземпляры представлений. Если представление указанного типа в настоящее время не находится в очереди повторного использования, табличное представление использует предоставленную информацию для создания новой автоматически.При предыдущей регистрации класса или файла пера с тем же идентификатором повторного использования, перо, Вы указываете в
nibпараметр заменяет старую запись. Можно указатьnilдляnibесли Вы хотите не зарегистрировать перо от указанного идентификатора повторного использования.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
registerClass (_: forHeaderFooterViewReuseIdentifier:) - registerClass:forHeaderFooterViewReuseIdentifier:Регистрирует класс для использования в создании нового табличного заголовка или представлений нижнего колонтитула.
Объявление
Swift
func registerClass(_aClass: AnyClass, forHeaderFooterViewReuseIdentifieridentifier: String)Objective C
- (void)registerClass:(Class)aClassforHeaderFooterViewReuseIdentifier:(NSString *)identifierПараметры
aClassКласс заголовка или представления нижнего колонтитула, что Вы хотите использовать в таблице.
identifierИдентификатор повторного использования для заголовка или представления нижнего колонтитула. Этот параметр не должен быть
nilи не должна быть пустая строка.Обсуждение
Перед исключением из очереди любой заголовок или представления нижнего колонтитула, вызовите этот метод или
registerNib:forHeaderFooterViewReuseIdentifier:метод для сообщения табличного представления, как создать новые экземпляры представлений. Если представление указанного типа в настоящее время не находится в очереди повторного использования, табличное представление использует предоставленную информацию для создания той автоматически.При предыдущей регистрации класса или файла пера с тем же идентификатором повторного использования, класс, Вы указываете в
aClassпараметр заменяет старую запись. Можно указатьnilдляaClassесли Вы хотите не зарегистрировать класс от указанного идентификатора повторного использования.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Возвращает допускающий повторное использование заголовок или представление нижнего колонтитула, расположенное его идентификатором.
Объявление
Swift
func dequeueReusableHeaderFooterViewWithIdentifier(_identifier: String) -> AnyObject?Objective C
- (id)dequeueReusableHeaderFooterViewWithIdentifier:(NSString *)identifierПараметры
identifierСтрока, идентифицирующая заголовок или нижний колонтитул, просматривает, чтобы быть снова использованной. Этот параметр не должен быть
nil.Возвращаемое значение
A
UITableViewHeaderFooterViewобъект со связанным идентификатором илиnilесли никакой такой объект не существует в допускающей повторное использование очереди представления.Обсуждение
По причинам производительности делегат табличного представления должен обычно снова использовать
UITableViewHeaderFooterViewобъекты, когда просят обеспечить их. Табличное представление поддерживает очередь или списокUITableViewHeaderFooterViewобъекты, которые делегат табличного представления отметил для повторного использования. Это отмечает представление для повторного использования путем присвоения его идентификатор повторного использования, когда это создает его (т.е. вinitWithReuseIdentifier:методUITableViewHeaderFooterView).Можно использовать этот метод для доступа к определенному шаблонному заголовку и представлениям нижнего колонтитула, что Вы ранее создали. Можно получить доступ к представлению’ s идентификатор повторного использования через его reuseIdentifier свойство.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
tableHeaderViewСвойствоВозвращает вспомогательное представление, выведенное на экран выше таблицы.
Объявление
Swift
var tableHeaderView: UIView?Objective C
@property(nonatomic, retain) UIView *tableHeaderViewОбсуждение
Значение по умолчанию
nil. Табличное представление заголовка отличается от заголовка раздела.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
tableFooterViewСвойствоВозвращает вспомогательное представление, выведенное на экран ниже таблицы.
Объявление
Swift
var tableFooterView: UIView?Objective C
@property(nonatomic, retain) UIView *tableFooterViewОбсуждение
Значение по умолчанию
nil. Табличное представление нижнего колонтитула отличается от нижнего колонтитула раздела.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
sectionHeaderHeightСвойствоВысота заголовков раздела в табличном представлении.
Объявление
Swift
var sectionHeaderHeight: CGFloatObjective C
@property(nonatomic) CGFloat sectionHeaderHeightОбсуждение
Это неотрицательное значение используется, только если делегат не реализует
tableView:heightForHeaderInSection:метод.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
sectionFooterHeightСвойствоВысота нижних колонтитулов раздела в табличном представлении.
Объявление
Swift
var sectionFooterHeight: CGFloatObjective C
@property(nonatomic) CGFloat sectionFooterHeightОбсуждение
Это неотрицательное значение используется только в таблицах группы раздела и только если делегат не реализует
tableView:heightForFooterInSection:метод.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает представление заголовка, связанное с указанным разделом.
Объявление
Swift
func headerViewForSection(_section: Int) -> UITableViewHeaderFooterView?Objective C
- (UITableViewHeaderFooterView *)headerViewForSection:(NSInteger)sectionПараметры
sectionИндекс, идентифицирующий раздел таблицы. Табличные представления в стандартном стиле имеют индекс раздела нуля.
Возвращаемое значение
Представление заголовка связалось с разделом, или
nilесли раздел не имеет представления заголовка.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Возвращает представление нижнего колонтитула, связанное с указанным разделом.
Объявление
Swift
func footerViewForSection(_section: Int) -> UITableViewHeaderFooterView?Objective C
- (UITableViewHeaderFooterView *)footerViewForSection:(NSInteger)sectionПараметры
sectionИндекс, идентифицирующий раздел таблицы. Табличные представления в стандартном стиле имеют индекс раздела нуля.
Возвращаемое значение
Представление нижнего колонтитула связалось с разделом, или
nilесли раздел не имеет представления нижнего колонтитула.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Возвращает ячейку таблицы в указанном индексном пути.
Объявление
Swift
func cellForRowAtIndexPath(_indexPath: NSIndexPath) -> UITableViewCell?Objective C
- (UITableViewCell *)cellForRowAtIndexPath:(NSIndexPath *)indexPathПараметры
indexPathИндексный путь, определяющий местоположение строки в табличном представлении.
Возвращаемое значение
Объект, представляющий ячейку таблицы, или
nilесли ячейка не видима илиindexPathвне диапазона.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает индексный путь, представляющий строку и раздел данной ячейки табличного представления.
Объявление
Swift
func indexPathForCell(_cell: UITableViewCell) -> NSIndexPath?Objective C
- (NSIndexPath *)indexPathForCell:(UITableViewCell *)cellПараметры
cellОбъект ячейки табличного представления.
Возвращаемое значение
Индексный путь, представляющий строку и раздел ячейки, или
nilесли индексный путь недопустим.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает индексный путь, идентифицирующий строку и раздел в данной точке.
Объявление
Swift
func indexPathForRowAtPoint(_point: CGPoint) -> NSIndexPath?Objective C
- (NSIndexPath *)indexPathForRowAtPoint:(CGPoint)pointПараметры
pointТочка в системе локальной координаты табличного представления (табличное представление’ s границы).
Возвращаемое значение
Индексный путь, представляющий строку и раздел, связался с
point, илиnilесли точка вне границ какой-либо строки.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Массив индекса соединяет каждое представление каналом строки, включенной данным прямоугольником.
Объявление
Swift
func indexPathsForRowsInRect(_rect: CGRect) -> [AnyObject]Параметры
rectПрямоугольник, определяющий область табличного представления в локальных координатах.
Возвращаемое значение
Массив
NSIndexPathобъекты каждое представление строки и индекса раздела, идентифицирующего строку вrect. Если нет никаких строк для возврата, возвращает пустой массив.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает ячейки таблицы, которые видимы в табличном представлении.
Возвращаемое значение
Массив, содержащий
UITableViewCellобъекты, каждый представляющий видимую ячейку в табличном представлении.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращается массив индекса соединяет каждую идентификацию каналом видимой строки в табличном представлении.
Объявление
Swift
func indexPathsForVisibleRows() -> [AnyObject]?Objective C
- (NSArray *)indexPathsForVisibleRowsВозвращаемое значение
Массив
NSIndexPathобъекты каждое представление индекса строки и индекса раздела, вместе идентифицирующих видимую строку в табличном представлении. Возвратыnilесли никакие строки не видимы.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
estimatedRowHeightСвойствоПредполагаемая высота строк в табличном представлении.
Объявление
Swift
var estimatedRowHeight: CGFloatObjective C
@property(nonatomic) CGFloat estimatedRowHeightОбсуждение
Обеспечение неотрицательной оценки высоты строк может улучшить производительность загрузки табличного представления. Если таблица содержит переменные строки высоты, могло бы быть дорого вычислить все их высоты, когда загружается таблица. Используя оценку позволяет Вам задерживать часть стоимости геометрического вычисления со времени загрузки к прокрутке времени.
Значение по умолчанию
0, что означает, что нет никакой оценки.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
estimatedSectionHeaderHeightСвойствоПредполагаемая высота заголовков раздела в табличном представлении.
Объявление
Swift
var estimatedSectionHeaderHeight: CGFloatObjective C
@property(nonatomic) CGFloat estimatedSectionHeaderHeightОбсуждение
Обеспечение неотрицательной оценки высоты заголовков раздела может улучшить производительность загрузки табличного представления. Если таблица содержит переменные заголовки раздела высоты, могло бы быть дорого вычислить все их высоты, когда загружается таблица. Используя оценку позволяет Вам задерживать часть стоимости геометрического вычисления со времени загрузки к прокрутке времени.
Значение по умолчанию
0, что означает, что нет никакой оценки.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
estimatedSectionFooterHeightСвойствоПредполагаемая высота нижних колонтитулов раздела в табличном представлении.
Объявление
Swift
var estimatedSectionFooterHeight: CGFloatObjective C
@property(nonatomic) CGFloat estimatedSectionFooterHeightОбсуждение
Обеспечение неотрицательной оценки высоты нижних колонтитулов раздела может улучшить производительность загрузки табличного представления. Если таблица содержит переменные нижние колонтитулы раздела высоты, могло бы быть дорого вычислить все их высоты, когда загружается таблица. Используя оценку позволяет Вам задерживать часть стоимости геометрического вычисления со времени загрузки к прокрутке времени.
Значение по умолчанию
0, что означает, что нет никакой оценки.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
scrollToRowAtIndexPath (_: atScrollPosition:animated:) - scrollToRowAtIndexPath:atScrollPosition:animated:Просматривает табличное представление путем прокрутки, пока строка, идентифицированная индексным путем, не в определенном расположении на экране.
Объявление
Swift
func scrollToRowAtIndexPath(_indexPath: NSIndexPath, atScrollPositionscrollPosition: UITableViewScrollPosition, animatedanimated: Bool)Objective C
- (void)scrollToRowAtIndexPath:(NSIndexPath *)indexPathatScrollPosition:(UITableViewScrollPosition)scrollPositionanimated:(BOOL)animatedПараметры
indexPathИндексный путь, идентифицирующий строку в табличном представлении его индексом строки и его индексом раздела.
NSNotFoundдопустимый индекс строки для прокрутки к разделу с нулевыми строками.scrollPositionКонстанта, идентифицирующая относительную позицию в табличном представлении (вершина, середина, нижняя часть) для
rowкогда заканчивается прокрутка. Посмотрите Позицию Прокрутки Табличного представления для описаний допустимых констант.animatedYEStrueесли Вы хотите анимировать изменение в позиции;NOfalseесли это должно быть непосредственно.Обсуждение
Вызов этого метода не заставляет делегата получать a
scrollViewDidScroll:сообщение, как нормально для программно вызванных операций пользовательского интерфейса.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
scrollToNearestSelectedRowAtScrollPosition (_: анимированный:) - scrollToNearestSelectedRowAtScrollPosition:animated:Прокручивает табличное представление так, чтобы выбранная строка, самая близкая к указанной позиции в табличном представлении, была в той позиции.
Объявление
Swift
func scrollToNearestSelectedRowAtScrollPosition(_scrollPosition: UITableViewScrollPosition, animatedanimated: Bool)Objective C
- (void)scrollToNearestSelectedRowAtScrollPosition:(UITableViewScrollPosition)scrollPositionanimated:(BOOL)animatedПараметры
scrollPositionКонстанта, идентифицирующая относительную позицию в табличном представлении (вершина, середина, нижняя часть) для строки, когда заканчивается прокрутка. Посмотрите Позицию Прокрутки Табличного представления для описания допустимых констант.
animatedYEStrueесли Вы хотите анимировать изменение в позиции;NOfalseесли это должно быть непосредственно.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает индексный путь, идентифицирующий строку и раздел выбранной строки.
Объявление
Swift
func indexPathForSelectedRow() -> NSIndexPath?Objective C
- (NSIndexPath *)indexPathForSelectedRowВозвращаемое значение
Индексный путь, идентифицирующий строку и индексы раздела выбранной строки, или
nilесли индексный путь недопустим.Обсуждение
Если существуют множественные выборы, этот метод возвращает первый индексный объект контуров в массиве выборов строки; этот объект имеет самые низкие индексные значения для раздела и строки.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает индексные пути, представляющие выбранные строки.
Объявление
Swift
func indexPathsForSelectedRows() -> [AnyObject]?Objective C
- (NSArray *)indexPathsForSelectedRowsВозвращаемое значение
Массив индексных объектов контуров каждая идентификация строки через ее раздел и индекс строки. Возвраты
nilпри отсутствии выбранных строк.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
См. также
-
Выбирает строку в табличном представлении, идентифицированном индексным путем, дополнительно прокручивая строку к расположению в табличном представлении.
Объявление
Swift
func selectRowAtIndexPath(_indexPath: NSIndexPath?, animatedanimated: Bool, scrollPositionscrollPosition: UITableViewScrollPosition)Objective C
- (void)selectRowAtIndexPath:(NSIndexPath *)indexPathanimated:(BOOL)animatedscrollPosition:(UITableViewScrollPosition)scrollPositionПараметры
indexPathИндексный путь, идентифицирующий строку в табличном представлении.
animatedYEStrueесли Вы хотите анимировать выбор и какое-либо изменение в позиции;NOfalseесли изменение должно быть непосредственным.scrollPositionКонстанта, идентифицирующая относительную позицию в табличном представлении (вершина, середина, нижняя часть) для строки, когда заканчивается прокрутка. Посмотрите Позицию Прокрутки Табличного представления для описаний допустимых констант.
Обсуждение
Вызов этого метода не заставляет делегата получать a
tableView:willSelectRowAtIndexPath:илиtableView:didSelectRowAtIndexPath:сообщение, и при этом это не отправляетUITableViewSelectionDidChangeNotificationуведомления наблюдателям.Специальные замечания
Передача
UITableViewScrollPositionNoneрезультаты ни в какой прокрутке, а не минимум, прокручивающий описанный для той константы. Для прокрутки к недавно выбранной строке с прокруткой минимума выберите строку с помощью этого метода сUITableViewScrollPositionNone, тогда вызовитеscrollToRowAtIndexPath:atScrollPosition:animated:сUITableViewScrollPositionNone.NSIndexPath *rowToSelect; // assume this exists and is set properlyUITableView *myTableView; // assume this exists[myTableView selectRowAtIndexPath:rowToSelect animated:YES scrollPosition:UITableViewScrollPositionNone];[myTableView scrollToRowAtIndexPath:rowToSelect atScrollPosition:UITableViewScrollPositionNone animated:YES];
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Отменяет выбор данной строки, идентифицированной индексным путем, с опцией анимировать отмену выбора.
Объявление
Swift
func deselectRowAtIndexPath(_indexPath: NSIndexPath, animatedanimated: Bool)Objective C
- (void)deselectRowAtIndexPath:(NSIndexPath *)indexPathanimated:(BOOL)animatedПараметры
indexPathИндексный путь, идентифицирующий строку в табличном представлении.
animatedYEStrueесли Вы хотите анимировать отмену выбора, иNOfalseесли изменение должно быть непосредственным.Обсуждение
Вызов этого метода не заставляет делегата получать a
tableView:willSelectRowAtIndexPath:илиtableView:didSelectRowAtIndexPath:сообщение, и при этом это не отправляетUITableViewSelectionDidChangeNotificationуведомления наблюдателям.Вызов этого метода не вызывает прокрутки к невыбранной строке.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
allowsSelectionСвойствоБулево значение, определяющее, могут ли пользователи выбрать строку.
Объявление
Swift
var allowsSelection: BoolObjective C
@property(nonatomic) BOOL allowsSelectionОбсуждение
Если значение этого свойства
YEStrue(значение по умолчанию), пользователи могут выбрать строки. Если Вы устанавливаете его вNOfalse, они не могут выбрать строки. Установка этого свойства влияет на выбор ячейки только, когда табличное представление не находится в режиме редактирования. Если Вы хотите ограничить выбор ячеек в режиме редактирования, использоватьallowsSelectionDuringEditing.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 3.0 и позже.
-
allowsMultipleSelectionСвойствоБулево значение, определяющее, могут ли пользователи выбрать больше чем одну строку за пределами режима редактирования.
Объявление
Swift
var allowsMultipleSelection: BoolObjective C
@property(nonatomic) BOOL allowsMultipleSelectionОбсуждение
Это свойство управляет, могут ли многократные строки быть выбраны одновременно за пределами режима редактирования. Когда значение этого свойства
YEStrue, галочка помещается рядом с каждой коснувшейся строкой. Ответвление строки снова удаляет галочку. Если Вы вызываетеindexPathsForSelectedRows, можно получить индексные пути, идентифицирующие выбранные строки.Значение по умолчанию этого свойства
NOfalse.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
allowsSelectionDuringEditingСвойствоБулево значение, определяющее, могут ли пользователи выбрать ячейки, в то время как табличное представление находится в режиме редактирования.
Объявление
Swift
var allowsSelectionDuringEditing: BoolObjective C
@property(nonatomic) BOOL allowsSelectionDuringEditingОбсуждение
Если значение этого свойства
YEStrue, пользователи могут выбрать строки во время редактирования. Значение по умолчаниюNOfalse. Если Вы хотите ограничить выбор ячеек независимо от режима, использоватьallowsSelection.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
allowsMultipleSelectionDuringEditingСвойствоБулево значение, управляющее, могут ли пользователи выбрать больше чем одну ячейку одновременно в режиме редактирования.
Объявление
Swift
var allowsMultipleSelectionDuringEditing: BoolObjective C
@property(nonatomic) BOOL allowsMultipleSelectionDuringEditingОбсуждение
Значение по умолчанию этого свойства
NOfalse. Если Вы устанавливаете его вYEStrue, галочки появляются рядом с выбранными строками в режиме редактирования. Кроме того,UITableViewне запрашивает для редактирования стилей, когда оно входит в режим редактирования. Если Вы вызываетеindexPathsForSelectedRows, можно получить индексные пути, идентифицирующие выбранные строки.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
Начинает серию вызовов метода, вставляющих, удаляющих или выбирающих строки и разделы табличного представления.
Объявление
Swift
func beginUpdates()Objective C
- (void)beginUpdatesОбсуждение
Вызовите этот метод, если Вы хотите последующие вставки, удаление и операции выбора (например,
cellForRowAtIndexPath:иindexPathsForVisibleRows) быть анимированным одновременно. Можно также использовать этот метод, сопровождаемыйendUpdatesметод для анимации изменения в высотах строки, не перезагружая ячейку. Эта группа методов должна завершить вызовомendUpdates. Эти пары метода могут быть вложены. Если Вы не делаете вставку, удаление и вызовы выбора в этом блоке, табличные атрибуты, такие как количество строки могли бы стать недопустимыми. Вы не должны вызыватьreloadDataв группе; при вызове этого метода в группе необходимо выполнить любые анимации сами.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Завершает серию вызовов метода, вставляющих, удаляющих, выбирающих или перезагружающих строки и разделы табличного представления.
Объявление
Swift
func endUpdates()Objective C
- (void)endUpdatesОбсуждение
Вы вызываете этот метод для заключения в скобки начинающейся серии вызовов метода
beginUpdatesи это состоит из операций, чтобы вставить, удалить, выбрать и перезагрузить строки и разделы табличного представления. Когда Вы вызываетеendUpdates,UITableViewанимирует операции одновременно. ВызовыbeginUpdatesиendUpdatesможет быть вложен. Если Вы не делаете вставку, удаление и вызовы выбора в этом блоке, табличные атрибуты, такие как количество строки могут стать недопустимыми.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Вставляет строки в табличное представление в расположениях, идентифицированных массивом индексных путей, с опцией анимировать вставку.
Объявление
Swift
func insertRowsAtIndexPaths(_indexPaths: [AnyObject], withRowAnimationanimation: UITableViewRowAnimation)Objective C
- (void)insertRowsAtIndexPaths:(NSArray *)indexPathswithRowAnimation:(UITableViewRowAnimation)animationПараметры
indexPathsМассив
NSIndexPathобъекты, каждый представляющий индекс строки и индекс раздела, вместе идентифицирующие строку в табличном представлении.animationКонстанта, или указывающая вид анимации для выполнения при вставке ячейки или не запрашивающая анимации. Посмотрите Анимацию Вставки и Удаления Ячейки таблицы для описаний констант.
Обсуждение
UITableViewвызывает соответствующего делегата и методы источника данных сразу позже для получения ячеек и другого содержания для видимых ячеек.Этот метод когда, когда вызывается в блоке анимации, определенном
beginUpdatesиendUpdatesметоды,UITableViewзадерживает любые вставки строк или разделов, пока это не обработало удаления строк или разделов. Этот порядок сопровождается независимо от того, как упорядочиваются вставка и вызовы метода удаления. Это непохоже на вставку или удаление элемента в непостоянном массиве, в котором работа может влиять на индекс массива, используемый для последовательной вставки или работы удаления. Для больше на этом предмете, посмотрите Пакетную Вставку, Удаление и Перезагрузку строк и Разделов в Руководстве по программированию Табличного представления для iOS.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Удаляет строки, указанные массивом индексных путей, с опцией анимировать удаление.
Объявление
Swift
func deleteRowsAtIndexPaths(_indexPaths: [AnyObject], withRowAnimationanimation: UITableViewRowAnimation)Objective C
- (void)deleteRowsAtIndexPaths:(NSArray *)indexPathswithRowAnimation:(UITableViewRowAnimation)animationПараметры
indexPathsМассив
NSIndexPathобъекты, идентифицирующие строки для удаления.animationКонстанта, указывающая, как удаление должно быть анимировано, например, постепенно исчезнуть или скользить из нижней части. Посмотрите Анимацию Вставки и Удаления Ячейки таблицы для описаний этих констант.
Обсуждение
Когда этот метод вызывают в блоке анимации, определенном
beginUpdatesиendUpdatesметоды,UITableViewзадерживает любые вставки строк или разделов, пока это не обработало удаления строк или разделов. Этот порядок сопровождается независимо, как упорядочиваются вставка и вызовы метода удаления. Это непохоже на вставку или удаление элемента в непостоянном массиве, в котором работа может влиять на индекс массива, используемый для последовательной вставки или работы удаления. Для больше на этом предмете, посмотрите Пакетную Вставку, Удаление и Перезагрузку строк и Разделов в Руководстве по программированию Табличного представления для iOS.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Перемещает строку в указанное расположение к целевому расположению.
Объявление
Swift
func moveRowAtIndexPath(_indexPath: NSIndexPath, toIndexPathnewIndexPath: NSIndexPath)Objective C
- (void)moveRowAtIndexPath:(NSIndexPath *)indexPathtoIndexPath:(NSIndexPath *)newIndexPathПараметры
indexPathИндексный путь, идентифицирующий строку для перемещения.
newIndexPathИндексный путь, идентифицирующий строку, которая является местом назначения строки в
indexPath. Существующая строка в том расположении скользит или вниз к смежной индексной позиции для создания места для него.Обсуждение
Можно объединить операции пересылки строки со вставкой строки и операциями удаления строки в a
beginUpdates–endUpdatesблок для имения всех изменений происходит вместе как единственная анимация.В отличие от вставки строки и методов удаления строки, этот метод не берет
animationпараметр. Для строк, перемещенных, перемещенная строка анимирует прямо от стартовой позиции до конечной позиции. Также в отличие от других методов, этот метод позволяет только одной строке быть перемещенной на вызов. Если Вы хотите многократные перемещенные строки, можно неоднократно вызывать этот метод в abeginUpdates–endUpdatesблок.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
Вставляет один или несколько разделов в табличное представление, с опцией анимировать вставку.
Объявление
Swift
func insertSections(_sections: NSIndexSet, withRowAnimationanimation: UITableViewRowAnimation)Objective C
- (void)insertSections:(NSIndexSet *)sectionswithRowAnimation:(UITableViewRowAnimation)animationПараметры
sectionsИндексный набор, указывающий разделы для вставки в табличное представление. Если раздел уже существует в указанном индексном расположении, он перемещен одно индексное расположение вниз.
animationКонстанта, указывающая, как вставка должна быть анимирована, например, постепенно появиться или задвигать слева. Посмотрите Анимацию Вставки и Удаления Ячейки таблицы для описаний этих констант.
Обсуждение
UITableViewвызывает соответствующего делегата и методы источника данных сразу позже для получения ячеек и другого содержания для видимых ячеек.Когда этот метод вызывают в блоке анимации, определенном
beginUpdatesиendUpdatesметоды,UITableViewзадерживает любые вставки строк или разделов, пока это не обработало удаления строк или разделов. Этот порядок сопровождается независимо от того, как упорядочиваются вставка и вызовы метода удаления. Это непохоже на вставку или удаление элемента в непостоянном массиве, в котором работа может влиять на индекс массива, используемый для последовательной вставки или работы удаления. Для больше на этом предмете, посмотрите Пакетную Вставку, Удаление и Перезагрузку строк и Разделов в Руководстве по программированию Табличного представления для iOS.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Удаляет один или несколько разделов в табличном представлении, с опцией анимировать удаление.
Объявление
Swift
func deleteSections(_sections: NSIndexSet, withRowAnimationanimation: UITableViewRowAnimation)Objective C
- (void)deleteSections:(NSIndexSet *)sectionswithRowAnimation:(UITableViewRowAnimation)animationПараметры
sectionsИндексный набор, указывающий разделы для удаления из табличного представления. Если раздел существует после указанного индексного расположения он повышен одно индексное расположение.
animationКонстанта, или указывающая вид анимации для выполнения при удалении раздела или не запрашивающая анимации. Посмотрите Анимацию Вставки и Удаления Ячейки таблицы для описаний констант.
Обсуждение
Этот метод когда, когда вызывается в блоке анимации, определенном
beginUpdatesиendUpdatesметоды,UITableViewзадерживает любые вставки строк или разделов, пока это не обработало удаления строк или разделов. Этот порядок сопровождается независимо, как упорядочиваются вставка и вызовы метода удаления. Это непохоже на вставку или удаление элемента в непостоянном массиве, в котором работа может влиять на индекс массива, используемый для последовательной вставки или работы удаления. Для больше на этом предмете, посмотрите Пакетную Вставку, Удаление и Перезагрузку строк и Разделов в Руководстве по программированию Табличного представления для iOS.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Перемещает раздел в новое расположение в табличном представлении.
Объявление
Параметры
sectionИндекс раздела для перемещения.
newSectionИндекс в табличном представлении, которое является местом назначения перемещения для раздела. Существующий раздел в том расположении скользит или вниз к смежной индексной позиции для создания места для него.
Обсуждение
Можно объединить операции пересылки раздела со вставкой раздела и операциями удаления раздела в a
beginUpdates–endUpdatesблок для имения всех изменений происходит вместе как единственная анимация.В отличие от методов удаления строки раздела вставки раздела, этот метод не берет параметр анимации. Для разделов, перемещенных, перемещенный раздел анимирует прямо от стартовой позиции до конечной позиции. Также в отличие от других методов, этот метод позволяет только одному разделу быть перемещенным на вызов. Если Вы хотите многократный перемещенный раздел, вызывайте этот метод неоднократно в a
beginUpdates–endUpdatesблок.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 5.0 и позже.
-
editingСвойствоБулево значение, определяющее, является ли табличное представление в режиме редактирования.
Объявление
Swift
var editing: BoolObjective C
@property(nonatomic, getter=isEditing) BOOL editingОбсуждение
Когда значение этого свойства
YEStrue, табличное представление находится в режиме редактирования: ячейки таблицы могли бы показать вставку или управление удалением на левой стороне каждой ячейки и управление переупорядочением на правой стороне, в зависимости от того, как сконфигурирована ячейка. (См. Ссылку класса UITableViewCell для подробных данных.) Ответвление управления заставляет табличное представление вызывать метод источника данныхtableView:commitEditingStyle:forRowAtIndexPath:. Значение по умолчаниюNOfalse.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Переключается табличное представление в и из режима редактирования.
Объявление
Swift
func setEditing(_editing: Bool, animatedanimate: Bool)Objective C
- (void)setEditing:(BOOL)editinganimated:(BOOL)animateПараметры
editingYEStrueввести режим редактирования;NOfalseоставить его. Значение по умолчаниюNOfalse.animateYEStrueанимировать переход к режиму редактирования;NOfalseсделать переход непосредственным.Обсуждение
Когда Вы вызываете этот метод со значением
editingнабор кYEStrue, табличное представление входит в режим редактирования путем вызоваsetEditing:animated:на каждом видимомUITableViewCellобъект. Вызов этого метода сeditingнабор кNOfalseвыключает режим редактирования. В режиме редактирования ячейки таблицы могли бы показать вставку или управление удалением на левой стороне каждой ячейки и управление переупорядочением на правой стороне, в зависимости от того, как сконфигурирована ячейка. (См. Ссылку класса UITableViewCell для подробных данных.) Источник данных табличного представления может выборочно исключить ячейки из режима редактирования путем реализацииtableView:canEditRowAtIndexPath:.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Перезагружает строки и разделы табличного представления.
Объявление
Swift
func reloadData()Objective C
- (void)reloadDataОбсуждение
Вызовите этот метод для перезагрузки всех данных, использующихся для построения таблицы, включая ячейки, заголовки раздела и нижние колонтитулы, индексные массивы, и т.д. Для эффективности табличное представление восстанавливает изображение только тех строк, которые видимы. Если таблица уменьшается в результате перезагрузки, это корректирует смещения. Делегат табличного представления или источник данных вызывают этот метод, когда это хочет, чтобы табличное представление полностью перезагрузило свои данные. Это нельзя вызвать в методах, вставляющих или удаляющих строки, особенно в блоке анимации, реализованном с вызовами к
beginUpdatesиendUpdates.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Перезагружает указанные строки с помощью эффекта анимации.
Объявление
Swift
func reloadRowsAtIndexPaths(_indexPaths: [AnyObject], withRowAnimationanimation: UITableViewRowAnimation)Objective C
- (void)reloadRowsAtIndexPaths:(NSArray *)indexPathswithRowAnimation:(UITableViewRowAnimation)animationПараметры
indexPathsМассив
NSIndexPathобъекты, идентифицирующие строки для перезагрузки.animationКонстанта, указывающая, как перезагрузка должна быть анимирована, например, постепенно исчезнуть или скользить из нижней части. Посмотрите Анимацию Вставки и Удаления Ячейки таблицы для описаний этих констант.
Анимация та постоянное, влияние направление, в который и старое и новое понижение строк. Например, если постоянная анимация
UITableViewRowAnimationRight, старые строки выскальзывают вправо, и новые ячейки задвигают от права.Обсуждение
Перезагрузка строки заставляет табличное представление просить у своего источника данных новую ячейку для той строки. Таблица анимирует ту новую ячейку в том, как это анимирует старую строку. Вызовите этот метод, если Вы хотите предупредить пользователя, что изменяется значение ячейки. Если, однако, уведомляя пользователя не важно — т.е. Вы просто хотите изменить значение, которое выводит на экран ячейка — можно получить ячейку для определенной строки и установить ее новое значение.
Когда этот метод вызывают в блоке анимации, определенном
beginUpdatesиendUpdatesметоды, это ведет себя так же кdeleteRowsAtIndexPaths:withRowAnimation:. Индексы этоUITableViewпередачи в метод указаны в состоянии табличного представления до любых обновлений. Это происходит независимо от упорядочивания вставки, удаления и перезагрузки вызовов метода в блоке анимации.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 3.0 и позже.
-
Перезагружает указанные разделы с помощью данного эффекта анимации.
Объявление
Swift
func reloadSections(_sections: NSIndexSet, withRowAnimationanimation: UITableViewRowAnimation)Objective C
- (void)reloadSections:(NSIndexSet *)sectionswithRowAnimation:(UITableViewRowAnimation)animationПараметры
sectionsИндексный набор, идентифицирующий разделы для перезагрузки.
animationКонстанта, указывающая, как перезагрузка должна быть анимирована, например, постепенно исчезнуть или скользить из нижней части. Посмотрите Анимацию Вставки и Удаления Ячейки таблицы для описаний этих констант.
Анимация та постоянное, влияние направление, в который и старое и новое понижение строк раздела. Например, если постоянная анимация
UITableViewRowAnimationRight, старые строки выскальзывают вправо, и новые ячейки задвигают от права.Обсуждение
Вызов этого метода заставляет табличное представление просить у своего источника данных новые ячейки для указанных разделов. Табличное представление анимирует вставку новых ячеек в том, как это анимирует старые ячейки. Вызовите этот метод, если Вы хотите предупредить пользователя, что изменяются значения определяемых разделов. Если, однако, Вы просто хотите изменить значения в ячейках указанных разделов, не предупреждая пользователя, можно получить те ячейки и непосредственно установить их новые значения.
Когда этот метод вызывают в блоке анимации, определенном
beginUpdatesиendUpdatesметоды, это ведет себя так же кdeleteSections:withRowAnimation:. Индексы этоUITableViewпередачи в метод указаны в состоянии табличного представления до любых обновлений. Это происходит независимо от упорядочивания вставки, удаления и перезагрузки вызовов метода в блоке анимации.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 3.0 и позже.
См. также
-
Перезагружает элементы в индексной панели вдоль правой стороны табличного представления.
Объявление
Swift
func reloadSectionIndexTitles()Objective C
- (void)reloadSectionIndexTitlesОбсуждение
Этот метод дает Вам способ обновить индекс раздела после вставки или удаления разделов, не имея необходимость перезагружать целую таблицу.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 3.0 и позже.
См. также
sectionIndexTitlesForTableView:(UITableViewDataSource)
-
Возвращает область получения для указанного раздела табличного представления.
Объявление
Параметры
sectionИндекс, идентифицирующий раздел табличного представления. Табличные представления стандартного стиля всегда имеют индекс раздела нуля.
Возвращаемое значение
Прямоугольник, определяющий область, в которой табличное представление рисует раздел.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает область получения для строки, идентифицированной индексным путем.
Объявление
Swift
func rectForRowAtIndexPath(_indexPath: NSIndexPath) -> CGRectObjective C
- (CGRect)rectForRowAtIndexPath:(NSIndexPath *)indexPathПараметры
indexPathИндексный объект контуров, идентифицирующий строку ее индексом и ее индексом раздела.
Возвращаемое значение
Прямоугольник, определяющий область, в которой табличное представление рисует строку или
CGRectZeroеслиindexPathнедопустимо.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает область получения для нижнего колонтитула указанного раздела.
Объявление
Параметры
sectionИндекс, идентифицирующий раздел табличного представления. Табличные представления стандартного стиля всегда имеют индекс раздела нуля.
Возвращаемое значение
Прямоугольник, определяющий область, в которой табличное представление рисует нижний колонтитул раздела.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает область получения для заголовка указанного раздела.
Объявление
Параметры
sectionИндекс, идентифицирующий раздел табличного представления. Табличные представления стандартного стиля всегда имеют индекс раздела нуля.
Возвращаемое значение
Прямоугольник, определяющий область, в которой табличное представление рисует заголовок раздела.
Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
dataSourceСвойствоОбъект, действующий как источник данных табличного представления.
Объявление
Swift
unowned(unsafe) var dataSource: UITableViewDataSource?Objective C
@property(nonatomic, assign) id< UITableViewDataSource > dataSourceОбсуждение
Источник данных должен принять
UITableViewDataSourceпротокол. Источник данных не сохраняется.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
delegateСвойствоОбъект, действующий как делегат табличного представления.
Объявление
Swift
unowned(unsafe) var delegate: UITableViewDelegate?Objective C
@property(nonatomic, assign) id< UITableViewDelegate > delegateОбсуждение
Делегат должен принять
UITableViewDelegateпротокол. Делегат не сохраняется.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
См. также
-
sectionIndexMinimumDisplayRowCountСвойствоЧисло строк таблицы, в которых можно вывести на экран индексный список на правом краю таблицы.
Объявление
Swift
var sectionIndexMinimumDisplayRowCount: IntObjective C
@property(nonatomic) NSInteger sectionIndexMinimumDisplayRowCountОбсуждение
Это свойство применимо только к табличным представлениям в
UITableViewStylePlainстиль. Значение по умолчанию является нулем.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
sectionIndexColorСвойствоЦвет для использования для текста указателя табличного представления.
Объявление
Swift
var sectionIndexColor: UIColor?Objective C
@property(nonatomic, retain) UIColor *sectionIndexColorОбсуждение
Табличные представления могут вывести на экран индекс вдоль стороны представления, упрощающего для пользователей перемещаться по содержанию таблицы быстро. Это свойство указывает цвет для использования для текста, выведенного на экран в этой области. Значение
nilпредставляет цвет по умолчанию.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
sectionIndexBackgroundColorСвойствоЦвет для использования для фона раздела табличного представления индексирует, не будучи затронутым.
Объявление
Swift
var sectionIndexBackgroundColor: UIColor?Objective C
@property(nonatomic, retain) UIColor *sectionIndexBackgroundColorОбсуждение
Табличные представления могут вывести на экран индекс вдоль стороны представления, упрощающего для пользователей перемещаться по содержанию таблицы быстро. Это свойство указывает цвет для использования для фона индекса. Значение
nilпредставляет цвет по умолчанию.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 7.0 и позже.
-
sectionIndexTrackingBackgroundColorСвойствоЦвет для использования для индексной фоновой области табличного представления.
Объявление
Swift
var sectionIndexTrackingBackgroundColor: UIColor?Objective C
@property(nonatomic, retain) UIColor *sectionIndexTrackingBackgroundColorОбсуждение
Табличные представления могут вывести на экран индекс вдоль стороны представления, упрощающего для пользователей перемещаться по содержанию таблицы быстро. Это свойство указывает цвет для отображения в фоновом режиме индекса, когда пользователь перетаскивает палец через него. Значение
nilпредставляет цвет по умолчанию.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 6.0 и позже.
-
Стиль табличного представления.
Объявление
Swift
enum UITableViewStyle : Int { case Plain case Grouped }Objective C
typedef enum { UITableViewStylePlain, UITableViewStyleGrouped } UITableViewStyle;Константы
-
PlainUITableViewStylePlainПростое табличное представление. Когда табличное представление прокручивается, любые заголовки раздела или нижние колонтитулы выведены на экран как встроенные разделители и плавание.
Доступный в iOS 2.0 и позже.
-
GroupedUITableViewStyleGroupedТабличное представление, разделы которого представляют отличные группы строк. Заголовки раздела и нижние колонтитулы не плавают.
Доступный в iOS 2.0 и позже.
Обсуждение
Вы устанавливаете стиль таблицы при инициализации табличного представления (см.
initWithFrame:style:). Вы не можете изменить стиль после того.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
-
Позиция в табличном представлении (вершина, середина, нижняя часть), до которого прокручивается данная строка.
Объявление
Swift
enum UITableViewScrollPosition : Int { case None case Top case Middle case Bottom }Objective C
typedef enum { UITableViewScrollPositionNone, UITableViewScrollPositionTop, UITableViewScrollPositionMiddle, UITableViewScrollPositionBottom } UITableViewScrollPosition;Константы
-
NoneUITableViewScrollPositionNoneТабличное представление прокручивает строку интереса быть полностью видимым с минимумом перемещения. Если строка уже полностью видима, никакая прокрутка не происходит. Например, если строка выше видимой области, поведение идентично указанному
UITableViewScrollPositionTop. Это - значение по умолчанию.Доступный в iOS 2.0 и позже.
-
TopUITableViewScrollPositionTopТабличное представление прокручивает строку интереса для вершины видимого табличного представления.
Доступный в iOS 2.0 и позже.
-
MiddleUITableViewScrollPositionMiddleТабличное представление прокручивает строку интереса для середины видимого табличного представления.
Доступный в iOS 2.0 и позже.
-
BottomUITableViewScrollPositionBottomТабличное представление прокручивает строку интереса для нижней части видимого табличного представления.
Доступный в iOS 2.0 и позже.
Обсуждение
Вы устанавливаете позицию прокрутки через параметр
selectRowAtIndexPath:animated:scrollPosition:,scrollToNearestSelectedRowAtScrollPosition:animated:,cellForRowAtIndexPath:, иindexPathForSelectedRowметоды.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
-
Тип анимации, когда строки вставлены или удалены.
Объявление
Swift
enum UITableViewRowAnimation : Int { case Fade case Right case Left case Top case Bottom case None case Middle case Automatic }Objective C
typedef enum { UITableViewRowAnimationFade, UITableViewRowAnimationRight, UITableViewRowAnimationLeft, UITableViewRowAnimationTop, UITableViewRowAnimationBottom, UITableViewRowAnimationNone, UITableViewRowAnimationMiddle, UITableViewRowAnimationAutomatic = 100 } UITableViewRowAnimation;Константы
-
FadeUITableViewRowAnimationFadeВставленная или удаленная строка или строки исчезают в или из табличного представления.
Доступный в iOS 2.0 и позже.
-
RightUITableViewRowAnimationRightВставленная строка или строки задвигают от права; удаленная строка или строки выскальзывают вправо.
Доступный в iOS 2.0 и позже.
-
LeftUITableViewRowAnimationLeftВставленная строка или строки задвигают слева; удаленная строка или строки выскальзывают налево.
Доступный в iOS 2.0 и позже.
-
TopUITableViewRowAnimationTopВставленная строка или строки задвигают от вершины; удаленная строка или строки выскальзывают к вершине.
Доступный в iOS 2.0 и позже.
-
BottomUITableViewRowAnimationBottomВставленная строка или строки задвигают от нижней части; удаленная строка или строки выскальзывают к нижней части.
Доступный в iOS 2.0 и позже.
-
NoneUITableViewRowAnimationNoneВставленные или удаленные строки используют анимации по умолчанию.
Доступный в iOS 3.0 и позже.
-
MiddleUITableViewRowAnimationMiddleТабличное представление пытается сохранить старые и новые ячейки центрируемыми в пространстве, которое они сделали или займут. Доступный в iPhone 3.2.
Доступный в iOS 3.2 и позже.
-
AutomaticUITableViewRowAnimationAutomaticТабличное представление выбирает надлежащий стиль анимации для Вас. (Представленный в iOS 5.0.)
Доступный в iOS 5.0 и позже.
Обсуждение
Вы указываете одну из этих констант как параметр
insertRowsAtIndexPaths:withRowAnimation:,insertSections:withRowAnimation:,deleteRowsAtIndexPaths:withRowAnimation:,deleteSections:withRowAnimation:,reloadRowsAtIndexPaths:withRowAnimation:, иreloadSections:withRowAnimation:методы.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
-
-
Значок запросов, который будет показан в индексе раздела табличного представления.
Объявление
Swift
let UITableViewIndexSearch: StringObjective C
UIKIT_EXTERN NSString *const UITableViewIndexSearch;Константы
-
UITableViewIndexSearchЕсли источник данных включает эту постоянную строку в массив строк, это возвращается в
sectionIndexTitlesForTableView:, индекс раздела выводит на экран значок лупы в соответствующем индексном расположении. Это расположение должно обычно быть первым заголовком в индексе.Доступный в iOS 3.0 и позже.
-
-
Значение по умолчанию для данной размерности.
Объявление
Swift
let UITableViewAutomaticDimension: CGFloatObjective C
UIKIT_EXTERN const CGFloat UITableViewAutomaticDimension;Константы
-
UITableViewAutomaticDimensionЗапросы это
UITableViewиспользуйте значение по умолчанию для данной размерности.Доступный в iOS 5.0 и позже.
Обсуждение
Вы возвращаете это значение из
UITableViewDelegateметоды, запрашивающие метрики размерности, когда Вы хотитеUITableViewвыбрать значение по умолчанию. Например, если Вы возвращаете эту константу вtableView:heightForHeaderInSection:илиtableView:heightForFooterInSection:,UITableViewиспользует высоту, соответствующую, значение возвратилось изtableView:titleForHeaderInSection:илиtableView:titleForFooterInSection:(если заголовок неnil). -
-
Отправленный, когда выбранная строка в изменениях табличного представления регистрации.
Существует нет
userInfoсловарь связался с этим уведомлением.Оператор импорта
Objective C
@import UIKit;Swift
import UIKitДоступность
Доступный в iOS 2.0 и позже.
