Uso e exemplo

A extensão da Web Lista de itens tem parâmetros para sua funcionalidade básica e parâmetros adicionais para personalizar o conteúdo.

Estes são os parâmetros principais:

  • Chaves do item: Uma referência a um intervalo de células que contém os nomes exclusivos dos itens e ações para processamento adicional. Quando uma ação é disparada, Actions.Input.Text envia um destes valores:
    • Actions.Input.Text="Row": O item é selecionado.
    • Actions.Input.Text="Edit": O botão Editar foi clicado.
    • Actions.Input.Text="Delete": O botão Excluir foi clicado.
  • Dados do item: Uma referência a um intervalo de células que contém dados de item ou a uma célula que contém o XML dos mesmos dados. A primeira coluna do intervalo de dados é reservada para estas propriedades opcionais de chaves de item:
  • Título (string)
  • Descrição 1(string)
  • Descrição 2 (string)
  • Carimbo de data/hora (string)
  • Visível (booliano): Se Falso, o item será ocultado. Verdadeiro é o padrão.
  • Habilitado (booliano): Se Falso, o item está desabilitado. Verdadeiro é o padrão.
  • Selecionado (booliano): Se Verdadeiro, o item é selecionado. Falso é a opção padrão.
  • Editar (booliano): Se Verdadeiro, os ícones de edição em linha e exclusão serão exibidos. Falso é a opção padrão.
Estes parâmetros adicionais permitem personalização do conteúdo. Especifique ="" para usar padrões quando disponíveis.
Nota

Onde você pode especificar texto, como para a mensagem de erro, use a função TRANSLATEUNIQUESTRING para garantir que o texto seja traduzido se o idioma da interface do usuário for alterado.

  • Multiselect: Se Verdadeiro, a seleção múltipla será habilitada. Falso é a opção padrão.
  • Espaço reservado da caixa de pesquisa: Por padrão, a caixa de pesquisa está visível e vazia. Especifique Falso para desabilitar a caixa de seleção.
  • Mensagem de erro: Por padrão, se não houver itens de lista, a mensagem de erro será Nenhum item disponível.
  • Título principal: O título da lista. Por padrão, nenhum título é exibido.
  • Cor do título principal: A cor padrão do título é #368ac0.
  • Cor do título: A cor padrão da fonte do título é #1a1a1a.
  • Cor selecionada: A cor na qual a linha selecionada é realçada. O padrão é #c8e9f4.
  • Texto dos itens selecionados: Por padrão, o texto é Selecionado. Este parâmetro só será aplicável se a seleção múltipla estiver habilitada.
  • Ação de remover: Defina uma ação em uma célula, que é disparada ao clicar no botão Remover. O texto padrão é Remover. Este parâmetro só será aplicável se a seleção múltipla estiver habilitada.
  • Ocultar bordas laterais: Especifique Verdadeiro para ocultar as bordas esquerda e direita da linha. Por padrão, as bordas estão visíveis.
  • Cor da borda: Por padrão, a cor das bordas é #d8d8d8.
  1. Crie um relatório do Application Studio.
  2. Insira estes dados de exemplo no intervalo B8:H12:
    Chave Título Descrição1 Descrição2 Habilitado Selecionado Editar
    a Item A Descrição A FALSE TRUE
    b Item B Descrição B Informações detalhadas B FALSE FALSE FALSE
    c Item C Descrição C TRUE FALSE
    d Item D Descrição D FALSE FALSE
  3. Crie uma variável de relatório denominada rv_SelectedItem, especifique c como o valor e o valor padrão e selecione como seu valor. Nas propriedades da variável, especifique Falso como o valor da opção É persistente.
  4. Na célula G9, especifique =ReportVariables.rv_SelectedItem.Text=B9. Copie a fórmula para as células G10, G11 e G12.
    Após esta atualização, as células reterão os respectivos textos originais.
  5. Em cada uma das células chave ( B9, B10, B11 e B12), crie uma ação com estas características:
    Ações: Tipo
    Selecione Definir parâmetros como o tipo de ação.
    Ações: Modo
    Selecione Extensão da Web como o modo.
    Ações: Condição
    Especifique =Actions.Input.Text="ROW".
    Nota

    Esta condição será inválida, a menos que o modo de ação seja Extensão da Web.

    Parâmetros: Nome
    Clique em Adicionar parâmetro e selecione a variável rv_SelectedItem.
    Parâmetros: Propriedade
    Especifique Selected Value(.Text).
    Parâmetros: Valor
    Para a ação em B9, especifique =B9. Para as outras ações, especifique =B10, =B11 e =B12, respectivamente.
  6. Crie uma variável de relatório denominada rv_TitleItemA e especifique Item A como seu valor. Nas propriedades da variável, especifique Item A como o valor padrão e selecione Falso como o valor da opção É persistente.
  7. Na célula C9, especifique =ReportVariables.rv_TitleItemA.Text e pressione Enter.
    Após esta atualização, a célula mantém seu texto original.
  8. Na célula B9, crie uma ação com estas características:
    Ações: Tipo
    Selecione Definir parâmetros como o tipo de ação.
    Ações: Modo
    Selecione Extensão da Web como o modo.
    Ações: Condição
    Especifique =Actions.Input.Text="EDIT"
    Nota

    Esta condição será inválida, a menos que o modo de ação seja Extensão da Web.

    Parâmetros: Nome
    Clique em Adicionar parâmetro e selecione a variável rv_TitleItemA.
    Parâmetros: Propriedade
    Selecione Value(.Text)
    Parâmetros: Valor
    Especifique ="Edited Item A".
  9. Na célula B13, especifique esta fórmula SETPROPERTY: 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. Clique em Extensão da Web na barra de ferramentas Objetos e clique duas vezes na extensão da Web Lista de itens.
    O cursor muda para um formato de cruz.
  11. Arraste o cursor para inserir, dimensionar e posicionar a extensão da Web.
  12. Especifique estes parâmetros.
    Nomes exclusivos
    Especifique o intervalo de células que contém os nomes exclusivos dos itens de lista. Neste exemplo, especifique =B9:B12.
    Dados do item
    Especifique o intervalo de células que define a tabela de dados para a extensão. Neste exemplo, especifique =B13.
  13. Opcionalmente, especifique valores para esses parâmetros ou especifique ="" para usar os valores padrão.
    Título principal
    Por padrão, a lista não tem título. Opcionalmente, escreva um título.
    Cor da fonte do título principal
    Se um título principal for especificado, sua cor padrão será azul (#368ac0). Opcionalmente, especifique um valor de cor diferente.
    Espaço reservado da caixa de pesquisa
    Por padrão, a caixa de pesquisa está vazia. Como opção, especifique o texto a ser exibido na caixa. Para ocultar a caixa de pesquisa, especifique FALSE (diferencia maiúsculas e minúsculas).
    Mensagem de erro
    Por padrão, nenhum erro será exibido se não houver itens disponíveis. Opcionalmente, especifique uma mensagem de erro. Use TRANSLATESTRING para facilitar a tradução do erro se o idioma da interface do usuário for alterado.
    Cor da fonte do título
    Por padrão, o título dos itens de lista é escuro (#1a1a1a). Opcionalmente, especifique um valor de cor diferente
    Cor selecionada
    Especifique a cor na qual o item de lista selecionado será realçado. O padrão é um azul-claro (#c8e9f4). Opcionalmente, especifique um valor de cor diferente.
    Multisseleção
    Por padrão, você pode selecionar somente itens individuais. Para habilitar as caixas de seleção para a seleção de vários itens, especifique ="TRUE".
    Ocultar bordas laterais
    Por padrão, cada linha tem uma borda esquerda e direita. Especifique "=TRUE" para ocultar essas bordas.
    Cor da borda
    Por padrão, as bordas superior e laterais da lista são cinza-claras (#d8d8d8). Opcionalmente, especifique um valor de cor diferente.
    Texto dos itens selecionados
    Se a seleção múltipla estiver habilitada, o número de itens selecionados será indicado, seguido por Selecionado. Como opção, especifique um texto diferente. Use TRANSLATESTRINGUNIQUE para facilitar a tradução do texto se o idioma da interface do usuário for alterado.
    Botão Remover barra de ações

    Se a seleção múltipla estiver habilitada, será possível exibir um botão Remover para desmarcar itens selecionados. Especifique a referência de uma célula que contém a palavra Remover.

    Use TRANSLATESTRING para facilitar a tradução do botão se o idioma da interface do usuário for alterado.