Classe CubeField (Excel VBA)

A classe CubeField representa um campo de hierarquia ou medida de um cubo OLAP. Em um relatório de tabela dinâmica, o objeto CubeField é membro da coleção CubeFields.

Os principais procedimentos da classe CubeField são AddMemberPropertyField, Delete e CubeFields.AddSet

Set

Para usar uma variável de classe CubeField, ela primeiro precisa ser instanciada por exemplo

Dim cbf as CubeField
Set cbf = ActiveCell.PivotField.CubeField

Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo CubeField: CubeFields.Item, CubeFields.AddSet, CubeFields.GetMeasure, PivotField.CubeField, PivotFilter.DataCubeField e PivotTable.CubeFields

For Each

Aqui está um exemplo de processamento dos itens CubeField em uma coleção.

Dim cbf As CubeField
For Each cbf In ActiveCell.CubeFields
	
Next cbf

Temas

Alguns procedimentos nesta classe foram agrupados em temas e são descritos em páginas de tema separadas

Add with its procedures AddMemberPropertyField e CubeFields.AddSet
Cube with its procedures CubeFieldSubType e CubeFieldType

Métodos

Estes são os principais métodos da classe CubeField

Delete - Exclui o objeto.

ActiveCell.PivotField.CubeField.Delete

Estes são os principais métodos da classe

AutoGroup - Agrupa automaticamente os campos de cubo em um cubo OLAP, opcionalmente, na orientação especificada e/ou na posição especificada.

ClearManualFilter - O método ClearManualFilter fornece uma maneira fácil de definir a propriedade Visible como true para todos os itens de um PivotField em tabelas dinâmicas e para esvaziar as coleções HiddenItemsList/coleções visibleitemslist em OLAP Tabelas dinâmicas.

CreatePivotFields - O método CreatePivotFields permite que os usuários apliquem um filtro a PivotFields ainda não adicionado à tabela dinâmica, criando o objeto PivotField correspondente.

CubeFields.GetMeasure - Dada uma hierarquia de atributo, retorna uma medida implícita para a função fornecida que corresponde a esse atributo. Se uma medida implícita não existir, uma nova medida implícita será criada e adicionada à coleção CubeFields .

Propriedades

AllItemsVisible A propriedade AllItemsVisible verifica se a filtragem manual é aplicada a um PivotField ou CubeField. Boolean somente leitura.

Dim booAllItemsVisible As Boolean
booAllItemsVisible = ActiveCell.PivotField.CubeField.AllItemsVisible

Caption Retorna um valor String que representa o texto do rótulo para o campo de cubo.

ActiveCell.PivotField.CubeField.Caption =

CurrentPageName Retorna ou define o nome da página de um CubeField. String de leitura/gravação.

ActiveCell.PivotField.CubeField.CurrentPageName =

DragToColumn True se o campo especificado puder ser arrastado para a posição de coluna. O valor padrão é True. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.DragToColumn = True

DragToData True se o campo especificado puder ser arrastado para a posição de dados. O valor padrão é True. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.DragToData = True

DragToHide True se o campo puder ser ocultado sendo arrastado para fora do relatório de tabela dinâmica. O valor padrão é True. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.DragToHide = True

DragToPage True se o campo puder ser arrastado para a posição de página. O valor padrão é True. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.DragToPage = True

DragToRow True se o campo puder ser arrastado para a posição de linha. O valor padrão é True. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.DragToRow = True

EnableMultiplePageItems Definida como True para permitir que sejam selecionados vários itens na área de campo de página em tabelas dinâmicas OLAP. O valor padrão é False. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.EnableMultiplePageItems = True

FlattenHierarchies Retorna ou define se os itens de todos os níveis de hierarquias em um cubo de conjunto nomeado são exibidos no mesmo campo de um relatório de Tabela Dinâmica com base em um cubo OLAP. Leitura/gravação.

ActiveCell.PivotField.CubeField.FlattenHierarchies = True

HasMemberProperties Retorna True quando existem propriedades de membros especificadas para serem exibidas para o campo de cubo. Boolean somente leitura.

Dim booHasMemberProperties As Boolean
booHasMemberProperties = ActiveCell.PivotField.CubeField.HasMemberProperties

HierarchizeDistinct Retorna ou define se deve ordenar e remover duplicatas ao exibir o conjunto nomeado especificado em um relatório de tabela dinâmica com base em um cubo OLAP. Leitura/gravação.

ActiveCell.PivotField.CubeField.HierarchizeDistinct = True

IncludeNewItemsInFilter A propriedade IncludeNewItemsInFilter é usada para controlar itens incluídos/excluídos nas Tabelas Dinâmicas OLAP. Leitura/gravação.

ActiveCell.PivotField.CubeField.IncludeNewItemsInFilter = True

IsDate Retorna True se CubeField for uma data. Boolean somente leitura.

Dim booIsDate As Boolean
booIsDate = ActiveCell.PivotField.CubeField.IsDate

LayoutForm Retorna ou define a forma como os itens de tabela dinâmica especificados são exibidos – no formato de tabela ou de estrutura de tópicos. Leitura/gravação XlLayoutFormType.

ActiveCell.PivotField.CubeField.LayoutForm = xlOutline

LayoutSubtotalLocation Retorna ou define a posição dos subtotais do campo de tabela dinâmica em relação ao campo especificado acima ou abaixo. Leitura/gravação XlSubtotalLocationType.

ActiveCell.PivotField.CubeField.LayoutSubtotalLocation = xlAtBottom

Name Retorna um valor String que representa o nome do objeto.

Dim strName As String
strName = ActiveCell.PivotField.CubeField.Name

Orientation Retorna ou define um valor XlPivotFieldOrientation que representa o local do campo no relatório de tabela dinâmica especificado.

ActiveCell.PivotField.CubeField.Orientation = xlColumnField

Parent Retorna o objeto pai do objeto especificado. Somente leitura.

Dim objParent As Object
Set objParent = ActiveCell.PivotField.CubeField.Parent

PivotFields Retorna a coleção PivotFields . Essa coleção contém todos os campos de tabela dinâmica, incluindo aqueles que atualmente não estão visíveis na tela. Objeto PivotFields de somente leitura.

Dim pfsPivotFields As PivotFields
Set pfsPivotFields = ActiveCell.PivotField.CubeField.PivotFields

Position Retorna ou define um valor Long que representa a posição do campo de hierarquia no relatório de tabela dinâmica quando ele é arrastado do campo.

ActiveCell.PivotField.CubeField.Position =

ShowInFieldList Quando for definida como True padrão, um objeto CubeField será mostrado na lista de campos. Boolean de leitura/gravação.

ActiveCell.PivotField.CubeField.ShowInFieldList = True

TreeviewControl Retorna o objeto TreeviewControl do objeto CubeField que representa o controle de manipulação de cubo de um relatório de tabela dinâmica baseado em OLAP. Somente leitura.

Dim tclTreeviewControl As TreeviewControl
Set tclTreeviewControl = ActiveCell.PivotField.CubeField.TreeviewControl

Value Retorna um valor String que representa o nome do campo especificado.

Dim strValue As String
strValue = ActiveCell.PivotField.CubeField.Value

CubeFields.Count Retorna um valor Long que representa o número de objetos na coleção.

Dim lngCount As Long
lngCount = ActiveCell.PivotTable.CubeFields.Count

CubeFields.Item Retorna um único objeto de uma coleção.

Dim cbfItem As CubeField
Set cbfItem = ActiveCell.PivotTable.CubeFields(Index:=1)

CubeFields.Parent Retorna o objeto pai do objeto especificado. Somente leitura.

Dim objParent As Object
Set objParent = ActiveCell.PivotTable.CubeFields.Parent