Office.DisplayedSubject interface

Pacote:

outlook

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Fornece um método para definir temporariamente o conteúdo apresentado no assunto de uma mensagem no modo de leitura.

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

Métodos

setAsync(data, options, callback)	Define temporariamente o conteúdo apresentado no assunto de uma mensagem no modo de leitura. O conteúdo definido permanecerá visível até que o utilizador mude para uma mensagem diferente ou feche a janela da mensagem atual.
setAsync(data, callback)	Define temporariamente o conteúdo apresentado no assunto de uma mensagem no modo de leitura. O conteúdo definido permanecerá visível até que o utilizador mude para uma mensagem diferente ou feche a janela da mensagem atual.

Detalhes do método

setAsync(data, options, callback)

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Define temporariamente o conteúdo apresentado no assunto de uma mensagem no modo de leitura. O conteúdo definido permanecerá visível até que o utilizador mude para uma mensagem diferente ou feche a janela da mensagem atual.

setAsync(data: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data

string

A cadeia a apresentar temporariamente no assunto de uma mensagem. A cadeia de caracteres está limitada a 255 caracteres.

options

Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. Quaisquer erros encontrados serão fornecidos na propriedade asyncResult.error.

Retornos

void

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

Importante:

• Se vários suplementos que implementam setAsync forem executados em simultâneo, o conteúdo definido pelo último suplemento que conclui a setAsync operação é apresentado no campo assunto.

• O conteúdo definido pelo setAsync método só é apresentado enquanto o utilizador estiver a ver o item. Não está em cache no Outlook e não sincroniza com outros clientes do Outlook.

• Se guardar uma mensagem depois de chamar setAsync, o assunto original é apresentado no item guardado.

• O setAsync método não é suportado em várias mensagens selecionadas.

setAsync(data, callback)

Observação

Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.

Define temporariamente o conteúdo apresentado no assunto de uma mensagem no modo de leitura. O conteúdo definido permanecerá visível até que o utilizador mude para uma mensagem diferente ou feche a janela da mensagem atual.

setAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data

string

A cadeia a apresentar temporariamente no assunto de uma mensagem. A cadeia de caracteres está limitada a 255 caracteres.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. Quaisquer erros encontrados serão fornecidos na propriedade asyncResult.error.

Retornos

void

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Leitura da Mensagem

Importante:

• Se vários suplementos que implementam setAsync forem executados em simultâneo, o conteúdo definido pelo último suplemento que conclui a setAsync operação é apresentado no campo assunto.

• O conteúdo definido pelo setAsync método só é apresentado enquanto o utilizador estiver a ver o item. Não está em cache no Outlook e não sincroniza com outros clientes do Outlook.

• Se guardar uma mensagem depois de chamar setAsync, o assunto original é apresentado no item guardado.

• O setAsync método não é suportado em várias mensagens selecionadas.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/99-preview-apis/set-displayed-body-subject.yaml

// This snippet temporarily sets the content displayed in the subject field of a message in read mode.
// The set content will remain visible until the user switches to a different message in the Reading Pane or closes the window of the current message.
const subjectText = $("#subject-text-field")
  .val()
  .toString();
Office.context.mailbox.item.display.subject.setAsync(subjectText, (asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log(`Action failed with error: ${asyncResult.error.message}`);
    return;
  }

  console.log("Temporarily set the content displayed in the subject field.");
});