Интерфейсы окна (OneNote)

Статья
04/04/2023

ИнтерфейсыWindows и Windows — это объекты API OneNote 2013, которые позволяют пользователям работать с окнами OneNote. Эти объекты позволяют пользователям применять перечисление в наборе окон OneNote и изменять определенные свойства окон.

Представления окна OneNote

В следующем списке показаны четыре режима представления, которые можно использовать для окон OneNote:

Обычное представление— отображает окно OneNote по умолчанию, в котором отображаются области навигации "Записная книжка" и "Страница".
Представление полной страницы — отображает представление с минимальным пользовательским интерфейсом, в котором не отображаются области записных книжек и страниц.
Краткое примечание. Отображает небольшое окно, в котором пользователи могут делать короткие заметки. Как правило, быстрые заметки можно получить через значок OneNote в области уведомлений Windows, но вы также можете получить к ним доступ на вкладке Вид в OneNote.
Закрепление на рабочем столе— отображает окно OneNote, которое можно закрепить с любой стороны рабочего стола (аналогично панели задач). Это представление уменьшает размер рабочего стола в соответствии с окном. Вы можете закрепить только одно окно в любое время, и окно всегда отображается, не блокируя рабочий стол.

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

Представления OneNote

Представления окон OneNote

Интерфейсы

В этом разделе перечислены интерфейсы и члены, которые можно использовать для программного изменения окон OneNote.

Интерфейс Windows

Интерфейс Windows позволяет пользователю получить доступ к набору открытых окон OneNote. Это свойство класса OneNote Application , доступ к нему осуществляется через Application.Windows. При этом возвращается перечисляемый набор окон OneNote.

Properties

Имя	Тип	Описание
Count	ulong	Возвращает количество объектов Window в наборе Windows .
CurrentWindow	Window	Возвращает объект Window активного окна OneNote.
Items	Window	Возвращает объект Window , соответствующий передаваемому значению индекса. Доступ к этому свойству напрямую невозможен. Чтобы вернуть объект Window , используйте индекс Windows [(uint)].

Интерфейс окна

Интерфейс Окна позволяет пользователю получить доступ к определенным свойствам каждого окна. Доступ к каждому окну OneNote можно получить путем перечисления через свойство Windows класса Application .

Properties

Имя	Тип	Описание
Active	логический	Возвращает или задает значение, указывающее, является ли окно активным окном OneNote.
Application	Application	Возвращает объект приложения OneNote, связанный с окном.
CurrentPageId	string	Возвращает идентификатор объекта активной страницы OneNote окна.
CurrentSectionId	string	Возвращает идентификатор объекта активного раздела OneNote окна.
CurrentSectionGroupId	string	Возвращает идентификатор объекта активной группы разделов OneNote окна.
CurrentNotebookId	string	Возвращает идентификатор объекта активной записной книжки OneNote окна.
DockedLocation	DockedLocation	Возвращает или задает закрепленное расположение окна OneNote.
FullPageView	логический	Возвращает или задает значение, указывающее, находится ли окно в режиме полной страницы (минимальное представление пользовательского интерфейса).
SideNote	логический	Возвращает или задает значение, указывающее, является ли окно окном быстрых заметок.
WindowHandle	ulong	Возвращает идентификатор дескриптора окна OneNote.

Методы

Для перехода к указанным объектам в окне OneNote или к указанным URL-адресам можно использовать следующие методы интерфейса Window .

NavigateTo

	Значение
Описание	Переход к указанному объекту в окне OneNote. Например, можно переходить к разделам, страницам и элементам структуры внутри страниц.
Синтаксис	`HRESULT NavigateTo(` `[in]BSTR bstrHierarchyObjectID,` `[in]BSTR bstrObjectID);`
Parameters	bstrHierarchyObjectID — идентификатор иерархии OneNote объекта, к которому требуется перейти. Идентификатор объекта может ссылаться на записную книжку OneNote, раздел, группу разделов или страницу. bstrObjectID — идентификатор OneNote определенного объекта, к который нужно перейти на странице OneNote. Если пользователь не хочет переходить к определенному объекту на странице, этот параметр имеет значение NULL.

NavigateToUrl

	Значение
Описание	Если передана ссылка OneNote (onenote://), откроется окно OneNote для соответствующего расположения в OneNote. Однако если ссылка является внешней, например https:// или file://, появится диалоговое окно безопасности. После закрытия OneNote пытается открыть ссылку и возвращается ошибка HResult.hrObjectDoesNotExist.
Синтаксис	`HRESULT NavigateToUrl (` `[in]BSTR bstrUrl);`
Parameters	bstrUrl — URL-адрес для перехода.

SetDockedLocation

	Значение
Описание	Закрепляет окно с расположением, указанным параметром dockLocation , и монитором в ptMonitor.
Синтаксис	`HRESULT SetDockedLocation`( `[in] DockLocation dockLocation,[in] POINT ptMonitor);`
Parameters	dockLocation — указывает закрепленное расположение окна OneNote 2013. ptMonitor — (необязательно) Указывает в координатах x,y, с которыми должно быть закреплено окно.

Пример

Следующий код выполняет итерацию по окнам OneNote, чтобы найти закрепленное окно. Если закрепленное окно не существует, пример закрепляет активное окно. Если активное окно не существует, код создает новое закрепленное окно.

using System;
using System.Diagnostics;
using Microsoft.Office.Interop.OneNote;
namespace SampleWND
{
    class DockOneNoteWindow
    {
        static void Main(string[] args)
        {
            Microsoft.Office.Interop.OneNote.Application app = new Microsoft.Office.Interop.OneNote.Application();
            // Search through all OneNote windows for a docked window and activate it.
            bool foundDockedWND = false;
            for (int i = 0; i < app.Windows.Count; i++)
            {
                if (app.Windows[(uint) i].DockedLocation != DockLocation.dlNone)
                {
                    foundDockedWND = true;
                    app.Windows[(uint) i].Active = true;
                }
            }
            
            // If no docked window exists, dock the active window.
            if (!foundDockedWND && (app.Windows.Count > 0))
                app.Windows.CurrentWindow.DockedLocation = DockLocation.dlDefault;
            // If no active window exists, create a new docked window.
            if (app.Windows.Count < 1)
            {
                Process oneProc = new Process();
                oneProc.StartInfo.FileName = "onenote.exe";
                oneProc.StartInfo.Arguments = "/docked";
                oneProc.Start();
            }
        }
    }
}

См. также

Справочник разработчика для OneNote

Поделиться через