entitySelection.copy( )

4D v19.8


entitySelection.copy ( {opção} ) -> Resultado

Parâmetro	Tipo	Descrição
opção	Inteiro longo	ck shared: retorna uma seleção de entidade compartilhável
Resultado	EntitySelection	Cópia da seleção de entidades

Descrição

A função entitySelection.copy( ) devolve uma cópia da seleção de entidades original.

Nota: esta função não modifica a seleção de entidades original.

Por padrão, se o parâmetro de opção for omitido, a função retorna uma nova seleção de entidade não compartilhável (mesmo que a função se aplique a uma seleção de entidade compartilhável). Passe a constante ck shared no parâmetro de opção se você quiser criar uma seleção de entidade compartilhável.

Nota: Para informações sobre a propriedade compartilhável das seleções da entidade, consulte o Seleção de Entidade Compatível vs Não-compatível paragraph.

Exemplo

Se criar uma nova seleção de entidades vazia, de produtos, quando carregar o formulário:

 Case of

    :(Form event code=On Load)

       Form.products:=ds.Products.newSelection()

 End case

Depois esta seleção de entidades é atualizada com produtos e se quiser compartilhar os produtos entre vários processos. Copie a seleção de entidades Form.products como uma seleção compartilhável:

 ...

  // A seleção de entidades Form.products é atualizada

 Form.products.add(Form.selectedProduct)

 

 Use(Storage)

    If(Storage.products=Null)

       Storage.products:=New shared object()

    End if

 

    Use(Storage.products)

       Storage.products:=Form.products.copy(ck shared)

    End use

 End use

Ver também

OB Copy