파워빌더 "AddCategory" 함수

AddCategory PowerScript function

설명

그래프의 category 축에 새로운 category를 추가한다. 
AddCategory는 string 타입의 데이터를 가지는 category 축을 위한 함수이다. 

적용

윈도와 사용자 object에 있는 그래프 control에 적용되고, 
DataWindow object에있는 그래프는 DataWindow로 부터 
직접 데이터를 가지고 오기 때문에 적용되지 않는다.
 

문법

controlname.AddCategory ( categoryname )
 

Argument

controlname
- category를 추가하려는 그래프의 이름.
 
categoryname
- controlname에 추가하려는 문자열로 된 category 이름. 
  category는 category 축에 나타나게 된다.
 

Return 값

Integer. 
추가에 성공하였을 경우에는 그 category에 할당된 번호를 되돌리고, 
category 축에 동일한 이름이 이미 존재할 경우에는 그 이름에 해당하는 번호를 되돌린다. 
또한, 에러가 발생하면 1을 되돌리고, 인수(argument)값이 NULL일 경우에는 NULL을 되돌린다.
 

용도

AddCategory는 category 축의 끝에 category를 추가한다. 
그 category는 데이터를 할당할 수 있도록 비어있는 상태가 된다. 
모든 category를 그래프와 연관시키려면 category 축에 꺽자(√) 표시를 한다.
category 축의 데이터 타입이 string 이면, category 이름으로 빈문자열("")을 명시할 수 있다. 
그러나, category 이름은 고유한 것이어야 하므로, 빈문자열은 한 번만 사용할 수 있다. 
또한, category 이름은 대소문자를 구별하므로, 동일한 이름이라도 대소문자를 다르게 적용하면 고유한 이름으로 인식한다.
category 축의 데이터 타입이 date, DateTime, number, time등일 때 category를 추가하려면, InsertCategory 함수를 사용한다. 
category들이 나열되어있는 중간에 category를 삽입하려면, InsertCategory 함수를 사용한다. 
또한, AddCategory처럼 끝에 category를 추가할때에도 InsertCategory를 사용할 수 있다.
그래프내에 데이터를 추가하려면, AddData 또는 InsertData 함수를 사용한다. 
새로운 category에 데이터 값을 추가하거나, 기존의 category에 데이터를 추가 또는 변경할 수도 있다. 
그래프에 category들의 묶음(series)을 추가하려면, AddSeries 함수를 사용한다.

 

예제

다음은 그래프 gr_product_data에 PCs라는 이름의 category를 추가하는 문장이다.

gr_product_data.AddCategory("PCs")

AddCategory