Share via


Excel.Interfaces.RangeCollectionLoadOptions interface

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

Propriedades

$all

Especificar $all para o LoadOptions carrega todas as propriedades escalares (por exemplo: Range.address) mas não as propriedades de navegação (por exemplo: Range.format.fill.color).

address

Para CADA ITEM na coleção: especifica a referência de intervalo no estilo A1. O valor do endereço contém a referência da planilha (por exemplo, "Sheet1! A1:B4").

addressLocal

Para CADA ITEM na coleção: representa a referência de intervalo para o intervalo especificado no idioma do usuário.

cellCount

Para CADA ITEM na coleção: especifica o número de células no intervalo. Essa API retornará -1 se a contagem de células exceder 2^31-1 (2.147.483.647).

columnCount

Para CADA ITEM na coleção: especifica o número total de colunas no intervalo.

columnHidden

Para CADA ITEM na coleção: representa se todas as colunas no intervalo atual estiverem ocultas. O valor é true quando todas as colunas em um intervalo são ocultas. O valor é false quando nenhuma coluna no intervalo está oculta. O valor é null quando algumas colunas em um intervalo são ocultas e outras colunas no mesmo intervalo não são ocultas.

columnIndex

Para CADA ITEM na coleção: especifica o número de coluna da primeira célula no intervalo. Indexados com zero.

dataValidation

Para CADA ITEM na coleção: retorna um objeto de validação de dados.

format

Para CADA ITEM na coleção: retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo.

formulas

Para CADA ITEM na coleção: representa a fórmula na notação de estilo A1. Se uma célula não tiver fórmula, seu valor será retornado.

formulasLocal

Para CADA ITEM na coleção: representa a fórmula na notação de estilo A1, na linguagem do usuário e na localidade de formatação de números. Por exemplo, a fórmula "=SUM(A1, 1.5)" em inglês seria "=SOMA(A1; 1,5)" em português. Se uma célula não tiver fórmula, seu valor será retornado.

formulasR1C1

Para CADA ITEM na coleção: representa a fórmula na notação no estilo R1C1. Se uma célula não tiver fórmula, seu valor será retornado.

hasSpill

Para CADA ITEM na coleção: representa se todas as células tiverem uma borda de derramamento. Retorna true se todas as células tiverem uma borda de derramamento ou false se todas as células não tiverem uma borda de derramamento. Retornará null se houver células com e sem bordas de derramamento dentro do intervalo.

height

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda superior do intervalo até a borda inferior do intervalo.

hidden

Para CADA ITEM na coleção: representa se todas as células do intervalo atual estiverem ocultas. O valor é true quando todas as células em um intervalo são ocultas. O valor é false quando nenhuma célula no intervalo está oculta. O valor é null quando algumas células em um intervalo estão ocultas e outras células no mesmo intervalo não estão ocultas.

hyperlink

Para CADA ITEM na coleção: representa o hiperlink para o intervalo atual.

isEntireColumn

Para CADA ITEM na coleção: representa se o intervalo atual for uma coluna inteira.

isEntireRow

Para CADA ITEM na coleção: representa se o intervalo atual for uma linha inteira.

left

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda esquerda da planilha para a borda esquerda do intervalo.

linkedDataTypeState

Para CADA ITEM na coleção: representa o estado do tipo de dados de cada célula.

numberFormat

Para CADA ITEM na coleção: representa o código de formato de número do Excel para o intervalo determinado. Para obter mais informações sobre a formatação de números do Excel, consulte Códigos de formato de número.

numberFormatCategories

Para CADA ITEM na coleção: representa a categoria de formato de número de cada célula.

numberFormatLocal

Para CADA ITEM na coleção: representa o código de formato de número do Excel para o intervalo determinado, com base nas configurações de linguagem do usuário. O Excel não executa nenhuma coerção de linguagem ou formato ao obter ou definir a numberFormatLocal propriedade. Qualquer texto retornado usa as cadeias de caracteres formatadas localmente com base no idioma especificado nas configurações do sistema.

rowCount

Para CADA ITEM na coleção: retorna o número total de linhas no intervalo.

rowHidden

Para CADA ITEM na coleção: representa se todas as linhas no intervalo atual estiverem ocultas. O valor é true quando todas as linhas em um intervalo são ocultas. O valor é false quando nenhuma linha no intervalo é oculta. O valor é null quando algumas linhas em um intervalo estão ocultas e outras linhas no mesmo intervalo não são ocultas.

rowIndex

Para CADA ITEM na coleção: retorna o número da linha da primeira célula no intervalo. Indexados com zero.

savedAsArray

Para CADA ITEM na coleção: representa se todas as células seriam salvas como uma fórmula de matriz. Retorna true se todas as células fossem salvas como uma fórmula de matriz ou false se todas as células não fossem salvas como uma fórmula de matriz. Retorna null se algumas células forem salvas como uma fórmula de matriz e algumas não forem.

style

Para CADA ITEM na coleção: representa o estilo do intervalo atual. Se os estilos das células forem inconsistentes, null serão retornados. Para estilos personalizados, o nome do estilo será retornado. Para estilos internos, uma cadeia de caracteres que representa um valor no BuiltInStyle enum será retornada.

text

Para CADA ITEM na coleção: valores de texto do intervalo especificado. O valor de texto não depende da largura da célula. A substituição de sinal de número (#) que acontece na interface do usuário do Excel não afetará o valor de texto retornado pela API.

top

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda superior da planilha até a borda superior do intervalo.

values

Para CADA ITEM na coleção: representa os valores brutos do intervalo especificado. Os dados retornados podem ser uma cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro. Se o valor retornado começar com uma adição ("+"), menos ("-"), ou sinal igual ("="), o Excel interpretará esse valor como uma fórmula.

valueTypes

Para CADA ITEM na coleção: especifica o tipo de dados em cada célula.

width

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda esquerda do intervalo até a borda direita do intervalo.

worksheet

Para CADA ITEM na coleção: a planilha que contém o intervalo atual.

Detalhes da propriedade

$all

Especificar $all para o LoadOptions carrega todas as propriedades escalares (por exemplo: Range.address) mas não as propriedades de navegação (por exemplo: Range.format.fill.color).

$all?: boolean;

Valor da propriedade

boolean

address

Para CADA ITEM na coleção: especifica a referência de intervalo no estilo A1. O valor do endereço contém a referência da planilha (por exemplo, "Sheet1! A1:B4").

address?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

addressLocal

Para CADA ITEM na coleção: representa a referência de intervalo para o intervalo especificado no idioma do usuário.

addressLocal?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

cellCount

Para CADA ITEM na coleção: especifica o número de células no intervalo. Essa API retornará -1 se a contagem de células exceder 2^31-1 (2.147.483.647).

cellCount?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

columnCount

Para CADA ITEM na coleção: especifica o número total de colunas no intervalo.

columnCount?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

columnHidden

Para CADA ITEM na coleção: representa se todas as colunas no intervalo atual estiverem ocultas. O valor é true quando todas as colunas em um intervalo são ocultas. O valor é false quando nenhuma coluna no intervalo está oculta. O valor é null quando algumas colunas em um intervalo são ocultas e outras colunas no mesmo intervalo não são ocultas.

columnHidden?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

columnIndex

Para CADA ITEM na coleção: especifica o número de coluna da primeira célula no intervalo. Indexados com zero.

columnIndex?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

dataValidation

Para CADA ITEM na coleção: retorna um objeto de validação de dados.

dataValidation?: Excel.Interfaces.DataValidationLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.8 ]

format

Para CADA ITEM na coleção: retorna um objeto de formato, encapsulando a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo.

format?: Excel.Interfaces.RangeFormatLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

formulas

Para CADA ITEM na coleção: representa a fórmula na notação de estilo A1. Se uma célula não tiver fórmula, seu valor será retornado.

formulas?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

formulasLocal

Para CADA ITEM na coleção: representa a fórmula na notação de estilo A1, na linguagem do usuário e na localidade de formatação de números. Por exemplo, a fórmula "=SUM(A1, 1.5)" em inglês seria "=SOMA(A1; 1,5)" em português. Se uma célula não tiver fórmula, seu valor será retornado.

formulasLocal?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

formulasR1C1

Para CADA ITEM na coleção: representa a fórmula na notação no estilo R1C1. Se uma célula não tiver fórmula, seu valor será retornado.

formulasR1C1?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hasSpill

Para CADA ITEM na coleção: representa se todas as células tiverem uma borda de derramamento. Retorna true se todas as células tiverem uma borda de derramamento ou false se todas as células não tiverem uma borda de derramamento. Retornará null se houver células com e sem bordas de derramamento dentro do intervalo.

hasSpill?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.12 ]

height

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda superior do intervalo até a borda inferior do intervalo.

height?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

hidden

Para CADA ITEM na coleção: representa se todas as células do intervalo atual estiverem ocultas. O valor é true quando todas as células em um intervalo são ocultas. O valor é false quando nenhuma célula no intervalo está oculta. O valor é null quando algumas células em um intervalo estão ocultas e outras células no mesmo intervalo não estão ocultas.

hidden?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Para CADA ITEM na coleção: representa o hiperlink para o intervalo atual.

hyperlink?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

isEntireColumn

Para CADA ITEM na coleção: representa se o intervalo atual for uma coluna inteira.

isEntireColumn?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

isEntireRow

Para CADA ITEM na coleção: representa se o intervalo atual for uma linha inteira.

isEntireRow?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

left

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda esquerda da planilha para a borda esquerda do intervalo.

left?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

linkedDataTypeState

Para CADA ITEM na coleção: representa o estado do tipo de dados de cada célula.

linkedDataTypeState?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

numberFormat

Para CADA ITEM na coleção: representa o código de formato de número do Excel para o intervalo determinado. Para obter mais informações sobre a formatação de números do Excel, consulte Códigos de formato de número.

numberFormat?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

numberFormatCategories

Para CADA ITEM na coleção: representa a categoria de formato de número de cada célula.

numberFormatCategories?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.12 ]

numberFormatLocal

Para CADA ITEM na coleção: representa o código de formato de número do Excel para o intervalo determinado, com base nas configurações de linguagem do usuário. O Excel não executa nenhuma coerção de linguagem ou formato ao obter ou definir a numberFormatLocal propriedade. Qualquer texto retornado usa as cadeias de caracteres formatadas localmente com base no idioma especificado nas configurações do sistema.

numberFormatLocal?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

rowCount

Para CADA ITEM na coleção: retorna o número total de linhas no intervalo.

rowCount?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

rowHidden

Para CADA ITEM na coleção: representa se todas as linhas no intervalo atual estiverem ocultas. O valor é true quando todas as linhas em um intervalo são ocultas. O valor é false quando nenhuma linha no intervalo é oculta. O valor é null quando algumas linhas em um intervalo estão ocultas e outras linhas no mesmo intervalo não são ocultas.

rowHidden?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rowIndex

Para CADA ITEM na coleção: retorna o número da linha da primeira célula no intervalo. Indexados com zero.

rowIndex?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

savedAsArray

Para CADA ITEM na coleção: representa se todas as células seriam salvas como uma fórmula de matriz. Retorna true se todas as células fossem salvas como uma fórmula de matriz ou false se todas as células não fossem salvas como uma fórmula de matriz. Retorna null se algumas células forem salvas como uma fórmula de matriz e algumas não forem.

savedAsArray?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.12 ]

style

Para CADA ITEM na coleção: representa o estilo do intervalo atual. Se os estilos das células forem inconsistentes, null serão retornados. Para estilos personalizados, o nome do estilo será retornado. Para estilos internos, uma cadeia de caracteres que representa um valor no BuiltInStyle enum será retornada.

style?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

text

Para CADA ITEM na coleção: valores de texto do intervalo especificado. O valor de texto não depende da largura da célula. A substituição de sinal de número (#) que acontece na interface do usuário do Excel não afetará o valor de texto retornado pela API.

text?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

top

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda superior da planilha até a borda superior do intervalo.

top?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

values

Para CADA ITEM na coleção: representa os valores brutos do intervalo especificado. Os dados retornados podem ser uma cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro. Se o valor retornado começar com uma adição ("+"), menos ("-"), ou sinal igual ("="), o Excel interpretará esse valor como uma fórmula.

values?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

valueTypes

Para CADA ITEM na coleção: especifica o tipo de dados em cada célula.

valueTypes?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

width

Para CADA ITEM na coleção: retorna a distância em pontos, para 100% de zoom, da borda esquerda do intervalo até a borda direita do intervalo.

width?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

worksheet

Para CADA ITEM na coleção: a planilha que contém o intervalo atual.

worksheet?: Excel.Interfaces.WorksheetLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.1 ]