====== 멀티 액션 버튼 ======

멀티 액션 버튼은 버튼을 터치했을 때 하나 이상의 <액션>을 실행하는 위젯입니다.

<액션>이란 특정 동작을 의미합니다.
예:

  * 외부 장치에 값 기록
  * 내부 변수 변경
  * 파일 저장
  * 화면 전환
  * 스크립트 실행




화면에는 일반 버튼과 동일한 형태로 표시됩니다.

{{ :comfilestudio:widget_multi_action_button:button_scree.png?nolink |멀티 액션 버튼이 화면에 배치된 예시입니다. 외형은 일반 버튼과 동일합니다.}}

===== 액션 실행 순서 =====

여러 개의 액션을 등록하면,
나열된 순서대로 실행되는 것이 원칙입니다.

그러나 다음 사항에 주의하십시오.

  * 외부 장치에 직접 기록하는 액션은
    다른 내부 액션이 모두 완료된 후 실행됩니다.

{{ :comfilestudio:widget_multi_action_button:button_screebc2.png?nolink |여러 개의 액션이 등록된 예시 화면입니다. 실행 순서를 확인할 수 있습니다.}}

즉,
  내부 변수 변경 → 계산 → 외부 장치 기록  
순으로 처리됩니다.

===== 멀티 액션 동작 시점 =====

멀티 액션 버튼에서는 각 액션마다 동작 시점을 지정할 수 있습니다.

액션 추가 시 <고급 옵션>이 활성화됩니다.

{{ :comfilestudio:widget_multi_action_button:button_screebc3.png?nolink |각 액션의 동작 시점을 누를 때 또는 뗄 때로 설정하는 화면입니다.}}

설정 가능 항목:

  * 누를 때 실행
  * 뗄 때 실행
  * 프로젝트 기본값 따름

프로젝트 전체 기본 터치 반응 시점은
프로젝트 속성에서 설정할 수 있습니다.

{{ :comfilestudio:widget_multi_action_button:button_screebc_94.png?nolink |}}

===== 액션 완료 후 화면 전환 =====

모든 액션 실행이 완료된 후,
자동으로 다른 화면으로 이동할 수 있습니다.

{{ :comfilestudio:widget_multi_action_button:button_screebc5.png?nolink |멀티 액션 실행 후 지정한 화면으로 전환하는 설정 화면입니다.}}

사용 예:

  * 저장 완료 후 다음 화면으로 이동
  * 로그인 성공 후 메인 화면 이동
  * 설정 적용 후 이전 화면 복귀

===== 언제 사용합니까? =====

  * 하나의 버튼으로 여러 동작을 동시에 수행할 때
  * 값 기록 후 화면 이동이 필요한 경우
  * 복잡한 동작 흐름을 구성할 때

===== 자주 묻는 질문 =====

Q. 액션이 순서대로 실행되지 않는 것 같습니다.  
→ 외부 장치 기록 액션은 내부 액션 완료 후 실행됩니다.

Q. 버튼을 눌렀을 때가 아니라 뗄 때 실행하고 싶습니다.  
→ 고급 옵션에서 동작 시점을 변경하십시오.

Q. 일부 액션만 조건부로 실행하고 싶습니다.  
→ 액션 조건 분기 기능을 사용하십시오.

----
키워드: 멀티 액션 버튼, 다중 액션 실행, 액션 순서, 버튼 동작 시점, 누를 때 실행, 화면 전환 액션, Comfile Studio 액션

[[comfilestudio:index#위젯|상위 페이지로 가기]]