웹브라우저 » Api

seturlex

Description

웹브라우저에서 URL 호출 시 특정값을 넘겨주는 API이다.

Parameters

Parameters Type Description
strURL STRING 호출할 URL
strPostData STRING 전송할 POST Data 문자열
strHeader STRING [옵션] 전송할 HTTP Header 문자열 (반영되지 않음)
bEncodeUTF8 BOOL [옵션] URL을 encodeURI로 인코딩 처리 여부

Return Value

Type Description
void 없음

Remark

bEncodeUTF8 파라미터는 옵션 파라미터로 값을 주지 않는 경우 기본값은 true이며, URL를 encodeURI로 인코딩 처리 여부를 지정한다.

strPostData 파라미터는 URL을 POST 방식으로 호출시 전달한 데이터 문자열이다. "&" 문자를 이용하여 여러개의 데이터를 KEY/VALUE 형식으로 전달할 수 있다.

strPostData 파라미터에 KEY/VALUE 값에 "&" 문자 또는 "=" 문자가 포함된 경우, seturlpostdataobject API를 사용해야 한다.

* 웹브라우저에 URL 호출시 특정한 값을 같이 넘겨줄 때 사용한다

* 동일 출처(same-origin)가 아닐 경우 security exception이 발생할 수 있다.
strHeader 파라미터로 전달된 헤더값은 무시된다. 과거 xFrame RunTime 버전과 API 파라미터 갯수를 맞추기 위한 용도로만 사용된다.

Example

function btn_seturlex_on_mouseup() { var strPostData, arrPostData; arrPostData = []; arrPostData.push("KEY1=VALUE1"); arrPostData.push("KEY2=VALUE2"); // & 문자로 배열에 있는 문자열 연결 strPostData = arrPostData.join("&"); webCtrl.seturlex("http://softbase.co.kr/temp.jsp",strPostData,""); }

See Also

seturl
seturlpostdataobject

Viewer Ver.

9.1.1.1

Update Date

20250124