Skip to content

method SetPlanAt

Saulo Martins edited this page Jul 4, 2026 · 1 revision

SetPlanAt

:SetPlanAt(xPlan)
Posiciona a edição em uma planilha (aba) já criada, informando o índice ou o nome da planilha


Parâmetros

Parâmetro Tipo Descrição Obrigatório Obs
xPlan numérico ou caractere Índice da planilha ou nome da planilha X

Retorno

Lógico - .T. quando a planilha foi localizada e posicionada, .F. quando o índice/nome não existe

Exemplo

Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan()                //Planilha 1
oExcel:ADDPlan(cNome="Teste",cCor="00AA00")//Planilha 2
oExcel:SetPlanAt(1)             //Posiciona pelo índice
oExcel:Pos(1,1):SetValue("Escrito na planilha 1")
oExcel:SetPlanAt("Teste")       //Posiciona pelo nome
oExcel:Pos(1,1):SetValue("Escrito na planilha Teste")
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Obs

Após o ADDPlan a edição fica sempre posicionada na planilha recém-criada. Use o SetPlanAt para voltar a editar uma planilha anterior.
Veja também GetPlanAt e LenPlanAt.


Clone this wiki locally