Microsoft Word 2007. Меняем интерфейс. Часть 2.

24.04.2007
Новиков Максим Глебович.

Структура вложенности элементов пользовательского интерфейса.

При отсутствии описания элемента ищите информацию на вышележащем уровне.
Подлинник описания (англ.): http://msdn2.microsoft.com/en-us/library/aa338199.aspx

customUI — корневой элемент, описывающий переопределяемый пользовательский
интерфейс. (включает: commands, ribbon)
    commands — переопределяемые команды (включает: command)
        command — переопределяемая команда
    ribbon — лента (включает: tabs, contextualTabs, qat, officeMenu)
        tabs — постоянные вкладки (включает: tab)
            tab — вкладка (включает: group)
                group — группа (включает: box, button, buttonGroup, checkBox,
                comboBox, control, dialogBoxLauncher, dropDown, editBox, gallery,
                labelControl, menu, separator, splitButton, toggleButton)
                    box — контейнер для элементов (включает: box, button, 
                    buttonGroup, checkBox, comboBox, control, dropdown,
                    dynamicMenu, editBox, gallery, labelControl, menu,
                    splitButton, toggleButton)
                        box
                        button
                        buttonGroup
                        checkBox
                        comboBox
                        control 
                        dropDown
                        dynamicMenu — меню, создаваемое в процессе работы
                        (включает то же, что и обычное menu)
                        editBox
                        gallery
                        labelControl
                        menu
                        splitButton
                        toggleButton
                    button — кнопка
                    buttonGroup — контейнер для кнопок (включает: button, control,
                    dynamicMenu, gallery, menu, splitButton, toggleButton)
                        button
                        control
                        dynamicMenu
                        gallery
                        menu
                        splitButton
                        toggleButton
                    checkBox — чекбокс (флажок)
                    comboBox — комбобокс (поле выбора) (включает: item)
                        item — элемент списка
                    control — любой элемент управления ниже group
                    dialogBoxLauncher — кнопка запуска диалогового окна
                    (включает: button)
                        button
                    dropDown — ниспадающий список (открывающийся список)
                    (включает: item)
                        item — элемент списка
                    editBox — поле редактирования
                    gallery — галерея (включает: item, button)
                        item
                        button
                    labelControl — надпись
                    menu — меню (включает: button, checkBox, control, dynamicMenu,
                    gallery, menu, menuSeparator, splitButton, toggleButton)
                        button
                        checkBox
                        control
                        dynamicMenu
                        gallery
                        menu
                        menuSeparator — разделительная линия между элементами меню
                        splitButton
                        toggleButton
                    separator — разделительная линия между элементами управления
                    splitButton — кнопка с выбором действия (включает: button,
                    toggleButton, menu)
                        button
                        toggleButton
                        menu
                    toggleButton — фиксирующаяся кнопка
        contextualTabs — контекстные вкладки (включает: tabSet)
            tabSet — коллекция контекстных вкладок (включает: tab)
                tab — вкладка (включает: group)
                    (далее то же, что и у tab элемента tads)
        qat — панель быстрого доступа (включает: documentControls, sharedControls)
            documentControls — элементы управления, используемые в документе
            (включает: button, control, separator)
                button
                control
                separator
            sharedControls — элементы управления, используемые в документах
            (включает: button, control, separator)
                button
                control
                separator
        officeMenu — кнопка Office (включает: button, checkBox, control,
        dynamicMenu, gallery, menu, menuSeparator, splitButton, toggleButton)
            button
            checkBox
            control
            dynamicMenu
            gallery
            menu
            menuSeparator
            splitButton
            toggleButton

[Вернуться в начало]

Описание элементов интерфейса

Внешний вид элементов интерфейса во многом зависит от их параметров, в частности от параметра Size (например, элемент button — на рисунке изображены два разных отображения этого элемента с параметром Size, установленным в "normal" и "large").

box — невизуальный контейнер для элементов
Параметры: getVisible, id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso
insertBeforeQ, visible, boxStyle

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

checkBox — чекбокс (флажок)
Параметры: description, enabled, getDescription, getEnabled, getKeytip, getLabel,
getScreentip, getSupertip, getVisible, id, idMso, idQ, insertAfterMso, insertAfterQ,
insertBeforeMso, insertBeforeQ, keytip, label, onAction, screentip, supertip, tag,
visible, 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, showItemImage, getItemCount,
getItemID, getItemImage, getItemLabel, getItemScreentip, getItemSupertip, getText, maxLength, onChange, sizeString

commands — переопределяемые команды

command — переопределяемая команда
Параметры: enabled, getEnabled, idMso, onAction

contextualTabs — контекстные вкладки.
Появляются только тогда, когда они могут понадобится. На картинке
справа показана вкладка, появляющаяся при редактировании таблицы.

control — любой элемент управления ниже group

customUI — Корневой элемент, описывающий переопределяемый пользовательский
интерфейс.
Параметры: onLoad, loadImage, xmlns

dialogBoxLauncher — кнопка открытия диалогового окна группы.

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, getItemCount, getItemID, getItemImage, getItemLabel,
getItemScreentip, getItemSupertip, showItemImage, sizeString, getSelectedItemID,
getSelectedItemIndex, showItemLabel

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, 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, getText,
maxLength, onChange, sizeString.

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, getItemWidth, itemHeight, itemWidth, rows, getItemCount,
getItemID, getItemImage, getItemLabel, getItemScreentip,
getItemSupertip, showItemImage, showItemLabel, getSelectedItemID,
getSelectedItemIndex, sizeString, columns, getItemHeight

group — группа
Параметры: getImage, getImageMso, getKeytip, getLabel, getScreentip, getSupertip,
getVisible, id, idMso, idQ, image, imageMso, insertAfterMso, insertAfterQ,
insertBeforeMso, insertBeforeQ, keytip, label, screentip, supertip, visible

item — элемент списка
Параметры: 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, itemSize

menuSeparator — горизонтальная разделительная линия между элементами меню.
На рисунке выше представлены разделительные линии двух типов — с надписью и без.
Параметры: id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ, title, getTitle.

officeMenu — кнопка Office

qat — панель быстрого доступа

ribbon — интерфейс RibbonX, включающий вкладки, панель быстрого доступа и кнопку Office.
Параметры: startFromScratch

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,
size, supertip, tag, visible, showLabel

tab — вкладка
Параметры: getKeytip, getLabel, getVisible, id, idMso, idQ, insertAfterMso,
insertAfterQ, insertBeforeMso, insertBeforeQ, keytip, label, tag, visible

tabs — постоянные вкладки

tabSet — коллекция контекстных вкладок.
Параметры: getVisible, idMso, visible

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

[Вернуться в начало]

Идентификаторы встроенных вкладок и групп (idMso):

Главная — TabHome

    Буфер обмена — GroupClipboard
    Шрифт — GroupFont
    Абзац — GroupParagraph
    Стили — GroupStyles
    Редактирование — GroupEditing
 
Вставка — TabInsert
    Страницы — GroupInsertPages
    Таблицы — GroupInsertTables
    Иллюстрации — GroupInsertIllustrations
    Связи — GroupInsertLinks
    Колонтитулы — GroupHeaderFooter
    Текст — GroupInsertText
    Символы — GroupInsertSymbols
    Штрихкод — GroupBarcode
 
Разметка страницы — TabPageLayoutWord
    Темы — GroupThemesWord
    Параметры страницы — GroupPageLayoutSetup
    Фон страницы — GroupPageBackground
    Абзац (Отступы и интервалы для абзацев) — GroupParagraphLayout
    Упорядочить — GroupArrange
 
Ссылки — TabReferences
    Оглавление — GroupTableOfContent
    Сноски — GroupFootnotes
    Ссылки и списки литературы — GroupCitationsAndBibliography
    Названия — GroupCaptions
    Предметный указатель — GroupIndex
    Таблица ссылок — GroupTableOfAuthorities
 
Рассылки — TabMailings
    Создать — GroupEnvelopeLabelCreate
    Начать слияние — GroupMailMergeStart
    Составление документа и вставка полей — GroupMailMergeWriteInsertFields
    Просмотр результатов — GroupMailMergePreviewResults
    Завершить — GroupMailMergeFinish
 
Рецензирование — TabReviewWord
    Правописание — GroupProofing
    Примечания — GroupComments
    Отслеживание — GroupChangesTracking
    Изменения — GroupChanges
    Сравнить — GroupCompare
    Защитить — GroupProtect
    Рукописные данные — GroupInk
    Перевод на китайский язык — GroupChineseTranslation
 
Вид — TabView
    Режимы просмотра документа — GroupDocumentViews
    Показать или скрыть — GroupViewShowHide
    Масштаб — GroupZoom
    Окно — GroupWindow
    Макросы — GroupMacros
 
Разработчик — TabDeveloper
    Код — GroupCode
    Элементы управления — GroupControls
    XML — GroupXml
    Защитить — GroupProtrct
    Шаблоны — GroupTemplates
 
Надстройки — TabAddIns
    Настраиваемые панели инструментов — GroupAddInsCustomToolbars
    Команды панели инструментов — GroupAddInsToolbarCommands
    Команды меню — GroupAddInsMenuCommands

Идентификаторы остальных внутренних элементов интерфейса можно узнать следующим образом. Щёлкните правой кнопкой мыши на любом элементе ленты и в открывшемся контекстном меню выберете «Настройка панели быстрого доступа». При наведении курсора мыши на любой элемент интерфейса, перечисленный в списке, появляется подсказка, в конце которой в скобках дан идентификатор текущего элемента.

Также список всех идентификаторов встроенных элементов управления Microsoft Office 2007 можно скачать в формате xlsx — Excel 2007 (1,65 Мб): 2007OfficeControlIDsExcel2007.rar

Кроме того, список всех встроенных в Microsoft Office 2007 иконок и их идентификаторы можно скачать в формате xlsm — Excel 2007 (53,6 Кб): Office2007IconsGallery.rar

Также некоторую полезную информацию по элементам интерфейса можно узнать из англоязычного хелпа (403 Кб): Office2007XMLSchema.rar

[Вернуться в начало]

Описание параметров

Параметр	Вид значения	Описание
boxStyle	Строка (horizontal, vertical)	Для контейнера элементов определяет вертикальное или горизонтальное расположение элементов внутри.
columns	Целое	Кол-во столбцов, отображающихся в галерее
description	Строка	Определяет текст описания, который отображается в меню, когда параметр itemSize = ”large”.
enabled	Бинарное (true, false; 0, 1)	Определяет доступность элемента управления для использования.
getContent		Для динамического меню — возвращает xml-структуру, описывающую меню.
getDescription		Возвращает описание элемента управления.
getEnabled	Бинарное (true, false; 0, 1)	Возвращает состояние доступности элемента для использования.
getImage		Возвращает иконку элемента управления.
getImageMso		Возвращает иконку встроенного элемента управления по её идентификатору.
getItemCount	Целое	Для комбобокса, раскрывающегося списка или галереи возвращает количество отображаемых элементов.
getItemHeight	Целое	Для галереи возвращает высоту элементов в пикселях
getItemID	Строка	Для комбобокса, раскрывающегося списка или галереи возвращает идентификатор текущего элемента.
getItemImage		Для комбобокса, раскрывающегося списка или галереи возвращает иконку текущего элемента.
getItemLabel	Строка	Для комбобокса, раскрывающегося списка или галереи возвращает надпись текущего элемента.
getItemScreentip	Строка	Для комбобокса, раскрывающегося списка или галереи возвращает подсказку текущего элемента.
getItemSupertip	Строка	Для комбобокса, раскрывающегося списка или галереи возвращает подробную подсказку текущего элемента.
getItemWidth	Целое	Для галереи возвращает ширину элементов в пикселях
getKeytip	Строка	Возвращает подсказку горячей клавиши элемента управления.
getLabel	Строка	Возвращает надпись элемента управления.
getPressed	Бинарное (true, false; 0, 1)	Для фиксирующейся кнопки возвращает значение, показывающее нажата или отжата кнопка. Для чекбокса (флажка) возвращает значение, показывающее установлен флажок или снят.
getScreentip	Строка	Возвращает подсказку элемента управления.
getSelectedItemID	Строка	Для ниспадающего списка или галереи возвращает идентификатор выделенного элемента.
getSelectedItemIndex	Целое	Для ниспадающего списка или галереи возвращает номер выделенного элемента.
getShowImage	Бинарное (true, false; 0, 1)	Возвращает значение, определяющее, отображается ли иконка элемента.
getShowLabel	Бинарное (true, false; 0, 1)	Возвращает значение, определяющее, отображается ли надпись элемента.
getSize	Строка (normal, large)	Возвращает значение, определяющее размер элемента (normal — нормальный или large — большой).
getSupertip	Строка	Возвращает значение, определяющее подробную подсказку для элемента
getText	Строка	Для текстовых элементов или полей редактирования возвращает текст, отображаемый в редактируемой части элемента.
getTitle	Строка	Для разделительной линии меню возвращает отображаемый (вместо линии) текст
getVisible	Бинарное (true, false; 0, 1)	Возвращает значение, которое определяет видимость элемента.
id	Строка	Определённый пользователем уникальный идентификатор для элемента интерфейса (взаимоисключающий с idMso и idQ)
idMso	Строка	Идентификатор встроенного элемента интерфейса (взаимоисключающий с id и idQ)
idQ	Строка	Ограниченный идентификатор, использующийся перед идентификатором пространства имён.
image	Строка	Определяет иконку для элемента интерфейса (в VBA это значение является идентификатором)
imageMso	Строка	Определяет идентификатор для встроенной иконки для быстрой его вставки в элемент интерфейса.
insertAfterMso	Строка	Определяет идентификатор встроенного элемента интерфейса, после которого следует помещать текущий элемент.
insertAfterQ	Строка	Определяет идентификатор ограниченного элемента интерфейса (элемента, который был определён идентификатором idQ), после которого следует помещать текущий элемент.
insertBeforeMso	Строка	Определяет идентификатор встроенного элемента интерфейса, перед которым следует помещать текущий элемент.
insertBeforeQ	Строка	Определяет идентификатор ограниченного элемента интерфейса (элемента, который был определён идентификатором idQ), перед которым следует помещать текущий элемент.
itemHeight	Целое	Для галереи определяет высоту элементов в пикселях
itemSize	Строка (large, normal)	Для меню определяет размер элемента меню.
itemWidth		Для галереи определяет ширину элементов в пикселях
keytip	Строка	Определяет подсказку для горячей клавиши элемента управления. Она отображается, когда пользователь нажимает клавишу ALT и после, в процессе нажатия от одной до трёх букв.
label	Строка	Определяет надпись для элемента.
loadImage	Строка
maxLength	Строка
onAction	Строка	Определяет имя процедуры, вызываемой при щелчке мышью на элементе.
onChange	Строка	Определяет имя процедуры, вызываемой, когда пользователь подтверждает ввод текста в поле редактирования или в поле выбора.
onLoad	Строка
rows	Целое	количество строк, отображающихся в галерее
screentip	Строка	Определяет подсказку элемента.
showImage	Бинарное (true, false; 0, 1)	Определяет, отображать ли иконку элемента.
showItemImage	Бинарное (true, false; 0, 1)	В поле выбора, ниспадающем списке или галерее определяет, показывать ли иконки в содержащихся элементах списка.
showItemLabel	Бинарное (true, false; 0, 1)	В поле выбора, ниспадающем списке или галерее определяет, показывать ли надписи в содержащихся элементах списка.
showLabel	Бинарное (true, false; 0, 1)	Определяет, отображать ли надпись элемента.
size	Строка (large, normal)	Определяет размер элемента.
sizeString	Строка	Определяет строку, такую как «ХХХХХ», показывающую ширину элемента.
startFromScratch	Бинарное (true, false; 0, 1)	Для ленты определяет, отключать ли имеющийся интерфейс.
supertip	Строка	Определяет подробную подсказку для элемента (это более длинная и более полная версия ScreenTip)
tag	Строка	Определяет текст, позволяющий вам сохранять информацию об элементе, которая не может быть помещена в другие его параметры.
title	Строка	Для разделительной линии меню определяет текст для отображения (вместо линии)
visible	Бинарное (true, false; 0, 1)	Определяет видимость элемента интерфейса.
xmlns	Строка	Для корневого элемента интерфейса определяет пространство имён, заданное для интерфейса по умолчанию.

Если вы нашли ошибку на этой странице, буду благодарен, если вы сообщите мне о ней.

[Вернуться в начало]

Часть 1

Часть 3

[Оставить отзыв в гостевой]