2012년 12월 31일 월요일

[iOS6] ABAddressBook 연락처 정보 읽어 오기


iOS6에서 사용자의 Address Book에서 연락처 리스트를 읽어와서, 각 연락처를 읽어오는 방법을 정리합니다.
Address Book은 Address Book 프레임워크를 사용하고 있어서, AB라는 접두어를 사용하고 있습니다.

1.  접근 권한 체크
처음 접근을 하면, 사용자에게 접근을 허락할 것인지 입력을 받습니다. 여기서 권한을 승인하거나 거부할 수 있는데, 프로그램에서는 이 권항이 있는지부터 체크를 해야 합니다.
소스
    //접근권한체크하기.
    ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();
    if(status == kABAuthorizationStatusDenied ||
       status == kABAuthorizationStatusRestricted)
    {
        NSString *message;
        message = @"연락처에접근할수있는권한이없습니다. 
                   설정 > 개인정보보호 > 연락처에서권한을설정해주세요.";
        //NSLog(@"Location Services Disabled");
        UIAlertView* addrressBookAlert = [[UIAlertView alloc] initWithTitle:@"Error" 
                                                                    message:message 
                                                                   delegate:self 
                                                          cancelButtonTitle:@"OK"
                                                          otherButtonTitles: nil];
        [addrressBookAlert show];
    }
이 권한은 연락처 일기 등을 할 때, 체크해서 보여줘도 되고, 프로그램이 시작할 때, 체크해서 사용자에게 권한을 변경하도록 요청할 수 있습니다.
 카카오톡의 경우는 친구 리스트에 "친구이름표시문제 안내"를 표시하고, 도움말에 설정을 변경할 것을 표시합니다.
 Foursqure의 경우는 위치보기 설정을 해야 정상적으로 표시함을 정보창의 크기로 알려줍니다.


2. Address Book 열기
객체를 ABAddressBookCreateWithOption함수를 통해서 어드레스북 객체를 만든다. 객체가 NULL일 경우, 에러가 난 것으로 권한이 없는지, iOS가 지원하지 않는 버전인지 등등을 체크해야 한다.
 그리고, 접근하기 위해서 ABAddressBookRequestAccessWithCompletion을 통해서 접근 요청을 한다. 여기에서 Block이 사용되고, 접근이 grant되었는지, 에러는 없는지 Block내에서 체크해야 한다.
아래에 myAddressBook은 ABAddressBookRef 타입이다.

- (void) prepareAddressBook
{
    CFErrorRef error;
    myAddressBook = ABAddressBookCreateWithOptions(NULL, &error);
    if (myAddressBook == NULL) {
        //
        if(error == kABOperationNotPermittedByStoreError){
            NSLog(@" not permitted by store");
        }
        /*
         else if(error == kABOperationNotPermittedByUserError){
         NSLog(@" not permitted by User");
         }*/
    }
    
    TCContactManager * __weak weakSelf = self;  // avoid capturing self in the block
    ABAddressBookRequestAccessWithCompletion(myAddressBook,
                            ^(bool granted, CFErrorRef error) {
                                if (granted) {
                                    weakSelf.friendsList = [weakSelf fetchPeopleInAddressBook:myAddressBook];
                                    NSLog(@" load success: %d", [weakSelf.friendsList count]);
                                                     
                                } else {
                                    // Handle the error
                                    NSLog(@" no granted..");
                                }
                            });
}

위에서 접근이 granted된 경우 현재 생성된 ABAddressBookRef 객체를 가지고 아래와 같이 연락처를 가져온다.

3. 모든 연락처 가져오기.
address book에서 모든 사람들의 리스트를 copy해 올려면, ABAddressBookCopyArrayOfAllPeople함수를 사용하면, 내 iOS에 저장된 모든 사람들의 주소가 저장된 순서대로 가져오게 된다.
 모든 연락처가 아닌 Source에 따라서 읽어오려면 ABAddressBookCopyArrayOfAllPeopleInSource 함수를 사용하여 특정 Source에 있는 주소를 읽어 온다.
순서를 가지고 읽어 오게 하려면 ABAddressBookCopyArrayOfAllPeopleInSourceWithSortOrdering 를 사용해서 Source에서 Ordering을 두고 읽어오게 할 수 있다.
아래는 모든 사람들을 읽어오는 예제이다.

// Return a list of people in address book
- (NSMutableArray*) fetchPeopleInAddressBook:(ABAddressBookRef)addressBook
{
    NSMutableArray *list = nil;
    CFArrayRef personList = ABAddressBookCopyArrayOfAllPeople(addressBook);
    long personCount = CFArrayGetCount(personList);
    if( personCount > 0){
        NSLog(@" Person Count:%ld", personCount);
        
        if(list == nil)
        {
            list = [[NSMutableArray alloc] initWithCapacity:personCount];
        }
        for(int i = 0; i < personCount; i++)
        {
            ABRecordRef record = CFArrayGetValueAtIndex(personList, i);
            
            TCContactData* contact = [self getContactDataFrom:record];
            
            if(contact != nil && ![list containsObject:contact]){
                [list addObject:contact];
            }
            
            CFRelease(record);
        }
    }
    CFRelease(personList);
    
    return list;
}
CFArrayRef의 형태로 받아오게 되고, CFArrayGetCount로 읽어온 개수를 알 수 있다.
각 데이터는 ABRecordRef의 형태로 가져올 수 있게 되는데, 이것은 클래스의 형태가 아닌 CF 형태로 되어 있으므로 이것을 Class로 변환을 해야, 관리가 편리하게 된다.
아래에서 ABRecordRef에서 각 데이터를 읽어오는 것을 알아본다.


4. 하나의 record에서 연락처 읽어 오기.
ABRecordRef는 Address book에서 하나의 레코드를 나타내는 것으로 각 레코드의 정보를 읽어오는 함수를 제공한다. (Getting Record Information)
ABRecordGetRecordID
ABRecordID ABRecordGetRecordID (
   ABRecordRef record
);
레코드의 Unique ID를 읽어오는 함수로 현재 레코드의 ID를 읽어올 수 있습니다.

ABRecordGetRecordType
ABRecordType ABRecordGetRecordType (
   ABRecordRef record
);
위에서 각 People이 아닌, 그룹의 리스트를 가져올 수도 있고, Source의 리스트를 받아 올 수도 있어서, 현재 Record의 타입이 뭔지 알수 있어야 합니다.
kABPersonType for person records
kABGroupType for group records.
kABSourceType for source records.

그리고, 각 레코드의 값을 읽어오거나, 설정/제거 할 수 있는 함수를 제공합니다. (Managing Property Value)
ABRecordSetValue
bool ABRecordSetValue (
   ABRecordRef record,
   ABPropertyID property,
   CFTypeRef value,
   CFErrorRef *error
);

레코드에 있는 Property에 값을 설정할 수 있는 함수이다.

ABRecordCopyValue
CFTypeRef ABRecordCopyValue (
   ABRecordRef record,
   ABPropertyID property
);

레코드에 있는 값들을 읽어 오는 함수로, ABPropertyID에 따라서 값들을 읽어 온다. 이 ABPropertyID는 두가지 형태가 있는데, ABPerson과 ABGroup에 따라 다르다. 각각에 Reference에 따라서 값들이 달라지는데, ABPerson을 예를 들면, 전화번호를 보면 kABPersonPhoneProperty로 값을 읽어오면, 아래와 같이 여러가지 종류의 전화번호를 가지고 있을 수 있다.
const ABPropertyID kABPersonPhoneProperty;
const CFStringRef kABPersonPhoneMobileLabel;
const CFStringRef kABPersonPhoneIPhoneLabel;
const CFStringRef kABPersonPhoneMainLabel;
const CFStringRef kABPersonPhoneHomeFAXLabel;
const CFStringRef kABPersonPhoneWorkFAXLabel;
const CFStringRef kABPersonPhoneOtherFAXLabel;
const CFStringRef kABPersonPhonePagerLabel;
그래서, kABPersonPhoneProperty로 읽으면 ABMultiValueRef 형태로 받아오고, 거기에서 위에 값들이 있는지 ABMultiValueCopyLabelAtIndex를 통해서 읽어 올 수 있다. 좀 복잡한데 아래 함수 설명 이후 전화번호 읽는 것을 예제로 보이도록 하겠다.

ABRecordRemoveValue
bool ABRecordRemoveValue (
   ABRecordRef record,
   ABPropertyID property,
   CFErrorRef *error
);

레코드에서 해당 값을 삭제하는 함수로 해당 ABPropertyID를 가지는 모든 Value를 삭제하게 된다.

ABRecordCopyCompositeName
CFStringRef ABRecordCopyCompositeName (
   ABRecordRef record
);

레코드에서 이름을 읽어 오는데, First, middle, last name을 각각 붙여서 읽어 오는 함수이다. Apple Documentation에는 "Returns an appropriate, human-friendly name for the record."라고 되어 있다.

아래 예제는 현재 ABRecordRef에서 전화번호가 있는지 살펴보고, 전화번호가 있으면, 이름과 이미지를 읽어서 TCContactData라는 클래스에 넣고 리턴하는 함수이다.

- (TCContactData*) getContactDataFrom:(ABRecordRef)record
{
    
    ABMultiValueRef phoneRef = ABRecordCopyValue(record, kABPersonPhoneProperty);
    NSString* phoneNumber = nil;
    int phoneRefCount = ABMultiValueGetCount(phoneRef);
    for( int j = 0; j < phoneRefCount; j++)
    {
        CFStringRef labelRef = ABMultiValueCopyLabelAtIndex(phoneRef, j);
        if( CFStringCompare(labelRef, kABPersonPhoneMobileLabel, 0) == kCFCompareEqualTo){
            phoneNumber = (__bridge NSString*)ABMultiValueCopyValueAtIndex(phoneRef, j);
            break;
        }else if( CFStringCompare(labelRef, kABPersonPhoneIPhoneLabel, 0) == kCFCompareEqualTo){
            phoneNumber = (__bridge NSString*)ABMultiValueCopyValueAtIndex(phoneRef, j);
            break;
        }
        /*else if( CFStringCompare(labelRef, kABPersonPhoneMainLabel, 0) == kCFCompareEqualTo){
         contact.phoneNumber = (__bridge NSString*)ABMultiValueCopyValueAtIndex(phoneRef, j);
         break;
         }*/
        CFRelease(labelRef);
    }
    if(phoneNumber){
        TCContactData* contact = [[TCContactData alloc] init];
        
        contact.name      = (__bridge NSString*)ABRecordCopyCompositeName(record);
        contact.firstName = (__bridge NSString*)ABRecordCopyValue(record, kABPersonFirstNameProperty);
        contact.lastName  = (__bridge NSString*)ABRecordCopyValue(record, kABPersonLastNameProperty);
        contact.phoneNumber = phoneNumber;
        
        CFDataRef thumbnail = ABPersonCopyImageDataWithFormat(record, kABPersonImageFormatThumbnail);
        if(thumbnail != nil)
        {
            contact.image = [[UIImage alloc] initWithData:(__bridge NSData*)thumbnail];
            NSLog(@" Name:%@ has image.", contact.name);
            CFRelease(thumbnail);
        }
        return contact;
    }
    
    CFRelease(phoneRef);
    return nil;
} 

위 함수에서 처럼 현재 레코드에서  Person Info Property, Address Property, Date Property, Person Type Property, Phone Number Property, Instant Messaging Keys, Instant Messaging Services, Social Profile Keys, Social Profile Services, URL Property, Related Name Property, Generic Property Labels 등의 정보를 읽어 올 수 있다.

한국과 맞지 않는 체계도 있지만, 전세계적으로 맞출수 있도록 되어 있습니다.
해외 서비스를 위해서는 많은 데이터를 보고, 그 나라 사람들이 사용하는 데이터가 되도록 조합해서 사용해야 되겠습니다.

2012년 마지막 포스팅이 되겠네요.
새해 복 많이 받으세요~
.

2012년 12월 23일 일요일

[iOS6] UIImagePickerController 사용하기

사용자가 iOS Device에서 사진을 찍고, 그 이미지를 선택하거나, 사용자의 Photo Library에서 이미지를 선택하는 기능을 UIImagePickerController를 사용해서 구현할 수 있다.

사진을 찍을 수도 있고, Photo Library에서 선택을 할 수 있는데, 현재의 iOS가 지원을 하는지 확인이 필요하다. iPad 2부터는 기본적으로 카메라가 있으므로 구분할 필요가 없겠지만....

소스
    Boolean cameraEnabled = NO;
    Boolean photoLibEnabled = NO;
    if( [UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypeCamera]){
        cameraEnabled = YES;
    }
    if( [UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypePhotoLibrary]){
        photoLibEnabled = YES;
    }

카메라 촬영이 가능한지, 포토 라이브러리를 접근하는 것이 가능한지를 알 수 있는 함수가 위 2가지 함수이다.
 이 정보를 가지고, ActionSheet를 통해서 새로 찍을 것인지, 기존 것을 선택할 것인지 선택하게 하고, 사진을 찍을 경우와 선택할 경우를 따로  구분해서 UIImagePickerController를 만든다.

소스

카메라를 사용할 수 있고, 지원하는 타입에 이미지 형식이 있을 경우..
    NSArray *mediaTypes = [UIImagePickerController availableMediaTypesForSourceType:
                                            UIImagePickerControllerSourceTypeCamera];
    if ([mediaTypes containsObject:(NSString *)kUTTypeImage]) {
        UIImagePickerController *picker = [[UIImagePickerController alloc] init];
        picker.delegate = self;
        picker.sourceType = UIImagePickerControllerSourceTypeCamera;
        picker.mediaTypes = [NSArray arrayWithObject:(NSString *)kUTTypeImage];
        picker.allowsEditing = NO;
        [self presentViewController:picker animated:YES completion:^{
            NSLog(@"presentViewController completion");
        }];
    }
포토 라이브러리를 사용할 수 있고, 지원하는 타입에 이미지가 있을 경우..
    NSArray *mediaTypes = [UIImagePickerController availableMediaTypesForSourceType:
                                      UIImagePickerControllerSourceTypePhotoLibrary];
    if ([mediaTypes containsObject:(NSString *)kUTTypeImage]) {
        UIImagePickerController *picker = [[UIImagePickerController alloc] init];
        picker.delegate = self;
        picker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary;
        picker.mediaTypes = [NSArray arrayWithObject:(NSString *)kUTTypeImage];
        picker.allowsEditing = NO;
        [self presentViewController:picker animated:YES completion:^{
            NSLog(@"presentViewController completion");
        }];
    }
아래는 이미지를 선택하거나 사진을 찍은 후에, UIImagePickerControllerDelegate로 받는 함수들이다. dismissImagePicker, Cancel, didFinishPickingMediaWithInfo함수가 있다.
- (void)dismissImagePicker
{
    [self dismissViewControllerAnimated:YES completion:^{
        NSLog(@"dismissViewControllerAnimated completion: ");
    }];
}

- (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker
{
    [self dismissImagePicker];
}

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info
{
    //Editing된 이미지를 가져온다.
    UIImage *image = [info objectForKey:UIImagePickerControllerEditedImage];
    //Edit하지 않았으면 원 이미지를 가져온다.
    if (!image) image = [info objectForKey:UIImagePickerControllerOriginalImage];
    if (image) {
        [self setImage:image]; //가져온 이미지를 처리한다.
    }
    [self dismissImagePicker];
}

설명

 왼쪽의 화면이 3가지 종류의 Media Type을 선택할 수 있는 ActionSheet를 표시한 것이다.


UIImagePickerControllerSourceType
The source to use when picking an image or when determining available media types.
와 같이 3가지 종류가 있다.

enum {
   UIImagePickerControllerSourceTypePhotoLibrary,
   UIImagePickerControllerSourceTypeCamera,
   UIImagePickerControllerSourceTypeSavedPhotosAlbum
};
typedef NSUInteger UIImagePickerControllerSourceType;






카메라를 선택할 경우 왼쪽과 같이 카메라를 찍고, 그 사진을 선택할 수 있다.

















Photo Library를 이용할 경우, 사용자에게 애플리케이션이 접근하는 것을 허용할 것인지를 묻고, 승인을 받아야 접근할 수 있게 된다.
만약 승인을 하지 않으면, 아래와 같이 접속이 안된다.

사용자가 Photo Library에 접근하는 것을 허용하지 않은 경우 왼쪽과 같이 표시된다.













접근을 허용한 경우, 왼쪽과 같이 화면에 표시가 된다.

SavedPhotosAlbum은 카메라로 찍은 사진들이 저정되어 있는 Camera Roll을 바로 접근하도록 해준다.


2012년 12월 22일 토요일

[iOS6] UIActionSheet 사용하기.


사용자에게 선택을 요청할 경우, UIActionSheet를 사용해서 여러 가지 선택을 할 수 있게 요청할 수 있다.

소스

#define STRING_TITLE @"I have a question."
#define STRING_CANCEL @"Cancel"
#define STRING_QUESTION1 @"What is your name?"
#define STRING_QUESTION2 @"Who you are?"
#define STRING_QUESTION3 @"I have no question."
#define STRING_QUESTION4 @"Question4"
#define STRING_QUESTION5 @"Question5"
#define STRING_QUESTION6 @"Question6"
#define STRING_QUESTION7 @"Question7"

- (IBAction)askQuestion:(id)sender
{
    UIActionSheet* actionSheet = [[UIActionSheet alloc] initWithTitle:STRING_TITLE
                                                             delegate:self
                                                    cancelButtonTitle:STRING_CANCEL
                                               destructiveButtonTitle:STRING_QUESTION1
                                                    otherButtonTitles:STRING_QUESTION2, STRING_QUESTION3, STRING_QUESTION4, STRING_QUESTION5, STRING_QUESTION6,STRING_QUESTION7, nil];
    
    [actionSheet showInView:self.view];
}

#pragma mark - UIActionSheetDelegate
- (void)actionSheet:(UIActionSheet *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex
{
    NSString *choice = [actionSheet buttonTitleAtIndex:buttonIndex];
    if(buttonIndex == [actionSheet destructiveButtonIndex]) {
        //?
    }
    if([choice isEqualToString:STRING_QUESTION1]){
        //
        UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Question"
                                                        message:STRING_QUESTION1
                                                       delegate:self
                                              cancelButtonTitle:STRING_CANCEL
                                              otherButtonTitles: nil];
        [alert show];
    }else if([choice isEqualToString:STRING_QUESTION2]){
        //
        UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Question"
                                                        message:STRING_QUESTION2
                                                       delegate:self
                                              cancelButtonTitle:STRING_CANCEL
                                              otherButtonTitles: nil];
        [alert show];
    }else if([choice isEqualToString:STRING_CANCEL]){
        //Do Nothing..
    }
}
-(void) actionSheet:(UIActionSheet *)actionSheet didDismissWithButtonIndex:(NSInteger)buttonIndex
{
    NSLog(@"actionSheet: didDismissWithButtonIndex:%d", buttonIndex);
}
-(void) actionSheet:(UIActionSheet *)actionSheet willDismissWithButtonIndex:(NSInteger)buttonIndex
{
    NSLog(@"actionSheet: willDismissWithButtonIndex:%d", buttonIndex);
}


설명
아래 그림과 같이 5개 이하는 왼쪽 처럼 표시가 되고, 5개 이상이면, 오른쪽 처럼 표시가 된다.





2012년 12월 18일 화요일

[iOS6] 큰 이미지를 작게 표시할 때..


큰 이미지를 iPhone의 작은 화면에 표시를 하거나, 작은 이미지로 사용해야 되는 경우가 많다. 이 경우에 이미지를 그대로 사용하게 되면, 이미지 사이즈가 커서 이미지를 로딩하는 메모리도 많이 사용하게 되고, 이미지를 그대로 압축해서 표시하므로, 계단현상이나 부드럽지 못한 이미지가 표시되게 된다.
이런 경우 Context를 생성하고, 거기에 DrawImage를 해서 작은 이미지와 Blend된 이미지로 표시할 수 있다.

소스
- (UIImage*)getResizedImage:(UIImage*)image inBound:(CGSize)size
{
    if (NULL != UIGraphicsBeginImageContextWithOptions)
        UIGraphicsBeginImageContextWithOptions(size, NO, 0);
    else
        UIGraphicsBeginImageContext(size);
    
    CGContextRef context = UIGraphicsGetCurrentContext();
    
    // Flip the context because UIKit coordinate system is upside down to Quartz coordinate system
    CGContextTranslateCTM(context, 0.0, size.height);
    CGContextScaleCTM(context, 1.0, -1.0);
    
    // Draw the original image to the context
    CGContextSetBlendMode(context, kCGBlendModeCopy);
    CGContextDrawImage(context, CGRectMake(0.0, 0.0, size.width, size.height), image.CGImage);
    
    // Retrieve the UIImage from the current context
    UIImage *imageOut = UIGraphicsGetImageFromCurrentImageContext();
    
    UIGraphicsEndImageContext();
    
    return imageOut;
}

설명
UIImage로 받은 큰 사이즈의 원본을 context에 작게 그리고, 그린 Context에서 UIImage를 받아오면, 작게 Blend된 이미지를 추출할 수 있게 된다.

비교


왼쪽이 원 이미지를 그대로 사용한 것이고 오른쪽이 이미지를 작게 렌더링 한 후 표시한 것입니다.
이미지를 캡춰해서 별 차이가 나지 않지만, 실제로 보면, 차이가 나고 메모리 사용량도 차이가 나는 겁니다.
 많이 필요없는 곳에 많은 데이터를 쓰고 있는 것이지요..

[iOS6] UIImageView의 Shadow설정하기.

이미지를 화면에 표시할 때, 사진처럼 보여주기 위해서, 그림자를 설정해야 되는 경우가 많다.
이럴 경우, UIImageView의 CALayer를 이용해서 그림자를 설정해줄 수 있다.
그림자 설정은 테두리 설정과 동시에 사용할 수 있지만, 라운드 처리와는 같이 사용할 수가 없다.
masksToBounds를 설정해서 주변을 Mask처리해야 하므로 그림자 부분이 사라지게 된다.

소스

#import <QuartzCore/QuartzCore.h>
..
- (void)viewDidLoad
{
    [super viewDidLoad];
    
    self.imageView.layer.shadowColor = [UIColor blackColor].CGColor; //그림자 색상
    self.imageView.layer.shadowOffset = CGSizeMake(5.0, 5.0); //그림자 Offset
    self.imageView.layer.shadowOpacity = 0.9f; //투명도
    self.imageView.layer.shadowRadius = 2.0f; //그림자 코너 부분
    self.imageView.layer.backgroundColor = [UIColor blackColor].CGColor;
}

동작 화면
storyboard에서 UIImageView를 등록하고, property로 연결한 다음에, 위와 같이 설정을 하면, 왼쪽과 같이 그림자를 표시할 수 있게 된다.

2012년 12월 14일 금요일

[iOS6] UIImageView의 라운드 처리와 테두리 넣기


iOS6에서 UIImageView의 테두리를 넣고, 라운드 처리하는 것을 정리한다.

CALayer속성 변경하기.
- UIImageView는  UIView의 하위 클래스이므로, UIView에 있는 CALayer인 layer의 property를 변경해서 라운드 처리를 할 수 있다.

#import <QuartzCore/QuartzCore.h>
..

UIImageView* imageView = [[UIImageView alloc] initWithImage:[UIImage ....]];
imageView.layer.cornerRadius = 5.0;        //테두리가 라운드가 된다.
imageView.layer.masksToBounds = YES; //테두리의 배경을 투명하게

imageView.layer.borderColor = [UIColor whiteColor].CGColor; //테두리 색상
imageView.layer.borderWidth = 3.0; //테두리의 두께


예제.


2012년 6월 16일 토요일

[QML/Qt] Lecture 03. QML에서 Qt Class의 Method를 호출하자.

Lecture 02.에서 만든 환경을 그대로 이용해서, QML에서 Qt Class의 메소드를 호출하는 방법을 알아봅니다.

Q_PROPERTY로 등록한 프로퍼티는 변수처럼, 읽고, 쓸 수 있는 기능을 하는 것으로 생각을 하면, 클래스의 특정 함수를 QML에서 호출하는 것은 Q_INVOKABLE을 이용할 수 있습니다.


class MyObject : public QObject
{
  Q_OBJECT
public:
  explicit MyObject(QString n, QObject *parent = 0);
  Q_PROPERTY (QString myName READ getName WRITE setName NOTIFY nameChanged)
  QString getName(void) { return name; }
  void    setName(QString n) { name = n; nameChanged();}
  Q_INVOKABLE QString getMyNameByMethod(QString param, int value)
  {
      qDebug() << __FUNCTION__ << " param:" << param << ", value:" << value;
      return name;
  }
 
signals:
  void nameChanged();
 
public slots:
private:
  QString name;
 
};


위에 녹색으로 표시한 것이 일반 Public 함수를 QML에서 보이도록 Q_INVOKABLE로 만든 함수입니다.

이 함수는 Qt의 다른 클래스에서도 Public 함수로 호출을 할 수 있으며, 이 클래스가 QDeclarativeView의 rootContext에 Property로 등록이 되면, 이 함수를 QML에서 호출 할 수 있습니다.
즉, Qt/QML의 Meta system에서 Q_INVOKABLE로 선언된 함수를 등록을 해 두므로, QML에서 호출 할 수 있게 되는 것입니다.
QML에서는 어떻게 호출은 하는가.
아래에 Main함수에서 MyObject를 Property인 “myObject”로 등록을 했습니다.

  DeclarativeView view;
  MyObject myObject("David Bae");
  view.rootContext()->setContextProperty("myObject", &myObject);
  view.setSource(QUrl("../QLecture/qml/QLecture/main.qml"));
  view.show();


그리고 QML에서 myObject의 getMyNameByMethod함수를 호출할 수 있게 됩니다.

   onClicked: {
       var name = myObject.getMyNameByMethod("nameFromQML", 50);
       console.log("[QML] getMyName:"+ name)
       idButtonText.text = name;
   }


위와 같이 호출을 할 수 있게 되고, 파라미터를 넘기거나, 리턴값을 받아 올 수 있습니다.

[QML/Qt] Lecture 02. Property를 등록하자.

Lecture 01에서 만든 환경에서, Class인 MyObject를 만들고, 거기에 Property 인 name을 등록을 하자. 그리고, 내용을 MyObject에서 이름을 가져와서, QML에서 표시를 해 보자.

1. QObject에서 상속받은 MyObject 클래스를 만들자.
 Menu > File > New File or Project 를 선택하고, C++인 Class를 선택하자.
 이름은 MyObject로 하고, QObject에서 상속을 받도록 만들자.
#ifndef MYOBJECT_H
#define MYOBJECT_H
#include <QObject>
class MyObject : public QObject
{
  Q_OBJECT
public:
  explicit MyObject(QObject *parent = 0);

signals:
public slots:

};
#endif // MYOBJECT_H

: 기본적으로 클래스를 만들면 위와 같이 기본 클래스가 만들어진다.

2. 만든 MyObject에 name을 추가하고,  Q_PROPERTY로 등록하자.
#ifndef MYOBJECT_H
#define MYOBJECT_H
#include <QObject>
class MyObject : public QObject
{
  Q_OBJECT
public:
  explicit MyObject(QString n, QObject *parent = 0);
  Q_PROPERTY (QString myName READ getName WRITE setName NOTIFY nameChanged)
  QString getName(void) { return name; }
  void    setName(QString n) { name = n; nameChanged();}
 
signals:
  void nameChanged();
 
public slots:
private:
  QString name;
 
};
#endif // MYOBJECT_H

: 위에 녹색으로 배경이 된 부분이 추가된 부분이 된다.
QML에서 myName이라는 프로퍼티이름으로 name을 읽을 수 있는데,
text: myObject.myName 이라고 쓰면, getName()이 호출되어서, 값을 넘겨주게 되고,
myObjectt.myName = “david” 라고 하면, setName(..)이 호출되어 값을 설정하게 된다.
설정될 때, nameChange() 시그널을 발생시켜서, QML에서 바인딩 된 다른 곳에서도 데이터가 변경이 된다. 이건 Property Binding과 Signa/Slot을 설명하고 나면 자세하게 알게 된다.
여기서는 nameChange라는 함수를 통해서, QML에서 자동으로 값을 읽어가게 된다는 것을 알고 가자.

3. Main에서 MyObject의 인스턴스를 만들고, view의 rootContext에서 이것을 등록하자.
#include <QApplication>
#include <QDeclarativeContext>
#include <QDeclarativeView>
#include "myobject.h"
Q_DECL_EXPORT int main(int argc, char *argv[])
{
  QApplication app(argc, argv);
  QDeclarativeView view;
  MyObject myObject("David Bae");
  view.rootContext()->setContextProperty("myObject", myObject);
  view.setSource(QUrl("../QLecture/qml/QLecture/main.qml"));
  view.show();
  return app.exec();
}

main함수에서 “myObject”로 view의 rootContext에 등록을 했으므로, QML에서 “myObject”라는 이름을 사용하면, 다른 QML콤포넌트의 id에 접근하듯이 등록된 클래스에 접근을 할 수 있게 된다.
view의 setSource를 통해서 QML파일을 등록하기 전에, rootContext에 “myObject”라는 이름으로 myObject를 등록을 하면, setSource에서 등록되는 QML에서는 myObject라는 이름으로 사용할 수 있게 된다.


4. QML에서 등록된 MyObject를 읽어와서, 내부의 Name을 읽어서 화면에 표시를 하자.
QML에서 myName을 읽으면, MyObject의 getName이 호출되고, myName에 이름을 넣으면, setName이 되는 것이다.

main.qml
Rectangle {
  width: 360
  height: 360
  Text {
      text: qsTr("Hello World2")
      anchors.centerIn: parent
  }
  Text {
      x:50; y:50
      text:myObject.myName;
  }
}


그럼, Main.qml에서 사용자가 마우스 클릭으로 이름을 바꾸고, 바꾼 내용이 화면이 표시가 되는지 확인해 보자.

QML에 버튼 비슷한 것을 만들고, click이 되면, 이름을 “Jamie”로 바꿔보자.
// import QtQuick 1.0 // to target S60 5th Edition or Maemo 5
import QtQuick 1.1
Rectangle {
  width: 360
  height: 360
  Text {
      text: qsTr("Hello World2")
      anchors.centerIn: parent
  }
  Text {
      x:50; y:50
      text:myObject.myName;
      color:"green"
  }
  Rectangle{
      x:150;y:50
      width:100;
      height:15
      color:"steelBlue"
      Text{
          anchors.fill:parent;
          verticalAlignment: Text.AlignVCenter;
          horizontalAlignment: Text.AlignHCenter;
          text: "Change"
      }
      MouseArea{
          anchors.fill: parent;
          onClicked: {
              myObject.myName = "Jamie";
          }
      }
  }
}

실제 동작하는 화면을 보면, Change를 클릭하면, David Bae라는 이름이 Jamie로 바뀌고, 화면에 자동으로 갱신이 된다.


좀더 자세하게 Q_PROPERTY를 설정할 때 들어가는 내용을 알아봅시다.
(참조 사이트: http://doc.qt.nokia.com/4.7/qobject.html#Q_PROPERTY )
Q_PROPERTY(type name
           READ getFunction
           [WRITE setFunction]
           [RESET resetFunction]
           [NOTIFY notifySignal]
           [DESIGNABLE bool]
           [SCRIPTABLE bool]
           [STORED bool]
           [USER bool]
           [CONSTANT]
           [FINAL])

선언
- 일반적인 변수와 동일하게 동작함.
- 추가적으로 Meta-Object System을 통해서 접근이 가능한 Property가 됨.
- READ : reading the property value
- WRITE: setting the property value
- RESET: default value로 돌아올 때
- NOTIFY: 변경을 알리는 Signal을 명시
- DESIGNABLE: GUI design tool에서 보이도록
- SCRIPTABLE: script engine에서 접근 가능, 디폴트로 true임
STORED: property가 자기것으로 가지고 있거나, 혹은 다른 Property의 Value에 따라 변하는지를 표시한다. 일반적으로 True, minimumWidth()의 경우, minimumSize()의 값이 되므로 자기것을 가지고 있을 필요 없다는 것임.
- USER: 사용자가 보고, 변경할 수 있는 것인지를 표시하는 것. (??)
- CONSTANT: const이므로 READ함수가 같은 값을 return한다.
- FINAL: 상속받은 class에서 overridden을 하지 못한다는 의미.