Interfaces das janelas (OneNote)

Artigo
07/19/2024

As interfacesWindow e Windows são objetos de API do OneNote 2013 que permitem que os usuários trabalhem com as janelas do OneNote. Esses objetos permitem que os usuários enumerem o conjunto das janelas do OneNote e modifiquem certas propriedades da janela.

OneNote window views

A lista a seguir mostra os quatro modos de exibição que estão disponíveis para janelas do OneNote:

Modo de exibição normal, exibe a janela padrão do OneNote onde os painéis de navegação do bloco de anotações e da página estiverem visível.
Total de exibição de página, exibe uma interface de usuário mínima (UI) onde os painéis de página e bloco de anotações não são exibidos.
Anotação rápida, exibe uma pequena janela que permite aos usuários fazer anotações curtas. Anotações rápidas normalmente podem ser acessadas por meio do ícone do OneNote na área de notificação do Windows, mas você também pode acessá-los por meio do guiamodo de exibiçãono OneNote.
Encaixar na área de trabalho, exibe uma janela do OneNote que você pode encaixar a qualquer lado da área de trabalho (semelhante à barra de tarefas). Esse modo de exibição reduz o tamanho da área de trabalho para ajustá-la a janela. Você pode encaixar apenas uma janela a qualquer momento e janela fica sempre visível sem bloquear a área de trabalho.

A figura a seguir mostra como os itens modo de página inteira, encaixar na área de trabalho modo de exibição, e anotações rápidas são exibidos na área de trabalho.

exibição do OneNote

Vistas de janela do OneNote vistas de

Interfaces

Esta seção lista as interfaces e membros que você pode usar para modificar as janelas do OneNote por programação.

Interface do Windows

A interface Windows também permite ao usuário acessar o conjunto de janelas abertas do OneNote. É uma propriedade do OneNote da classe aplicativo acessado por meio deApplication.Windows. Isso retorna o conjunto enumerado de janelas do OneNote.

Propriedades

Nome	Tipo	Descrição
Contagem	ULong	Obtém o número dos objetos Window no conjunto do Windows.
CurrentWindow	Janela	Obtém o objetojanelada janela ativa do OneNote.
Items	Janela	Retorna o objetojanelaque corresponde ao valor de índice passado. Essa propriedade não pode ser acessada diretamente. Para retornar um objeto janela, use Windows [índice (uint)].

Interface de janela

A interface janela também permite ao usuário acessar certas propriedades de cada janela. Cada janela do OneNote pode ser acessada por enumerar através da propriedade Windowsda classe aplicativo.

Propriedades

Nome	Tipo	Descrição
Ativo	bool	Obtém ou define um valor que indica se a janela é a janela ativa do OneNote.
Aplicativo	Aplicativo	Obtém o objeto aplicativo do OneNote que estão associados com a janela.
CurrentPageId	string	Obtém a ID de objeto da página do OneNote ativa da janela.
CurrentSectionId	string	Obtém a ID de objeto da seção do OneNote ativa da janela.
CurrentSectionGroupId	string	Obtém a ID de objeto da seção de grupo ativa da janela do OneNote.
CurrentNotebookId	string	Obtém a ID de objeto do bloco de anotações ativo na janela do OneNote.
DockedLocation	DockedLocation	Obtém ou define a localização encaixada da janela do OneNote.
FullPageView	bool	Obtém ou define um valor que indica se a janela está no modo de exibição de página inteira (exibição mínima de interface do usuário).
SideNote	bool	Obtém ou define um valor que indica se a janela é uma janela de anotação rápida.
WindowHandle	ULong	É a ID de alça da janela do OneNote.

Métodos

Você pode usar os seguintes métodos das interfacesjanelapara acessar objetos específicos na janela do OneNote ou nas URLs especificadas.

NavigateTo

	Valor
Descrição	Leva até um objeto específico na janela do OneNote. Por exemplo, você pode navegar em seções, páginas elementos de estrutura das páginas.
Sintaxe	`HRESULT NavigateTo(` `[in]BSTR bstrHierarchyObjectID,` `[in]BSTR bstrObjectID);`
Parameters	bstrHierarchyObjectID: Hierarquia do OneNote ID do objeto que você quer navegar. A ID de objeto pode fazer referência a um bloco de anotações do OneNote, seção, grupo de seção ou página. bstrObjectID, a ID do OneNote de um objeto específico para navegar até em uma página do OneNote. Se o usuário não quiser navegar até um objeto específico em uma página, esse parâmetro será definido como nulo.

NavigateToUrl

	Valor
Descrição	Se for aprovado um link do OneNote (onenote: / /), a janela do OneNote abrirá no local correspondente no OneNote. No entanto, se o link está um link externo, como https:// ou file://,uma caixa de diálogo de segurança aparecerá. Após a demissão, o OneNote tentará abrir o link e um erro HResult.hrObjectDoesNotExist será retornado.
Sintaxe	`HRESULT NavigateToUrl (` `[in]BSTR bstrUrl);`
Parameters	bstrUrl, a URL para navegar até.

SetDockedLocation

	Valor
Descrição	Encaixa a janela na localização especificada por dockLocation e pelo monitor na ptMonitor.
Sintaxe	`HRESULT SetDockedLocation`( `[in] DockLocation dockLocation,[in] POINT ptMonitor);`
Parameters	dockLocation -indica o local encaixado de uma janela do OneNote 2013. ptMonitor -(opcional) indica em coordenadas x,y em qual monitor a janela deve ser encaixada.

Exemplo

O seguinte código percorre o OneNote do windows para encontrar uma janela encaixada. Se não houver nenhuma janela encaixada, o exemplo encaixa a janela ativa. Se não houver nenhuma janela encaixada, o código criará uma nova janela encaixada.

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();
            }
        }
    }
}

Confira também

Referência do desenvolvedor do OneNote

Compartilhar via