WideStudio Programming Guide	WideStudio Index Table of contents

---

A lista verbosa (verbose list)

---

Ajustando os itens pelo método

Utilize o método addItem para adicionar itens à lista cuja propriedade WSNtype é WS_VERBOSE com uma string e posição. Se a posição é omitida, adicione ao final lista. O programa abaixo é um exemplo de adição de item à lista. A diferença desta lista é o item denotado com uma vírgula.


[a lista verbosa]
Ajuste 50,100,150 para a propriedade WSNbarValue para tornar a lista com 4 colunas tal como na figura acima. Esta propriedade aponta a posição do separado de título. Cuidado, porque o número de colunas é fixado por esta propriedade. O programa abaixo é um exemplo de como adicionar à lista.

#include <WScom.h>
#include <WSCfunctionList.h>
#include <WSCbase.h>
//----------------------------------------------------------
//Function for the event procedure
//----------------------------------------------------------
#include <WSCverbList.h>
extern WSCverbList* newlist_001;
void btnep1(WSCbase* object){
  //Delete all the items of the list.
  newlist_001->delAll();
  //Add an item to the last of the list.
  newlist_001->addItem("item1,aaa,bbb,ccc");
  newlist_001->addItem("item2,aaa,bbb,ccc");
  newlist_001->addItem("item3,aaa,bbb,ccc");
  newlist_001->addItem("item4,aaa,bbb,ccc");

  //Add an item to the specified position of the list.
  newlist_001->updateList();
}
static WSCfunctionRegister  op("btnep1",(void*)btnep1);

---

Ajustando os itens pela propriedade

A propriedade WSNdata pode ser usada para ajustar os itens da lista, se o número de itens for comparativamente menor. Em tais casos, ajuste a propriedade WSNdataSource para WS_DATA_SOURCE_NONE, e ajuste a propriedade WSNdata dos itens que têm um vírgula.

#include <WScom.h>
#include <WSCfunctionList.h>
#include <WSCbase.h>
//----------------------------------------------------------
//Function for the event procedure
//----------------------------------------------------------
#include <WSCverbList.h>
extern WSCverbList* newlist_001;
void btnep1(WSCbase* object){
  //Delete all the items of the list.
  newlist_001->delAll();
  //Set the items of the list by the property
  newlist_001->setProperty(WSNdataSource,WS_DATA_SOURCE_NONE);
  newlist_001->setProperty(WSNdata,
     "item1,aaa,bbb,ccc\nitem2,aaa,bbb,ccc\nitem3,aaa,bbb,ccc");

static WSCfunctionRegister  op("btnep1",(void*)btnep1);

É possível indicar um ícone específico através de seu arquivo, conforme programa abaixo. Ajuste a propriedade WSNuseIcon como True e ajuste os itens com o formato a seguir apresentado. Se omitido, o valor de WSNiconPixmap é utilizado por default.

  format:
  ICON1filename,str11,str12,str13,..\nICON2filename,str21,str22,str23,...\n...

void btnep1(WSCbase* object){
  //Delete all the list of the list
  newlist_001->delAll();
  //Set the items of the list by the property
  newlist_001->setProperty(WSNdataSource,WS_DATA_SOURCE_NONE);
  newlist_001->setProperty(WSNdata,
  "$(WSDIR)/sys/pixmaps/bi16.xpm,item1,aaa,bbb,ccc\nitem2,aaa,bbb,ccc\nitem3,aaa,bbb,ccc");
}
static WSCfunctionRegister  op("btnep1",(void*)btnep1);

---

Ajustando os itens a parte do diretório de arquivo

É possível ajustar os itens diretamente a partir de arquivo. Neste caso, primeiro ajustamos a propriedade WSNdataSource  de WS_DATA_SOURCE_FILE, então ajustamos a propriedade WSNdataSourceName com o nome do arquivo.

#include <WScom.h>
#include <WSCfunctionList.h>
#include <WSCbase.h>
//----------------------------------------------------------
//Function for the event procedure
//----------------------------------------------------------
#include <WSCverbList.h>
extern WSCverbList* newlist_001;
void btnep1(WSCbase* object){
  //Delete all the items of the list
  newlist_001->delAll();
  //Set the items from file directly
  newlist_001->setProperty(WSNdataSource,WS_DATA_SOURCE_FILE);
  newlist_001->setProperty(WSNdataSourceName,"data.txt");
}
static WSCfunctionRegister  op("btnep1",(void*)btnep1);

//data.txt contains...
$(WSDIR)/sys/pixmaps/bi16.xpm,item1,aaa,bbb,ccc
item2,aaa,bbb,ccc
item3,aaa,bbb,ccc
item4,aaa,bbb,ccc
$(WSDIR)/sys/pixmaps/bi16.xpm,item5,aaa,bbb,ccc
item6,aaa,bbb,ccc
item7,aaa,bbb,ccc
item8,aaa,bbb,ccc

---

Ajustando os itens a partir de outra instância

É possível ajustar os itens a partir de outra instância através da propriedade de destino da fonte de código. Nestes casos, ajuste a propriedade WSNdataSource de  WS_DATA_SOURCE_INSTANCE, e ajuste a propriedade WSNdataSourceName com o name da instância. No exemplo a seguir, a instância WSCtextField é referenciada pela propriedade WSNdataSourceName, e portanto apresenta a informação para a lista.

#include <WScom.h>
#include <WSCfunctionList.h>
#include <WSCbase.h>
//----------------------------------------------------------
//Function for the event procedure
//----------------------------------------------------------
#include <WSCverbList.h>
extern WSCverbList* newlist_001;
void btnep1(WSCbase* object){
  //Delete all the items of the list
  newlist_001->delAll();
  //Set the items from the other instances
  newlist_001->setProperty(WSNdataSource,WS_DATA_SOURCE_INSTANCE);
  newlist_001->setProperty(WSNdataSourceName,"newtext_000");
}
static WSCfunctionRegister  op("btnep1",(void*)btnep1);