4D v14.3

HIGHLIGHT RECORDS

Página Inicial

 
4D v14.3
HIGHLIGHT RECORDS

HIGHLIGHT RECORDS 


 

HIGHLIGHT RECORDS ( {tabela }{;}{ nomConjunto {; *}} ) 
Parâmetro Tipo   Descrição
tabela  Tabela in Tabela cujos registros foram selecionados se omitidos, tabela do formulário atual
nomConjunto  cadeia in Conjunto de registros a selecionar ou Userset se omitido
Operador in Desativar a barra de rolagem automático da lista

O comando HIGHLIGHT RECORDS permite selecionar registros em um formulário listado. Esta operação é idêntica à seleção de registros manual em modo listado utilizando o mouse ou as combinações de teclado Shift+Clique ou Ctrl+Clique (Windows) ou comando+Clique (Mac OS). A seleção atual não é modificada.

Nota: o conjunto de registros selecionados é atualizado depois de redesenhar os registros; ou seja, depois da execução de todo o método de chamada e não apenas imediatamente depois da execução de HIGHLIGHT RECORDS.

O parâmetro tabela permite designar a tabela da qual selecionar os registros. Este parâmetro pode ser utilizado, particularmente, para selecionar os registros dos subformulários incluídos, os quais não pertencem à tabela atual (ver a seguir).

  • Se passa um nome de conjunto válido em nomConjunto, o comando será aplicado aos registros desse conjunto para a tabela definida.
  • Se omite o parâmetro nomConjunto, o comando selecionará unicamente os registros do conjunto UserSet atual. Este conjunto apenas é manejado em modo Desenho em caso de chamar os comandos DISPLAY SELECTION /MODIFY SELECTION. Se deseja selecionar os registros de um subformulário, deve passar um nome de tabela e de conjunto. Para maior informação sobre o conjunto UserSet, consulte a seção Conjuntos

Quando se passa o parâmetro *, provoca a inativação da função de rolagem automático da lista se os registros selecionados não forem visíveis. Este mecanismo autoriza a gestão personalizadas da rolagem através do comando OBJECT SET SCROLL POSITION .

Nota: no marco dos subformulários incluídos, o comando HIGHLIGHT RECORDS não faz nada se a propriedade de seleção Várias linhas não estiver selecionada para o formulário. Neste caso, para selecionar uma linha, deve utilizar o comando GOTO SELECTED RECORD.

Exemplo  

Em um formulário de saída mostrado pelo comando MODIFY SELECTION, você deseja que o usuário possa realizar pesquisas sem que a seleção atual seja modificada. Para fazer isto, coloque um botão Procurar no formulário e associe-o com o seguinte método:

 SET QUERY DESTINATION(Into set;"UserSet")
 QUERY
 SET QUERY DESTINATION(Into current selection)
 HIGHLIGHT RECORDS

Quando o usuário clicar no botão, aparece a caixa de diálogo padrão procurar. Quando confirmar a pesquisa, os registros encontrados serão selecionados sem que a seleção atual seja modificada.

 
PROPRIEDADES 

Produto: 4D
Tema: Seleção
Número 656

 
HISTÓRIA 

Modificado: 4D 2004

 
VER TAMBÉM 

GET HIGHLIGHTED RECORDS
OBJECT SET SCROLL POSITION

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)