Compartilhar via


Office.Addin interface

Representa a funcionalidade de nível de suplemento para operar ou configurar vários aspetos do suplemento.

Comentários

Conjunto de requisitos: SharedRuntime 1.1

Propriedades

beforeDocumentCloseNotification

Representa uma caixa de diálogo de notificação modal que pode ser apresentada quando o utilizador tenta fechar um documento. O documento não será fechado até que o utilizador responda. Esta API só é suportada no Excel.

Métodos

getStartupBehavior()

Obtém o comportamento de arranque atual do suplemento.

hide()

Oculta o painel de tarefas.

onVisibilityModeChanged(handler)

Adiciona um processador para o onVisibilityModeChanged evento.

setStartupBehavior(behavior)

Define o comportamento de arranque do suplemento para quando o documento for aberto da próxima vez.

showAsTaskpane()

Mostra o painel de tarefas associado ao suplemento.

Detalhes da propriedade

beforeDocumentCloseNotification

Representa uma caixa de diálogo de notificação modal que pode ser apresentada quando o utilizador tenta fechar um documento. O documento não será fechado até que o utilizador responda. Esta API só é suportada no Excel.

beforeDocumentCloseNotification: BeforeDocumentCloseNotification;

Valor da propriedade

Comentários

Conjunto de requisitos: SharedRuntime 1.2

Detalhes do método

getStartupBehavior()

Obtém o comportamento de arranque atual do suplemento.

getStartupBehavior(): Promise<Office.StartupBehavior>;

Retornos

Comentários

Conjunto de requisitos: SharedRuntime 1.1

hide()

Oculta o painel de tarefas.

hide(): Promise<void>;

Retornos

Promise<void>

Uma promessa que é resolvida quando a IU é ocultada.

Comentários

Conjunto de requisitos: SharedRuntime 1.1

onVisibilityModeChanged(handler)

Adiciona um processador para o onVisibilityModeChanged evento.

onVisibilityModeChanged(
            handler: (message: VisibilityModeChangedMessage) => void,
        ): Promise<() => Promise<void>>;

Parâmetros

handler

(message: Office.VisibilityModeChangedMessage) => void

A função de processador que é chamada quando o evento é emitido. Esta função recebe uma mensagem para o componente de receção.

Retornos

Promise<() => Promise<void>>

Uma promessa que é resolvida para uma função quando o processador é adicionado. Chamá-lo remove o processador.

Comentários

Conjunto de requisitos: SharedRuntime 1.1

Exemplos

Office.onReady(() => {
    Office.addin.onVisibilityModeChanged((args) => {
        if (args.visibilityMode === Office.VisibilityMode.taskpane) {
            // Do something when the task pane is visible.
        }
    });

    // Other startup tasks.
});

setStartupBehavior(behavior)

Define o comportamento de arranque do suplemento para quando o documento for aberto da próxima vez.

setStartupBehavior(behavior: Office.StartupBehavior): Promise<void>;

Parâmetros

behavior
Office.StartupBehavior

Especifica o comportamento de arranque do suplemento.

Retornos

Promise<void>

Comentários

Conjunto de requisitos: SharedRuntime 1.1

Exemplos

// Configure your add-in to load and start running when the document is opened.
Office.addin.setStartupBehavior(Office.StartupBehavior.load);

showAsTaskpane()

Mostra o painel de tarefas associado ao suplemento.

showAsTaskpane(): Promise<void>;

Retornos

Promise<void>

Uma promessa que é resolvida quando a IU é apresentada.

Comentários

Conjunto de requisitos: SharedRuntime 1.1