Office.Control interface

Paket:

office

Stellt ein einzelnes Steuerelement oder einen einzelnen Befehl und den Zustand dar, den es haben soll.

Hinweise

Codebeispiele zur Verwendung eines Control Objekts und seiner Eigenschaften finden Sie unter Ändern der Verfügbarkeit von Add-In-Befehlen und Erstellen von benutzerdefinierten Kontextregisterkarten.

Anforderungssatz: RibbonAPI 1.1

Beispiele

// 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);
}

Eigenschaften

enabled	Gibt an, ob das Steuerelement aktiviert oder deaktiviert werden soll. Der Standardwert ist "true".
id	Bezeichner des Steuerelements, wie im Manifest angegeben.

Details zur Eigenschaft

enabled

Gibt an, ob das Steuerelement aktiviert oder deaktiviert werden soll. Der Standardwert ist "true".

enabled?: boolean;

Eigenschaftswert

boolean

id

Bezeichner des Steuerelements, wie im Manifest angegeben.

id: string;

Eigenschaftswert

string