< 모래시계 커서 >

WTL은 윈도우 상의 커서를 간단하게 변경하기 위해서 CWaitCursor 클래스를 준비해 있습니다. 이 클래스는 atlctrlx.h 헤더에 정의되고 있습니다. 다음에 나타내는 것은CWaitCursor 클래스의 가장 간단한 사용 방법입니다.

// 어느 함수

void function(){

CWaitCursor cursor;

// 시간이 걸리는 처리

}

CWaitCursor 클래스의 constructor에는 3개의 인수를 지정할 수 있습니다. 제1인수는 인스턴스를 작성한 직후로 커서를 변경하는지 어떤지를 나타내는 bool값으로 true를 지정하면 내부에서Set()라고 하는 멤버 함수가 불려 가자 마자 커서가 바뀝니다. 제2인수는 커서 리소스명, 제3인수는 시스템 커서를 사용하는지 어떤지를 나타내는 bool값입니다. 이러한 인수는 모두 생략 할 수 있어 생략 했을 경우는 디폴트 인수로서 순서에 true,IDC_WAIT,true가 지정됩니다. 위의 예에서는 constructor인수를 생략 하고 있기 때문에 커서가 모래시계 커서가 됩니다. CWaitCursor 클래스의 소멸자에서는 Restore()이라고 하는 멤버 함수가 불려 가 커서가 원래대로 돌아갑니다.

　Set()나 Restore()는 명시적으로 호출할 수도 있습니다. 다음에 나타내는 것은 전술의 예와 같은 처리를 멤버 함수를 명시적으로 호출해 실행하는 예입니다.

// 어느 함수

void function(){

CWaitCursor cursor(false);

cursor.Set(); // 커서를 변경

// 시간이 걸리는 처리

cursor.Restore(); // 커서를 바탕으로 되돌리는

}

이 예에서는 CWaitCursor 클래스의 constructor의 제1인수에 false를 지정해 있기 때문에 인스턴스를 작성한 시점에서는 아직 커서는 변경되지 않습니다. Set()을 호출했을 때에 처음으로 커서가 변경됩니다.

　다음에 나타내는 것은 독자적인 커서를 표시하는 예입니다. 덧붙여 미리 프로젝트에 IDC_CURSOR1라고 하는 ID의 커서 리소스를 추가해 둡니다.

// 어느 함수

void function(){

CWaitCursor cursor(true, MAKEINTRESOURCE(IDC_CURSOR1), false);

// 있는 처리

}

이 예에서는 시스템 커서가 아니고 독자적인 커서 자원을 사용하기 위해 constructor의 제3인수에는 false를 지정합니다.

　덧붙여 WTL는 독자적인 커서를 표시하기 위해서 CWaitCursor클래스로부터 파생한 CCustomWaitCursor 클래스를 준비해 있습니다. 다음에 나타내는 것은 CCustomWaitCursor클래스를 사용하는 예입니다.

// 어느 함수

void function(){

CCustomWaitCursor cursor(IDC_CURSOR1);

// 있는 처리

}

CCustomWaitCursor클래스의 constructor의 제1인수에는 커서 리소스의 ID를 지정합니다. 제2, 3인수에는 각각 인스턴스를 작성한 직후로 커서를 변경하는지 어떤지를 나타내는 bool 값과 커서 자원이 들어간 모듈의 인스턴스 핸들을 지정할 수 있습니다만 어느 쪽이나 생략 가능합니다. 생략 했을 경우는 디폴트 인수로서 각각 true,NULL이 지정됩니다.