Comando
SapSelect()
Seleciona ou desmarca controles SAP como radio buttons, checkboxes, linhas de tabelas e grids. Para GuiGridView, permite selecionar linhas específicas ou colunas inteiras.
SapSelect(controlId, selecionado [, linha [, change [, appId]]])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
controlId | Sim | Identificador do controle SAP. Formatos: ID completo ou Nome#Tipo. Suporta GuiRadioButton, GuiCheckBox, GuiTableRow, GuiTableControl e GuiGridView. Utilize a janela de configuração do comando no DevStudio para obter os seletores. |
selecionado | Sim | true: seleciona o controle. false: desmarca. Para GuiGridView, este parâmetro é ignorado — a linha/coluna é sempre definida pelo parâmetro linha. |
linha | Condicional | Para GuiTableControl: índice da linha (0-based). Para GuiGridView: índice(s) de linha(s) ou nome de coluna (dependendo do parâmetro change). |
change | Não | Modificador de comportamento para GuiGridView. Informe col para selecionar uma coluna inteira (usando SelectColumn). Se omitido, seleciona linhas (SelectedRows). |
appId | Não | Identificador da instância SAP gerenciada. |
Exemplos
// Marcar checkbox:
SapSelect('chk[0]#GuiCheckBox', true)
// Desmarcar radio button:
SapSelect('rad[1]#GuiRadioButton', false)
// Selecionar linha 3 de uma tabela SAP (GuiTableControl):
SapSelect('tbl#GuiTableControl', true, '3')
// Selecionar linha(s) de grid:
SapSelect('grid#GuiGridView', true, '0')
// Selecionar coluna inteira de grid:
SapSelect('grid#GuiGridView', true, 'DOCNUM', 'col')Observações
Para GuiTableControl: usa GetAbsoluteRow(index).Selected. Para GuiGridView com linhas: define SelectedRows (string de índices separados por vírgula aceita pelo SAP). Para GuiGridView com change=col: usa SelectColumn(nomeColuna). O comportamento de marcar/desmarcar só é aplicado se o estado atual for diferente do desejado (evita cliques redundantes).