컴포넌트 배경에 그라데이션 효과 유형(gradient_effect 속성)을 설정하는 API이다.
| Parameters | Type | Description | 
|---|---|---|
| nEffect | short | [옵션] 그라데이션 효과 스타일 상수(*Remark 참조) (기본값 null) | 
| clrStart | COLOR | [옵션] 그라데이션 시작 색상 (기본값 null) | 
| clrEnd | COLOR | [옵션] 그라데이션 종료 색상 (기본값 null) | 
| Type | Description | 
|---|---|
| BOOL | 정상 처리 여부 | 
그라데이션은 배경 이미지와 함께 표시되며, gradient_effect 속성을 0:none이 아닌값으로 설정시, 배경색 및 transparent 속성은 무시된다.
clrStart, clrEnd 파라미터 값 미지정(undefined) 또는 null로 지정시, 해당 파라미터 값은 무시된다.
* nEffect 상수값 XFD_GRADIENT_NONE = 0 // none XFD_GRADIENT_VERT = 1 // vertical XFD_GRADIENT_HORZ = 2 // horizontal XFD_GRADIENT_FORWARD = 3 // forwarddiagonal XFD_GRADIENT_BACKWARD = 4 // backwarddiagonal
// objInst 파라미터는 컴포넌트 인스턴스
function TestGradientEffect(objInst)
{
	var gradient_effect;
	// 컴포넌트 gradient_effect 속성값을 구하여, 콘솔에 표시
	gradient_effect = objInst.getgradienteffect();
	factory.consoleprint("before gradient_effect = " + gradient_effect);
	// 그라데이션 유형이 0인 경우, 수직 방향으로 그라데이션 유형 설정
	if (gradient_effect == 0) {
		objInst.setgradienteffect(1);
	}
	// 그라데이션 유형이 0이 아닌 경우, 그라데이션 유형 삭제 처리
	else {
		objInst.setgradienteffect(0);
	}
	
	// 컴포넌트 gradient_effect 속성값을 구하여, 콘솔에 표시
	gradient_effect = objInst.getgradienteffect();
	factory.consoleprint("before gradient_effect = " + gradient_effect);
}
function SetGradientEffectEx(objInst)
{
	// 그라데이션 유형 지정
	objInst.setgradienteffect(1);
	// 그라데이션 유형 및 시작/종료 색상 지정
	objInst.setgradienteffect(1, factory.rgb(255, 0, 0), factory.rgb(0, 0, 255));
	// 그라데이션 유형 및 시작 색상 지정
	objInst.setgradienteffect(1, factory.rgb(255, 0, 0), null);
	// 그라데이션 유형 및 종료 색상 지정
	objInst.setgradienteffect(1, null, factory.rgb(0, 0, 255));
}