연구 개발 매뉴얼
공간 바로가기
페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

page no.  94372001

Start Release No : 7.0.500.20240905-11 / Update Release No : 7.0.500.20240905-11 

작성자 : 김예슬  / 검수자 :  이승우


  1. 개요
    기존에는 사용자가 컨트롤의 속성을 잘못 설정했을 경우, 경고 문구를 통해서만 문제를 인지할 수 있었습니다.
    하지만 경고 문구만으로는 속성 설정 상태를 명확하게 파악하기 어려운 경우가 많았습니다.
    이를 개선하기 위해, 우측 설정 창(PropertyGrid) 에서 속성의 활성화 또는 비활성화 상태를 UI 를 통해 직관적으로 확인할 수 있도록 개선하였습니다.
    또한, 속성들의 배치를 수정하여 연관된 속성들이 함께 배치되도록 하였습니다.
    이를 통해 관련된 속성들을 한눈에 확인하고 관리할 수 있어, 속성 관리의 효율성을 높였습니다.


  2. 기능 설명

    1. MultiComboBox 의 속성창에서 시각적인 피드백을 제공합니다.

    2. 관련된 속성들이 함께 배치되어있습니다. (예를 들어, TreeView 형식일 때만 사용되는 속성들끼리 연속으로 배치)
        

  3. 사용 방법

    1. 사용자가 특정 속성을 조정하면 관련된 다른 속성들이 자동으로 활성화 되거나 비활성화 됩니다.


MultiComboBox 컨트롤의 속성 리스트

속성명기본값유형상세 설명
ViewType

MultiCheckBoxList

string

콤보 박스의 사용 유형을 설정합니다.

값설명
MultiCheckBoxList

다중/단일 선택 콤보 박스로 이용할 수 있습니다.

TreeViewList

다중/단일 트리 콤보 박스로 이용할 수 있습니다.

※ Binding 속성과 함께 사용할 수 없습니다.

※ FilterParamName 속성과 함께 사용할 수 없습니다 .

IsMultiSelecttrueboolean

다중 선택 허용 여부를 설정합니다.

※ HideCheckBox 속성이 true 일 때는 사용할 수 없습니다.

※ UseAllItems 속성이 true 일 때는 사용할 수 없습니다.

값설명
true

다중 선택을 사용합니다.

false

단일 선택을 사용합니다.

HideCheckBoxfalseboolean

각 노드에 체크 박스를 숨길지/표시할지 선택할 수 있습니다.

※ IsMultiSelect 속성이 true 일 때는 사용할 수 없습니다.

값설명
true

노드의 체크 박스를 숨깁니다.

false

노드의 체크 박스를 표시합니다.


EditableValueTextfalseboolean

Caption 영역에 값 입력 가능 여부를 설정합니다.

※ IsReadOnly 속성이 true 일 때는 사용할 수 없습니다.

※ UseSelectedAllText 속성이 true 일 때는 사용할 수 없습니다.

값설명
true

사용자가 Caption 영역에 직접 값을 입력하거나 수정할 수 있습니다.

false사용자가 Caption 영역에 직접 값을 입력하거나 수정할 수 없습니다.
UseSelectAllValuetrueboolean

쿼리의 조건문에 사용되는 파라미터 값이 "전체"로 설정된 경우(모든 항목이 선택된 경우),

해당 조건 라인을 쿼리에서 제거해주는 기능 사용 여부를 설정합니다.

값설명
true

조건 라인을 쿼리에서 제거하여 불필요한 조건문이 실행되지 않도록 합니다.

'전체' 가 아닌 특정 값을 선택한 경우에는 조건 라인이 정상적으로 적용됩니다.

예시 코드
SELECT *
  FROM MTX_OPTION
 WHERE 1=1
   AND OPTION_CODE IN (@:VS_MultiCombo)	-- 멀티콤보의 모든 노드가 선택된 경우, 해당 라인이 주석처리 됩니다.
false조건 라인을 쿼리에서 제거하지 않습니다.
UseSelectAllTextfalseboolean

모든 항목이 선택되었을 때, Caption 영역에 개별 항목 이름 대신 '전체' 라는 문구를 표시할지 여부를 설정합니다.

사용자는 이를 통해 현재 모든 항목이 선택되었음을 쉽게 인지할 수 있습니다.

※ EditableValueText 속성이 true 일 때는 사용할 수 없습니다.

값설명
true

'전체' 라는 문구를 표시합니다.

※ 이 문구는 다국어가 적용됩니다.

false

항목의 값을 표시합니다.

UseAllItemsfalseboolean

항목에 '전체' 라는 노드를 추가할지 여부를 설정합니다.

※ IsMultiSelect 속성이 true 일 때는 사용할 수 없습니다.

값설명
true

항목에 '전체' 라는 노드를 추가합니다.

※ 이 문구는 다국어가 적용됩니다.


false항목에 '전체' 라는 노드를 추가하지 않습니다.
FilterParamNameundefinedstring | undefined

팝업컨테이너에서 검색 텍스트박스의 값이 FilterParamName 에 작성된 변수(VS_ 또는 VN_ 으로 시작) 에 할당됩니다.

EmptyValue

(null)

string

데이터셋에 null 값이 존재할 경우, 이 속성에 설정된 EmptyValue 로 변환됩니다.

이를 통해 null 값으로 인해 발생할 수 있는 오류나 불완전한 데이터 표시를 방지하고, 데이터의 일관성을 유지할 수 있습니다.

SortTypeNoneenSortType

항목의 정렬을 설정합니다.

값enum설명
None0항목을 정렬하지 않습니다.
Desc1항목을 내림차순으로 정렬합니다.
Asc2항목을 오름차순으로 정렬합니다.
AutoChildSelecttrueboolean

부모 노드를 선택할 때 자동으로 모든 자식 노드도 선택할지 여부를 설정합니다.

※ ViewType 이 TreeViewList일 때만 사용할 수 있습니다.

값설명
true

사용자가 부모 노드를 선택할 때 해당 부모 노드에 속한 모든 자식 노드도 자동으로 선택됩니다.

동작 예시 : 부모 노드 'A' 를 선택했을 때, 하위의 자식 노드들도 자동으로 선택된다.

false부모 노드를 선택해도 자식 노드는 별도로 선택해야 합니다.
LeafNodeOnlyfalseboolean

부모 노드는 선택되지 않고 자식 노드만 선택되도록 설정할 수 있습니다.

※ ViewType 이 TreeViewList 일 때만 사용할 수 있습니다.

값설명
true

가장 하위의 자식 노드만 Value 로 설정됩니다.

동작 예시 : 부모 노드 'A' 를 선택해도 Value 로 인식하지 않는다.

가장 하위의 자식 노드인 'AA' 는 선택된 Value 로 인식된다.

false부모/자식 노드 여부와 관계 없이 선택된 노드가 Value 로 설정됩니다.
AutoExpandLevel0number

지정된 레벨까지 노드를 자동으로 확장하는 기능을 제공합니다.

※ ViewType 이 TreeViewList 일 때만 사용할 수 있습니다.

Min: 0

Max: 100

IndentSize

15

number

노드의 들여쓰기(Indentation) 크기를 설정하여, 노드가 UI에서 얼마나 들여쓰기 되어 보일지를 조정합니다.

※ ViewType 이 TreeViewList 일 때만 사용할 수 있습니다.

Min: 15

Max: 100

주의 사항

변경 사항

변경 전변경 후릴리즈 번호

7.0.500.20240905-11
기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보

  • Release No : 7.0.500.20240905-11