본문으로 건너뛰기

대화상자 빌더

대화상자 빌더란 무엇인가요?​

대화상자 빌더는 매크로 내에서 인터랙티브한 대화상자를 만들 수 있는 유용한 기능입니다. 이러한 대화상자는 일반적으로 매크로가 주요 실행을 시작하기 전에 사용자로부터 입력을 받는 데 사용됩니다. 사용자 선택에 따라 매크로의 동작을 사용자 지정하는 방법이라고 생각하시면 됩니다.

예를 들어, "어떤 옵션을 실행하시겠습니까?"라고 묻는 대화상자를 만들 수 있습니다. 사용자가 옵션 5를 선택하면, 매크로는 해당 선택과 관련된 특정 동작 집합을 수행합니다.

대화상자 구성 요소​

대화상자는 다양한 UI 구성 요소를 사용하여 구성됩니다. 각 대화상자에는 다음 요소가 포함될 수 있습니다:

  1. CheckBox: 예/아니오 또는 참/거짓 선택용
  2. EditText: 자유 형식 텍스트 입력용
  3. RadioGroup: 여러 RadioButton의 컨테이너
  4. Column: 세로 레이아웃 컨테이너
  5. Row: 가로 레이아웃 컨테이너
  6. RadioButton: RadioGroup 내에서 단일 선택용
  7. TextView: 텍스트 정보 표시용

기본값​

대화상자 입력 구성 요소는 대화상자가 표시되기 전에 초기 값을 정의할 수 있습니다:

  • EditText(id, hint, defaultValue)는 시작 텍스트를 설정합니다
  • CheckBox(id, text, defaultChecked)는 시작 체크 상태를 설정합니다
  • RadioGroup(id, defaultButtonId)는 기본적으로 라디오 버튼을 선택합니다

기본값이 제공되면, 대화상자가 열릴 때 먼저 사용됩니다.

대화상자 만들기​

이러한 구성 요소를 결합하여 매크로의 필요에 맞는 사용자 지정 대화상자를 만들 수 있습니다. 이러한 구성 요소 중 값을 검색할 수 있는 세 가지 입력 유형이 있습니다:

  • CheckBox
  • EditText
  • RadioGroup

이러한 입력 구성 요소에서 값에 액세스하려면 매크로 로직에서 Dialog:getValueById() 함수를 사용할 수 있습니다. 구성 요소의 고유 ID를 지정하면 사용자의 입력을 검색하여 매크로의 동작을 안내하는 데 사용할 수 있습니다.

참고: 대화상자의 각 구성 요소에는 고유한 ID가 있어야 합니다. 이를 통해 매크로가 대상으로 하는 특정 구성 요소에서 올바르게 값을 식별하고 검색할 수 있습니다. 중복 ID는 매크로 실행 시 혼란과 오류를 초래할 수 있습니다.

최종 수정: 에