[Cocoa] 마우스 커서 감지 – NSTrackingArea

특정한 뷰에 마우스가 들어오거나 나갈 때에는 이벤트가 발생하는데, 경우에 따라서는 뷰 외부의 다른 객체가 뷰에 이러한 마우스 이벤트가 일어나는 것을 감지해야 할 필요가 있다. 예를 들면 NSView에 대해 별도의 서브 클래싱 없이 마우스 이벤트 처리를 하고 싶을 때처럼 말이다. 이럴 때는 NSTrackingArea를 만들어서 원하는 뷰에 추가해주는 것으로 서브클래싱 작업을 피할 수 있다.

NSTrackingArea

NSTrackingArea는 마우스 추적과 커서 업데이트 이벤트를 특정한 영역에서 구현해준다. 이 추적영역 객체를 생성할 때는 다음과 같은 정보가 필요하다.

1) 영역이 어디인지 (CGRect)
2) 추적 옵션은 무엇인지
3) 타겟은 누구인지 (id)
4) 또 선택적으로 추가로 던질 userInfo는 무엇인지

추적 영역이 붙는 뷰와 메시지를 받는 타겟이 동일할 필요는 없다. 이렇게 생성된 마우스 추적 영역은 뷰에 addTrackingArea: 메소드를 통해 추적영역을 추가하게 된다.

추적 옵션에 따라서, owner는  mouseEnterd:, mouseExited:, mouseMoved:, cursorUpdate: 등의 메시지를 받게 된다.

옵션 – NSTrackingAreaOption

추적옵션(NSTrackingAreaOption)은 다음과 같은 것들이 있다. 각각은 바이트 연산으로 묶어줄 수 있다.

  • NSTrackingMouseEnteredAndExited – 마우스가 들어오고 나가는 것을 감지
  • NSTrackingMouseMoved – 영역 내에서 마우스가 움직이는 것을 감지
  • NSTrackingCursorUpdated – 영역내에 마우스의 움직임을 모두 감지

또한 영역의 상태에 따라서도 추적 여부를 지정할 수 있는 옵션이 있다.

  • NSTrackingActiveWhenFirstResponder – 뷰가 First Responder일 때에만 동작
  • NSTrackingActiveInKeyWindow – 뷰가 키윈도에 있을 때만 동작
  • NSTrackingAciveInActiveApp – 활성화된 앱일 때만 동작
  • NSTrakingActiveAlways – 항상동작

그외 옵션

  • NSTrackingAssumeInside – 별로 쓰이지는 않는다. 추적영역을 벗어난 마우스 포인터가 여전히 그 뷰 안에 있다고 가정한다.
  • NSTrackingInVisibleRect – 뷰의 visibleRect에 동기화됨. 지정해준 rect 크기는 무시된다.
  • NSTrackingEnabledDuringMouseDrage – 드래깅 중간에 영역에 들어갔을 때도 추적을 활성화한다. 이 옵션이 켜지지 않으면 드래그하는 중에 이 영역을 지나갈 때에는 옵션이 활성화되지 않는다.

예제

NSTimer *fadeTimer;

-(void)awakeFramNib {
    NSTrackingArea *area = [[NSTrakingArea alloc] initWithRect:self.window.frame
        option:(NSTrakingMouseEnteredAndExited | NSTrakingActiveInAcitveApp | NSTrackingInVisibleRect)
        owner:self
        userInfo:nil];

    [self.window.contentView addTrackingArea:area];

}

-(void)mouseEnterd:(NSEvent*)event
{
    self.fadeTimer = nil;
    [[self.window animator] setAlphaValue:1.0];
}

-(void)mouseExited:(NSEvent*)event
{
    self.fadeTimer =<# 타이머를 생성 #>
}

소스코드 : http://www.box.com/s/69ded0033db0a452ddf1

[Cocoa] 코코아의 이름 규칙

코코아 프레임워크에서 이름 짓는 규칙에 익숙해지는 것은 단순히 코드의 가독성을 높일 뿐만아니라 부분적으로 키-밸류 코딩의 규칙을 따르는 것과도 관련이 있다. 애플의 이름 짓기 규칙은 특히나 약어를 거의 사용하지 않고 단어나 문장을 통째로 쓰는 경향이 있는데 이러면 메소드나 변수의 이름이 길어질 수는 있지만 그 의미를 명확히 이해할 수 있을 뿐만아니라, Xcode의 멋진 자동완성기능이 있어 그리 많은 타이핑이 필요하지도 않다. 이름 짓기가 잘 된 소스는 나중에 본인이 재사용할 때도 매우 명확하고 쉽게 접근할 수 있으며, 그 자체로 소스에 대한 주석이 될 수도 있다.

이름을 정할 때의 규칙 일반

  1. 간결하되 명확성을 해치지 않아야 한다.
  2. 군더더기를 빼라. 예를 들어 my나 object와 같은 접두어는 불필요하다.
  3. 축약형을 쓰지 마라. 축약할 때는 쉽지만 원래 의미는 나중에 아무도 알아보지 못한다.
  4. 이중적인 의미의 단어를 피하라. 예를 들어 displayText는 문자를 표시하는 메소드인가, 그냥 표시되는 텍스트의 이름을 나타내는 변수명인가?
  5. 일관성은 중요하다. 서로 다른 클래스에서 같은 이름의 메소드를 만들었다면, 이들 메소드는 같은 기능을 수행해야 한다.
  6. 접두어를 사용하는 것은 추천할만하다. 대부분의 파운데이션 클래스나 함수는 NS로 시작한다. (이는 NextSTEP에서 왔다는 의미이다.) 또한 아이폰 개발에 사용되는 UIKit에서는 UI로 시작하는 클래스들이 있다. 비슷한 기능을 하는 객체가 접두어를 통해 쓰임새나 출신을 파악할 수 있다.
  7. 클래스 이름에는 연관되는 명사가 있어야 한다. 또한 이들과 관련된 이름은 클래스 이름과 닮으면 된다. 예를 들어 UITableViewCell 은 클래스이고, 셀의 스타일을 지정하는 상수는 UITableViewCellStyleDefault 와 같은 식으로 정의되어 있다.
  8. 카테고리 이름은 클래스+카테고리 로 표현한다. 예를 들면 NSString+HTMLFormatting 과 같은 식이다. 여기서 HTML은 축약어로 들어갔지만, HTML은 널리 사용되고 있기에 허용할 수 있다. URL도 같은 맥락에서 허용한다.
  9. 델리게이트나 데이터소스 프로토콜은 이름이 곧 설명이다. UITableViewDataSource, UITableViewDelegate를 보라.
  10. 그외 프로토콜 이름은 형용사를 쓸 수 있다. 예를 들어 NSCoding 프로토콜은 NSCoder와 NSDecoder 의 두 클래스와 관련이 있음을 알 수 있다.

메소드 이름들

  1. 메소드 이름은 소문자로 시작하고, 단어 단위로 대문자를 첫 글자로 쓴다. 축약어를 쓰는 것은 명확하지 않으므로 권장하지 않는다. 또한 메소드 이름은 접두어를 쓰지 않는다.
  2. 메소드 이름을 언더스코어를 시작하는 것은 가능하나, 애플은 이를 private method로 간주하게 될 것이다.
  3. 속성을 리턴하는 메소드이름은 그 속성과 같은 이름을 쓴다. get-, calculate-와 같은 접두어를 사용하지 않는다. 이는 키-밸류 코딩 규칙과도 관련이 있으므로 중요하다.
  4. 파라미터의 이름은 그 파라미터를 설명하는 이름을 쓴다.
  5. 동사를 형용사처럼 만들지 않는다. calculationPerformed 보다는 performsCalculation이라고 한다.

델리게이트와 데이터 소스

  1. 첫번째 인자는 이 메소드를 호출하는 객체의 이름이다. 예를 들어 테이블 뷰의 데이터 소스에서 -(NSInteger)tableView:(UITableView*) numberOfRows… 와 같다. 왜냐하면 델리게이트나 데이터 소스가 되는 객체는 동시에 여러 객체의 델리게이트나, 데이터소스가 될 수 있기 때문이다.
  2. 델리게이트 메소드 이름에는 did나 will이 종종 들어갈 수 있다. 이는 어떤 작업 이전에 호출되는지, 이벤트가 일어난 이후에 호출되는지를 명시적으로 드러내는 좋은 방법이다.
  3. 델리게이트에게 어떤 ‘허가’를 요청하는 메소드는 -(BOOL)shouldCloseWindow…와 같이 should로 시작한다.

기타

  1. 상수값을 사용하는 경우 정수보다는 열거형을 선언하여 단어로 인식할 수 있도록 하라.UITableViewCellStyleDefault는 그냥 0일 뿐이지만, 이름이 붙어 훨씬 명확해진다.
  2. 전처리기가 처리하는 이름은 전체를 대문자로 사용하고 공백을 언더스코어로 대치한다. LIKE_THIS, DEFAULT_NAME_VALUE 등이 이러한 예다.
  3. 오류 이름은 접두어+고유이름+Exception으로 붙인다. NSIllegalSelectorException 이나 NSRangeException 등이 이런 이름이다.

[iOS/OSX] Timer 사용하기

특정한 시간 이후에 작업을 시행하는 타이머를 사용하는 방법에는 몇 가지 방법이 있을 수 있는데, 코코아에서 타이머는 NSTimer 객체를 통해 구현된다.

타이머와 런루프

타이머는 런루프(Run Loop)와 밀접한 관련을 맺고 있다. 타이머는 스스로 동작기한을 가지고 있고, 그 상태로 런루프에 등록된다. 런루프는 그 기한이 지나는 시점에 타이머를 지켜보고 있다가, 타이머가 실행하기로 한 액션을 지정된 객체로 보내게 된다.

런루프는 (역시나 런루프와 스레드를 혼동하는 불편한 진실 때문에 이에 대한 별도의 포스팅도 필요할 듯) 사용자의 입력 등에 적절히 반응하기 위해서 계속해서 “기다리는” 일종의 루프이다. 예를 들면 키보드는 풀링이라는 방식으로 일종의 런루프를 가지고 있다. 즉 사용자가 키보드를 누르지 않는 상황에서 키보드는 ‘최선을, 총력을 다해서’ 사용자 입력을 반복해서 기다린다. 런루프는 이와 유사하게 스레드 내에서 사용자의 UI 입력을 최선을 다해 기다린다.

타이머가 지정한 액션은 런루프에 의해서 확인된다. 타이머를 사용할 때 가장 유의해야 하는 점은 NSTimer는 실시간 타이머가 아니라는 점이다. 만약 반복되는 주기를 가진 타이머의 특정 작업이 있다고 할 때, 런루프는 단지 그 타이머만을 감시하는 것이 아니라 아주 많은 종류의 입력을 처리해야 하기 때문에 이를 놓치는 경우가 있을 수 있다. 따라서 NSTimer를 통해 이뤄지는 지연된 작업이나, 반복작업은 실제 시간과 다소 차이가 있을 수 있으며, 경우에 따라서는 “상당히 큰” 차이가 발생할 수 있다.

타이머 사용하기

스케줄된 타이머 사용하기

타이머를 사용하는 가장 일반적인 방법은 NSTImer의 scheduledTimerWithTimeInterval:target:selector:userInfo:repeats: 를 사용하는 방법이다. 이는 현재 메인 런루프에 타이머를 추가한다.

-(void)startOneOffTimer {
    [NSTimer scheduledTimerWithTimeInterval:1.0
        target:self
        selector:@selector(timerFired:)
        userInfo:[self userInfo]
        repeat:NO];
}

 

-(void)startRepeatingTimer {
    NSTimer *timer = [NSTimer scheduledTimerWithTimeInterval:0.5
        target:self selector:@selector(timerFired:)
        userInfo:[self userInfo] repeat:YES];
    self.repeatedTimer = timer;
}

타이머의 반복이 없는 경우에는 타이머가 종료된 후 해당 액션을 호출해주고 난 후 타이머는 자체적으로 해제된다. 그렇지 않은 경우에는 추후에 반복되는 타이머를 해제해주기 위해서 따로 참조점을 갖고 있어야 한다.

스케줄링 된 타이머는 생성 즉시 런루프에 추가되어 카운트다운을 시작하게 된다. 이와 별도로 특정 시점부터 동작을 시작하는 타이머는 다음과 같이 만들 수 있다.

-(void)startFireDateTimer {
    NSDate *fireDate = [NSDate dateWithTimeIntervalSinceNow:3600];
    NSTimer *timer = [[NSTimer alloc]
        initWithFireDate:fireDate
        interval:0.5
        target:self
        selector:@selector(timerFiredMethod:)
        userInfo:[self uesrInfo]
        repeat:YES];
    NSRunLoop *theRunLoop = [NSRunLoop currentRunLoop];
    [theRunLoop addTimer:timer forMode:NSDefaultRunLoopMode];
}

시작된 타이머를 멈추기

위와 같이 만들어지고 시작된 타이머는 반복되지 않는다면 종료시 호출해야 하는 액션을 호출하고, 정지된다. 하지만 아직 정해진 시간을 다 채우지 않았거나, 반복해서 실행되는 타이머는 멈출 필요도 있다. 타이머를 멈추기 위해서는 해당 타이머에 invalidate 메시지를 보내면 된다.

-(void)stopRepatedTImer
{
    [self.repeatedTimer invalidate];
    self.repeatedTimer = nil;
}

타이머를 사용하지 않은 예약된 작업 호출

타이머를 사용하지 않고도 특정한 시간 지연 후에 간단히 어떤 기능을 실행할 수 있다. 이 기능은 NSObject에 이미 정의된 메소드이다. (역시 코코아의 루트 클래스가 NSObject라는 사실은 매우 다행스럽다!) 이는 -performSelector: withObject : afterDelay: 이다. 이는 다음과 같이 사용할 수 있다.

    
[self.tableView performSelector:@selector(reloadData)
    withObject:nil
    afterDelay:10.0];

이미 예약된 작업 취소하기

NSObject의 클래스 메소드인 +cancelPreviousPerformRequestsWithTarget:selector:object:+cancelPreviousPerformRequestsWithTarget: 을 사용한다. 이는 지연 후에 일을 하게되는 객체가 이 메시지를 받고 예약된 작업을 실행하지 않게 된다.