Cabeçalho

f_Opcoes - Seleção de múltiplos registros. Tela de parâmetro

Autor: Eurai Criado: 16/09/2023 Atualizado: 22/11/2025 Diversos

Postagem

Descrição

f_Opcoes – Seleção de múltiplos registros ⭐ Tela de parâmetros

📌 Sintaxe

f_Opcoes()

🔣 Parâmetros

Par	Nome	Tipo	Descrição	Default	Obg	Ref
01	uVarRet	Indefinido	Variável de retorno		X	S
02	cTitulo	Caracter	Título da coluna das opções		X
03	aOpcoes	Array	Opções de escolha (array)		X
04	cOpcoes	Caracter	String de opções para retorno		X
07	lSelOneElement	Lógico	Permite selecionar apenas 1 item	.F.
08	nTamKey	Numérico	Tamanho da chave
09	nElemRet	Numérico	Máximo de elementos na variável de retorno
10	lIncluiButton	Lógico	Inclui botões para múltipla seleção	.T.
11	lX3CBBOX	Lógico	Usa opções do ComboBox de campo (X3_CBOX)	.F.
13	lOrdena	Lógico	Impede ordenação	.F.
14	lPesquisa	Lógico	Impede pesquisa	.F.
15	lRetArray	Lógico	Força retorno como array	.F.
16	cConsultaF3	Caracter	Consulta F3 associada

🔁 Retorno

Retorno	Tipo	Descrição
lRet	Logical	Confirmação de seleção

🧩 Exemplo

#INCLUDE "TOTVS.CH"

User Function f_Opcoes()

// Executa f_Opcoes para Selecionar ou Mostrar os Registros Selecionados (BlackTDN)
f_Opcoes(    @uVarRet    ,;    //Variavel de Retorno
                cTitulo     ,;    //Titulo da Coluna com as opcoes
                @aOpcoes    ,;    //Opcoes de Escolha (Array de Opcoes)
                @cOpcoes    ,;    //String de Opcoes para Retorno
                NIL         ,;    //Nao Utilizado
                NIL         ,;    //Nao Utilizado
                .F.         ,;    //Se a Selecao sera de apenas 1 Elemento por vez
                nTamKey     ,;    //Tamanho da Chave
                nElemRet    ,;    //No maximo de elementos na variavel de retorno
                .T.         ,;    //Inclui Botoes para Selecao de Multiplos Itens
                .F.         ,;    //Se as opcoes serao montadas a partir de ComboBox de Campo ( X3_CBOX )
                NIL         ,;    //Qual o Campo para a Montagem do aOpcoes
                .F.         ,;    //Nao Permite a Ordenacao
                .F.         ,;    //Nao Permite a Pesquisa    
                .F.         ,;    //Forca o Retorno Como Array
                cF3          ;    //Consulta F3    
              )

Return( Nil )

📸 Resultado

ℹ️ Informações adicionais

O f_Opcoes é amplamente utilizado para telas de seleção, filtros, múltipla escolha e parametrizações complexas no Protheus. Permite flexibilidade e personalização total das opções exibidas. ✔️

Gostou? Compartilhe com seus amigos e deixe um comentário! 😎