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:
сообщение (с первым параметром YES
true
), табличное представление вводит в режим редактирования, где это показывает редактирование или переупорядочение средств управления каждой видимой строки, в зависимости от editingStyle
из каждого связался UITableViewCell
. Щелчок по вставке или управлению удалением заставляет источник данных получать a tableView:commitEditingStyle:forRowAtIndexPath:
сообщение. Вы фиксируете удаление или вставку путем вызова deleteRowsAtIndexPaths:withRowAnimation:
или insertRowsAtIndexPaths:withRowAnimation:
, как надлежащий. Также в режиме редактирования, если ячейка табличного представления имеет showsReorderControl
набор свойств к YES
true
, источник данных получает 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(frame
frame
: CGRect, stylestyle
: UITableViewStyle)Objective C
- (instancetype)initWithFrame:(CGRect)
frame
style:(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: UITableViewCellSeparatorStyle
Objective 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: UIEdgeInsets
Objective 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)
cellClass
forCellReuseIdentifier:(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 *)
identifier
forIndexPath:(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)
aClass
forHeaderFooterViewReuseIdentifier:(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: CGFloat
Objective C
@property(nonatomic) CGFloat sectionHeaderHeight
Обсуждение
Это неотрицательное значение используется, только если делегат не реализует
tableView:heightForHeaderInSection:
метод.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
sectionFooterHeight
СвойствоВысота нижних колонтитулов раздела в табличном представлении.
Объявление
Swift
var sectionFooterHeight: CGFloat
Objective 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: CGFloat
Objective C
@property(nonatomic) CGFloat estimatedRowHeight
Обсуждение
Обеспечение неотрицательной оценки высоты строк может улучшить производительность загрузки табличного представления. Если таблица содержит переменные строки высоты, могло бы быть дорого вычислить все их высоты, когда загружается таблица. Используя оценку позволяет Вам задерживать часть стоимости геометрического вычисления со времени загрузки к прокрутке времени.
Значение по умолчанию
0
, что означает, что нет никакой оценки.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 7.0 и позже.
-
estimatedSectionHeaderHeight
СвойствоПредполагаемая высота заголовков раздела в табличном представлении.
Объявление
Swift
var estimatedSectionHeaderHeight: CGFloat
Objective C
@property(nonatomic) CGFloat estimatedSectionHeaderHeight
Обсуждение
Обеспечение неотрицательной оценки высоты заголовков раздела может улучшить производительность загрузки табличного представления. Если таблица содержит переменные заголовки раздела высоты, могло бы быть дорого вычислить все их высоты, когда загружается таблица. Используя оценку позволяет Вам задерживать часть стоимости геометрического вычисления со времени загрузки к прокрутке времени.
Значение по умолчанию
0
, что означает, что нет никакой оценки.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 7.0 и позже.
-
estimatedSectionFooterHeight
СвойствоПредполагаемая высота нижних колонтитулов раздела в табличном представлении.
Объявление
Swift
var estimatedSectionFooterHeight: CGFloat
Objective 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 *)
indexPath
atScrollPosition:(UITableViewScrollPosition)scrollPosition
animated:(BOOL)animated
Параметры
indexPath
Индексный путь, идентифицирующий строку в табличном представлении его индексом строки и его индексом раздела.
NSNotFound
допустимый индекс строки для прокрутки к разделу с нулевыми строками.scrollPosition
Константа, идентифицирующая относительную позицию в табличном представлении (вершина, середина, нижняя часть) для
row
когда заканчивается прокрутка. Посмотрите Позицию Прокрутки Табличного представления для описаний допустимых констант.animated
YES
true
если Вы хотите анимировать изменение в позиции;NO
false
если это должно быть непосредственно.Обсуждение
Вызов этого метода не заставляет делегата получать 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)
scrollPosition
animated:(BOOL)animated
Параметры
scrollPosition
Константа, идентифицирующая относительную позицию в табличном представлении (вершина, середина, нижняя часть) для строки, когда заканчивается прокрутка. Посмотрите Позицию Прокрутки Табличного представления для описания допустимых констант.
animated
YES
true
если Вы хотите анимировать изменение в позиции;NO
false
если это должно быть непосредственно.Оператор импорта
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 *)
indexPath
animated:(BOOL)animated
scrollPosition:(UITableViewScrollPosition)scrollPosition
Параметры
indexPath
Индексный путь, идентифицирующий строку в табличном представлении.
animated
YES
true
если Вы хотите анимировать выбор и какое-либо изменение в позиции;NO
false
если изменение должно быть непосредственным.scrollPosition
Константа, идентифицирующая относительную позицию в табличном представлении (вершина, середина, нижняя часть) для строки, когда заканчивается прокрутка. Посмотрите Позицию Прокрутки Табличного представления для описаний допустимых констант.
Обсуждение
Вызов этого метода не заставляет делегата получать a
tableView:willSelectRowAtIndexPath:
илиtableView:didSelectRowAtIndexPath:
сообщение, и при этом это не отправляетUITableViewSelectionDidChangeNotification
уведомления наблюдателям.Специальные замечания
Передача
UITableViewScrollPositionNone
результаты ни в какой прокрутке, а не минимум, прокручивающий описанный для той константы. Для прокрутки к недавно выбранной строке с прокруткой минимума выберите строку с помощью этого метода сUITableViewScrollPositionNone
, тогда вызовитеscrollToRowAtIndexPath:atScrollPosition:animated:
сUITableViewScrollPositionNone
.NSIndexPath *rowToSelect; // assume this exists and is set properly
UITableView *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 *)
indexPath
animated:(BOOL)animated
Параметры
indexPath
Индексный путь, идентифицирующий строку в табличном представлении.
animated
YES
true
если Вы хотите анимировать отмену выбора, иNO
false
если изменение должно быть непосредственным.Обсуждение
Вызов этого метода не заставляет делегата получать a
tableView:willSelectRowAtIndexPath:
илиtableView:didSelectRowAtIndexPath:
сообщение, и при этом это не отправляетUITableViewSelectionDidChangeNotification
уведомления наблюдателям.Вызов этого метода не вызывает прокрутки к невыбранной строке.
Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
allowsSelection
СвойствоБулево значение, определяющее, могут ли пользователи выбрать строку.
Объявление
Swift
var allowsSelection: Bool
Objective C
@property(nonatomic) BOOL allowsSelection
Обсуждение
Если значение этого свойства
YES
true
(значение по умолчанию), пользователи могут выбрать строки. Если Вы устанавливаете его вNO
false
, они не могут выбрать строки. Установка этого свойства влияет на выбор ячейки только, когда табличное представление не находится в режиме редактирования. Если Вы хотите ограничить выбор ячеек в режиме редактирования, использоватьallowsSelectionDuringEditing
.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 3.0 и позже.
-
allowsMultipleSelection
СвойствоБулево значение, определяющее, могут ли пользователи выбрать больше чем одну строку за пределами режима редактирования.
Объявление
Swift
var allowsMultipleSelection: Bool
Objective C
@property(nonatomic) BOOL allowsMultipleSelection
Обсуждение
Это свойство управляет, могут ли многократные строки быть выбраны одновременно за пределами режима редактирования. Когда значение этого свойства
YES
true
, галочка помещается рядом с каждой коснувшейся строкой. Ответвление строки снова удаляет галочку. Если Вы вызываетеindexPathsForSelectedRows
, можно получить индексные пути, идентифицирующие выбранные строки.Значение по умолчанию этого свойства
NO
false
.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 5.0 и позже.
-
allowsSelectionDuringEditing
СвойствоБулево значение, определяющее, могут ли пользователи выбрать ячейки, в то время как табличное представление находится в режиме редактирования.
Объявление
Swift
var allowsSelectionDuringEditing: Bool
Objective C
@property(nonatomic) BOOL allowsSelectionDuringEditing
Обсуждение
Если значение этого свойства
YES
true
, пользователи могут выбрать строки во время редактирования. Значение по умолчаниюNO
false
. Если Вы хотите ограничить выбор ячеек независимо от режима, использоватьallowsSelection
.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 2.0 и позже.
-
allowsMultipleSelectionDuringEditing
СвойствоБулево значение, управляющее, могут ли пользователи выбрать больше чем одну ячейку одновременно в режиме редактирования.
Объявление
Swift
var allowsMultipleSelectionDuringEditing: Bool
Objective C
@property(nonatomic) BOOL allowsMultipleSelectionDuringEditing
Обсуждение
Значение по умолчанию этого свойства
NO
false
. Если Вы устанавливаете его вYES
true
, галочки появляются рядом с выбранными строками в режиме редактирования. Кроме того,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 *)
indexPaths
withRowAnimation:(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 *)
indexPaths
withRowAnimation:(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 *)
indexPath
toIndexPath:(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 *)
sections
withRowAnimation:(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 *)
sections
withRowAnimation:(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: Bool
Objective C
@property(nonatomic, getter=isEditing) BOOL editing
Обсуждение
Когда значение этого свойства
YES
true
, табличное представление находится в режиме редактирования: ячейки таблицы могли бы показать вставку или управление удалением на левой стороне каждой ячейки и управление переупорядочением на правой стороне, в зависимости от того, как сконфигурирована ячейка. (См. Ссылку класса UITableViewCell для подробных данных.) Ответвление управления заставляет табличное представление вызывать метод источника данныхtableView:commitEditingStyle:forRowAtIndexPath:
. Значение по умолчаниюNO
false
.Оператор импорта
Objective C
@import UIKit;
Swift
import UIKit
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Переключается табличное представление в и из режима редактирования.
Объявление
Swift
func setEditing(_
editing
: Bool, animatedanimate
: Bool)Objective C
- (void)setEditing:(BOOL)
editing
animated:(BOOL)animate
Параметры
editing
YES
true
ввести режим редактирования;NO
false
оставить его. Значение по умолчаниюNO
false
.animate
YES
true
анимировать переход к режиму редактирования;NO
false
сделать переход непосредственным.Обсуждение
Когда Вы вызываете этот метод со значением
editing
набор кYES
true
, табличное представление входит в режим редактирования путем вызоваsetEditing:animated:
на каждом видимомUITableViewCell
объект. Вызов этого метода сediting
набор кNO
false
выключает режим редактирования. В режиме редактирования ячейки таблицы могли бы показать вставку или управление удалением на левой стороне каждой ячейки и управление переупорядочением на правой стороне, в зависимости от того, как сконфигурирована ячейка. (См. Ссылку класса 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 *)
indexPaths
withRowAnimation:(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 *)
sections
withRowAnimation:(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: Int
Objective 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;
Константы
-
Plain
UITableViewStylePlain
Простое табличное представление. Когда табличное представление прокручивается, любые заголовки раздела или нижние колонтитулы выведены на экран как встроенные разделители и плавание.
Доступный в iOS 2.0 и позже.
-
Grouped
UITableViewStyleGrouped
Табличное представление, разделы которого представляют отличные группы строк. Заголовки раздела и нижние колонтитулы не плавают.
Доступный в 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;
Константы
-
None
UITableViewScrollPositionNone
Табличное представление прокручивает строку интереса быть полностью видимым с минимумом перемещения. Если строка уже полностью видима, никакая прокрутка не происходит. Например, если строка выше видимой области, поведение идентично указанному
UITableViewScrollPositionTop
. Это - значение по умолчанию.Доступный в iOS 2.0 и позже.
-
Top
UITableViewScrollPositionTop
Табличное представление прокручивает строку интереса для вершины видимого табличного представления.
Доступный в iOS 2.0 и позже.
-
Middle
UITableViewScrollPositionMiddle
Табличное представление прокручивает строку интереса для середины видимого табличного представления.
Доступный в iOS 2.0 и позже.
-
Bottom
UITableViewScrollPositionBottom
Табличное представление прокручивает строку интереса для нижней части видимого табличного представления.
Доступный в 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;
Константы
-
Fade
UITableViewRowAnimationFade
Вставленная или удаленная строка или строки исчезают в или из табличного представления.
Доступный в iOS 2.0 и позже.
-
Right
UITableViewRowAnimationRight
Вставленная строка или строки задвигают от права; удаленная строка или строки выскальзывают вправо.
Доступный в iOS 2.0 и позже.
-
Left
UITableViewRowAnimationLeft
Вставленная строка или строки задвигают слева; удаленная строка или строки выскальзывают налево.
Доступный в iOS 2.0 и позже.
-
Top
UITableViewRowAnimationTop
Вставленная строка или строки задвигают от вершины; удаленная строка или строки выскальзывают к вершине.
Доступный в iOS 2.0 и позже.
-
Bottom
UITableViewRowAnimationBottom
Вставленная строка или строки задвигают от нижней части; удаленная строка или строки выскальзывают к нижней части.
Доступный в iOS 2.0 и позже.
-
None
UITableViewRowAnimationNone
Вставленные или удаленные строки используют анимации по умолчанию.
Доступный в iOS 3.0 и позже.
-
Middle
UITableViewRowAnimationMiddle
Табличное представление пытается сохранить старые и новые ячейки центрируемыми в пространстве, которое они сделали или займут. Доступный в iPhone 3.2.
Доступный в iOS 3.2 и позже.
-
Automatic
UITableViewRowAnimationAutomatic
Табличное представление выбирает надлежащий стиль анимации для Вас. (Представленный в 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: String
Objective C
UIKIT_EXTERN NSString *const UITableViewIndexSearch;
Константы
-
UITableViewIndexSearch
Если источник данных включает эту постоянную строку в массив строк, это возвращается в
sectionIndexTitlesForTableView:
, индекс раздела выводит на экран значок лупы в соответствующем индексном расположении. Это расположение должно обычно быть первым заголовком в индексе.Доступный в iOS 3.0 и позже.
-
-
Значение по умолчанию для данной размерности.
Объявление
Swift
let UITableViewAutomaticDimension: CGFloat
Objective 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 и позже.