method IconSet

IconSet

:IconSet(cRefDe,cRefAte,cIconSet,lReverso,lMostrarValor)
Formatação condicional com conjunto de ícones (semáforos, setas, etc.) por faixas de valor

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cRefDe	caractere	Referência inicial (ex: "C2")	X
cRefAte	caractere	Referência final (ex: "C9")
cIconSet	caractere	Nome do conjunto de ícones do Excel (ex: "3TrafficLights1", "3Arrows", "4Rating", "5Quarters")		Default "3TrafficLights1". O prefixo numérico do nome define a quantidade de ícones (3, 4 ou 5)
lReverso	lógico	Inverte a ordem dos ícones		Default .F.
lMostrarValor	lógico	Exibir o valor numérico junto com o ícone		Default .T.

Retorno

Nulo

Exemplo

Local nCont
Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan(cNome="FormatCondAvancada")
oExcel:Pos(1,3):SetValue("Icones")
For nCont:=1 to 8
	oExcel:Pos(nCont+1,3):SetValue(nCont*12)
Next
oExcel:IconSet(cRefDe="C2",cRefAte="C9",cIconSet="3TrafficLights1") //Semáforo de 3 ícones
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Obs

Segue a especificação ECMA-376 CT_IconSet (18.3.1.49).
As faixas são geradas automaticamente em percentuais iguais (0/33/67 para 3 ícones, 0/25/50/75 para 4, 0/20/40/60/80 para 5).
Veja também DataBar e FormatCond.