VIZZARD Document Help

Plugin.xml

구현된 Plugin Class Library를 실행하기 위해, Plugin.xml 파일 정의 및 설정이 필요합니다.

파일 형식

  • Plugin.xml 기본 구조는 아래와 같습니다.

<?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> </VIZZARDManager>
  • Plugin 유형별 Tag가 추가된 구조

<?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> <Plugins> ... </Plugins> <SHControls> ... </SHControls> <KIOSK> ... </KIOSK> </VIZZARDManager>

Plugin 정의

  • TAG 설명

TAG

설명

Attribute

Plugins

Plugin 항목의 그룹 TAG 이며, VIZZARD 메뉴에 Plugin 메뉴 그룹의 이름을 설정합니다.

GroupTitle

Visible

Plugin

개별 Plugin 항목을 정의하며, Class Library의 Path, Namespace, Class 등을 정의합니다.

ID

Enable

ControlName

AssemblyPath

Menu

Plugin에 대한 메뉴 속성을 정의합니다.

Title

RelationShowControl

MenuButtonImageSize

ImagePath

DockingWindow

Plugin 컨테이너의 속성을 정의합니다.

Title

Position

Width

  • Plugins Attribute

Attribute

설명

예시

GroupTitle

Plugin 그룹 메뉴 이름

GroupTitle="My Plugins"

Visible

Plugin 메뉴 보이기/숨기기 설정

Visible="True"

Visible="False"

  • Plugin Attribute

Attribute

설명

예시

ID

Plugin 컨트롤의 ID

ID="1"

Enable

Plugin 메뉴 보이기/숨기기 설정

Enable="True"

Enable="False"

ControlName

네임스페이스 + "." + 클래스

MyPlugin.MyControl

AssemblyPath

Plugin 클래스 라이브러리의 빌드된 경로

AssemblyPath="C:\VIZZARD\MyPlugin.dll"

  • Menu Attribute

Attribute

설명

예시

Title

메뉴에 표시되는 Plugin 이름

Title="MyPlugin 기능"

RelationShowControl

Plugin 컨트롤 활성화 시 함께 실행되어야 할 Plugin ID

RelationShowControl="1,2,3"

ImagePath

메뉴에 표시할 이미지 경로

ImagePath="C:\VIZZARD\Menu.png"

MenuButtonImageSize

메뉴에 이미지를 지정하는 경우, 이미지 크기

Small Size : 0

Large Size : 1

MenuButtonImageSize="0"

MenuButtonImageSize="1"

  • DockingWindow Attribute

Attribute

설명

예시

Title

Plugin 컨테이너 창 이름

Title="My Plugin Control"

Position

Plugin 컨테이너 창 초기 표시 위치

TOP : 0

LEFT : 1

RIGHT : 2

BOTTOM : 3

FLOATING : 4

Position="2"

Width

Plugin 컨테이너 창 초기 가로 길이

Width="400"

  • Example Plugin.xml

<?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> <Plugins GroupTitle="My Plugins" Visible="True"> <Plugin ID="1" Enable="True" ControlName="MyPlugin.MyControl" AssemblyPath="C:\VIZZARD\MyPlugin.dll"> <Menu Title="MyPlugin 기능" RelationShowControl="" ImagePath="C:\VIZZARD\Menu.png" MenuButtonImageSize="1" /> <DockingWindow Title="My Plugin Control" Position="2" Width="400"/> </Plugin> </Plugins> </VIZZARDManager>
<?xml version="1.0" encoding="utf-8" ?> <?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> <Plugins GroupTitle="My Plugins" Visible="True"> <Plugin ID="1" Enable="True" ControlName="MyPlugin.MyControl" AssemblyPath="C:\VIZZARD\MyPlugin.dll"> <Menu Title="MyPlugin 기능" RelationShowControl="2" ImagePath="C:\VIZZARD\Menu.png" MenuButtonImageSize="1" /> <DockingWindow Title="My Plugin Control" Position="2" Width="400"/> </Plugin> <Plugin ID="2" Enable="True" ControlName="YourPlugin.YourControl" AssemblyPath="C:\VIZZARD\YourPlugin.dll"> <Menu Title="YourPlugin 기능" RelationShowControl="" ImagePath="C:\VIZZARD\YourMenu.png" MenuButtonImageSize="1" /> <DockingWindow Title="Your Plugin Control" Position="2" Width="400"/> </Plugin> </Plugins> </VIZZARDManager>

SHControl 정의

  • TAG 설명

TAG

설명

Attribute

SHControls

SHControl 항목의 그룹 TAG 이며, Attribute는 없습니다.

SHControl

SHControl 항목을 정의하며, Class Library의 Path, Namespace, Class 를 정의합니다.

Class

AssemblyPath

  • SHControl Attribute

Attribute

설명

예시

Class

네임스페이스 + "." + 클래스

Class="MySHControl.MyClass"

AssemblyPath

SHControl 클래스 라이브러리의 빌드된 경로

AssemblyPath="C:\VIZZARD\MySHControl.dll"

  • Example Plugin.xml

<?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> <SHControls> <SHControl Class="MySHControl.MyClass" AssemblyPath="C:\VIZZARD\MySHControl.dll" /> </SHControls> </VIZZARDManager>
<?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> <SHControls> <SHControl Class="MySHControl.MyClass" AssemblyPath="C:\VIZZARD\MySHControl.dll" /> <SHControl Class="YourSHControl.YourClass" AssemblyPath="C:\VIZZARD\YourSHControl.dll" /> </SHControls> </VIZZARDManager>

KIOSK 정의

  • TAG 설명

TAG

설명

Attribute

KIOSK

KIOSK 항목의 그룹 TAG 이며, Attribute는 없습니다.

Control

KIOSK Control 항목을 정의하며, Class Library의 Path, Namespace, Class 를 정의합니다.

Class

AssemblyPath

Tile

KIOSK Control 항목의 메뉴 타일 버튼에 대한 속성을 설정합니다.

Text

ItemSize

ImagePath

ImageAlignment

ImageToTextAlignment

TextAlignment

TextColor

BackColor

BackColor2

BorderColor

  • Control Attribute

Attribute

설명

예시

Class

네임스페이스 + "." + 클래스

Class="MyKIOSK.MyControl"

AssemblyPath

KIOSK 컨트롤 라이브러리의 빌드된 경로

AssemblyPath="C:\VIZZARD\MyKIOSK.dll"

  • Tile Attribute

Attribute

설명

예시

Text

TILE 메뉴 텍스트

Text="My KOSK 메뉴"

ItemSize

TILE 메뉴 크기

Default

Small

Medium

Wide

Large

ItemSize="Default"

ImagePath

TILE 메뉴 이미지 경로

ImagePath="C:\VIZZARD\Tile.png"

ImageAlignment

이미지 정렬

Default

TopLeft

TopCenter

TopRight

MiddleLeft

MiddleCenter

MiddleRight

BottomLeft

BottomCenter

BottomRight

Manual

ImageAlignment="MiddleCenter"

ImageToTextAlignment

Image 및 Text 정렬

Default

None

Top

Left

Right

Bottom

ImageToTextAlignment="Left"

TextAlignment

텍스트 정렬

Default

TopLeft

TopCenter

TopRight

MiddleLeft

MiddleCenter

MiddleRight

BottomLeft

BottomCenter

BottomRight

Manual

TextAlignment="MiddleCenter"

TextColor

텍스트 색상

TextColor="#AA2D2D2D"

BackColor

배경 색상

BackColor="#FFF376B4"

BackColor2

배경2 색상

BackColor2="#FFF376B4"

BorderColor

테두리 색상

BorderColor="#FFFFFFFF"

  • Example Plugin.xml

<?xml version="1.0" encoding="utf-8" ?> <VIZZARDManager> <KIOSK> <Control Class="MyKIOSK.KIOSKControl" AssemblyPath="C:\VIZZARD\MyKIOSK.dll"> <Tile Text="KIOSK 컨트롤" ItemSize="Wide" ImagePath="C:\VIZZARD\MyKIOSK.png" ImageAlignment="MiddleCenter" ImageToTextAlignment="Left" TextAlignment="MiddleCenter" TextColor="#AA2D2D2D" BackColor="#FFF376B4" BackColor2="#FFF376B4" BorderColor="#FFFFFFFF"/> </Control> </KIOSK> </VIZZARDManager>
Last modified: 04 3월 2024