Office.EventType enum

Especifica el tipo de evento que se ha generado. Devuelto por la type propiedad de un *EventArgs objeto .

Los complementos de Project admiten los Office.EventType.ResourceSelectionChangedtipos de eventos , Office.EventType.TaskSelectionChangedy Office.EventType.ViewSelectionChanged .

Solo los complementos de panel de tareas para Outlook admiten tipos de eventos de conjuntos de API de buzón.

Comentarios

Ejemplos

// This sample shows how to register an event handler in Outlook.
Office.onReady(() => {
    // Registers an event handler to identify when messages are selected.
    Office.context.mailbox.addHandlerAsync(Office.EventType.SelectedItemsChanged, getMessageProperties, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(asyncResult.error.message);
            return;
        }

        console.log("Event handler added for the SelectedItemsChanged event.");
    });
});

function getMessageProperties() {
    // Retrieves the selected messages' properties and logs them to the console.
    Office.context.mailbox.getSelectedItemsAsync((asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(asyncResult.error.message);
            return;
        }

        asyncResult.value.forEach((message) => {
            console.log(`Item ID: ${message.itemId}`);
            console.log(`Subject: ${message.subject}`);
            console.log(`Item type: ${message.itemType}`);
            console.log(`Item mode: ${message.itemMode}`);
        });
    });
}

Campos

ActiveViewChanged

Se generó un Document.ActiveViewChanged evento en PowerPoint.

AppointmentTimeChanged

Se produce cuando se cambia cualquier fecha o hora de la cita o serie seleccionada en Outlook. Importante: solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el AppointmentTimeChanged evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.AppointmentTimeChangedEventArgs.

[ Conjunto de API: Buzón 1.7 ]

AttachmentsChanged

Se produce cuando se agrega o quita un dato adjunto de un elemento. Importante: solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el AttachmentsChanged evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.AttachmentsChangedEventArgs.

[ Conjunto de API: Buzón 1.8 ]

BindingDataChanged

Se produce cuando los datos del enlace se cambian en Excel o Word.

Para agregar un controlador de eventos para el BindingDataChanged evento de un enlace, use el addHandlerAsync método del objeto Binding. El controlador de eventos recibe un argumento de tipo Office.BindingDataChangedEventArgs.

BindingSelectionChanged

Se produce cuando se cambia la selección dentro del enlace en Excel o Word.

Para agregar un controlador de eventos para el BindingSelectionChanged evento de un enlace, use el addHandlerAsync método del objeto Binding. El controlador de eventos recibe un argumento de tipo Office.BindingSelectionChangedEventArgs.

DialogEventReceived

Se desencadena cuando Dialog tiene un evento, como el diálogo cerrado o se produjo un error en la navegación del cuadro de diálogo.

DialogMessageReceived

Se desencadena cuando un cuadro de diálogo envía un mensaje a través de messageParent.

DialogParentMessageReceived

Se desencadena cuando una página host envía un mensaje a un cuadro de diálogo secundario con messageChild.

DocumentSelectionChanged

Se desencadena cuando se produce una selección de nivel de documento en Excel o Word.

EnhancedLocationsChanged

Se produce cuando se cambia la ubicación de la cita en Outlook. Importante: solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el EnhancedLocationsChanged evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.EnhancedLocationsChangedEventArgs.

[ Conjunto de API: Buzón 1.8 ]

InfobarClicked

Se produce en Outlook cuando se selecciona una acción en un mensaje de notificación con una acción personalizada definida. Actualmente, "Descartar" es la única acción admitida que desencadena este evento.

Importante: Este evento solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el InfobarClicked evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.InfobarClickedEventArgs.

[ Conjunto de API: Buzón 1.10 ]

ItemChanged

Se produce cuando se selecciona un elemento de Outlook diferente para su visualización mientras el panel de tareas está anclado. Importante: solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el ItemChanged evento, use el addHandlerAsync método del Mailbox objeto .

[ Conjunto de API: Buzón 1.5 ]

NodeDeleted

Se desencadena cuando se elimina un customXmlPart nodo.

NodeInserted

Se desencadena cuando se inserta un customXmlPart nodo.

NodeReplaced

Se desencadena cuando se reemplaza un customXmlPart nodo.

RecipientsChanged

Se produce cuando se cambia la lista de destinatarios del elemento seleccionado o la ubicación de la cita en Outlook. Importante: solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el RecipientsChanged evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.RecipientsChangedEventArgs.

[ Conjunto de API: Buzón 1.7 ]

RecurrenceChanged

Se produce cuando se cambia el patrón de periodicidad de la serie seleccionada en Outlook. Importante: solo está disponible con la implementación del panel de tareas.

Para agregar un controlador de eventos para el RecurrenceChanged evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.RecurrenceChangedEventArgs.

[ Conjunto de API: Buzón 1.7 ]

ResourceSelectionChanged

Se desencadena cuando se produce una selección de recursos en Project.

SelectedItemsChanged

Se produce en Outlook cuando se seleccionan o anulan la selección de uno o varios mensajes. Importante: Este evento solo se puede controlar en un panel de tareas. No es compatible con los comandos de función.

Para agregar un controlador de eventos para el SelectedItemsChanged evento, use el addHandlerAsync método del Mailbox objeto .

[ Conjunto de API: Buzón 1.13 ]

SensitivityLabelChanged

Se produce en Outlook cuando cambia la etiqueta de confidencialidad de un mensaje o cita. Importante: Este evento solo se puede controlar en un panel de tareas. No es compatible con los comandos de función.

Para agregar un controlador de eventos para el SensitivityLabelChanged evento, use el addHandlerAsync método del Item objeto . El controlador de eventos recibe un argumento de tipo Office.SensitivityLabelChangedEventArgs.

[ Conjunto de API: Buzón 1.13 ]

SettingsChanged

Se generó un Settings.settingsChanged evento en Excel, PowerPoint o Word.

TaskSelectionChanged

Se desencadena cuando se produce una selección de tarea en Project.

ViewSelectionChanged

Se desencadena cuando se produce una selección de vista en Project.