Lista Personalizada

Lista personalizada é um controle dinâmico baseado em modelo que incorpora vários controles com flexibilidade excepcional. Longe de ser um controle de lista padrão, a Lista Personalizada permite ainda mais controles dentro do layout, tornando-a ideal para tarefas como a criação de uma grade de listagem de e-mails eficaz.

Propriedades

A Lista personalizada tem dois conjuntos de propriedades: um para o controle principal e outro para o modelo dentro dele.

Para alternar entre as propriedades de uma Lista Personalizada e seu Modelo, clique no controle da tela ou selecione-o no modo de exibição de árvore, à esquerda.

EstaLinha

Use a palavra-chave ThisRow para representar cada linha dos dados da lista personalizada.

Para associar valores da Origem de dados aos controles individuais dentro da Lista personalizada, use a palavra-chave ThisRow .

Limitações

• Devido a considerações de desempenho, vários controles não podem ser incluídos em uma Lista personalizada:

  • Editar Grade
  • Tabela
  • Lista Personalizada
  • HTML Personalizado
  • Guias
  Observação:

  Para controles baseados em lista que excedam quatro itens, recomendamos usar controles suspensos .

• Fazer referência direta de controles da Lista personalizada , como MainPage.Header, não é permitido, apesar do nome do controle ter sido encontrado pelo IntelliSense.

• Arrastar controles entre o contexto de uma Lista personalizada e outros controles do contêiner pode causar expressões inválidas, algumas visíveis apenas quando você visualiza o aplicativo. Isso ocorre porque as associações dentro do contexto da Lista personalizada (usando a palavra-chave ThisRow ) se tornam inválidas fora da Lista personalizada.

Geral

Lista Personalizada

• Oculto — se definido como verdadeiro, oculta o controle durante o tempo de execução.
• Desabilitado — Se definido como falso, os usuários de aplicativos podem interagir com a lista. Se definido como verdadeiro, a lista ficará no estado somente leitura.

Modelo

• Dica de ferramenta — Dica de ferramenta a ser exibida no modelo. Use isso para fornecer informações adicionais sobre o modelo.
• Oculto— se definido como verdadeiro, oculta o controle durante o tempo de execução.
• Desabilitado — Se definido como falso, os usuários de aplicativos podem interagir com o modelo. Se definido como verdadeiro, o modelo estará no estado somente leitura.

Events

Lista Personalizada

• Linha selecionada — configure o que acontece quando o usuário do aplicativo seleciona uma linha (ou seja, um controle dentro de um modelo) na Lista personalizada. Configure o que deve acontecer quando o valor é alterado.

Modelo

• Clicando em — Configure o que acontece ao se clicar no modelo.

Estilo

Lista Personalizada

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.
  Observação:

  O alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).

• Layout - Personalize a posição dos modelos dentro da lista personalizada:
  • Vertical - os modelos são organizados verticalmente
  • Horizontal — os modelos são organizados horizontalmente
  • Grade - os modelos são dispostos em um formato de grade
  • Espaço entre ( somente pixels) - o espaçamento entre os modelos, quando eles são organizados em um layout Vertical ou Horizontal .
  • Espaço horizontal / vertical - o espaçamento horizontal e vertical entre os modelos, quando eles são organizados em um layout de Grade .
  • Largura do modelo — a largura do modelo.
  • Altura do modelo — a altura do modelo.
  Observação:

  • Em um layout Horizontal , a Largura é definida em pixels e a Altura em pixels, %, em, ou auto.
  • Em um layout Vertical , a Altura é definida em pixels, e a Largura pode ser em pixels, %, em ou auto.
  • Em um layout de Grade , Altura e Largura devem estar em pixels. Unidades relativas como %, em ou auto não podem ser usadas.
• Margem — a margem do layout. Por padrão, uma margem de 4px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .
• Tamanho — a largura e a altura da lista personalizada, em pixels. Valores padrão:
  • Em um layout Horizontal : Largura 800 pixels, Altura automática
  • Em um layout Vertical : largura automática, Altura 400 pixels
  • Em um Layout de grade : Largura 800 px, Altura 400 pxPara definir valores mínimos ou máximos, clique no ícone de três pontos (*).

Modelo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.
  Observação:

  O alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).

• Layout — Determine como os controles dentro do modelo são posicionados:
  • Horizontal/Vertical — a orientação dos controles.
  • Alinhamento— o alinhamento de controles dentro do modelo.
  • Permitir encapsulamento — se selecionado, encapsula os controles no modelo.
  • Permitir rolagem — se selecionado, permite a rolagem dentro do modelo. Para habilitar o Permitir rolagem, o modelo deve ter uma altura fixa (layout vertical) ou largura fixa (layout horizontal).
• Cor de fundo — a cor em segundo plano do modelo.
• Borda — define a borda do controle. Espessura, cor e raio da borda podem ser configurados.
• Fonte — a família de fontes para o modelo. Todos os controles dentro do modelo compartilham a mesma família de fontes. Por padrão, o modelo herda a família de fontes da Lista personalizada.
• Margem— a margem do layout. Por padrão, uma margem de 0px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .
• Preenchimento — o preenchimento do modelo. Por padrão, é definido um preenchimento de 16px. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Preenchimento .
• Avançado — exibe as propriedades Flex do controle.
  • Flex basis - Define o tamanho original de um item Flex antes que o espaço extra seja distribuído ou retirado (px, %, em, auto).
  • Flex grow — quando há espaço extra disponível, este valor determina quanto um item Flex deve crescer em relação ao restante dos itens.
  • Flex shrink — quando o espaço não é suficiente, esse valor determina quanto um item Flex deve encolher em comparação com os outros itens. Para obter detalhes, consulte a documentação da Rede de Desenvolvedores Mozilla.

Propriedades VB

Expandir tabela

Nome da propriedade	Tipo de dados	Permissões de acesso	Exemplo
Disabled	Booleano	Ler/Escrever	Se verdadeiro, desabilita o controle no tempo de execução.
Hidden	Booleano	Ler/Escrever	Se verdadeiro, oculta o controle no tempo de execução.
SelectedItemIndex	Número inteiro	Somente leitura	Retorna o índice da linha atualmente selecionada: MainPage.CustomList.SelectedItemIndex
ThisRow	A mesma que o campo Fonte de dados .	Somente leitura	Refere-se ao registro atual da Fonte de Dados. Use-o para configurar campos dentro da Lista personalizada.