iOS. Приемы программирования Нахавандипур Вандад
self.helloWorldLabel.backgroundColor = [UIColor blackColor];
self.helloWorldLabel.textColor = [UIColor whiteColor];
self.helloWorldLabel.textAlignment = UITextAlignmentCenter;
/* Убеждаемся, что мы активизировали пользовательские взаимодействия;
в противном случае эта метка не будет фиксировать события нажатия. */
self.helloWorldLabel.userInteractionEnabled = YES;
/* А теперь убеждаемся, что метка отображается в виде. */
[self.view addSubview: self.helloWorldLabel];
/* Создаем распознаватель жестов панорамирования. */
self.panGestureRecognizer = [[UIPanGestureRecognizer alloc]
initWithTarget: self
action:@selector(handlePanGestures:)];
/* Для активизации распознавателя жестов панорамирования требуется
один палец. */
self.panGestureRecognizer.minimumNumberOfTouches = 1;
self.panGestureRecognizer.maximumNumberOfTouches = 1;
/* Добавляем распознаватель к виду. */
[self.helloWorldLabel addGestureRecognizer: self.panGestureRecognizer];
}
Распознаватель жестов панорамирования будет вызывать метод handlePanGestures: в качестве целевого. Этот метод описан в подразделе «Решение» данного раздела.
Обсуждение
Распознаватель UIPanGestureRecognizer, как понятно из его названия[9], способен обнаруживать жесты панорамирования. В ходе работы этот распознаватель проходит через следующие состояния:
• UIGestureRecognizerStateBegan;
• UIGestureRecognizerStateChanged;
• UIGestureRecognizerStateEnded.
Целевой метод этого распознавателя жестов можно реализовать следующим образом. Приведенный код будет непрерывно перемещать центр метки вслед за пальцем пользователя, и на протяжении этого процесса будет сообщаться о событиях GestureRecognizerStateChanged:
— (void) handlePanGestures:(UIPanGestureRecognizer*)paramSender{
if (paramSender.state!= UIGestureRecognizerStateEnded &&
paramSender.state!= UIGestureRecognizerStateFailed){
CGPoint location = [paramSender
locationInView: paramSender.view.superview];
paramSender.view.center = location;
}
}
Чтобы можно было перемещать метку вида, относящегося к контроллеру вида, нам нужно знать не положение метки, а положение пальца на виде. Поэтому мы вызываем метод locationInView: распознавателя жестов панорамирования и передаем родительский вид метки в качестве целевого.
Воспользуйтесь методом locationInView: распознавателя жестов панорамирования, чтобы найти позиции пальцев (или пальца), которые в настоящее время совершают этот жест. Чтобы найти положение нескольких пальцев, пользуйтесь методом locationOfTouch: inView:. С помощью свойств minimumNumberOfTouches и maximumNumberOfTouches класса UIPanGestureRecognizer можно одновременно регистрировать более одного панорамирующего касания. Но в примере ради простоты мы пытаемся найти положение всего одного пальца.
В состоянии UIGestureRecognizerStateEnded сообщаемые значения x и y могут быть и нечисловыми — они могут равняться NAN. Вот почему необходимо избегать использования значений, сообщаемых именно в этом конкретном состоянии.
10.4. Обнаружение жестов долгого нажатия
Постановка задачи
Необходимо обнаруживать ситуации, в которых пользователь нажимает определенный экранный элемент и удерживает палец на экране в течение некоторого периода времени.
Решение
Создайте экземпляр класса UILongPressGestureRecognizer и добавьте его к виду, в котором требуется распознавать жесты долгого нажатия. h-файл контроллера вида будет определяться следующим образом:
#import «ViewController.h»
@interface ViewController ()
@property (nonatomic, strong)
UILongPressGestureRecognizer *longPressGestureRecognizer;
@property (nonatomic, strong) UIButton *dummyButton;
@end
@implementation ViewController
Далее приведен метод экземпляра viewDidLoad, относящийся к контроллеру вида, где используется распознаватель долгих нажатий. Этот распознаватель реализован в следующем. m-файле:
— (void)viewDidLoad {
[super viewDidLoad];
self.dummyButton = [UIButton buttonWithType: UIButtonTypeRoundedRect];
self.dummyButton.frame = CGRectMake(0.0f,
0.0f,
72.0f,
37.0f);
self.dummyButton.center = self.view.center;
[self.view addSubview: self.dummyButton];
/* Сначала создаем распознаватель жестов. */
self.longPressGestureRecognizer =
[[UILongPressGestureRecognizer alloc]
initWithTarget: self
action:@selector(handleLongPressGestures:)];
/* Количество пальцев, которые должны находиться на экране. */
self.longPressGestureRecognizer.numberOfTouchesRequired = 2;
/* Допускается движение не более чем на 100 точек,
прежде чем жест будет распознан. */
self.longPressGestureRecognizer.allowableMovement = 100.0f;
/* Пользователь должен прижать к экрану два пальца
(numberOfTouchesRequired) как минимум на секунду, чтобы жест
был распознан. */
self.longPressGestureRecognizer.minimumPressDuration = 1.0;
/* Добавляем этот распознаватель жестов к виду. */
[self.view addGestureRecognizer: self.longPressGestureRecognizer];
}
Если распознаватель долгих нажатий инициирует события, отправляемые объекту-получателю, а пользователь продолжает совершать такой жест и в этой ситуации поступает входящий звонок либо наступает какое-то иное прерывание, то распознаватель жестов перейдет в состояние UIGestureRecognizerStateCancelled. Объекту-получателю не будет поступать никакой информации от распознавателя жестов до тех пор, пока пользователь снова не совершит всю последовательность действий, требуемых, чтобы возобновился процесс распознавания. В данном примере распознавание возобновится после удержания хотя бы двух пальцев на виде в контроллере вида, и нажатие должно длиться не менее 1 секунды.
Код работает в контроллере вида со свойством longPressGestureRecognizer типа UILongPressGestureRecognizer. Этот аспект подробнее рассмотрен в подразделе «Решение» данного раздела.
Обсуждение
В составе iOS SDK есть класс для распознавания долгих нажатий, который называется UILongTapGestureRecognizer. Жест долгого нажатия инициируется, когда пользователь нажимает одним или несколькими пальцами (количество пальцев в данном случае задает программист) вид UIView и удерживает палец (или пальцы) в этой точке на протяжении определенного количества секунд. Учитывайте, что долгие нажатия — это непрерывные события.
На работу распознавателя жестов долгих нажатий влияют четыре важных свойства:
• numberOfTapsRequired — это количество нажатий целевого вида, которые пользователь должен совершить, прежде чем может быть инициирован жест долгого нажатия. Не забывайте, что нажать — это не просто прикоснуться пальцем к экрану. Нажатие — это движение, при котором палец сначала прижимается к экрану, а потом отрывается от него. По умолчанию это свойство имеет значение 0;
• numberOfTouchesRequired — в этом свойстве указывается количество пальцев, которые должны оказаться на экране, прежде чем начнется распознавание жеста. Если свойство numberOfTapsRequired имеет значение больше 0, то для обнаружения нажатий нужно указать аналогичное количество пальцев;
• allowableMovement — это максимальное количество пикселов, на которое можно продвинуть палец на экране, прежде чем распознавание жеста будет прекращено;
• minimumPressDuration — данное свойство указывает, как долго (в секундах) пользователь должен прижимать пальцы к экрану, прежде чем будет обнаружен жест.
В нашем примере для перечисленных свойств заданы следующие значения:
• numberOfTapsRequired — Default (это значение мы не меняем);
• numberOfTouchesRequired — 2;
• allowableMovement — 100;
• minimumPressDuration — 1.
При таких значениях жест долгого нажатия будет распознан, только если пользователь нажмет экран двумя пальцами и задержит пальцы на экране в течение 1 секунды (minimumPressDuration), причем перемещать пальцы от места касания он может не более чем на 100 пикселов (allowableMovement).
Теперь, когда жест распознан, он вызовет метод handleLongPressGestures:, который можно реализовать следующим образом:
— (void) handleLongPressGestures:
(UILongPressGestureRecognizer *)paramSender{
/* Здесь мы хотим найти среднюю точку между двумя пальцами,
инициировавшими жест долгого нажатия, который требуется распознать.
Мы сконфигурировали это число, воспользовавшись свойством
numberOfTouchesRequired класса UILongPressGestureRecognizer,
инстанцированного в методе экземпляра viewDidLoad данного контроллера
вида. Если выяснится, что другой распознаватель долгих нажатий
использует данный метод в качестве целевого, мы это проигнорируем. */
if (paramSender.numberOfTouchesRequired == 2){
CGPoint touchPoint1 =
[paramSender locationOfTouch:0
inView: paramSender.view];
CGPoint touchPoint2 =
[paramSender locationOfTouch:1
inView: paramSender.view];
CGFloat midPointX = (touchPoint1.x + touchPoint2.x) / 2.0f;
CGFloat midPointY = (touchPoint1.y + touchPoint2.y) / 2.0f;
CGPoint midPoint = CGPointMake(midPointX, midPointY);
self.dummyButton.center = midPoint;
} else {
/* Это распознаватель долгих нажатий, которые совершаются
более или менее чем двумя пальцами. */
}
}
}
В качестве примера программы для iOS, в которой используются долгие нажатия, можно назвать приложение Maps (Карты). Просматривая в этой программе разные места, нажмите пальцем определенную точку на карте и ненадолго задержите палец. В этой точке появится маркер.
10.5. Обнаружение жестов-нажатий
Постановка задачи
Необходимо фиксировать, когда пользователь нажимает экранный вид в той или иной точке.
Решение
Создайте экземпляр класса UITapGestureRecognizer и добавьте его к целевому виду с помощью метода экземпляра addGestureRecognizer:, относящегося к классу UIView. Рассмотрим определение контроллера вида (.h-файл):
#import «ViewController.h»
@interface ViewController ()
@property (nonatomic, strong)
UITapGestureRecognizer *tapGestureRecognizer;
@end
@implementation ViewController
Реализация метода экземпляра viewDidLoad контроллера вида такова:
— (void)viewDidLoad {
[super viewDidLoad];
/* Создаем распознаватель жестов-нажатий. */
self.tapGestureRecognizer = [[UITapGestureRecognizer alloc]
initWithTarget: self
action:@selector(handleTaps:)];
/* Количество пальцев, которые должны находиться на экране. */
self.tapGestureRecognizer.numberOfTouchesRequired = 2;
/* Общее количество касаний, которое должно быть выполнено, прежде
чем жест будет распознан. */
self.tapGestureRecognizer.numberOfTapsRequired = 3;
/* Добавляем к виду этот распознаватель жестов. */
[self.view addGestureRecognizer: self.tapGestureRecognizer];
}
Обсуждение
Распознаватель жестов-нажатий лучше всех остальных распознавателей подходит для обнаружения обычных нажатий (толчков) на экран. Нажатие — это событие, происходящее, когда пользователь касается пальцем какой-то точки экрана, а потом отрывает палец от него. Жест нажатия является дискретным.
Метод locationInView: класса UITapGestureRecognizer можно применять для обнаружения точки, в которой произошло событие нажатия. Если для регистрации нажатия требуется более одного касания, то можно вызвать метод locationOfTouch: inView: класса UITapGestureRecognizer, определяющий точки отдельных касаний. В коде мы задали для свойства numberOfTouchesRequired распознавателя жестов-нажатий значение 2. При таком значении распознавателю жестов необходимо, чтобы в момент каждого нажатия на экране находились два пальца. Количество нажатий, требуемое, чтобы жесты-нажатия стали распознаваться, определено как 3. Я сделал это с помощью свойства numberOfTapsRequired. Я указал метод handleTaps: в качестве целевого метода распознавателя жестов-нажатий:
— (void) handleTaps:(UITapGestureRecognizer*)paramSender{
NSUInteger touchCounter = 0;
for (touchCounter = 0;
touchCounter < paramSender.numberOfTouchesRequired;
touchCounter++){
CGPoint touchPoint =
[paramSender locationOfTouch: touchCounter
inView: paramSender.view];
NSLog(@"Touch #%lu: %@",
(unsigned long)touchCounter+1,
NSStringFromCGPoint(touchPoint));
}
}
В этом коде мы дожидаемся, пока произойдет такое количество нажатий, которое требуется, чтобы распознаватель жестов-нажатий начал работу. Беря за основу это количество, мы узнаем точку, в которой было сделано каждое нажатие. В зависимости от того, работаете ли вы с реальным устройством или с симулятором, в окне консоли будут выведены примерно такие результаты:
Touch #1: {107, 186}
Touch #2: {213, 254}
При работе с симулятором можно имитировать два одновременных нажатия, удерживая клавишу Option и передвигая указатель мыши по экрану симулятора. На экране появятся две концентрические точки касания.
Кроме того, необходимо упомянуть о методе NSStringFromCGPoint, который, как понятно из его названия[10], может преобразовать структуру CGPoint в строку NSString. Эта функция применяется для превращения CGPoint каждого прикосновения к экрану в NSString, а данную строку мы уже можем записать в окне консоли, воспользовавшись NSLog. Чтобы открыть окно консоли, выполните Run — Console (Запустить— Консоль).
10.6. Обнаружение щипка
Постановка задачи
Необходимо предоставить пользователю возможность выполнять движения щипка.
Решение
Создайте экземпляр класса UIPinchGestureRecognizer и добавьте его к вашему целевому виду, воспользовавшись методом экземпляра addGestureRecognizer:, относящимся к классу UIView:
— (void)viewDidLoad {
[super viewDidLoad];
CGRect labelRect = CGRectMake(0.0f, /* X */
0.0f, /* Y */
200.0f, /* Ширина */
200.0f); /* Высота */
self.myBlackLabel = [[UILabel alloc] initWithFrame: labelRect];
self.myBlackLabel.center = self.view.center;
self.myBlackLabel.backgroundColor = [UIColor blackColor];
/* Без этой строки распознаватель щипков работать не будет. */
self.myBlackLabel.userInteractionEnabled = YES;
[self.view addSubview: self.myBlackLabel];
/* Создаем распознаватель щипков. */
self.pinchGestureRecognizer = [[UIPinchGestureRecognizer alloc]
initWithTarget: self
action:@selector(handlePinches:)];
/* Добавляем этот распознаватель жестов к виду. */
[self.myBlackLabel
addGestureRecognizer: self.pinchGestureRecognizer];
}
Контроллер вида определяется так:
#import «ViewController.h»
@interface ViewController ()
@property (nonatomic, strong)
UIPinchGestureRecognizer *pinchGestureRecognizer;
@property (nonatomic, strong) UILabel *myBlackLabel;
@property (nonatomic, unsafe_unretained) CGFloat currentScale;
@end
Обсуждение