# InObject - função de gráfico

A função de gráfico InObject() avalia se o objeto atual está ou não contido em outro objeto com o ID especificado no argumento da função. O objeto pode ser uma pasta ou uma visualização.

Essa função pode ser usada para mostrar a hierarquia de objetos em uma pasta, desde o objeto de pasta de nível superior até visualizações aninhadas em outras visualizações. Essa função pode ser usada junto com as funções if e ObjectId para criar navegação personalizada em seus aplicativos.

[Creating a custom navigation in your app using InObject function](https://play.vidyard.com/yZ7ao42dELw6Yy3wiozUNF)

Sintaxe:

InObject(id\_str)

Tipo de dados de retorno: Booleano

No Qlik Sense, o valor booleano “true” é representado por -1, e o valor falso é representado por 0.

Argumentos

| Argumento | Descrição |
| --- | --- |
| id\_str | Um valor de string representando a ID do objeto que está sendo avaliado. |

Você pode usar o menu Incorporar para obter IDs de objeto.

Faça o seguinte:

1. No modo de análise, clique com o botão direito em uma visualização ou pasta e depois clique em the Compartilhar icon > the Incorporar icon .

2. Copie o ID do objeto ou da pasta.

Limitações:

Essa função pode gerar resultados inesperados quando invocada em um objeto (por exemplo, um botão) dentro de um contêiner que é um item mestre. Essa limitação também se aplica aos itens mestres do painel de filtro, que são contêineres para várias caixas de listagem. Isso se deve à forma como os itens mestres usam a hierarquia de objetos.

InObject() é frequentemente usado em combinação com as seguintes funções:

Funções relacionadas

| Função | Interação |
| --- | --- |
| [if Função de script e de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/if.htm) | As funções if e ObjectId podem ser usadas juntas para criar expressões condicionais. Por exemplo, visualizações podem obter cores condicionais por meio de expressões usando essas funções. |
| [ObjectId - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemFunctions/ObjectId.htm) | Semelhante a if, ObjectID também é usado com InObject para criar expressões condicionais. |

## Exemplo 1 – Funcionalidade básica

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemFunctions/InObject.htm)

#### Expressão e resultados do gráfico

O exemplo básico a seguir demonstra como determinar se um objeto está contido em outro objeto. Nesse caso, verificaremos se um objeto de Texto e imagem reside em um objeto de pasta usando o ID da pasta como argumento.

Faça o seguinte:

1. Abra uma nova pasta e, no painel Ativos, abra Gráficos.

2. Em Legado, arraste um gráfico de Texto e imagem para a pasta.

3. No painel de propriedades, clique em Adicionar medida.

4. Clique em the Expressão icon para abrir o editor de expressão.

5. Cole a seguinte expressão no diálogo:

   ```
   =InObject()
   ```

6. Modifique a expressão para incluir o ID da sua pasta como uma string entre parênteses.

   Por exemplo, para uma pasta com ID 1234-5678, você usaria o seguinte:

   `=InObject('1234-5678')`

7. Clique em Aplicar.

O valor `-1` é exibido no gráfico, indicando que a expressão foi avaliada como true.

## Exemplo 2 – Objetos com cores condicionais

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemFunctions/InObject.htm)

#### Expressão e resultados do gráfico

Visão geral

O exemplo a seguir demonstra como criar botões de navegação personalizados mostrando cores diferentes para indicar a pasta que está aberta no momento.

Comece criando um novo aplicativo e abrindo o Editor da carga de dados. Cole o script de carregamento a seguir em uma nova guia: Observe que os dados em si são um espaço reservado e não serão usados no conteúdo do exemplo.

Script de carregamento

```
Transactions: 

Load 
* 
Inline  
[ 
id,date,amount 
8188,'1/19/2022',37.23 
8189,'1/7/2022',17.17 
8190,'2/28/2022',88.27 
8191,'2/5/2022',57.42 
8192,'3/16/2022',53.80 
8193,'4/1/2022',82.06 
8194,'4/7/2022',40.39 
8195,'5/16/2022',87.21 
8196,'6/15/2022',95.93 
8197,'7/26/2022',45.89 
8198,'8/9/2022',36.23 
8199,'9/22/2022',25.66 
8200,'11/23/2022',82.77 
8201,'12/27/2022',69.98 
8202,'1/1/2023',76.11 
8203,'2/8/2022',25.12 
8204,'3/19/2022',46.23 
8205,'6/26/2022',84.21 
8206,'9/14/2022',96.24 
8207,'11/29/2022',67.67 
]; 
```

Criando as visualizações

Carregue os dados e crie duas novas pastas. Chame-os de Sales 2022 e Sales 2023, respectivamente.

Na pasta Sales 2022, ative as opções avançadas. Em seguida, crie dois objetos de botão que serão usados para navegar entre as duas pastas.

Faça o seguinte:

1. Adicione dois objetos Botão à pasta.

2. Em Aparência > Geral, defina o Rótulo de cada botão como Sales 2022 e Sales 2023, respectivamente.

3. Organize os botões para combinar com a imagem a seguir.

   Arranjo da pasta Sales 2022 com dois botões de navegação

   Arranjo da pasta Sales 2022 com dois botões de navegação

   Arranjo da pasta Sales 2022Sales 2022 com dois botões de navegação![Pasta de Sales 2022 com dois botões, denominados "Sales 2022" e "Sales 2023", respectivamente.](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Resources/Images/ObjectId_ConditionalColorButtonsArrangement.png)

4. Selecione o botão Sales 2022 e expanda Ações e navegação no painel de propriedades.

5. Clique em Adicionar ação e, em Navegação, selecione Ir para uma pasta.

6. Em Pasta, selecione Sales 2022.

7. Repita a configuração da ação desse botão para vincular o botão Sales 2023 à pasta Sales 2023.

8. Converta os botões em itens mestres clicando com o botão direito do mouse neles e selecionando the Adicionar a itens mestres icon .

Agora, você pode copiar cada botão e colá-lo na pasta Sales 2023, usando o mesmo tamanho e disposição na pasta.

Criando cores condicionais

Em seguida, configure os botões para que fiquem azuis se estiverem vinculados à pasta aberta no momento e para que fiquem cinza claro se estiverem vinculados à pasta que não está aberta.

Faça o seguinte:

1. Abra a pasta Sales 2022 e obtenha o ID dessa pasta no URL. Mantenha a pasta Sales 2022 aberta.

2. Clique no item mestre do botão Sales 2022 e selecione Editar no painel de propriedades.

3. Em Aparência > Plano de fundo, selecione para colorir o botão Por expressão.

4. Em Expressão, cole o seguinte texto:

   =if(InObject(''), Blue(), LightGray())

5. Entre parênteses na expressão acima, cole o ID da pasta Sales 2022.

O botão agora está configurado para ficar azul quando a pasta Sales 2022 estiver aberta e para ficar cinza claro quando não estiver aberta.

Repita as instruções acima para a pasta Sales 2023, vinculando o item mestre do botão Sales 2023 ao ID da pasta Sales 2023.

Cada pasta agora deve ter dois botões indicando a pasta aberta no momento com a cor azul.

Pasta Sales 2022 com coloração azul para indicar que Sales 2022 está sendo exibido atualmente

Pasta Sales 2022 com coloração azul para indicar que Sales 2022 está sendo exibido atualmente

Pasta Sales 2022Sales 2022 com coloração azul para indicar que Sales 2022 está sendo exibido atualmente ![Modo de análise para a pasta Vendas 2022 com dois botões, denominados "Sales 2022" e "Sales 2023", respectivamente.](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Resources/Images/ObjectId_ConditionalColorButtonsSales2022.png)