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 |
https://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="https://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)가 있습니다. 기재된 정보를 적용하여 매력적인 독자적 솔루션을 생성하여 다른 응용 프로그램과 차별화할 수 있습니다.