코드 블럭

language	vb
theme	Emacs
title	Example
linenumbers	true

Sub SetControlProperty()

    Dim mxmodule As Object
    Set mxmodule = Application.COMAddIns.Item("iMATRIX6iMATRIX.ExcelModule").Object


	mxmodule.xapi.SetControlProperty "Btn1", "Visible", True
	
End Sub

Property 별 상세 적용 방법

...

(2021.04.09 UPDATE

...

)

펼치기

title	Property 상세 적용법

제품 버전에 따라 Property가 없을 수 있습니다.

...

펼치기

title	Property 상세 적용법

DataSource, DefineItems 속성의 경우 해당 XAPI로 컨트롤이 불가능합니다.

Name

Type

Description

String

Basic 속성 하위의 Description 속성, 해당 조건 컨트롤의 설명을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Description", "TEST VALUE"

InitCell

String

Basic 속성 하위의 InitCell 속성, 해당 조건 컨트롤의 초기값을 가져올 Cell의 주소를 지정

해당 셀의 위치를 문자열로 입력 하거나 Excel 내 이름정의 된 이름을 입력하여 지정 가능

코드 블럭

language	vb
theme	Emacs

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 속성, 해당 조건 컨트롤의 이름을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Name", "TEST VALUE"

LinkedCell

String

Basic 속성 하위의 LinkedCell 속성, 해당 조건 컨트롤의 값을 변경 시 변경사항이 적용될 Cell의 주소를 지정

(단일 Cell만이 지정 가능)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TxtBox1", "LinkedCell", "'V1'!$C$5"

LinckedCellText

String

Basic 속성 하위의 LinckedCellText 속성, 해당 조건 컨트롤의 값을 변경 시 변경사항의 데이터 이름에 해당하는 값이 적용될 Cell의 주소를 지정

(LinkedCell 의 경우 데이터의 코드 / LinkedCellText는 데이터의 이름을 출력, 단일 Cell만이 지정 가능)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "ComboBox1", "LinckedCellText", "'V1'!$C$5"

FilterOption

String

FilterOption 속성, 해당 조건 컨트롤의 검색 기능이 있을 시 데이터 내 검색 옵션을 지정

(Or 의 경우 ' , ' 로 구분 / And 의 경우 ' '으로 구분하여 사용)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "ComboBox1", "FilterOption", "Or"
mxmodule.xapi.SetControlProperty "ComboBox1", "FilterOption", "And"

FilterTarget

String

FilterTarget 속성, 해당 조건 컨트롤의 검색 기능 사용 시 데이터 내 검색 대상을 지정

(CodeorName : 코드와 이름 모두 검색 / Name : 이름만 검색)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "ComboBox1", "FilterTarget", "CodeOrName"
mxmodule.xapi.SetControlProperty "ComboBox1", "FilterTarget", "Name"

MatchCase

Bool

MatchCase 속성, 해당 조건 컨트롤의 검색 기능 사용 시 대소문자 구분 유무 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "ComboBox1", "MatchCase", True
mxmodule.xapi.SetControlProperty "ComboBox1", "MatchCase", False

Text

String

데이터 속성 하위의 Text 속성, 해당 조건 컨트롤에 표시되는 문자열을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Text", "TEST VALUE"

ToolTip

String

데이터 속성 하위의 ToolTip 속성, 해당 조건 컨트롤의 툴팁으로 표시되는 문자열을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "ToolTip", "TEST VALUE"

MaxLength

Int

데이터 속성 하위의 MaxLength 속성, 해당 조건 컨트롤에 표시되는 문자열의 자릿수를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TxtBox1", "MaxLength", 5

Format

String

데이터 속성 하위의 Format 속성, 해당 조건 컨트롤의 값이 표현될 형식을 지정

(# : 숫자 0~9 입력 가능)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "NumBox1", "Format", "###.00"

Maximum

Double

데이터 속성 하위의 Maximum 속성, 해당 조건 컨트롤에 표시되는 실수의 최대값을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "NumBox1", "Maximum", 200

Minimum

Double

데이터 속성 하위의 Minimum 속성, 해당 조건 컨트롤에 표시되는 실수의 최소값을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "NumBox1", "Minimum", 0

Number

Double

데이터 속성 하위의 Number 속성, 해당 조건 컨트롤에 표시되는 실수값을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "NumBox1", "MaxLength", 10

AllItem

String

데이터 속성 하위의 AllItem 속성, 해당 조건 컨트롤의 전체 항목을 선택했을 때 Linked Cell에 표시될 값을 지정

(조건 컨트롤 ComboBox의 경우 선행 옵션 : DisplayAll 속성값이 True)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "ComboBox1", "AllItem", "TEST VALUE"

DataRange

String

데이터 속성 하위의 DataRange 속성, 해당 조건 컨트롤에 표시할 항목을 지정

(이전에 연결되어있던 데이터는 초기화되며 영역으로 지정할 경우 세로로 열거된 항목들만 가능)

코드 블럭

language	vb
theme	Emacs

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 속성, 해당 조건 컨트롤에 [전체] 표시 유무 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "ComboBox1", "DisplayAll", True
mxmodule.xapi.SetControlProperty "ComboBox1", "DisplayAll", False

DescriptionPath

String

데이터 속성 하위의 DescriptionPath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 설명이 될 컬럼을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TreeCombo1", "DescriptionPath", "Des_Path"

ImageNamePath

String

데이터 속성 하위의 ImageNamePath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 사용할 이미지 경로 컬럼을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TreeCombo1", "ImageNamePath", "Img_Path"

KeyPath

String

데이터 속성 하위의 KeyPath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 전달 할 값의 컬럼을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TreeCombo1", "KeyPath", "Key_Path"

NamePath

String

데이터 속성 하위의 NamePath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 표시될 값의 컬럼을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TreeCombo1", "NamePath", "Name_Path"

ParentKeyPath

String

데이터 속성 하위의 ParentKeyPath 속성, 해당 트리 컨트롤의 바인딩된 데이터 소스에 전달받은 값의 부모가 될 컬럼을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TreeCombo1", "ParentKeyPath", "ParentKey_Path"

ValuePath

String

데이터 속성 하위의 ValuePath 속성, 해당 트리 컨트롤의 LinkedCell에 출력될 값을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TreeCombo1", "ValuePath", "Value_Path"

DateFormat

String

데이터 속성 하위의 DateFormat 속성, 해당 달력 컨트롤의 데이터 날짜 형식을 설정

(년 = y, 월 = M, 일 = d, 주 = w 로 작성)

코드 블럭

language	vb
theme	Emacs

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 속성, 해당 달력 컨트롤에 표시되는 날짜의 최대값을 지정

코드 블럭

language	vb
theme	Emacs

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 속성, 해당 달력 컨트롤에 표시되는 날짜의 최소값을 지정

코드 블럭

language	vb
theme	Emacs

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 속성, 해당 달력 컨트롤의 표시영역에 출력할 날짜 형식을 설정

코드 블럭

language	vb
theme	Emacs

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에 전달되는 값을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Check1", "CheckValue", "OP_CHECK"

UnCheckValue

String

데이터 속성 하위의 UnCheckValue 속성, 해당 컨트롤이 UnChecked 상태일 때 LinkedCell에 전달되는 값을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Check1", "UnCheckValue", "OP_UNCHECK"

GroupName

String

데이터 속성 하위의 GroupName 속성, 라디오 버튼 컨트롤의 그룹 이름을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Radio1", "GroupName", "G1"
mxmodule.xapi.SetControlProperty "Radio2", "GroupName", "G1"

Image

String

데이터 속성 하위의 Image 속성, 이미지 컨트롤에 표시할 이미지를 지정

(이미지는 설치경로\reports\WEB_IMAGES 내에 존재하는 파일)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Img1", "Image", "robot.png"

ImageOn

String

데이터 속성 하위의 ImageOn 속성, 이미지 컨트롤에 커서를 올렸을 때 표시할 이미지를 지정

(이미지는 설치경로\reports\WEB_IMAGES 내에 존재하는 파일)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Img1", "ImageOn", "robot.png"

AuthorizationCode

String

동작 속성 하위의 AuthorizationCode 속성, 해당 조건 컨트롤에 권한 코드를 지정

(권한 코드의 경우 iMGT 내 버튼관리, 버튼권한관리 에서 관리)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "AuthorizationCode", ""

Enabled

Bool

동작 속성 하위의 Enabled 속성, 해당 조건 컨트롤의 사용 여부를 True, False로 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Enabled", True
mxmodule.xapi.SetControlProperty "Btn1", "Enabled", False

LanguageCode

String

동작 속성 하위의 LanguageCode 속성, 해당 조건 컨트롤의 다국어 코드를 지정

(다국어 코드의 경우 iMGT 내 다국어 목록, 다국어 목록 관리 에서 관리)

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "LanguageCode", "TEST VALUE"

LinkedControl

String

동작 속성 하위의 LinkedControl속성, 해당 조건 컨트롤의 선택 값에 따라 Refresh 할 객체를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1",

Macro

String

동작 속성 하위의 Macro속성, 해당 조건 컨트롤의 VBA Macro를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Macro", "TEST VALUE"

Visible

Bool

동작 속성 하위의 Visible 속성, 해당 조건 컨트롤의 표시 여부를 True, False로 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Visible", True
mxmodule.xapi.SetControlProperty "Btn1", "Visible", False

NotNull

Bool

동작 속성 하위의 NotNull 속성, 해당 조건 컨트롤의 필수 입력 여부를 True, False로 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TxtBox1", "NotNull", True
mxmodule.xapi.SetControlProperty "TxtBox1", "NotNull", False

ReadOnly

Bool

동작 속성 하위의 ReadOnly 속성, 해당 조건 컨트롤의 읽기 전용 모드 선택 여부를 True, False로 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "TxtBox1", "ReadOnly", True
mxmodule.xapi.SetControlProperty "TxtBox1", "ReadOnly", False

LinkedControl

String

동작 속성 하위의 LinkedControl 속성, 해당 컨트롤의 값 변경에 따라 Refresh해야 할 객체를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "LinkedControl", "ComboBox1"

BackgroundColor

String

디자인 속성 하위의 BackgroundColor 속성, 해당 조건 컨트롤의 배경색을 지정

ARGB, RGB를 HexCode로 입력하거나 시스템에서 인식하는 색상을 문자열로도 입력 가능

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "BackgroundColor", "#FF0058D6"
mxmodule.xapi.SetControlProperty "Btn1", "BackgroundColor", "#49B000"
mxmodule.xapi.SetControlProperty "Btn1", "BackgroundColor", "Black"

Border

String

디자인 속성 - BorderStyle 하위의 Border 속성, 해당 조건 컨트롤의 테두리 두께를 지정

전체 테두리 값을 한번에 지정하거나 좌측, 상단, 우측 하단을 차례로 지정 가능

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Border", "5"
mxmodule.xapi.SetControlProperty "Btn1", "Border", "5,5,5,5"

BorderColor

String

디자인 속성 - BorderStyle 하위의 BorderColor 속성, 해당 조건 컨트롤의 테두리 색상을 지정

ARGB, RGB를 HexCode로 입력하거나 시스템에서 인식하는 색상을 문자열로도 입력 가능

코드 블럭

language	vb
theme	Emacs

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" 값을 입력하여 설정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "ContentAlignment ", "TopLeft"
mxmodule.xapi.SetControlProperty "Btn1", "ContentAlignment ", "BottomCenter"

Docking.Bottom

Bool

디자인 속성 - Docking 하위의 Bottom 속성, 해당 조건 컨트롤을 하단에 고정할지 지정

True, False로 지정 가능하며 해당 옵션 활성화 시 Top 값이 변경될 수 있음

코드 블럭

language	vb
theme	Emacs

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)이 활성화 될 경우 해당 조건 컨트롤의 크기가 변경되는 것을 방지함

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Docking.HoldSize", True
mxmodule.xapi.SetControlProperty "Btn1", "Docking.HoldSize", False

Docking.Left

Bool

디자인 속성 - Docking 하위의 Left 속성, 해당 조건 컨트롤을 좌측에 고정할지 지정

True, False로 지정 가능하며 해당 옵션 활성화 시 Left 값이 변경될 수 있습니다.

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Docking.Left", True
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Left", False

Docking.Margin

String

디자인 속성 - Docking 하위의 Margin 속성, 해당 조건 컨트롤을 고정했을 시 여백을 지정

전체 여백 값을 한번에 지정하거나 좌측, 상단, 우측 하단을 차례로 지정 가능

코드 블럭

language	vb
theme	Emacs

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 값이 변경될 수 있습니다.

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Docking.Right", True
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Right", False

Docking.Top

Bool

디자인 속성 - Docking 하위의 Top 속성, 해당 조건 컨트롤을 상단에 고정할지 지정

True, False로 지정 가능하며 해당 옵션 활성화 시 Top 값이 변경될 수 있습니다.

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Docking.Top", True
mxmodule.xapi.SetControlProperty "Btn1", "Docking.Top", False

Font

String

디자인 속성 - FontStyle 하위의 Font 속성, Text에 입력된 문자열의 FontFamily와 FontSize를 지정

PropertyWindow 내에서 직접 지정 시 선택 가능한 스타일, 효과(취소선, 밑줄)의 경우 현재 지원 불가능

각각 'Name=폰트명', 'Size=크기'의 형태로 입력해야 정상적으로 적용됨

코드 블럭

language	vb
theme	Emacs

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로 입력하거나 시스템에서 인식하는 색상을 문자열로도 입력 가능

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "ForegroundColor", "#FF0058D6"
mxmodule.xapi.SetControlProperty "Btn1", "ForegroundColor", "#49B000"
mxmodule.xapi.SetControlProperty "Btn1", "ForegroundColor", "Black"

Height

Double

디자인 속성 하위의 Height 속성, 해당 조건 컨트롤의 높이 크기를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Height", 30

Left

Double

디자인 속성 하위의 Left 속성, 해당 조건 컨트롤의 좌측 여백을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Left", 30

TabIndex

Int

디자인 속성 하위의 TabIndex 속성, Viewer에서 탭키를 누를 시 해당 조건 컨트롤의 우선순위를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "TabIndex", 3

Top

Double

디자인 속성 하위의 Left 속성, 해당 조건 컨트롤의 상단 여백을 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Top", 30

Width

Double

디자인 속성 하위의 Width 속성, 해당 조건 컨트롤의 너비 크기를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "Width", 30

ZIndex

Int

디자인 속성 하위의 ZIndex 속성, 조건 영역 내 해당 조건 컨트롤의 수직 우선순위를 지정

코드 블럭

language	vb
theme	Emacs

mxmodule.xapi.SetControlProperty "Btn1", "ZIndex", 30

공간 바로가기

페이지 트리

버전 비교

이전 버전 32

새 버전 현재

키

Property 별 상세 적용 방법

(2021.04.09 UPDATE

)

공간 바로가기

페이지 트리

페이지 이력

버전 비교

이전 버전 32

새 버전 현재

키

Property 별 상세 적용 방법

(2021.04.09 UPDATE

)