2007 Office Fluent Ribbon을 사용자 지정 (개발자 대상) (2부)

http://msdn.microsoft.com/ko-kr/library/aa338199

2007 Office Fluent Ribbon을 사용자 지정 (개발자 대상) (2부)

소개: 이 문서에는 리본 사용자 인터페이스의 컨트롤 및 메서드 서명에 관한 레퍼런스 백서가 기재되어 있습니다 .

Frank Rice, Microsoft Corporation

Ken Getz, MCW Technologies, LLC

발행 : 2006 년 5 월

업데이트 : 2006 년 11 월

적용 대상 : 2007 Microsoft Office Suites, Microsoft Office Access 2007, Microsoft Office Excel 2007, Microsoft Office PowerPoint 2007, Microsoft Office Outlook 2007, Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office system

목차

• 소개

• 리본 컨트롤 설명, 속성 및 자식 컨트롤 정보

• 요약

Microsoft Office Fluent 사용자 인터페이스 (UI) 기능은 현재의 Microsoft Office 응용 프로그램의 계층 메뉴, 도구 막대 및 작업 윈도우를 사용한 UI 를 대신하는 효율성과 검색 성이 향상된 보다 간단한 인터페이스 시스템입니다. UI 의 확장기능에 의해서 도입된 혁신적 모델을 사용하여 사용자 경험을 향상시킬 수 있습니다. Fluent UI 를 구성하는 구성요소는 확장 마크업 언어 (XML) 및 종래의 프로그래밍 언어 중 1 개를 사용하여 조작합니다. 이후의 섹션에는 Fluent UI 의 사용자 지정에 사용하는 각 구성요소, 메서드 및 속성 정의와 설명을 기재합니다. 이 설명을 참고로 하여, 풍부한 기능을 갖춘 직감적인 환경을 구축하면, 고객의 효율성과 생산성을 최대한으로 향상시킬 수 있습니다.

리본 컨트롤에 대한 설명, 속성 및 자식 컨트롤 정보

다음의 XML 레퍼런스는 리본 컨트롤의 마크 업에 대해 설명합니다. 리본에 고유한 XML 에 관한 설명과 기본적인 컨트롤을 위한 XML 에 관한 설명의 2 개의 메인 섹션으로 구성됩니다.

리본 XML

다음의 XML 레퍼런스는 리본에 고유합니다.

customUI

모든 리본 사용자 지정의 루트 태그.

속성(Attributes)

공통 : 없음

표 1. Fluent UI 컨테이너 속성과 메서드

속성/메서드	형식/액션	설명
xmlns	String	http://schemas.microsoft.com/office/2006/01/customui 로 설정해야 합니다.
onLoad	콜백	리본의 로드로서 콜백 프로시저에 리본의 매개 변수를 건네줍니다. 이것에 의해, 관련 코드가 리본 참조를 보관하여 다음에 사용할 수 있습니다. 문서 「2007 Office Fluent Ribbon을 사용자 지정하는 (개발자 대상) (파트 1/3)」의 「Fluent UI 를 동적으로 업데이트 한다」를 참조해 주세요.
loadImage	콜백	리본에 필요한 모든 이미지를 로드하는 단일 프로시저를 생성할 수 있습니다. 문서 「2007 Office Fluent Ribbon을 사용자 지정하는 (개발자 대상) (파트 1/3)」의 「이미지 로드」를 참조해 주세요.

자식 컨트롤

commands, ribbon

commands

글로벌에 재사용 되는 커멘드를 보관합니다.

속성

없음

자식 컨트롤

command

command

재사용되는 커멘드를 나타냅니다.

속성

공통 : enabled, getEnabled, idMso (필수), onAction

자식 컨트롤

없음

ribbon

Fluent UI 를 나타냅니다.

속성

표 2. Fluent UI 속성

속성	값	설명
startFromScratch	True, False, 1, 0	True 로 설정하면, 기본 제공 메인 탭이 표시되지 않고, 최소한의 [File] 메뉴가 표시됩니다.

자식 컨트롤

contextualTabs, officeMenu, qat, tabs

contextualTabs

특정 개체의 종류 (그림 도구 등)가 선택되었을 때에 표시되는 탭.

속성

없음

자식 컨트롤

tabSet

tabSet

탭 콘트롤의 컬렉션을 나타냅니다.

속성

공통 : getVisible, idMso (필수), visible

자식 컨트롤

tab

qat

퀵 액세스 도구 막대. [start from scratch] 모드의 경우만 생성할 수 있습니다.

속성

없음

자식 컨트롤

　documentControls, sharedControls

sharedControls

문서 사이에 공유되는 컨트롤 (일반적으로는 　documentControls 을 사용하고, sharedControls는 사용하지 않습니다).

속성

없음

자식 컨트롤

button, control, separator

　documentControls

문서 고유의 컨트롤.

속성

없음

자식 컨트롤

button, control, separator

officeMenu

Microsoft Office 메뉴에 포함된 컨트롤.

속성

없음

자식 컨트롤

button, checkbox, control, dynamicMenu, gallery, menu, menuSeparator, splitButton, toggleButton

tabs

탭 콘트롤을 보관합니다.

속성

없음

자식 컨트롤

tab

tab

리본상의 탭을 나타냅니다.

속성

공통 : getKeytip, getLabel, getVisible, id, idMso, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, tag, visible

자식 컨트롤

group

group

리본상의 탭내 그룹을 나타냅니다.

속성

공통 : getImage, getImageMso, getKeytip, getLabel, getScreentip, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, screentip, supertip, visible

자식 컨트롤

box, button, buttonGroup, checkBox, comboBox, control, dialogBoxLauncher, dropDown, editBox, gallery, labelControl, menu, separator, splitButton, toggleButton

기본적인 컨트롤

다음의 XML 레퍼런스에서 기본적인 컨트롤을 설명합니다.

box

그룹내에 컨트롤을 배치합니다.

속성

공통 : getVisible, id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, visible

표 3. box 의 속성

속성	값	설명
boxStyle	Horizontal, Vertical	상자내 컨트롤의 시각적인 흐름을 결정합니다.

자식 컨트롤

box, button, buttonGroup, checkBox, comboBox, control, dropdown, dynamicMenu, editBox, gallery, labelControl, menu, splitButton, toggleButton

button

버튼 컨트롤을 나타냅니다.

속성

공통 : description, enabled, getDescription, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSize, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, onAction, screentip, showImage, showLabel, size, supertip, tag, visible

자식 컨트롤

없음

buttonGroup

버튼의 그룹화를 나타냅니다.

속성

공통 : getVisible, id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, visible

자식 컨트롤

button, control, dynamicMenu, gallery, menu, splitButton, toggleButton

checkBox

체크 박스 컨트롤을 나타냅니다.

속성

공통 : description, enabled, getDescription, getEnabled, getKeytip, getLabel, getScreentip, getSupertip, getVisible, id, idMso, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, onAction, screentip, supertip, tag, visible

표 4. checkBox 의 속성

속성	형식/액션	설명
getPressed	콜백	체크 박스 컨트롤이 눌렸는지 여부를 표시할 수 있습니다.

자식 컨트롤

없음

comboBox

콤보 상자 컨트롤을 나타냅니다.

속성

공통 : enabled, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, label, screentip, showImage, showLabel, supertip, tag, visible

editBox 와 공통 : getText, maxLength, onChange, sizeString

표 5. comboBox 의 속성과 메서드

메서드	속성/메서드	설명
getItemCount	콜백	이 comboBox 내의 항목수를 취득합니다.
getItemID	콜백	이 항목의 ID 를 취득합니다.
getItemImage	콜백	이 항목의 이미지를 취득합니다.
getItemLabel	콜백	이 항목의 라벨을 취득합니다.
getItemScreentip	콜백	이 항목의 힌트를 취득합니다.
getItemSupertip	콜백	이 항목의 스크린팁을 취득합니다.
showItemImage	True, False, 1, 0	항목 이미지를 표시할지를 지정합니다.

자식 컨트롤

item

dialogBoxLauncher

그룹의 대화상자 실행 프로그램을 보관합니다. 그룹에는 1 개의 dialogBoxLauncher 컨트롤만을 보관 할 수 있습니다. 이 컨트롤에는 버튼 컨트롤을 보관해야 합니다. 또, 이 컨트롤은 포함된 그룹 요소내의 마지막의 요소로서 표시되어야 합니다.

속성

없음

자식 컨트롤

button (필수)

dropDown

드롭 다운 목록 상자를 나타냅니다.

속성

공통 : enabled, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, onAction, screentip, showImage, showLabel, supertip, tag, visible

comboBox 와 공통 : getItemCount, getItemID, getItemImage, getItemLabel, getItemScreentip, getItemSupertip, showItemImage

editBox 와 공통 : sizeString

표 6. dropDown 의 속성과 메서드

메서드	액션	설명
getSelectedItemID	콜백	ID에서 선택할 필요가 있는 항목을 문의합니다. 이 속성 또는 getSelectedItemIndex 속성의 한쪽을 지정합니다.
getSelectedItemIndex	콜백	인덱스에서 선택할 필요가 있는 항목을 문의합니다. 이 속성 또는 getSelectedItemId 속성의 한쪽을 지정합니다.
showItemLabel	True, False, 1, 0	항목이 라벨을 표시할지 보여줍니다.

자식 컨트롤

item

dynamicMenu

실행시에 생성 되는 메뉴를 나타냅니다.

속성

공통 : description, enabled, getDescription, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSize, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, screentip, showImage, showLabel, supertip, tag, visible

표 7. dynamicMenu 의 메서드

메서드	액션	설명
getContent	콜백	동적 메뉴 내용을 포함한 XML 문자열을 취득합니다.

getContent 메서드는 메뉴로 설정하기 위해 다음과 같이 XML 를 반환해야 합니다.

복사

<menu xmlns="http://schemas.microsoft.com/office/2006/01/customui">  <button id="dynaButton" label="Button"    onAction="OnAction" imageMso="FoxPro"/>  <toggleButton id="dynaToggleButton" label="Toggle Button"    onAction="OnToggleAction" image="logo.bmp"/>  <menuSeparator id="div2"/>  <dynamicMenu id="subMenu" label="Sub Menu" getContent="GetSubContent" /></menu>

자식 컨트롤

menu 와 마찬가지로, getContent 콜백을 사용하여 설정됩니다.

editBox

편집 상자 컨트롤을 나타냅니다.

속성

공통 : enabled, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, screentip, showImage, showLabel, supertip, tag, visible

표 8. editBox 속성과 메서드

속성/메서드	형식/액션	설명
getText	콜백	editBox 에 표시하는 텍스트를 취득합니다.
maxLength	Integer	사용자를 입력할 수 있는 최대 문자수.
onChange	콜백	사용자가 editBox 값을 변경하고, 확정했을 때에 호출된 함수.
sizeString	String	editBox 크기를 결정하는 "wwwwwwwwww" 와 같은 문자열.

자식 컨트롤

없음

gallery

갤러리 컨트롤을 나타냅니다.

속성

공통 : description, enabled, getDescription, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSize, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, onAction, screentip, showImage, showLabel, size, supertip, tag, visible

comboBox 와 공통 : getItemCount, getItemID, getItemImage, getItemLabel, getItemScreentip, getItemSupertip, showItemImage, showItemLabel

dropDown 와 공통 : getSelectedItemID, getSelectedItemIndex

editBox 와 공통 : sizeString

표 9. gallery 속성과 메서드

속성/메서드	형식/액션	설명
columns	Integer	이 갤러리에 표시하는 열수..
getItemHeight	콜백	항목의 높이 (픽셀)를 문의합니다.
getItemWidth	콜백	항목의 폭 (픽셀)을 문의합니다.
itemHeight	Integer	항목의 높이 (픽셀).
itemWidth	Integer	항목의 폭 (픽셀).
rows	Integer	이 갤러리에 표시하는 행수.

자식 컨트롤

item, button.button 는 항목의 뒤로 표시되어 갤러리의 맨 밑에 표시되어야 합니다.

item

gallery, dropDown 또는 comboBox 의 정적 항목.정적 항목을 지정했을 경우, 동적 항목은 지정할 수 없습니다.

속성

공통 : id, image, imageMso, label, screentip, supertip

자식 컨트롤

없음

labelControl

라벨 컨트롤을 나타냅니다.

속성

공통 : enabled, getEnabled, getLabel, getScreentip, getShowLabel, getSupertip, getVisible, id, idMso, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, label, screentip, showLabel, supertip, tag, visible

자식 컨트롤

없음

menu

메뉴 컨트롤을 나타냅니다.

속성

공통 : description, enabled, getDescription, getEnabled, getImage, getImageMso, getKeytip, getLabel, getScreentip, getShowImage, getShowLabel, getSize, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, screentip, showImage, showLabel, size, supertip, tag, visible

표 10. menu 의 속성

속성	값	설명
itemSize	Normal, Large	메뉴내의 항목 크기. 대형(Large) 메뉴 항목에는 Description 속성이 표시됩니다.

자식 컨트롤

button, checkBox, control, dynamicMenu, gallery, menu, menuSeparator, splitButton, toggleButton

menuSeparator

메뉴 아이템간의 구분선을 나타냅니다 (옵션으로 텍스트 라벨을 포함할 수도 있습니다).

속성

공통 : id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ

표 11. menuSeparator 의 속성과 메서드

속성	형식/액션	설명
title	String	단락 기호 텍스트.
getTitle	콜백	단락 기호 텍스트에 대한 콜백.

자식 컨트롤

없음

separator

컨트롤 사이의 구분선을 나타냅니다.

속성

공통 : getVisible, id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, visible

자식 컨트롤

없음

splitButton

분할 버튼 컨트롤을 나타냅니다.

속성

공통 : enabled, getEnabled, getKeytip, getShowLabel, getSize, getSupertip, getVisible, id, idMso, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, showLabel (버튼 컨트롤 또는 토글 버튼 컨트롤 중 누가 그 라벨을 표시하는지를 결정합니다), size, supertip, tag, visible

자식 컨트롤

button 또는 toggleButton (필수. 한쪽을 메뉴 앞에 표시) : 분할 버튼 컨트롤의 메인 버튼.

menu (필수) : 분할 버튼 컨트롤 메뉴.

toggleButton

토글 버튼 컨트롤을 나타냅니다.

속성

공통 : description, enabled, getDescription, getEnabled, getImage, getImageMso, getKeytip, getLabel, getPressed, getScreentip, getShowImage, getShowLabel, getSize, getSupertip, getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, onAction, screentip, showImage, showLabel, size, supertip, tag, visible

표 12. toggleButton 속성

속성	형식/액션	설명
getPressed	콜백	토글 버튼 컨트롤이 눌렸는지 지정할 수 있습니다.

자식 컨트롤

없음

요약

이 문서 및 같은 제목의 문서 (1/3,3/3)는 고객의 요구에 맞춘 전문 개발에 필요한 정보를 제공합니다. 첫번째 문서에 기재된 사용자 지정의 예를 기본으로 UI 를 생성하면, 고객이 가장 필요로 하는 컨트롤이나 옵션을 조작하기 쉬운 장소에 배포 할 수 있습니다. 이 문서에 있는 관련 정보를 참고하여, 리본 UI 의 형태를 세부 사항에 정의할 수 있습니다. 이 문서의 시리즈의 3/3 에는 자주 물어보는 질문 목록(FAQ)가 있습니다. 기재된 정보를 적용하여 매력적인 독자적 솔루션을 생성하여 다른 응용 프로그램과 차별화할 수 있습니다.