Power Apps 사용자 지정 구성요소 5 - 구성요소의 출력 사용자 지정 속성

Power Apps 사용자 지정 구성요소 5 - 구성요소의 출력 사용자 지정 속성

사용자 지정 구성요소에서 입력 속성을 사용하여 값을 새로 생성하고 변경할 수 있지만 딱히 앱에서 입력이 불필요하다면 구성요소 속성창에 항목을 늘릴 필요가 없을 것이다. 이것을 위해 값을 반환하기만을 위한 '출력 사용자 지정'을 사용하면 된다.

출력 사용자 지정 속성

출력 사용자 지정 속성은 구성요소에 입력이 불가능한 속성을 정의한다. 입력은 불가능하지만 해당 사용자 지정 구성요소에서 정의한 변수값을 반환하거나 미리 정의한 복잡한 함수결과 값을 반환하도록 만든다.

1. 새 구성 요소를 만든다.(필자는 아래와 같은 레이블 2개와 텍스트 입력 컨트롤을 만들었다.)
   
   
2. '트리 뷰'에서 자신이 만든 구성요소 중 속성을 추가하려는 구성요소를 클릭(구성요소 안의 컨트롤을 선택하면 안된다.)
   
   
3. '구성 요소'의 '속성' 탭에서 + 새 사용자 속성 클릭
   
   
4. 사용자 지정 속성 편집 창이 뜰 것이다. 이곳에 '표시 이름', '이름', '설명'을 입력하고 '속성 형식'은 출력, 그리고 사용할 '데이터 형식'을 선택한다. 각 항목의 설명은 가장 아래부분에 정리하겠다.
   
   
5. '구성 요소 속성 창'에서 '고급' 탭으로 가면 생성한 구성요소 속성이 보일 것이다. 이곳에서 자신이 원하는 초기값으로 변경하자. 만약 기본값만을 사용할 거면 '앱에서 출력 속성 사용'으로 넘어가자(필자는 이후 컨트롤 내부의 변수설정 Set 함수를 사용하는 것을 보여주기 위해 varText 라는 값을 넣었다)
   
   
6. 해당 속성을 사용자 지정 구성요소 컨트롤 안의 이벤트에서 정의하자. 사용시에는 {구성요소 이름}.{사용자 속성 이름}을 사용한다.(아래 이미지는 텍스트입력 컨트롤의 'OnChange' 이벤트에 Set(varText, TextInput1.Text) 으로 varText를 정의했다.)
   
   
7. 이것으로 사용자 지정 구성요소 안에서 정의한 변수의 값을 '출력 사용자 지정 속성'을 통해 앱에서도 사용 가능하게 되었다.

• 참고로 사용자 지정 속성 편집을 수정하기 위해선 사용자 속성의 '데이터 형식'을 클릭하면 된다.
  

앱에서 출력 속성 사용

1. 앱에서 방금 만든 사용자 지정 구성요소를 추가하여 삽입한다.
2. 출력 속성을 가져올 컨트롤을 생성하고 그안에 값으로 '출력 사용자 지정 속성'을 입력한다.(아래 이미지는 출력 사용자 지정 속성의 값을 기본값으로 가지는 텍스트입력 컨트롤의 값을 정의하였다.)
   
   
3. 앱을 실행하여 컨트롤 내부의 변수값이 변화하는 이벤트를 발생시켜 값이 변경되는지 확인한다.(아래 이미지는 OnChange 이벤트가 일어나면 'OutputText' 출력 속성 값이 변화되는것을 확인 가능하다)
   
   

사용자 지정 속성 편집 항목 설명

항목 이름	설명
표시 이름	속성 창에서 표시될 이름이다. 이름과 같지는 않다. FX에서는 해당 이름을 사용하지 않는다
이름	FX 등에서 사용할 속성값의 이름이다. 표시 이름과는 다르게 FX로 코딩할때 사용된다.
설명	해당 속성의 설명
속성 형식	해당 속성이 사용자가 직접 입력이 가능한 '입력' 사용자가 값을 불러올 수만 있는 '출력' 중 한가지를 선택한다.
데이터 형식	해당 속성에서 사용될 데이터 형식