Compartilhar via


item (Requisito da caixa de correio definido como 1.14)

Office.context.mailbox.item

item é utilizado para aceder à mensagem, pedido de reunião ou compromisso atualmente selecionado. Pode determinar o tipo do item com a itemType propriedade .

Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Nível de permissão mínimo restrito
Modo do Outlook aplicável Organizador do Compromisso, Participante do Compromisso,
Composição de Mensagens ou Leitura de Mensagens

Importante

Android e iOS: existem limitações sobre quando os suplementos são ativados e quais as APIs que estão disponíveis. Para saber mais, consulte Adicionar suporte móvel a um suplemento do Outlook.

Propriedades

Propriedade Minimum
nível de permissão
Detalhes por modo Tipo de retorno Minimum
conjunto de requisitos
anexos ler item Participante do Compromisso Matriz.<AttachmentDetails> 1.1
Mensagem lida Matriz.<AttachmentDetails> 1.1
bcc ler item Composição da mensagem Destinatários 1.1
corpo ler item Organizador de Compromissos Body 1.1
Participante do Compromisso Body 1.1
Composição da mensagem Body 1.1
Mensagem lida Body 1.1
categories ler item Organizador de Compromissos Categories 1.8
Participante do Compromisso Categories 1.8
Composição da mensagem Categories 1.8
Mensagem lida Categories 1.8
cc ler item Composição da mensagem Destinatários 1.1
Mensagem lida Matriz.<EmailAddressDetails> 1.1
conversationId ler item Composição da mensagem Cadeia de caracteres 1.1
Mensagem lida Cadeia de caracteres 1.1
dateTimeCreated ler item Participante do Compromisso Data 1.1
Mensagem lida Data 1.1
dateTimeModified ler item Participante do Compromisso Data 1.1
Mensagem lida Data 1.1
delayDeliveryTime ler item Composição da mensagem DelayDeliveryTime 1.13
end ler item Organizador de Compromissos Time 1.1
Participante do Compromisso Data 1.1
Mensagem lida
(Pedido de Reunião)
Data 1.1
enhancedLocation ler item Organizador de Compromissos EnhancedLocation 1.8
Participante do Compromisso EnhancedLocation 1.8
from ler/escrever item Composição da mensagem De 1.7
ler item Mensagem lida EmailAddressDetails 1.1
inReplyTo ler item Composição da mensagem Cadeia de caracteres 11.4
InternetHeaders ler item Composição da mensagem InternetHeaders 1.8
internetMessageId ler item Mensagem lida Cadeia de caracteres 1.1
itemClass ler item Participante do Compromisso Cadeia de caracteres 1.1
Mensagem lida Cadeia de caracteres 1.1
itemId ler item Participante do Compromisso Cadeia de caracteres 1.1
Mensagem lida Cadeia de caracteres 1.1
itemType ler item Organizador de Compromissos MailboxEnums.ItemType 1.1
Participante do Compromisso MailboxEnums.ItemType 1.1
Composição da mensagem MailboxEnums.ItemType 1.1
Mensagem lida MailboxEnums.ItemType 1.1
localização ler item Organizador de Compromissos Location 1.1
Participante do Compromisso Cadeia de caracteres 1.1
Mensagem lida
(Pedido de Reunião)
Cadeia de caracteres 1.1
normalizedSubject ler item Participante do Compromisso Cadeia de caracteres 1.1
Mensagem lida Cadeia de caracteres 1.1
notificationMessages ler item Organizador de Compromissos NotificationMessages 1.3
Participante do Compromisso NotificationMessages 1.3
Composição da mensagem NotificationMessages 1.3
Mensagem lida NotificationMessages 1.3
optionalAttendees ler item Organizador de Compromissos Destinatários 1.1
Participante do Compromisso Matriz.<EmailAddressDetails> 1.1
organizer ler/escrever item Organizador de Compromissos Organizador 1.7
ler item Participante do Compromisso EmailAddressDetails 1.1
recurrence ler item Organizador de Compromissos Recurrence 1.7
Participante do Compromisso Recurrence 1.7
Mensagem lida
(Pedido de Reunião)
Recurrence 1.7
requiredAttendees ler item Organizador de Compromissos Destinatários 1.1
Participante do Compromisso Matriz.<EmailAddressDetails> 1.1
sender ler item Mensagem lida EmailAddressDetails 1.1
sensitivity ler item Organizador de Compromissos Sensitivity 11.4
Participante do Compromisso MailboxEnums.AppointmentSensitivityType 11.4
sensitivityLabel ler/escrever item Organizador de Compromissos SensitivityLabel 1.13
Composição da mensagem SensitivityLabel 1.13
seriesId ler item Organizador de Compromissos Cadeia de caracteres 1.7
Participante do Compromisso Cadeia de caracteres 1.7
Composição da mensagem Cadeia de caracteres 1.7
Mensagem lida Cadeia de caracteres 1.7
sessionData ler item Organizador de Compromissos SessionData 1.11
Composição da mensagem SessionData 1.11
iniciar ler item Organizador de Compromissos Time 1.1
Participante do Compromisso Data 1.1
Mensagem lida
(Pedido de Reunião)
Data 1.1
assunto ler item Organizador de Compromissos Assunto 1.1
Participante do Compromisso Cadeia de caracteres 1.1
Composição da mensagem Assunto 1.1
Mensagem lida Cadeia de caracteres 1.1
para ler item Composição da mensagem Destinatários 1.1
Mensagem lida Matriz.<EmailAddressDetails> 1.1

Métodos

Método Minimum
nível de permissão
Detalhes por modo Minimum
conjunto de requisitos
addFileAttachmentAsync(uri, attachmentName, [options], [callback]) ler/escrever item Organizador de Compromissos 1.1
Composição da mensagem 1.1
addFileAttachmentFromBase64Async(base64File, attachmentName, [options], [callback]) ler/escrever item Organizador de Compromissos 1.8
Composição da mensagem 1.8
addHandlerAsync(eventType, handler, [options], [callback]) ler item Organizador de Compromissos 1.7
Participante do Compromisso 1.7
Composição da mensagem 1.7
Mensagem lida 1.7
addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) ler/escrever item Organizador de Compromissos 1.1
Composição da mensagem 1.1
close() restrito Organizador de Compromissos 1.3
Composição da mensagem 1.3
closeAsync([opções], [chamada de retorno]) ler/escrever item Composição da mensagem 11.4
disableClientSignatureAsync([options], [callback]) ler/escrever item Organizador de Compromissos 1.10
Composição da mensagem 1.10
displayReplyAllForm(formData) ler item Participante do Compromisso 1.1
Mensagem lida 1.1
displayReplyAllFormAsync(formData, [options], [callback]) ler item Participante do Compromisso 1.9
Mensagem lida 1.9
displayReplyForm(formData) ler item Participante do Compromisso 1.1
Mensagem lida 1.1
displayReplyFormAsync(formData, [options], [callback]) ler item Participante do Compromisso 1.9
Mensagem lida 1.9
getAllInternetHeadersAsync([options], [callback]) ler item Mensagem lida 1.8
getAsFileAsync([opções], chamada de retorno) ler item Mensagem lida 11.4
getAttachmentContentAsync(attachmentId, [options], [callback]) ler item Organizador de Compromissos 1.8
Participante do Compromisso 1.8
Composição da mensagem 1.8
Mensagem lida 1.8
getAttachmentsAsync([options], [callback]) ler item Organizador de Compromissos 1.8
Composição da mensagem 1.8
getComposeTypeAsync([opções], chamada de retorno) ler item Composição da mensagem 1.10
getConversationIndexAsync([opções], chamada de retorno) ler item Composição da mensagem 11.4
getEntities() (preterido) ler item Participante do Compromisso 1.1
Mensagem lida 1.1
getEntitiesByType(entityType) (preterido) restrito Participante do Compromisso 1.1
Mensagem lida 1.1
getFilteredEntitiesByName(name) (preterido) ler item Participante do Compromisso 1.1
Mensagem lida 1.1
getInitializationContextAsync([options], [callback]) ler item Organizador de Compromissos 1.8
Participante do Compromisso 1.8
Composição da mensagem 1.8
Mensagem lida 1.8
getItemClassAsync([opções], chamada de retorno) ler item Composição da mensagem 11.4
getItemIdAsync([opções], chamada de retorno) ler item Organizador de Compromissos 1.8
Composição da mensagem 1.8
getRegExMatches() ler item Participante do Compromisso 1.1
Mensagem lida 1.1
getRegExMatchesByName(name) ler item Participante do Compromisso 1.1
Mensagem lida 1.1
getSelectedDataAsync(coercionType, [opções], chamada de retorno) ler item Organizador de Compromissos 1.2
Composição da mensagem 1.2
getSelectedEntities() (preterido) ler item Participante do Compromisso 1.6
Mensagem lida 1.6
getSelectedRegExMatches() ler item Participante do Compromisso 1.6
Mensagem lida 1.6
getSharedPropertiesAsync([opções], chamada de retorno) ler item Organizador de Compromissos 1.8 (suporte de pastas partilhadas)

1.13 (suporte de caixa de correio partilhada)
Participante do Compromisso 1.8 (suporte de pastas partilhadas)

1.13 (suporte de caixa de correio partilhada)
Composição da mensagem 1.8 (suporte de pastas partilhadas)

1.13 (suporte de caixa de correio partilhada)
Mensagem lida 1.8 (suporte de pastas partilhadas)

1.13 (suporte de caixa de correio partilhada)
isClientSignatureEnabledAsync([opções], chamada de retorno) ler item Organizador de Compromissos 1.10
Composição da mensagem 1.10
loadCustomPropertiesAsync(callback, [userContext]) ler item Organizador de Compromissos 1.1
Participante do Compromisso 1.1
Composição da mensagem 1.1
Mensagem lida 1.1
removeAttachmentAsync(attachmentId, [options], [callback]) ler/escrever item Organizador de Compromissos 1.1
Composição da mensagem 1.1
removeHandlerAsync(eventType, handler, [options], [callback]) ler item Organizador de Compromissos 1.7
Participante do Compromisso 1.7
Composição da mensagem 1.7
Mensagem lida 1.7
saveAsync([options], callback) ler/escrever item Organizador de Compromissos 1.3
Composição da mensagem 1.3
setSelectedDataAsync(data, [options], callback) ler/escrever item Organizador de Compromissos 1.2
Composição da mensagem 1.2

Eventos

Pode subscrever e anular a subscrição dos seguintes eventos com addHandlerAsync e removeHandlerAsync respetivamente.

Event Descrição Minimum
conjunto de requisitos
AppointmentTimeChanged A data ou hora do compromisso ou série selecionado foi alterada. Apenas disponível com a implementação do painel de tarefas. 1.7
AttachmentsChanged Foi adicionado ou removido um anexo do item. Apenas disponível com a implementação do painel de tarefas. 1.8
EnhancedLocationsChanged A localização do compromisso selecionado foi alterada. Apenas disponível com a implementação do painel de tarefas. 1.8
InfobarClicked Foi selecionada uma ação a partir de uma mensagem de notificação. Apenas disponível com a implementação do painel de tarefas. 1.10
RecipientsChanged A lista de destinatários do item selecionado ou da localização do compromisso foi alterada. Apenas disponível com a implementação do painel de tarefas. 1.7
RecurrenceChanged O padrão de periodicidade da série selecionada foi alterado. Apenas disponível com a implementação do painel de tarefas. 1.7
SensitivityLabelChanged A etiqueta de confidencialidade de uma mensagem ou compromisso no modo de composição foi alterada. Apenas disponível com a implementação do painel de tarefas. 1.13
SpamReporting Foi reportada uma mensagem não solicitada no Outlook. Disponível apenas com um comando de função. 11.4

Exemplo

O exemplo de código JavaScript a seguir mostra como acessar a propriedade subject do item atual no Outlook.

// The initialize function is required for all apps.
Office.onReady(() => {
  // Checks for the DOM to load using the jQuery ready function.
  $(document).ready(function () {
    // After the DOM is loaded, app-specific code can run.
    const item = Office.context.mailbox.item;
    const subject = item.subject;
    // Continue with processing the subject of the current item,
    // which can be a message or appointment.
  });
});