Office.ValueFormat enum
Especifica se valores, como números e datas, retornados pelo método invocado são retornados com sua formatação aplicada.
Comentários
Por exemplo, se o parâmetro valueFormat for especificado como "formatado", um número formatado como moeda ou uma data formatada como mm/dd/yy na aplicação do Office terá a respetiva formatação preservada. Se o parâmetro valueFormat for especificado como "não formatado", será devolvida uma data no respetivo formulário de número de série sequencial subjacente.
Exemplos
/* 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}".`);
}
});
Campos
| Formatted | Retorna dados formatados. |
| Unformatted | Retorna dados não formatados. |