method DataBar

DataBar

:DataBar(cRefDe,cRefAte,cCor,lMostrarValor,cTipoMin,xValMin,cTipoMax,xValMax)
Formatação condicional com Barra de Dados: preenche o fundo da célula com uma barra proporcional ao valor

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cRefDe	caractere	Referência inicial (ex: "B2")	X
cRefAte	caractere	Referência final (ex: "B9")
cCor	caractere	Cor da barra em ARGB		Default "FF638EC6" (azul)
lMostrarValor	lógico	Exibir o valor numérico junto com a barra		Default .T.
cTipoMin	caractere	Tipo do valor mínimo: min, num, percent, percentile, formula		Default "min"
xValMin	caractere ou numérico	Valor do mínimo, quando o tipo exigir (num/percent/percentile/formula)
cTipoMax	caractere	Tipo do valor máximo: max, num, percent, percentile, formula		Default "max"
xValMax	caractere ou numérico	Valor do máximo, quando o tipo exigir

Retorno

Nulo

Exemplo

Local nCont
Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan(cNome="FormatCondAvancada")
oExcel:Pos(1,2):SetValue("Barra")
For nCont:=1 to 8
	oExcel:Pos(nCont+1,2):SetValue(nCont*12)
Next
oExcel:DataBar(cRefDe="B2",cRefAte="B9",cCor="FF638EC6") //Barra de dados azul, escala automática (min/max)
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Obs

Segue a especificação ECMA-376 CT_DataBar (18.3.1.28).
Para uma escala fixa (em vez de automática pelo mínimo/máximo dos dados), informe cTipoMin="num"/cTipoMax="num" com xValMin/xValMax.
Veja também IconSet e FormatCond.