Worksheet Interface

Definição

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Microsoft.Office.Interop.Excel.WorksheetClass

Atributos: GuidAttribute

Implementações: _Worksheet DocEvents_Event

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 de 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:

Worksheets de propriedade
ActiveSheet de propriedade

Propriedade Worksheets

Use Worksheets(index), onde index é o número ou 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 é membro do Sheets conjunto. A coleção Planilhas contém todas as planilhas da pasta de trabalho (planilhas de gráfico e planilhas).

Propriedade ActiveSheet

Quando uma planilha é a planilha ativa, você pode usar a propriedade ActiveSheet para fazer referência a ela.

Propriedades

Nome	Description
_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 do 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. Não retornará nada se a filtragem estiver desativada. Somente leitura. (Herdado de _Worksheet)
AutoFilterMode	Verdadeiro se as setas suspensas de Filtro Automático estiverem sendo exibidas na planilha. Esta propriedade é independente da FilterMode propriedade. Boolean de leitura/gravação. (Herdado de _Worksheet)
Cells	Retorna um Range objeto que representa todas as células da 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 planilha ou retorna Nothing se não houver nenhuma referência circular na planilha. 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. Somente leitura xlCreatorCode. (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 especificado for exibido da direita para a esquerda, e não 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	Verdadeiro se a planilha estiver no modo de filtro. Boolean somente leitura. (Herdado de _Worksheet)
HPageBreaks	Retorna uma HPageBreaks coleção 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 para a 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 Chartobjeto , Rangeou Worksheet 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 a estrutura de tópicos 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, Range, ou 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 no 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 planilha de gráfico. 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 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 leitura XlSheetType. (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

Nome	Description
_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 incorporados (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 de retorno; 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 (um OLEObjects conjunto) 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. Este 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, em seguida, crie um relatório de Tabela Dinâmica com base no cache. objeto de Tabela Dinâmica . (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 elemento gráfico de plano de fundo de uma planilha ou de um 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. Não 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

Nome	Description
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 após a planilha ser 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 do aplicativo e da pasta de trabalho, consulte o evento SheetFollowHyperlink . (Herdado de DocEvents_Event)
LensGalleryRenderComplete	Ocorre quando os ícones de uma galeria de balões (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

Comentários

Esta página foi útil?