P » Api

setgradienteffect

Description

컴포넌트 배경에 그라데이션 효과 유형(gradient_effect 속성)을 설정하는 API이다.

Parameters

Parameters Type Description
nEffect short [옵션] 그라데이션 효과 스타일 상수(*Remark 참조) (기본값 null)
clrStart COLOR [옵션] 그라데이션 시작 색상 (기본값 null)
clrEnd COLOR [옵션] 그라데이션 종료 색상 (기본값 null)

Return Value

Type Description
BOOL 정상 처리 여부

Remark

그라데이션은 배경 이미지와 함께 표시되며, 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

Example

// 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)); }

See Also

getgradienteffect

Viewer Ver.

9.1.1.1

Update Date

20230824