Atualizar rangeformat

Artigo
05/12/2024

Namespace: microsoft.graph

Atualize as propriedades do objeto rangeformat.

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante)	Files.ReadWrite	Indisponível.
Delegado (conta pessoal da Microsoft)	Files.ReadWrite	Indisponível.
Aplicativo	Sem suporte.	Sem suporte.

Solicitação HTTP

PATCH /me/drive/items/{id}/workbook/names/{name}/range/format
PATCH /me/drive/root:/{item-path}:/workbook/names/{name}/range/format
PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')/format
PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')/format
PATCH /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range/format
PATCH /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range/format

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Workbook-Session-Id	ID de sessão de pasta de trabalho que determina se as alterações são persistentes ou não. Opcional.

Corpo da solicitação

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base em alterações em outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.

Propriedade	Tipo	Descrição
columnWidth	double	Obtém ou define a largura de todas as colunas dentro do intervalo. Se as larguras da coluna não forem uniformes, o nulo será retornado.
horizontalAlignment	string	Representa o alinhamento horizontal do objeto especificado. Os valores possíveis são: `General`, , `Left`, `Center`, `Right`, `Fill`, `Justify`, `CenterAcrossSelection`. `Distributed`
rowHeight	duplo	Obtém ou define a altura de todas as linhas do intervalo. Se as alturas da linha não forem nulas uniformes serão retornadas.
verticalAlignment	string	Representa o alinhamento vertical do objeto especificado. Os valores possíveis são: `Top`, `Center`, `Bottom`, `Justify`, `Distributed`.
wrapText	booliano	Indica se o Excel quebra automaticamente a linha de texto no objeto. Um valor nulo indica que o intervalo inteiro não tem configuração de quebra de linha automática uniforme.

Resposta

Se for bem-sucedido, esse método retornará um código de resposta e um 200 OK objeto workbookRangeFormat atualizado no corpo da resposta.

Exemplo

Atualizar as propriedades de fonte, formatação e preenchimento em três células de tabela

Os exemplos a seguir demonstram como atualizar propriedades da pasta de trabalhoRangeFormat, workbookRangeFill e workbookRangeFont de um intervalo especificado.

O resultado desse conjunto de solicitações é uma tabela com três células formatadas como as três células principais na imagem abaixo.

Tabela de gráfico do Excel com três células cujas propriedades formatação, preenchimento e fonte foram atualizadas.

Solicitação

Esta solicitação atualiza o alinhamento vertical, a altura da linha e a altura da coluna da primeira célula.

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{sheet-id}/range(address='$A$1')/format
Content-type: application/json

{
  "columnWidth": 135,
  "verticalAlignment": "Top",
  "rowHeight": 49,
  "wrapText": false
}