화면 » Event

on_recvcopydata

Description

WM_COPYDATA 메세지 수신시 호출되는 이벤트이며, xplusstartcopydatawnd API로 CopyData 윈도우를 시작한 경우에 동작합니다. xFrame 화면에서 xplusstartcopydatawnd API를 이용해서 등록한 윈도우 타이틀명에 해당하는 정보를 이용해서 외부 어플리케이션에서 WM_COPYDATA 메시지를 송신한 경우에 이벤트가 발생합니다. 

Parameters

Parameters Type Description
command STRING WM_COPYDATA 메시지의 명령부 문자열
recvdata STRING COPYDATA 메시지의 데이터부 문자열

Return Value

Type Description
void

Remark

전용 브라우저 환경에서만 동작합니다.

Example

// 화면 로드 이벤트에서 WM_COPYDATA 메시지를 받기 위한 준비를 합니다.
function screen_on_load()
{
    // "XFRAME_COPYDATA_WINDOW"란 이름으로 메시지를 받기위한 윈도우를 생생합니다.
    if(factory.xplusstartcopydatawnd(screen, true, "XFRAME_COPYDATA_WINDOW") == false) {
        screen.alert("CopyData 시작 오류..");
    }

    m_bStartCopyData = true;
}

// 화면 종료 이벤트시 on_load 이벤트에서 생성한 윈도우를 종료합니다.
function screen_on_destroy()
{
    // 생성한 COPYDATA 윈도우를 종료함.
	if(m_bStartCopyData == true) {
        factory.xplusstartcopydatawnd(screen, false, "XFRAME_COPYDATA_WINDOW");
    }

	return 1;
}

/**
 * WM_COPYDATA 메세지 수신 이벤트
 * 전용 브라우저 환경에서만 동작한다.
 * xplusstartcopydatawnd API로 CopyData 윈도우를 시작한 경우에 동작한다.
 * xFrame 화면에서 xplusstartcopydatawnd API를 이용해서 등록한
 * 윈도우 타이틀명에 해당하는 정보를 이용해서 외부 어플리케이션에서
 * WM_COPYDATA 메시지를 송신한 경우에 이벤트가 발생한다.
 * 
 * @param {string} command WM_COPYDATA 메시지의 명령부 문자열
 * @param {string} recvdata COPYDATA 메시지의 데이터부 문자열
 */
function screen_on_recvcopydata(command, recvdata)
{
	factory.consoleprint("screen_on_recvcopydata> start");
	factory.consoleprint("screen_on_recvcopydata> command = " + command);
	factory.consoleprint("screen_on_recvcopydata> recvdata = " + recvdata);
}

Viewer Ver.

9.1.1.1

Update Date

20230508