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 property
- ActiveSheet property
Propriedade Worksheets
Use Planilhas( ), onde está o número ou o nome do índice da index index 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 da Sheets coleção. A coleção Sheets contém todas as planilhas na pasta de trabalho (folhas 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
| _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 Microsoft Excel aplicativo. 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 em. Retorna Nothing se a filtragem estiver desligada. Somente leitura. (Herdado de _Worksheet) |
| AutoFilterMode |
True se as setas listadas do Filtro Automático estão exibidas na planilha. Essa propriedade é independente da FilterMode propriedade. Boolean de leitura/gravação. (Herdado de _Worksheet) |
| Cells |
Retorna um objeto que representa todas as células da planilha (não apenas as células Range que estão em uso no momento). Somente leitura. (Herdado de _Worksheet) |
| CircularReference |
Retorna um objeto que representa o intervalo que contém a primeira referência circular na planilha ou retorna Nothing se não houver Range 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. XlCreatorCodesomente leitura. (Herdado de _Worksheet) |
| CustomProperties |
Retorna um objeto que representa as informações CustomProperties de 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, planilha ou ListObject especificada for exibida da direita para a esquerda, em vez de 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 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. XlEnableSelectionLeitura/gravação. (Herdado de _Worksheet) |
| FilterMode |
True 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 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 ListObject de objetos na planilha. Coleção ListObjects de somente leitura. (Herdado de _Worksheet) |
| MailEnvelope |
Representa um header 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 coleção que representa todos os nomes específicos da planilha Names (nomes definidos com o "WorksheetName!" prefix). Objeto Names somente leitura. (Herdado de _Worksheet) |
| Next |
Retorna um Chart , ou objeto que representa a próxima planilha ou Range Worksheet 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 página do objeto especificado. Somente leitura. (Herdado de _Worksheet) |
| Parent |
Retorna o objeto pai para o objeto especificado. Somente leitura. (Herdado de _Worksheet) |
| Previous |
Retorna um Chart , , ou objeto que representa a planilha ou célula Range Worksheet 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 argumento definido como |
| ProtectScenarios |
True se os cenários de planilha estiverem protegidos. Boolean de 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 coleção, que contém objetos que representam blocos de script ou código no documento especificado quando ele Scripts é salvo como uma página da Script 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 planilha do 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 da planilha em pontos. Double somente leitura. (Herdado de _Worksheet) |
| StandardWidth |
Retorna ou define a largura padrão de todas as colunas da 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 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. XlSheetVisibilityLeitura/gravação. (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 incorporado (um objeto) ou uma coleção de todos os gráficos ChartObject 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; 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 ) ou uma coleção de todos os objetos OLEObject OLE (uma OLEObjects coleção) no gráfico ou 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) |
Colar 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 objeto) ou uma coleção de todos os relatórios de tabela PivotTable 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 método para adicionar um cache de tabela dinâmica e crie um Add(Object, Object, Object, Object) 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 objeto) ou uma coleção de Scenario 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 Nothing 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 que qualquer planilha seja 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 de 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 texto explicador (dinâmico e estático) 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) |