- MATRIX팀님이 작성, 2024-08-28에 최종 변경
조건 컨트롤의 속성 값을 지정 합니다.
각 속성 값에 대한 상세 사용 방법은 본문 마지막에 위치하고 있습니다.
public void SetControlProperty ( string controlID, string name string value )
Parameters
controlId |
|---|
Type: String
조건 컨트롤의 id
name |
|---|
Type: String
조건 컨트롤의 속성 이름
value |
|---|
Type: String
조건 컨트롤 속성에 지정 할 값
Return Value
Type: void
Sub SetControlProperty()
Dim mxmodule As Object
Set mxmodule = Application.COMAddIns.Item("iMATRIX.ExcelModule").Object
mxmodule.xapi.SetControlProperty "Btn1", "Visible", True
End Sub
Property 별 상세 적용 방법 (2021.04.09 UPDATE)
제품 버전에 따라 Property가 없을 수 있습니다.
DataSource, DefineItems 속성의 경우 해당 XAPI로 컨트롤이 불가능합니다.
| Name | Type | Description |
|---|---|---|
| Description | String | Basic 속성 하위의 Description 속성, 해당 조건 컨트롤의 설명을 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Description", "TEST VALUE" | ||
| InitCell | String | Basic 속성 하위의 InitCell 속성, 해당 조건 컨트롤의 초기값을 가져올 Cell의 주소를 지정 해당 셀의 위치를 문자열로 입력 하거나 Excel 내 이름정의 된 이름을 입력하여 지정 가능 |
mxmodule.xapi.SetControlProperty "Btn1", "InitCell", "'V1'!$C$5" mxmodule.xapi.SetControlProperty "Btn1", "InitCell", "'V1'!$A$1:$B$3" mxmodule.xapi.SetControlProperty "Btn1", "InitCell", "TEST VALUE" | ||
| Name | String | Basic 속성 하위의 Name 속성, 해당 조건 컨트롤의 이름을 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Name", "TEST VALUE" | ||
| LinkedCell | String | Basic 속성 하위의 LinkedCell 속성, 해당 조건 컨트롤의 값을 변경 시 변경사항이 적용될 Cell의 주소를 지정 (단일 Cell만이 지정 가능) |
mxmodule.xapi.SetControlProperty "TxtBox1", "LinkedCell", "'V1'!$C$5" | ||
| LinckedCellText | String | Basic 속성 하위의 LinckedCellText 속성, 해당 조건 컨트롤의 값을 변경 시 변경사항의 데이터 이름에 해당하는 값이 적용될 Cell의 주소를 지정 (LinkedCell 의 경우 데이터의 코드 / LinkedCellText는 데이터의 이름을 출력, 단일 Cell만이 지정 가능) |
mxmodule.xapi.SetControlProperty "ComboBox1", "LinckedCellText", "'V1'!$C$5" | ||
| FilterOption | String | FilterOption 속성, 해당 조건 컨트롤의 검색 기능이 있을 시 데이터 내 검색 옵션을 지정 (Or 의 경우 ' , ' 로 구분 / And 의 경우 ' '으로 구분하여 사용) |
mxmodule.xapi.SetControlProperty "ComboBox1", "FilterOption", "Or" mxmodule.xapi.SetControlProperty "ComboBox1", "FilterOption", "And" | ||
| FilterTarget | String | FilterTarget 속성, 해당 조건 컨트롤의 검색 기능 사용 시 데이터 내 검색 대상을 지정 (CodeorName : 코드와 이름 모두 검색 / Name : 이름만 검색) |
mxmodule.xapi.SetControlProperty "ComboBox1", "FilterTarget", "CodeOrName" mxmodule.xapi.SetControlProperty "ComboBox1", "FilterTarget", "Name" | ||
| MatchCase | Bool | MatchCase 속성, 해당 조건 컨트롤의 검색 기능 사용 시 대소문자 구분 유무 지정 |
mxmodule.xapi.SetControlProperty "ComboBox1", "MatchCase", True mxmodule.xapi.SetControlProperty "ComboBox1", "MatchCase", False | ||
| Text | String | 데이터 속성 하위의 Text 속성, 해당 조건 컨트롤에 표시되는 문자열을 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Text", "TEST VALUE" | ||
| ToolTip | String | 데이터 속성 하위의 ToolTip 속성, 해당 조건 컨트롤의 툴팁으로 표시되는 문자열을 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "ToolTip", "TEST VALUE" | ||
| MaxLength | Int | 데이터 속성 하위의 MaxLength 속성, 해당 조건 컨트롤에 표시되는 문자열의 자릿수를 지정 |
mxmodule.xapi.SetControlProperty "TxtBox1", "MaxLength", 5 | ||
| Format | String | 데이터 속성 하위의 Format 속성, 해당 조건 컨트롤의 값이 표현될 형식을 지정 (# : 숫자 0~9 입력 가능) |
mxmodule.xapi.SetControlProperty "NumBox1", "Format", "###.00" | ||
| Maximum | Double | 데이터 속성 하위의 Maximum 속성, 해당 조건 컨트롤에 표시되는 실수의 최대값을 지정 |
mxmodule.xapi.SetControlProperty "NumBox1", "Maximum", 200 | ||
| Minimum | Double | 데이터 속성 하위의 Minimum 속성, 해당 조건 컨트롤에 표시되는 실수의 최소값을 지정 |
mxmodule.xapi.SetControlProperty "NumBox1", "Minimum", 0 | ||
| Number | Double | 데이터 속성 하위의 Number 속성, 해당 조건 컨트롤에 표시되는 실수값을 지정 |
mxmodule.xapi.SetControlProperty "NumBox1", "MaxLength", 10 | ||
| AllItem | String | 데이터 속성 하위의 AllItem 속성, 해당 조건 컨트롤의 전체 항목을 선택했을 때 Linked Cell에 표시될 값을 지정 (조건 컨트롤 ComboBox의 경우 선행 옵션 : DisplayAll 속성값이 True) |
mxmodule.xapi.SetControlProperty "ComboBox1", "AllItem", "TEST VALUE" | ||
| DataRange | String | 데이터 속성 하위의 DataRange 속성, 해당 조건 컨트롤에 표시할 항목을 지정 (이전에 연결되어있던 데이터는 초기화되며 영역으로 지정할 경우 세로로 열거된 항목들만 가능) |
mxmodule.xapi.SetControlProperty "ComboBox1", "DataRange", "'V1'!$C$5" mxmodule.xapi.SetControlProperty "ComboBox1", "DataRange", "'V1'!$A$5:$A$11" mxmodule.xapi.SetControlProperty "ComboBox1", "DataRange", "TEST VALUE" | ||
| DisplayAll | Bool | 데이터 속성 하위의 DisplayAll 속성, 해당 조건 컨트롤에 [전체] 표시 유무 지정 |
mxmodule.xapi.SetControlProperty "ComboBox1", "DisplayAll", True mxmodule.xapi.SetControlProperty "ComboBox1", "DisplayAll", False | ||
| DescriptionPath | String | 데이터 속성 하위의 DescriptionPath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 설명이 될 컬럼을 지정 |
mxmodule.xapi.SetControlProperty "TreeCombo1", "DescriptionPath", "Des_Path" | ||
| ImageNamePath | String | 데이터 속성 하위의 ImageNamePath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 사용할 이미지 경로 컬럼을 지정 |
mxmodule.xapi.SetControlProperty "TreeCombo1", "ImageNamePath", "Img_Path" | ||
| KeyPath | String | 데이터 속성 하위의 KeyPath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 전달 할 값의 컬럼을 지정 |
mxmodule.xapi.SetControlProperty "TreeCombo1", "KeyPath", "Key_Path" | ||
| NamePath | String | 데이터 속성 하위의 NamePath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 표시될 값의 컬럼을 지정 |
mxmodule.xapi.SetControlProperty "TreeCombo1", "NamePath", "Name_Path" | ||
| ParentKeyPath | String | 데이터 속성 하위의 ParentKeyPath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 전달받은 값의 부모가 될 컬럼을 지정 |
mxmodule.xapi.SetControlProperty "TreeCombo1", "ParentKeyPath", "ParentKey_Path" | ||
| ValuePath | String | 데이터 속성 하위의 ValuePath 속성, 해당 트리 컨트롤의 LinkedCell에 출력될 값을 지정 |
mxmodule.xapi.SetControlProperty "TreeCombo1", "ValuePath", "Value_Path" | ||
| DateFormat | String | 데이터 속성 하위의 DateFormat 속성, 해당 달력 컨트롤의 데이터 날짜 형식을 설정 (년 = y, 월 = M, 일 = d, 주 = w 로 작성) |
mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyyMMdd" mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyy-MM-dd" mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyy/MM/dd" mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyy.MM.dd" | ||
| MaxDate | String | 데이터 속성 하위의 MaxDate 속성, 해당 달력 컨트롤에 표시되는 날짜의 최대값을 지정 |
mxmodule.xapi.SetControlProperty "Cal1", "MaxDate", "20211231" mxmodule.xapi.SetControlProperty "Cal1", "MaxDate", "2021-12-31" mxmodule.xapi.SetControlProperty "Cal1", "MaxDate", "2021/12/31" mxmodule.xapi.SetControlProperty "Cal1", "MaxDate", "2021.12.31" | ||
| MinDate | String | 데이터 속성 하위의 MinDate 속성, 해당 달력 컨트롤에 표시되는 날짜의 최소값을 지정 |
mxmodule.xapi.SetControlProperty "Cal1", "MinDate", "19990101" mxmodule.xapi.SetControlProperty "Cal1", "MinDate", "1999-01-01" mxmodule.xapi.SetControlProperty "Cal1", "MinDate", "1999/01/01" mxmodule.xapi.SetControlProperty "Cal1", "MinDate", "1999.01.01" | ||
| ViewFormat | String | 데이터 속성 하위의 DateFormat 속성, 해당 달력 컨트롤의 표시영역에 출력할 날짜 형식을 설정 |
mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyyMMdd" mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyy-MM-dd" mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyy/MM/dd" mxmodule.xapi.SetControlProperty "Cal1", "DateFormat", "yyyy.MM.dd" | ||
| CheckValue | String | 데이터 속성 하위의 CheckValue 속성, 해당 컨트롤이 Checked 상태일 때 LinkedCell에 전달되는 값을 지정 |
mxmodule.xapi.SetControlProperty "Check1", "CheckValue", "OP_CHECK" | ||
| UnCheckValue | String | 데이터 속성 하위의 UnCheckValue 속성, 해당 컨트롤이 UnChecked 상태일 때 LinkedCell에 전달되는 값을 지정 |
mxmodule.xapi.SetControlProperty "Check1", "UnCheckValue", "OP_UNCHECK" | ||
| GroupName | String | 데이터 속성 하위의 GroupName 속성, 라디오 버튼 컨트롤의 그룹 이름을 지정 |
mxmodule.xapi.SetControlProperty "Radio1", "GroupName", "G1" mxmodule.xapi.SetControlProperty "Radio2", "GroupName", "G1" | ||
| Image | String | 데이터 속성 하위의 Image 속성, 이미지 컨트롤에 표시할 이미지를 지정 (이미지는 설치경로\reports\WEB_IMAGES 내에 존재하는 파일) |
mxmodule.xapi.SetControlProperty "Img1", "Image", "robot.png" | ||
| ImageOn | String | 데이터 속성 하위의 ImageOn 속성, 이미지 컨트롤에 커서를 올렸을 때 표시할 이미지를 지정 (이미지는 설치경로\reports\WEB_IMAGES 내에 존재하는 파일) |
mxmodule.xapi.SetControlProperty "Img1", "ImageOn", "robot.png" | ||
| AuthorizationCode | String | 동작 속성 하위의 AuthorizationCode 속성, 해당 조건 컨트롤에 권한 코드를 지정 (권한 코드의 경우 iMGT 내 버튼관리, 버튼권한관리 에서 관리) |
mxmodule.xapi.SetControlProperty "Btn1", "AuthorizationCode", "" | ||
| Enabled | Bool | 동작 속성 하위의 Enabled 속성, 해당 조건 컨트롤의 사용 여부를 True, False로 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Enabled", True mxmodule.xapi.SetControlProperty "Btn1", "Enabled", False | ||
| LanguageCode | String | 동작 속성 하위의 LanguageCode 속성, 해당 조건 컨트롤의 다국어 코드를 지정 (다국어 코드의 경우 iMGT 내 다국어 목록, 다국어 목록 관리 에서 관리) |
mxmodule.xapi.SetControlProperty "Btn1", "LanguageCode", "TEST VALUE" | ||
| LinkedControl | String | 동작 속성 하위의 LinkedControl속성, 해당 조건 컨트롤의 선택 값에 따라 Refresh 할 객체를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", | ||
| Macro | String | 동작 속성 하위의 Macro속성, 해당 조건 컨트롤의 VBA Macro를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Macro", "TEST VALUE" | ||
| Visible | Bool | 동작 속성 하위의 Visible 속성, 해당 조건 컨트롤의 표시 여부를 True, False로 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Visible", True mxmodule.xapi.SetControlProperty "Btn1", "Visible", False | ||
| NotNull | Bool | 동작 속성 하위의 NotNull 속성, 해당 조건 컨트롤의 필수 입력 여부를 True, False로 지정 |
mxmodule.xapi.SetControlProperty "TxtBox1", "NotNull", True mxmodule.xapi.SetControlProperty "TxtBox1", "NotNull", False | ||
| ReadOnly | Bool | 동작 속성 하위의 ReadOnly 속성, 해당 조건 컨트롤의 읽기 전용 모드 선택 여부를 True, False로 지정 |
mxmodule.xapi.SetControlProperty "TxtBox1", "ReadOnly", True mxmodule.xapi.SetControlProperty "TxtBox1", "ReadOnly", False | ||
| LinkedControl | String | 동작 속성 하위의 LinkedControl 속성, 해당 컨트롤의 값 변경에 따라 Refresh해야 할 객체를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "LinkedControl", "ComboBox1" | ||
| BackgroundColor | String | 디자인 속성 하위의 BackgroundColor 속성, 해당 조건 컨트롤의 배경색을 지정 ARGB, RGB를 HexCode로 입력하거나 시스템에서 인식하는 색상을 문자열로도 입력 가능 |
mxmodule.xapi.SetControlProperty "Btn1", "BackgroundColor", "#FF0058D6" mxmodule.xapi.SetControlProperty "Btn1", "BackgroundColor", "#49B000" mxmodule.xapi.SetControlProperty "Btn1", "BackgroundColor", "Black" | ||
| Border | String | 디자인 속성 - BorderStyle 하위의 Border 속성, 해당 조건 컨트롤의 테두리 두께를 지정 전체 테두리 값을 한번에 지정하거나 좌측, 상단, 우측 하단을 차례로 지정 가능 |
mxmodule.xapi.SetControlProperty "Btn1", "Border", "5" mxmodule.xapi.SetControlProperty "Btn1", "Border", "5,5,5,5" | ||
| BorderColor | String | 디자인 속성 - BorderStyle 하위의 BorderColor 속성, 해당 조건 컨트롤의 테두리 색상을 지정 ARGB, RGB를 HexCode로 입력하거나 시스템에서 인식하는 색상을 문자열로도 입력 가능 |
mxmodule.xapi.SetControlProperty "Btn1", "BorderColor", "#FF0058D6" mxmodule.xapi.SetControlProperty "Btn1", "BorderColor", "#49B000" mxmodule.xapi.SetControlProperty "Btn1", "BorderColor", "Black" | ||
| ContentAlignment | String | 디자인 속성 하위의 ContentAlignment 속성, 해당 조건 컨트롤의 Text 위치를 지정 좌측 상단부터 우측 하단까지 차례대로 "TopLeft", "TopCenter", "TopRight", "MiddleLeft", "MiddleCenter", "MiddleRight", "BottomLeft", "BottomCenter", "BottomRight" 값을 입력하여 설정 |
mxmodule.xapi.SetControlProperty "Btn1", "ContentAlignment ", "TopLeft" mxmodule.xapi.SetControlProperty "Btn1", "ContentAlignment ", "BottomCenter" | ||
| Docking.Bottom | Bool | 디자인 속성 - Docking 하위의 Bottom 속성, 해당 조건 컨트롤을 하단에 고정할지 지정 True, False로 지정 가능하며 해당 옵션 활성화 시 Top 값이 변경될 수 있음 |
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Bottom ", True mxmodule.xapi.SetControlProperty "Btn1", "Docking.Bottom ", False | ||
| Docking.HoldSize | Bool | 디자인 속성 - Docking 하위의 HoldSize 속성, Docking선택과 상관없이 해당 조건 컨트롤의 크기를 고정 True, False로 지정 가능하며 양쪽 방향의 Docking (Top/Bottom, Left/Right)이 활성화 될 경우 해당 조건 컨트롤의 크기가 변경되는 것을 방지함 |
mxmodule.xapi.SetControlProperty "Btn1", "Docking.HoldSize", True mxmodule.xapi.SetControlProperty "Btn1", "Docking.HoldSize", False | ||
| Docking.Left | Bool | 디자인 속성 - Docking 하위의 Left 속성, 해당 조건 컨트롤을 좌측에 고정할지 지정 True, False로 지정 가능하며 해당 옵션 활성화 시 Left 값이 변경될 수 있습니다. |
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Left", True mxmodule.xapi.SetControlProperty "Btn1", "Docking.Left", False | ||
| Docking.Margin | String | 디자인 속성 - Docking 하위의 Margin 속성, 해당 조건 컨트롤을 고정했을 시 여백을 지정 전체 여백 값을 한번에 지정하거나 좌측, 상단, 우측 하단을 차례로 지정 가능 |
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Margin", "5" mxmodule.xapi.SetControlProperty "Btn1", "Docking.Margin", "5,5,5,5" | ||
| Docking.Right | Bool | 디자인 속성 - Docking 하위의 Right 속성, 해당 조건 컨트롤을 우측에 고정할지 지정 True, False로 지정 가능하며 해당 옵션 활성화 시 Left 값이 변경될 수 있습니다. |
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Right", True mxmodule.xapi.SetControlProperty "Btn1", "Docking.Right", False | ||
| Docking.Top | Bool | 디자인 속성 - Docking 하위의 Top 속성, 해당 조건 컨트롤을 상단에 고정할지 지정 True, False로 지정 가능하며 해당 옵션 활성화 시 Top 값이 변경될 수 있습니다. |
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Top", True mxmodule.xapi.SetControlProperty "Btn1", "Docking.Top", False | ||
| Font | String | 디자인 속성 - FontStyle 하위의 Font 속성, Text에 입력된 문자열의 FontFamily와 FontSize를 지정 PropertyWindow 내에서 직접 지정 시 선택 가능한 스타일, 효과(취소선, 밑줄)의 경우 현재 지원 불가능 각각 'Name=폰트명', 'Size=크기'의 형태로 입력해야 정상적으로 적용됨 |
mxmodule.xapi.SetControlProperty "Btn1", "Font", "Name=맑은 고딕, Size=13.5" mxmodule.xapi.SetControlProperty "Btn1", "Font", "Name=맑은 고딕" mxmodule.xapi.SetControlProperty "Btn1", "Font", "Size=13.5" | ||
| ForegroundColor | String | 디자인 속성 - FontStyle 하위의 ForegroundColor 속성, Text에 입력된 문자열의 색상을 지정 ARGB, RGB를 HexCode로 입력하거나 시스템에서 인식하는 색상을 문자열로도 입력 가능 |
mxmodule.xapi.SetControlProperty "Btn1", "ForegroundColor", "#FF0058D6" mxmodule.xapi.SetControlProperty "Btn1", "ForegroundColor", "#49B000" mxmodule.xapi.SetControlProperty "Btn1", "ForegroundColor", "Black" | ||
| Height | Double | 디자인 속성 하위의 Height 속성, 해당 조건 컨트롤의 높이 크기를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Height", 30 | ||
| Left | Double | 디자인 속성 하위의 Left 속성, 해당 조건 컨트롤의 좌측 여백을 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Left", 30 | ||
| TabIndex | Int | 디자인 속성 하위의 TabIndex 속성, Viewer에서 탭키를 누를 시 해당 조건 컨트롤의 우선순위를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "TabIndex", 3 | ||
| Top | Double | 디자인 속성 하위의 Left 속성, 해당 조건 컨트롤의 상단 여백을 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Top", 30 | ||
| Width | Double | 디자인 속성 하위의 Width 속성, 해당 조건 컨트롤의 너비 크기를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "Width", 30 | ||
| ZIndex | Int | 디자인 속성 하위의 ZIndex 속성, 조건 영역 내 해당 조건 컨트롤의 수직 우선순위를 지정 |
mxmodule.xapi.SetControlProperty "Btn1", "ZIndex", 30 | ||
- 레이블 없음