Compartir a través de

Office.Control interface

Paquete:
office

Representa un control o comando individuales y el estado que debe tener.

Comentarios

Para ver ejemplos de código que muestran cómo usar un Control objeto y sus propiedades, vea Cambiar la disponibilidad de los comandos de complemento y Crear pestañas contextuales personalizadas.

Conjunto de requisitos: RibbonAPI 1.1

Ejemplos

// This snippet enables a control (a button) in a custom ribbon tab.
// Note that "MyButton", "OfficeAddinTab1", and "CustomGroup111" are defined in the manifest.
const enableButton = async () => {
    const button: Control = { id: "MyButton", enabled: true };
    const parentGroup: Group = { id: "CustomGroup111", controls: [button] };
    const parentTab: Tab = { id: "OfficeAddinTab1", groups: [parentGroup] };
    const ribbonUpdater: RibbonUpdaterData = { tabs: [parentTab] };
    Office.ribbon.requestUpdate(ribbonUpdater);
}

Propiedades

enabled

Indica si el control debe estar habilitado o deshabilitado. El valor predeterminado es true.
id

Identificador del control tal como se especifica en el manifiesto.

Detalles de las propiedades

enabled

Indica si el control debe estar habilitado o deshabilitado. El valor predeterminado es true.

enabled?: boolean;

Valor de propiedad

boolean

id

Identificador del control tal como se especifica en el manifiesto.

id: string;

Valor de propiedad

string