Compartilhar via


Worksheet Interface

Definição

Representa uma planilha.

public interface class Worksheet : Microsoft::Office::Interop::Excel::_Worksheet, Microsoft::Office::Interop::Excel::DocEvents_Event
[System.Runtime.InteropServices.Guid("000208D8-0000-0000-C000-000000000046")]
public interface Worksheet : Microsoft.Office.Interop.Excel._Worksheet, Microsoft.Office.Interop.Excel.DocEvents_Event
Public Interface Worksheet
Implements _Worksheet, DocEvents_Event
Derivado
Atributos
Implementações

Comentários

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. Para obter informações sobre o método e os membros da propriedade do objeto COM, consulte _Worksheet.

O objeto Worksheet é um membro da Worksheets coleção. A coleção de Planilhas contém todos os objetos Planilha em uma pasta de trabalho.

As seguintes propriedades para retornar um objeto Worksheet são descritas nesta seção:

Propriedade Worksheets

Use Planilhas(index), em que index é o número ou o nome do índice da planilha, para retornar um único objeto worksheet .

O número de índice da planilha indica a posição de uma planilha na barra de guias da pasta de trabalho. Worksheets(1) é a primeira planilha (à esquerda) na pasta de trabalho e Worksheets(Worksheets.Count) é a última. Todas as planilhas estão incluídas na contagem do índice, mesmo se elas estiverem ocultas.

O nome da planilha é exibido na guia da planilha. Use a Name propriedade para definir ou retornar o nome da planilha.

O objeto Worksheet também é um membro da Sheets coleção. A coleção Planilhas contém todas as planilhas da pasta de trabalho (planilhas e planilhas de gráficos).

Propriedade ActiveSheet

Quando uma planilha é a planilha ativa, você pode usar a propriedade ActiveSheet para se referir a ela.

Propriedades

_CodeName

Reservado para uso interno.

(Herdado de _Worksheet)
_DisplayRightToLeft

Reservado para uso interno.

(Herdado de _Worksheet)
Application

Quando usada sem um qualificador de objeto, essa propriedade retorna um Application objeto que representa o aplicativo Microsoft Excel. Quando usada com um qualificador de objeto, essa propriedade retornará um objeto Application que representa o criador do objeto especificado (você pode usar essa propriedade com um objeto Automation do OLE para retornar o aplicativo desse objeto). Somente leitura.

(Herdado de _Worksheet)
AutoFilter

Retorna um AutoFilter objeto se a filtragem estiver ativada. Retorna Nada se a filtragem estiver desativada. Somente leitura.

(Herdado de _Worksheet)
AutoFilterMode

True se as setas suspensas do AutoFilter forem exibidas atualmente na planilha. Essa propriedade é independente da FilterMode propriedade. Boolean de leitura/gravação.

(Herdado de _Worksheet)
Cells

Retorna um Range objeto que representa todas as células na planilha (não apenas as células que estão em uso no momento). Somente leitura.

(Herdado de _Worksheet)
CircularReference

Retorna um Range objeto que representa o intervalo que contém a primeira referência circular na folha ou retorna Nothing se não houver nenhuma referência circular na folha. A referência circular precisa ser removida antes do cálculo prosseguir. Somente leitura.

(Herdado de _Worksheet)
CodeName

Retorna o nome de código do objeto. String somente leitura.

(Herdado de _Worksheet)
Columns

Retorna um Range objeto que representa todas as colunas na planilha especificada. Somente leitura.

(Herdado de _Worksheet)
Comments

Retorna uma Comments coleção que representa todos os comentários da planilha especificada. Somente leitura.

(Herdado de _Worksheet)
ConsolidationFunction

Retorna o código de função usado para a consolidação atual. Pode ser uma das XlConsolidationFunction constantes. Somente leitura.

(Herdado de _Worksheet)
ConsolidationOptions

Retorna uma matriz de três elementos de opções de consolidação, como mostrado na tabela seguinte. Se o elemento for True, essa opção será definida. Somente leitura objeto.

(Herdado de _Worksheet)
ConsolidationSources

Retorna uma matriz de valores de sequência de caracteres informando os nomes das planilhas de origem para a consolidação da planilha atual. Retorna Empty se não houver consolidação na planilha. Somente leitura objeto.

(Herdado de _Worksheet)
Creator

Retorna uma constante na XlCreator enumeração que indica o aplicativo no qual esse objeto foi criado. Se o objeto foi criado no Microsoft Excel, essa propriedade retornará a sequência XCEL, que é equivalente ao número hexadecimal 5843454C. XlCreatorCode somente leitura.

(Herdado de _Worksheet)
CustomProperties

Retorna um CustomProperties objeto que representa as informações do identificador associadas a uma planilha.

(Herdado de _Worksheet)
DisplayAutomaticPageBreaks

Reservado para uso interno.

(Herdado de _Worksheet)
DisplayPageBreaks

True se as quebras de página (automática e manual) na planilha especificada estiverem ativadas. Boolean de leitura/gravação.

(Herdado de _Worksheet)
DisplayRightToLeft

True se a janela, a planilha ou o ListObject especificados forem exibidos da direita para a esquerda, em vez da esquerda para a direita. False se o objeto for exibido da esquerda para a direita. Boolean somente leitura.

(Herdado de _Worksheet)
EnableAutoFilter

True se as setas do AutoFiltro estiverem ativadas quando a proteção apenas da interface do usuário estiver ativada. Boolean de leitura/gravação.

(Herdado de _Worksheet)
EnableCalculation

True se o Microsoft Excel recalcular automaticamente a planilha quando necessário. False se o Excel não recalcular a planilha. Boolean de leitura/gravação.

(Herdado de _Worksheet)
EnableFormatConditionsCalculation

Retorna ou define se os formatos condicionais ocorrerão automaticamente conforme necessário. Boolean de leitura/gravação.

(Herdado de _Worksheet)
EnableOutlining

True se os símbolos de tópicos estiverem ativados quando a proteção apenas da interface do usuário estiver ativada. Boolean de leitura/gravação.

(Herdado de _Worksheet)
EnablePivotTable

True se os controles e ações da tabela dinâmica estiverem ativados quando a proteção apenas da interface do usuário estiver ativada. Boolean de leitura/gravação.

(Herdado de _Worksheet)
EnableSelection

Retorna ou define o que pode ser selecionado na planilha. Leitura/gravação XlEnableSelection.

(Herdado de _Worksheet)
FilterMode

True se a planilha estiver no modo de filtro. Boolean somente leitura.

(Herdado de _Worksheet)
HPageBreaks

Retorna uma coleção HPageBreaks que representa as quebras de página horizontais na planilha. Somente leitura.

(Herdado de _Worksheet)
Hyperlinks

Retorna uma Hyperlinks coleção que representa os hiperlinks para o intervalo ou planilha.

(Herdado de _Worksheet)
Index

Retorna o número de índice do objeto dentro da coleção de objetos similares. Integer somente leitura.

(Herdado de _Worksheet)
ListObjects

Retorna uma coleção de ListObject objetos na planilha. Coleção ListObjects de somente leitura.

(Herdado de _Worksheet)
MailEnvelope

Representa um cabeçalho de email para um documento.

(Herdado de _Worksheet)
Name

Retorna ou define o nome do objeto. String de leitura/gravação.

(Herdado de _Worksheet)
Names

Retorna uma Names coleção que representa todos os nomes específicos da planilha (nomes definidos com o prefixo "WorksheetName!"). Objeto Names somente leitura.

(Herdado de _Worksheet)
Next

Retorna um Chart, Rangeou Worksheet objeto que representa a próxima planilha ou célula. Somente leitura.

(Herdado de _Worksheet)
OnCalculate

Reservado para uso interno.

(Herdado de _Worksheet)
OnData

Reservado para uso interno.

(Herdado de _Worksheet)
OnDoubleClick

Reservado para uso interno.

(Herdado de _Worksheet)
OnEntry

Reservado para uso interno.

(Herdado de _Worksheet)
OnSheetActivate

Reservado para uso interno.

(Herdado de _Worksheet)
OnSheetDeactivate

Reservado para uso interno.

(Herdado de _Worksheet)
Outline

Retorna um Outline objeto que representa o contorno da planilha especificada. Somente leitura.

(Herdado de _Worksheet)
PageSetup

Retorna um PageSetup objeto que contém todas as configurações de configuração de página para o objeto especificado. Somente leitura.

(Herdado de _Worksheet)
Parent

Retorna o objeto pai do objeto especificado. Somente leitura.

(Herdado de _Worksheet)
Previous

Retorna um Chart, Rangeou Worksheet objeto que representa a planilha ou célula anterior. Somente leitura.

(Herdado de _Worksheet)
PrintedCommentPages

Obtém o número de páginas de comentários que serão impressas para a planilha atual.

(Herdado de _Worksheet)
ProtectContents

True se o conteúdo da planilha estiver protegido. Para um gráfico, isso protege o gráfico inteiro. Para uma planilha, isso protege as células individuais. Boolean somente leitura.

(Herdado de _Worksheet)
ProtectDrawingObjects

True se as formas estiverem protegidas. Boolean somente leitura.

(Herdado de _Worksheet)
Protection

Retorna um Protection objeto que representa as opções de proteção da planilha.

(Herdado de _Worksheet)
ProtectionMode

True se a proteção somente da interface do usuário estiver ativada. Para ativar a proteção da interface do usuário, use o Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) método com o UserInterfaceOnly argumento definido como True. Boolean somente leitura.

(Herdado de _Worksheet)
ProtectScenarios

True se os cenários de planilha estiverem protegidos. Boolean somente leitura.

(Herdado de _Worksheet)
QueryTables

Retorna a QueryTables coleção que representa todas as tabelas de consulta na planilha especificada. Somente leitura.

(Herdado de _Worksheet)
Range[Object, Object]

Retorna um Range objeto que representa uma célula ou um intervalo de células.

(Herdado de _Worksheet)
Rows

Retorna um Range objeto que representa todas as linhas na planilha especificada. Objeto Range somente leitura.

(Herdado de _Worksheet)
Scripts

Retorna a Scripts coleção, que contém Script objetos que representam blocos de script ou código no documento especificado quando ele é salvo como uma página da Web.

(Herdado de _Worksheet)
ScrollArea

Retorna ou define o intervalo em que a rolagem é permitida como uma referência de intervalo de estilo A1. As células fora da área de rolagem não podem ser selecionadas. String de leitura/gravação.

(Herdado de _Worksheet)
Shapes

Retorna um Shapes objeto que representa todas as formas na planilha ou na planilha de gráficos. Somente leitura.

(Herdado de _Worksheet)
SmartTags

Retorna um SmartTags objeto que representa o identificador da célula especificada.

(Herdado de _Worksheet)
Sort

Retorna os valores classificados na planilha atual. Somente leitura.

(Herdado de _Worksheet)
StandardHeight

Retorna a altura padrão (padrão) de todas as linhas na planilha em pontos. Double somente leitura.

(Herdado de _Worksheet)
StandardWidth

Retorna ou define a largura padrão de todas as colunas na planilha. Double de leitura/gravação.

(Herdado de _Worksheet)
Tab

Retorna um Tab objeto para um gráfico ou uma planilha.

(Herdado de _Worksheet)
TransitionExpEval

True se o Microsoft Excel usar as regras de avaliação de expressões do Lotus 1-2-3 para a planilha. Boolean de leitura/gravação.

(Herdado de _Worksheet)
TransitionFormEntry

True se o Microsoft Excel usar as regras de entrada de fórmula do Lotus 1-2-3 para a planilha. Boolean de leitura/gravação.

(Herdado de _Worksheet)
Type

Retorna ou define o tipo de planilha. Somente XlSheetTypeleitura .

(Herdado de _Worksheet)
UsedRange

Retorna um Range objeto que representa o intervalo usado na planilha especificada. Somente leitura.

(Herdado de _Worksheet)
Visible

Determina se o objeto será visível. Leitura/gravação XlSheetVisibility.

(Herdado de _Worksheet)
VPageBreaks

Retorna uma VPageBreaks coleção que representa as quebras de página verticais na planilha. Somente leitura.

(Herdado de _Worksheet)

Métodos

_CheckSpelling(Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

(Herdado de _Worksheet)
_Evaluate(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
_PasteSpecial(Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

(Herdado de _Worksheet)
_PrintOut(Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

(Herdado de _Worksheet)
_Protect(Object, Object, Object, Object, Object)

Reservado para uso interno.

(Herdado de _Worksheet)
_SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Arcs(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Buttons(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
ChartObjects(Object)

Retorna um objeto que representa um único gráfico inserido (um ChartObject objeto) ou uma coleção de todos os gráficos inseridos (um ChartObjects objeto) na planilha.

(Herdado de _Worksheet)
CheckBoxes(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
CheckSpelling(Object, Object, Object, Object)

Verifica a ortografia de um objeto. Esse formulário não tem valor retornado; O Microsoft Excel exibe a caixa de diálogo Ortografia.

(Herdado de _Worksheet)
CircleInvalid()

Circunda entradas inválidas na planilha.

(Herdado de _Worksheet)
ClearArrows()

Limpa as setas de rastreamento da planilha. Elas são adicionadas com o uso do recurso de auditoria.

(Herdado de _Worksheet)
ClearCircles()

Retira os círculos das entradas inválidas na planilha.

(Herdado de _Worksheet)
Copy(Object, Object)

Copia a planilha para outro local na pasta de trabalho.

(Herdado de _Worksheet)
Delete()

Exclui o objeto.

(Herdado de _Worksheet)
DrawingObjects(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Drawings(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
DropDowns(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Evaluate(Object)

Converte um nome do Microsoft Excel em um objeto ou em um valor.

(Herdado de _Worksheet)
ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)

Exporta para um arquivo do formato especificado.

(Herdado de _Worksheet)
GroupBoxes(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
GroupObjects(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Labels(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Lines(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
ListBoxes(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Move(Object, Object)

Move a planilha para outro local na pasta de trabalho

(Herdado de _Worksheet)
OLEObjects(Object)

Retorna um objeto que representa um único objeto OLE (um OLEObject) ou uma coleção de todos os objetos OLE (uma coleção OLEObjects ) no gráfico ou na planilha. Somente leitura.

(Herdado de _Worksheet)
OptionButtons(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Ovals(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Paste(Object, Object)

Cola o conteúdo da Área de Transferência na planilha.

(Herdado de _Worksheet)
PasteSpecial(Object, Object, Object, Object, Object, Object, Object)

Cola o conteúdo da Área de Transferência na planilha usando um formato especificado. Use este método para colar dados de outros aplicativos ou para colar dados em um formato específico.

(Herdado de _Worksheet)
Pictures(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
PivotTables(Object)

Retorna um objeto que representa um único relatório de Tabela Dinâmica (um PivotTable objeto) ou uma coleção de todos os relatórios de Tabela Dinâmica (um PivotTables objeto) em uma planilha. Somente leitura.

(Herdado de _Worksheet)
PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Cria um PivotTable objeto. Esse método não exibe o Assistente de Tabela Dinâmica. Esse método não está disponível para fontes de dados OLE DB. Use o Add(Object, Object, Object, Object) método para adicionar um cache de Tabela Dinâmica e crie um relatório de Tabela Dinâmica com base no cache. Objeto PivotTable .

(Herdado de _Worksheet)
PrintOut(Object, Object, Object, Object, Object, Object, Object, Object)

Imprime o objeto.

(Herdado de _Worksheet)
PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

(Herdado de _Worksheet)
PrintPreview(Object)

Mostra uma visualização de como o objeto aparecerá quando for impresso.

(Herdado de _Worksheet)
Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Protege uma planilha de forma que ela não possa ser modificada.

(Herdado de _Worksheet)
Rectangles(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
ResetAllPageBreaks()

Redefine todas as quebras de página da planilha especificada.

(Herdado de _Worksheet)
SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Salva alterações feitas no gráfico ou na planilha em um arquivo diferente.

(Herdado de _Worksheet)
Scenarios(Object)

Retorna um objeto que representa um único cenário (um Scenario objeto) ou uma coleção de cenários (um Scenarios objeto) na planilha.

(Herdado de _Worksheet)
ScrollBars(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Select(Object)

Seleciona o objeto.

(Herdado de _Worksheet)
SetBackgroundPicture(String)

Define o gráfico em segundo plano para uma planilha ou gráfico.

(Herdado de _Worksheet)
ShowAllData()

Tornar visíveis todas as linhas da lista atualmente filtrada. Se o AutoFiltro estiver em uso, esse método mudará as setas para "Tudo".

(Herdado de _Worksheet)
ShowDataForm()

Exibe o formulário de dados associado à planilha.

(Herdado de _Worksheet)
Spinners(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
TextBoxes(Object)

Reservado para uso interno.

(Herdado de _Worksheet)
Unprotect(Object)

Remove a proteção de uma planilha ou de uma pasta de trabalho. Esse método não terá efeito caso a planilha ou a pasta de trabalho não esteja protegida.

(Herdado de _Worksheet)
XmlDataQuery(String, Object, Object)

Retorna um Range objeto que representa as células mapeadas para um XPath específico. Retorna Nada se o XPath especificado não tiver sido mapeado para a planilha ou se o intervalo mapeado estiver vazio.

(Herdado de _Worksheet)
XmlMapQuery(String, Object, Object)

Retorna um Range objeto que representa as células mapeadas para um XPath específico. Retorna Nothing se o XPath especificado não tiver sido mapeado para a pasta de trabalho.

(Herdado de _Worksheet)

Eventos

Activate

Ocorre quando uma planilha é ativada.

(Herdado de DocEvents_Event)
BeforeDelete

O evento BeforeDelete ocorre antes de qualquer planilha ser excluída.

(Herdado de DocEvents_Event)
BeforeDoubleClick

Ocorre quando uma planilha é clicada duas vezes, antes da ação padrão de clique duplo.

(Herdado de DocEvents_Event)
BeforeRightClick

Ocorre quando uma planilha é clicada com o botão direito, antes da ação padrão de clique com o botão direito.

(Herdado de DocEvents_Event)
Calculate

Ocorre depois que a planilha é recalculada.

(Herdado de DocEvents_Event)
Change

Ocorre quando as células da planilha são alteradas pelo usuário ou por um link externo.

(Herdado de DocEvents_Event)
Deactivate

Ocorre quando a planilha é desativada.

(Herdado de DocEvents_Event)
FollowHyperlink

Ocorre ao clicar em qualquer hiperlink em uma planilha. Para eventos no nível de aplicativo e pasta de trabalho, consulte o evento SheetFollowHyperlink .

(Herdado de DocEvents_Event)
LensGalleryRenderComplete

Ocorre quando os ícones de uma galeria de chamada (dinâmicos e estáticos) concluíram a renderização.

(Herdado de DocEvents_Event)
PivotTableAfterValueChange

Ocorre depois que uma célula ou intervalo de células dentro de uma Tabela Dinâmica é editada(o) ou recalculada(o) (para células que contêm fórmulas).

(Herdado de DocEvents_Event)
PivotTableBeforeAllocateChanges

Ocorre antes que as alterações sejam aplicadas a uma Tabela Dinâmica.

(Herdado de DocEvents_Event)
PivotTableBeforeCommitChanges

Ocorre antes de as alterações serem confirmadas com base na fonte de dados OLAP de uma Tabela Dinâmica.

(Herdado de DocEvents_Event)
PivotTableBeforeDiscardChanges

Ocorre antes de as alterações feitas em uma Tabela Dinâmica serem descartadas.

(Herdado de DocEvents_Event)
PivotTableChangeSync

Ocorre após as alterações em uma Tabela Dinâmica.

(Herdado de DocEvents_Event)
PivotTableUpdate

Ocorre após um relatório de tabela dinâmica ser atualizado em uma planilha.

(Herdado de DocEvents_Event)
SelectionChange

Ocorre quando a seleção é alterada em uma planilha.

(Herdado de DocEvents_Event)
TableUpdate

Ocorre depois que uma tabela de consulta conectada ao Modelo de Dados é atualizada em uma planilha.

(Herdado de DocEvents_Event)

Aplica-se a