Compartilhar via

Office.AttachmentDetailsCompose interface

Pacote:
outlook

Representa um anexo num item. Somente modo de redação.

O método devolve getAttachmentsAsync uma matriz de AttachmentDetailsCompose objetos.

Comentários

[ Conjunto de API: Caixa de Correio 1.8 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml

Office.context.mailbox.item.getAttachmentsAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.error(result.error.message);
    return;
  }

  if (result.value.length > 0) {
    for (let i = 0; i < result.value.length; i++) {
      const attachment = result.value[i];
      let attachmentType;
      switch (attachment.attachmentType) {
        case Office.MailboxEnums.AttachmentType.Cloud:
          attachmentType = "Attachment is stored in a cloud location";
          break;
        case Office.MailboxEnums.AttachmentType.File:
          attachmentType = "Attachment is a file";
          break;
        case Office.MailboxEnums.AttachmentType.Item:
          attachmentType = "Attachment is an Exchange item";
          break;
      }
      console.log(
        "ID: " +
          attachment.id +
          "\n" +
          "Type: " +
          attachmentType +
          "\n" +
          "Name: " +
          attachment.name +
          "\n" +
          "Size: " +
          attachment.size +
          "\n" +
          "isInline: " +
          attachment.isInline
      );
    }
  } else {
    console.log("No attachments on this message.");
  }
});

Propriedades

attachmentType

Obtém um valor que indica o tipo do anexo.
contentId

Obtém o identificador de conteúdo de um anexo inline.
id

Obtém o índice do anexo.
isInline

Obtém um valor que indica se o anexo aparece como uma imagem no corpo do item em vez de na lista de anexos.
name

Obtém o nome de arquivo do anexo.
size

Obtém o tamanho do anexo em bytes.
url

Obtém o URL do anexo se o respetivo tipo for MailboxEnums.AttachmentType.Cloud.

Detalhes da propriedade

attachmentType

Obtém um valor que indica o tipo do anexo.

attachmentType: MailboxEnums.AttachmentType | string;

Valor da propriedade

Office.MailboxEnums.AttachmentType | string

Comentários

Importante:

  • No Outlook na Web e no novo Outlook no Windows, uma mensagem ou compromisso que é guardado localmente e anexado com arrastar e largar ou a opção Anexar Item é do tipo Office.MailboxEnums.AttachmentType.File. A extensão de nome de ficheiro é devolvida na name propriedade . No entanto, uma mensagem ou compromisso anexado através da opção Reencaminhar como Anexo é do tipo Office.MailboxEnums.AttachmentType.Item. Neste caso, não é devolvida uma extensão na name propriedade .

  • No Outlook clássico no Windows, uma mensagem ou compromisso anexado através de arrastar e largar, Anexar Ficheiro ou Reencaminhar como Anexo é do tipo Office.MailboxEnums.AttachmentType.Item. Não é devolvida uma extensão de nome de ficheiro na name propriedade .

  • No Outlook para Mac, uma mensagem ou compromisso anexado através de arrastar e largar, Anexar Item ou Reencaminhar como Anexo é do tipo Office.MailboxEnums.AttachmentType.File. A extensão de nome de ficheiro é devolvida na name propriedade .

contentId

Obtém o identificador de conteúdo de um anexo inline.

contentId: string;

Valor da propriedade

string

Comentários

Importante:

  • A contentId propriedade só é suportada no Outlook na Web, no novo Outlook no Windows e no Outlook clássico no Windows (pré-visualização). Para pré-visualizar a contentId propriedade no Outlook clássico no Windows, o seu cliente do Outlook tem de executar a Versão 2510 (Compilação 19312.20000) ou posterior e tem de estar no Canal Beta. Para obter mais informações, consulte Programa Microsoft 365 Insider.

  • Alterações à forma como as imagens inline são representadas no corpo HTML dos e-mails do Outlook no Outlook na Web e no novo Outlook no Windows lançado a 15 de novembro de 2025. Anteriormente, o ID de anexo da imagem aparecia no src atributo do elemento aplicável <img> . Agora, a imagem é representada por um ID de conteúdo (cid) no src atributo . Se analisar o ID de anexo do editor de HTML ou obter o valor codificado em Base64 da imagem a partir do URL no src atributo, tem de atualizar a lógica de análise do suplemento. Para obter mais informações, consulte Alterações à representação de imagens inline no Outlook na Web e no novo Outlook para Windows.

id

Obtém o índice do anexo.

id: string;

Valor da propriedade

string

isInline

Obtém um valor que indica se o anexo aparece como uma imagem no corpo do item em vez de na lista de anexos.

isInline: boolean;

Valor da propriedade

boolean

name

Obtém o nome de arquivo do anexo.

name: string;

Valor da propriedade

string

Comentários

Importante:

  • Um anexo do tipo Office.MailboxEnums.AttachmentType.Item não devolve uma extensão de nome de ficheiro na name propriedade .

  • No Outlook na Web e no novo Outlook no Windows, uma mensagem ou compromisso que é guardado localmente e anexado com arrastar e largar ou a opção Anexar Item é do tipo Office.MailboxEnums.AttachmentType.File. A extensão de nome de ficheiro é devolvida na name propriedade . No entanto, uma mensagem ou compromisso anexado através da opção Reencaminhar como Anexo é do tipo Office.MailboxEnums.AttachmentType.Item. Neste caso, não é devolvida uma extensão na name propriedade .

  • No Outlook clássico no Windows, uma mensagem ou compromisso anexado através de arrastar e largar, Anexar Ficheiro ou Reencaminhar como Anexo é do tipo Office.MailboxEnums.AttachmentType.Item. Não é devolvida uma extensão de nome de ficheiro na name propriedade .

  • No Outlook para Mac, uma mensagem ou compromisso anexado através de arrastar e largar, Anexar Item ou Reencaminhar como Anexo é do tipo Office.MailboxEnums.AttachmentType.File. A extensão de nome de ficheiro é devolvida na name propriedade .

size

Obtém o tamanho do anexo em bytes.

size: number;

Valor da propriedade

number

url

Obtém o URL do anexo se o respetivo tipo for MailboxEnums.AttachmentType.Cloud.

url?: string;

Valor da propriedade

string