Partager via


Office.ValueFormat enum

Spécifie si les valeurs (telles que les nombres et les dates) retournées par la méthode appelée sont retournées avec leur mise en forme appliquée.

Remarques

Par exemple, si le paramètre valueFormat est spécifié comme « formatté », la mise en forme d’un nombre au format monétaire ou d’une date au format mm/jj/aa dans l’application Office est conservée. Si le paramètre valueFormat est spécifié en tant que "unformatted", la date est retournée dans sa forme numérique séquentielle sous-jacente.

Exemples

/* Set the selection options. These will:
 - Pass the string "myContext" to the callback.
 - Include both visible and hidden data.
 - Return the formatted values of the selection 
     (for an Excel date, 1/1/2023 instead of 44928).
 */  
const options: Office.GetSelectedDataOptions = {
    asyncContext: "myContext",
    filterType: Office.FilterType.All,
    valueFormat: Office.ValueFormat.Formatted
}

// Get the selected data in the Office document as text.
Office.context.document.getSelectedDataAsync(
    Office.CoercionType.Text,
    options,
    (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.error(`${asyncResult.asyncContext}: asyncResult.error.message`);
        } else {
            console.log(`The selected data is "${asyncResult.value}".`);
        }
});

Champs

Formatted

Retourne les données mises en forme.

Unformatted

Retourne les données non mises en forme.