WideStudio Logo
WideStudio
Programming Guide
WideStudio Index
Table of contents


详细一览



通过函数进行详细一览数据的显示控制

在详细一览(WSCverbList)中,或者WSClist 的一览类别为[详细一览]的一览中,要追加项目显示数据时,同前面介绍的一览情况完全一样,使用addItem 函数。根据addItem ,指定追加的字符串,追加的位置。省略追加位置的话,将被追加到一览的末尾。与一览情况有区别的是设定各项目时使用分号进行隔开。



[详细一览显示的例子]

如下图的具有横4项的一览,对属性 barValue ,设定为50,100,150。通过这个属性,指定标题的分离位置。因为将根据这个属性决定项的数,设定时请多注意。属性 titleString中,设定sec1,sec2,sec3,sec4。

以下是详细一览中追加项目的范例。

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mpfc;

sub btnep1 {
  my ($object) = @_;
  # Delete all the items of the list.
  mpfc::WSClist_delAll($newlist_001);

  #Add an item to the last of the list.
  mpfc::WSClist_addItem($newlist_001,"item1,aaa,bbb,ccc");
  mpfc::WSClist_addItem($newlist_001,"item2,aaa,bbb,ccc");
  mpfc::WSClist_addItem($newlist_001,"item3,aaa,bbb,ccc");
  mpfc::WSClist_addItem($newlist_001,"item4,aaa,bbb,ccc");

  #Add an item to the specified position of the list.
  mpfc::WSClist_updateList($newlist_001);
  return;
}
1;



通过属性设定详细一览的数据

项目数少的比较情况,能通过属性进行项目的总括设定。这个情况时,首先,将dataSource 属性设定为WS_DATA_SOURCE_NONE。然后,用改行方法在data 属性中设定数据。

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mpfc;

sub btnep1 {
  my ($object) = @_;
  #Delete all the items of the list.
  mpfc::WSClist_delAll($newlist_001);
  #Set the items of the list by the property
  mpfc::WSCbase_setProperty($newlist_001,"dataSource",$mpfc::WS_DATA_SOURCE_NONE);
  mpfc::WSCbase_setProperty($newlist_001,"data",
     "item1,aaa,bbb,ccc\nitem2,aaa,bbb,ccc\nitem3,aaa,bbb,ccc");
  return;
}
1;

如果如下面一样,图标文件同时也指定的话,每项目的图标也可指定。如果设定属性useIcon为True ,指定图标时用分号来指定。图标文件省略的话,将使用属性iconPixmap中所指定的图标。 格式:

图标文件,项目字符串\n图标文件,项目字符串\n....

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mpfc;

sub btnep1 {
  my ($object) = @_;
  #Delete all the list of the list
  mpfc::WSClist_delAll($newlist_001);
  #Set the items of the list by the property
  mpfc::WSCbase_setProperty($newlist_001,"dataSource",$mpfc::WS_DATA_SOURCE_NONE);
  mpfc::WSCbase_setProperty($newlist_001,"data",
     "$(WSDIR)/sys/pixmaps/bi16.xpm,item1,aaa,bbb,ccc\n,item2,aaa,bbb,ccc\n,item3,aaa,bbb,ccc");
  return;
}
1;



通过文件设定一览数据

可以通过指定文件名,从文件进行项目的总括设定。这种情况时,首先,将dataSource 属性指定为 WS_DATA_SOURCE_FILE。然后,在dataSourceName 属性中指定文件名。通过builder的属性设定,和程序的设定实现动作。下列是在程序中的设定的例子。

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mpfc;

sub btnep1 {
  my ($object) = @_;
  # Delete all the items of the list
  mpfc::WSClist_delAll($newlist_001);

  # Set the items from file directly
  mpfc::WSCbase_setProperty($newlist_001,"dataSource",$mpfc::WS_DATA_SOURCE_FILE);
  mpfc::WSCbase_setProperty($newlist_001,"dataSourceName","data.txt");
  return;
}
1;
#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



通过Instance显示一览的数据

通过指定Instance名,从该Instance的数据源对象属性对项目进行总括设定。这个情况时,首先,将dataSource 属性设定为WS_DATA_SOURCE_INSTANCE。然后,在dataSourceName 属性中指定Instance名。下列的例子中,指定了WSCtextField 的Instance(newtext_000)。数据的形式,与文件指定的情况一样。被输入到newtext_000中的字符串在一览里将被显示。通过builder的属性设定,程序的设定可以动作。下列是在程序设定的例子。这个情况,被输入区域的Instance newtext_000中所输入的字符串将作为详细一览的项目被显示。

#----------------------------------------------------------
#Function for the event procedure
#----------------------------------------------------------
use mpfc;

sub btnep1 {
  my ($object) = @_;
  #Delete all the items of the list
  mpfc::WSClist_delAll($newlist_001);

  #Set the items from the other instances
  mpfc::WSCbase_setProperty($newlist_001,"dataSource",$mpfc::WS_DATA_SOURCE_INSTANCE);
  mpfc::WSCbase_setProperty($newlist_001,"dataSourceName","newtext_000");
  return;
}
1;


Document Release 3.70 for WideStudio ver 3.70, Feb 2004


WideStudio documents index | Table of contents

Copyright(C) T. Hirabayashi, 2000-2004 Last modified: Feb 25, 2004