Worksheet Interface
Definição
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_EventPublic 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:
- Worksheets Propriedade
- ActiveSheet Propriedade
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 |
| 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) |