dataClass.newSelection( )

4D v19.8


dataClass.newSelection ( {keepOrder} ) -> Resultado

Parâmetro	Tipo	Descrição
keepOrder	Inteiro longo	dp keep ordered: cria uma seleção de entidade ordenada
Resultado	EntitySelection	Nova seleção de entidade em branco relacionada a Dataclass

Descrição

O método dataClass.newSelection( ) cria uma nova seleção de entidades vazia na memória, relacionada com a dataclass.

Nota: para mais informação, ver Seleção de Entidade Compatível vs Não-compatível.

Se quiser criar uma seleção de entidades ordenada, passe o seletor dk keep ordered no parâmetro manterOrdeM. Por padrão, se omitir este parâmetro, ou se passa o seletor dk non ordered, o método cria uma entity selection desordenada. As seleções de entidades desordenadas são mais rápidas, mas não pode confiar nas posições das entidades. Para mais informação, consulte o parágrafo Entity selections Ordenadas vs não ordenadas na Referencia de Desenho 4D.

Quando for crIado, a seleção de entidades não contém nenhuma entidade (mySelection.length devolve 0). Este método lhe permite criar seleção de entidades gradualmente realizando chamadas posteriores ao método add( ).

Exemplo

 C_OBJECT($USelection;$OSelection)

 $USelection:=ds.Employee.newSelection() //create an unordered empty entity selection

 $OSelection:=ds.Employee.newSelection(dk keep ordered) //create an ordered empty entity selection

Ver também

dataClass.query( )