ACAPI_OpenUndoableSession
Undoable 세션을 엽니다.
GSErrCode ACAPI_OpenUndoableSession (
const char* undoString
);
파라미터
- undoString
- [in] 이 문자열은 Edit 메뉴의 "Undo " 이후에 나타나게 됩니다. 리소스로부터 읽어와야 합니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_REFUSEDCMD- 현재 액션이 Undoable이 아닙니다.
APIERR_NOTMINE- 또 다른 애드온이 이미 Undoable 세션을 열었습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 (연쇄적인) Undoable 단계의 시작을 표시합니다. (예. 요소 생성) 모든 데이터베이스 변경 동작들은 그 동작에 대하여 Undo 세션을 열었는지 여부를 확인합니다.
일부 애드온 타입(예. I/O 타입 애드온들)의 경우, 이 함수는 호출되지 않습니다. 왜냐하면 파일을 여는 것을 'undo' 하는 것은 말이 안 되기 때문입니다.
애드온들은 요소 데이터베이스 이벤트 핸들러 콜백으로부터 Undoable 세션을 열 수 없습니다. 왜냐하면 그것들의 알림들은 이미 열린 Undo 단계로부터 전송되기 때문입니다.
요소 변경 이후에 애드온은 Undo 엔트리를 마무리하기 위해 API_CloseUndoableSession 함수를 호출해야 합니다.
애드온은 1번 호출하는 동안 여러 번 Undo 세션을 열 수 있습니다. 만약 사용자가 한 단계만에 작업을 완료하면, 예전 상태를 복원("undo" 수행)하는 데 한 단계 이상 필요하다면 사용자에게는 불편할 수 있음을 알아두십시오.
요구사항
- 버전: API 4.1 또는 이후
- 헤더: ACAPinc.h
