oz.api

Class OZReportCommandListener

java.lang.Object

oz.api.OZReportCommandListener

public abstract class OZReportCommandListener
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
OZReportCommandListener()

Method Summary

Modifier and Type	Method and Description
void	OZBankBookPrintCommand(java.lang.String datas) 통장 프린터 인쇄 아이콘이 클릭된 후 발생하는 이벤트입니다.
void	OZCommand(java.lang.String code, java.lang.String args) 오즈 뷰어 이벤트 실행 시 발생되는 이벤트입니다.
void	OZEFormInputEventCommand(java.lang.String docindex, java.lang.String formid, java.lang.String eventname, java.lang.String mainscreen) 사용자가 입력 컴포넌트를 클릭하거나 값을 변경하여 OnClick/OnFocus/OnKillFocus/OnValueChanged 이벤트가 실행된 경우 발생되는 이벤트입니다.
void	OZErrorCommand(java.lang.String code, java.lang.String message, java.lang.String detailmessage, java.lang.String reportname) 에러 발생 시 발생하는 이벤트입니다.
void	OZExitCommand() Deprecated. Android 뷰어에서는 동작하지 않습니다
void	OZExportCommand(java.lang.String code, java.lang.String path, java.lang.String filename, java.lang.String pagecount, java.lang.String filepaths) 보고서 저장 시 발생하는 이벤트입니다.
void	OZExportMemoryStreamCallBack(java.lang.String outputdata) Script, ScriptEx 함수의 명령어를 "save_memorystream"로 설정하여 실행한 경우 발생하는 이벤트입니다.
void	OZLinkCommand(java.lang.String docindex, java.lang.String compname, java.lang.String usertag, java.lang.String uservalue, java.lang.String mousebutton) SetLinkEvent/setLinkEvent 함수가 실행된 후 발생하는 이벤트입니다.
void	OZMailCommand(java.lang.String code) 보고서를 오즈 메일로 전송 시 발생하는 이벤트입니다.
void	OZPageBindCommand(java.lang.String docindex, java.lang.String pagecount) viewer.pagebindcommandinterval 패러미터에서 설정한 주기별로 페이지가 바인딩된 후 발생하는 이벤트입니다.
void	OZPageChangeCommand(java.lang.String docindex) 화면에 표시되는 페이지가 변경된 후 발생하는 이벤트입니다.
void	OZPostCommand(java.lang.String cmd, java.lang.String msg) 보고서를 뷰어 창에 미리보기한 후 또는 미리보기 없이 바로 저장하거나 인쇄한 후 발생하는 이벤트입니다.
void	OZPrintCommand(java.lang.String msg, java.lang.String code, java.lang.String reportname, java.lang.String printername, java.lang.String printcopy, java.lang.String printpages, java.lang.String printrange, java.lang.String username, java.lang.String printerdrivername, java.lang.String printpagesrange) 보고서 인쇄 즉, 보고서를 프린터 스풀에 넘긴 후 발생하는 이벤트입니다.
void	OZProgressCommand(java.lang.String step, java.lang.String state, java.lang.String reportname) 보고서 생성 단계별로 발생하는 이벤트입니다.
void	OZReportChangeCommand(java.lang.String docindex) 화면에 표시되는 보고서가 변경된 후 발생하는 이벤트입니다.
void	OZTextBoxCommand(OZRTextBoxCmd textBoxCmd, int mode) TextBox의 keyboard타입이 EXTERNAL일 때 발생되는 이벤트 입니다(외부연동 키보드)
void	OZUserActionCommand(java.lang.String type, java.lang.String attr) 인쇄, 저장, 컴포넌트 속성 변경 등 사용자가 뷰어의 기능을 실행할 때 발생하는 이벤트입니다.
java.lang.String	OZUserEvent(java.lang.String param1, java.lang.String param2, java.lang.String param3) _TriggerOCXUserEvent 함수 실행 시 발생하는 이벤트입니다.
boolean	OZWillChangeIndex_Paging(int newIndex, int oldIndex) 미리보기 시 다음 페이지 넘길 때 넘길지 여부를 확인 체크를 하는 이벤트 (디폴트로 무조건 true로 해줘야 다음 페이지로 넘어간다.)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OZReportCommandListener

public OZReportCommandListener()

Method Detail

OZPostCommand

public void OZPostCommand(java.lang.String cmd,
                          java.lang.String msg)

보고서를 뷰어 창에 미리보기한 후 또는 미리보기 없이 바로 저장하거나 인쇄한 후 발생하는 이벤트입니다.
보고서를 미리보기한 경우에는 오즈 뷰어에 보고서가 표시된 후 발생하고, 보고서를 미리보기 없이 바로 저장한 경우에는 파일 저장이 완료된 후에 발생하고, 보고서를 미리보기 없이 바로 인쇄한 경우에는 보고서를 프린터 스풀에 넘긴 후 발생합니다.

OZPostCommand 이벤트를 사용하려면 viewer.postcommand 패러미터 값에 명령어와 메시지를 세미콜론(;)을 구분자로 하여 설정해야 합니다.

Parameters:

cmd - 뷰어 패러미터에서 설정한 명령어

msg - 뷰어 패러미터에서 설정한 메시지

See Also:

viewer.postcommand

OZPrintCommand

public void OZPrintCommand(java.lang.String msg,
                           java.lang.String code,
                           java.lang.String reportname,
                           java.lang.String printername,
                           java.lang.String printcopy,
                           java.lang.String printpages,
                           java.lang.String printrange,
                           java.lang.String username,
                           java.lang.String printerdrivername,
                           java.lang.String printpagesrange)

보고서 인쇄 즉, 보고서를 프린터 스풀에 넘긴 후 발생하는 이벤트입니다.

printpagesrange의 경우 인쇄 다이얼로그에서 설정한 인쇄 범위를 "-"와 ","를 이용하여 리턴합니다. 예를 들어, 전체 10 페이지인 보고서를 인쇄할 때 인쇄 범위를 모두로 선택한 경우에는 "1-10"으로, 현재 페이지로 선택한 경우에는 페이지 번호를, 선택된 페이지 또는 페이지 지정으로 선택한 경우에는 "1-3" 또는 "5,7" 또는 "1-3,5,7" 등의 형태로 리턴됩니다.
Flash, HTML5 뷰어의 경우 "printername", "drivername"은 항상 빈 값이 리턴됩니다.
OZPrintCommand 이벤트를 사용하려면 viewer.printcommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

msg - 프린트 결과 메시지

code - 프린트 성공 여부(0 : 성공, 1 : 실패)

reportname - 보고서 이름

printername - 프린터 이름

printcopy - 인쇄 매수

printpages - 인쇄된 용지 매수

printrange - 인쇄 범위(all : 모두, current : 현재 페이지, selected : 선택된 페이지, range : 페이지 지정)

username - 사용자 이름

printerdrivername - 프린터 드라이버 이름

printpagesrange - 인쇄된 페이지 범위

See Also:

viewer.printcommand

OZExportCommand

public void OZExportCommand(java.lang.String code,
                            java.lang.String path,
                            java.lang.String filename,
                            java.lang.String pagecount,
                            java.lang.String filepaths)

보고서 저장 시 발생하는 이벤트입니다.
 
 예를 들어, 여러 페이지의 보고서를 jpg 파일로 저장할 때 파일 경로(path)가 "c:\report\"이고, 파일 이름(filename)이 "sample.jpg"인 경우 뷰어가 실제 저장한 파일(filepaths)은 "c:\report\sample.jpg|c:\report\sample_2_1.jpg|c:\report\sample_3_1.jpg|..." 형태의 여러 개 파일입니다.
 Flash, HTML5, WinRT 뷰어의 경우 "path", "filename", "filepaths"는 항상 빈 값이 리턴됩니다.
 OZExportCommand 이벤트를 사용하려면 viewer.exportcommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

code - 저장 성공 여부(0 : 실패, 1 : 성공)

path - 파일 경로

filename - 파일 이름

pagecount - 저장된 페이지 수, 여러 페이지의 보고서를 한 페이지로 저장한 경우에는 1이 리턴됨

filepaths - 뷰어가 실제 저장한 모든 파일의 경로와 이름, 파일이 여러 개일 경우 "|"를 구분자로 하여 리턴됨

See Also:

viewer.exportcommand

OZProgressCommand

public void OZProgressCommand(java.lang.String step,
                              java.lang.String state,
                              java.lang.String reportname)

보고서 생성 단계별로 발생하는 이벤트입니다.

OZProgressCommand 이벤트를 사용하려면 viewer.progresscommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

step - 보고서 생성 단계(0 : 뷰어 실행 옵션 설정, 1 : 보고서 파일 다운로드, 2 : 보고서 템플릿 생성, 3 : 데이터 다운로드, 4 : 보고서 바인딩)

state - 보고서 생성 상태(1 : 시작, 2 : 완료)

reportname - : 보고서 이름

See Also:

viewer.progresscommand

OZErrorCommand

public void OZErrorCommand(java.lang.String code,
                           java.lang.String message,
                           java.lang.String detailmessage,
                           java.lang.String reportname)

에러 발생 시 발생하는 이벤트입니다.

OZErrorCommand 이벤트를 사용하려면 viewer.errorcommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

code - 에러 메시지 코드

message - 에러 기본 메시지

detailmessage - 에러 상세 메시지

reportname - 보고서 이름

See Also:

viewer.errorcommand

OZCommand

public void OZCommand(java.lang.String code,
                      java.lang.String args)

오즈 뷰어 이벤트 실행 시 발생되는 이벤트입니다.
 
 OZCommand 이벤트를 사용하여 이벤트의 인자 값을 가져오려면 해당 이벤트를 구동시키는 패러미터 값을 true로 설정해야 합니다.
 
오즈 뷰어의 이벤트별로 리턴되는 code 값은 다음과 같습니다.
 ERROR : OZErrorCommand
 EXIT : OZExitCommand
 EXPORT : OZExportCommand
 LINK : OZLinkCommand
 MAIL : OZMailCommand
 PAGEBIND : OZPageBindCommand
 PAGECHANGE : OZPageChangeCommand
 POST : OZPostCommand
 PRINT : OZPrintCommand
 PROGRESS : OZProgressCommand
 REPORTCHANGE : OZReportChangeCommand

Parameters:

code - 이벤트 종류

args - 실행된 이벤트의 모든 인자 값을 세미콜론(;)을 구분자로하여 나타낸 문자열

See Also:

OZErrorCommand, OZExitCommand, OZExportCommand, OZLinkCommand, OZMailCommand, OZPageBindCommand, OZPageChangeCommand, OZPostCommand, OZPrintCommand, OZProgressCommand, OZReportChangeCommand

OZExitCommand

public void OZExitCommand()

Deprecated. Android 뷰어에서는 동작하지 않습니다

오즈 뷰어가 종료된 후 발생하는 이벤트입니다.

OZExitCommand 이벤트를 사용하려면 viewer.exitcommand 패러미터 값을 true로 설정해야 합니다.
또한 ActiveX, Applet, WPF 뷰어의 경우 viewer.isframe 패러미터 값을 true 또는 inprocess로 설정해야 합니다.

Android에서는 동작하지 않으며 android.app.Activity.onDestory()함수에서 별도로 OZReportViewer.dispose()를 사용하여 종료하여아 합니다.

See Also:

viewer.exitcommand, viewer.isframe

OZMailCommand

public void OZMailCommand(java.lang.String code)

보고서를 오즈 메일로 전송 시 발생하는 이벤트입니다.

OZMailCommand 이벤트를 사용하려면 viewer.mailcommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

code - 오즈 메일 전송 성공 여부(0 : 실패, 1 : 성공)

See Also:

viewer.mailcommand

OZUserActionCommand

public void OZUserActionCommand(java.lang.String type,
                                java.lang.String attr)

인쇄, 저장, 컴포넌트 속성 변경 등 사용자가 뷰어의 기능을 실행할 때 발생하는 이벤트입니다.

OZUserActionCommand 이벤트를 사용하려면 viewer.useractioncommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

type - 기능 타입

attr - 실행 정보

See Also:

viewer.useractioncommand

OZLinkCommand

public void OZLinkCommand(java.lang.String docindex,
                          java.lang.String compname,
                          java.lang.String usertag,
                          java.lang.String uservalue,
                          java.lang.String mousebutton)

SetLinkEvent/setLinkEvent 함수가 실행된 후 발생하는 이벤트입니다.

OZLinkCommand 이벤트를 사용하려면 viewer.linkcommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

docindex - 보고서 인덱스
동일한 웹 브라우저에서 여러 개 보고서를 열었을 경우 각각의 보고서를 구별하기 위한 인덱스(zero-based index)

compname - SetLinkEvent/setLinkEvent를 실행한 컴포넌트 이름

usertag - 사용자 정의 태그

uservalue - 사용자 정의 값

mousebutton - 사용자가 클릭한 마우스 단추(Left : 왼쪽 단추, Right : 오른쪽 단추)

See Also:

viewer.linkcommand

OZBankBookPrintCommand

public void OZBankBookPrintCommand(java.lang.String datas)

통장 프린터 인쇄 아이콘이 클릭된 후 발생하는 이벤트입니다.

통장 프린터 인쇄 아이콘은 기본적으로 툴바에 표시되지 않습니다. 툴바에 통장 프린터 인쇄 아이콘을 표시하려면 toolbar.bankbookprint 패러미터 값을 true로 설정해야 합니다.
OZBankBookPrintCommand 이벤트를 사용하려면 viewer.bankbookprintcommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

datas - 보고서의 라벨과 라인 정보를 가진 문자열

See Also:

toolbar.bankbookprint, viewer.bankbookprintcommand

OZReportChangeCommand

public void OZReportChangeCommand(java.lang.String docindex)

화면에 표시되는 보고서가 변경된 후 발생하는 이벤트입니다.

보고서가 처음 바인딩될 때에도 OZReportChangeCommand 이벤트가 발생하고, 해당 보고서의 인덱스가 리턴됩니다.
단, global.concatpage=true로 설정한 경우 child로 설정한 보고서가 맨 처음 바인딩될 때에는 OZReportChangeCommand 이벤트는 보고서 개수만큼 발생하지만 docindex는 무조건 0으로 리턴됩니다. 바인딩된 후 보고서 트리에서 보고서를 클릭하거나 페이지 이동 등으로 보고서가 변경될 때에는 해당 보고서의 인덱스로 리턴됩니다.
OZReportChangeCommand 이벤트를 사용하려면 viewer.reportchangecommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

docindex - 보고서 인덱스(zero-based index)

See Also:

viewer.reportchangecommand

OZUserEvent

public java.lang.String OZUserEvent(java.lang.String param1,
                                    java.lang.String param2,
                                    java.lang.String param3)

_TriggerOCXUserEvent 함수 실행 시 발생하는 이벤트입니다.

Parameters:

param1 - _TriggerOCXUserEvent 함수에서 전달한 첫 번째 값

param2 - _TriggerOCXUserEvent 함수에서 전달한 두 번째 값

param3 - _TriggerOCXUserEvent 함수에서 전달한 세 번째 값

Returns:

OZWillChangeIndex_Paging

public boolean OZWillChangeIndex_Paging(int newIndex,
                                        int oldIndex)

미리보기 시 다음 페이지 넘길 때 넘길지 여부를 확인 체크를 하는 이벤트 (디폴트로 무조건 true로 해줘야 다음 페이지로 넘어간다.)

Parameters:

newIndex -

oldIndex -

Returns:

OZPageChangeCommand

public void OZPageChangeCommand(java.lang.String docindex)

화면에 표시되는 페이지가 변경된 후 발생하는 이벤트입니다.

OZPageChangeCommand 이벤트를 사용하려면 viewer.pagechangecommand 패러미터 값을 true로 설정해야 합니다.

Parameters:

docindex - 보고서 인덱스(zero-based index)

See Also:

viewer.pagechangecommand

OZPageBindCommand

public void OZPageBindCommand(java.lang.String docindex,
                              java.lang.String pagecount)

viewer.pagebindcommandinterval 패러미터에서 설정한 주기별로 페이지가 바인딩된 후 발생하는 이벤트입니다.

OZPageBindCommand 이벤트는 viewer.pagebindcommandinterval 패러미터에서 설정한 주기에 따라 발생하며 마지막 페이지에서의 주기와 상관없이 발생합니다.
예를 들어, 전체 25 페이지 보고서에서 viewer.pagebindcommandinterval 패러미터 값을 5로 설정한 경우 OZPageBindCommand 이벤트는 5, 10, 15, 20, 25, 25 페이지 순으로 발생합니다.(주기와 상관없이 마지막인 25 페이지에서 한 번 더 발생함)
크로스탭, 테이블, 간트 차트의 경우 자식 라벨을 모두 만든 후 한꺼번에 바인딩하므로 해당 컴포넌트가 있는 페이지의 경우 OZPageBindCommand 이벤트가 한꺼번에 발생할 수 있습니다.
OZPageBindCommand 이벤트가 가로 방향으로 바인딩된 페이지에서 실행될 시점인 경우 같은 행에 있는 마지막 페이지에서 실행됩니다.

OZPageBindCommand 이벤트를 사용하려면 viewer.pagebindcommandinterval 패러미터 값을 0보다 큰 값으로 설정해야 합니다.

Parameters:

docindex - 보고서 인덱스(zero-based index)

pagecount - 바인딩된 페이지 번호

See Also:

viewer.pagebindcommandinterval

OZTextBoxCommand

public void OZTextBoxCommand(OZRTextBoxCmd textBoxCmd,
                             int mode)

TextBox의 keyboard타입이 EXTERNAL일 때 발생되는 이벤트 입니다(외부연동 키보드)

Parameters:

textBoxCmd - 텍스트의 값을 입력할 수 있는 객체

mode - 0=BEGIN(입력값을 받을 수 있는 상태), 1=END(입력을 받을 수 없는 상태)

OZEFormInputEventCommand

public void OZEFormInputEventCommand(java.lang.String docindex,
                                     java.lang.String formid,
                                     java.lang.String eventname,
                                     java.lang.String mainscreen)

사용자가 입력 컴포넌트를 클릭하거나 값을 변경하여 OnClick/OnFocus/OnKillFocus/OnValueChanged 이벤트가 실행된 경우 발생되는 이벤트입니다.

Parameters:

docindex - 보고서 인덱스(zero-based index)

formid - OnClick/OnFocus/OnKillFocus/OnValueChanged 이벤트가 발생한 컴포넌트의 FormID, FormID가 설정되지 않은 경우 컴포넌트의 이름이 리턴됨

eventname - 발생한 이벤트 이름(OnClick : 클릭됨, OnFocus : 포커스 얻음, OnKillFocus : 포커스 잃음, OnValueChanged : 값 변경됨)

mainscreen - 멀티스크린에서 동작시 메인화면에서 발생된 이벤트인지 아닌지 여부

OZExportMemoryStreamCallBack

public void OZExportMemoryStreamCallBack(java.lang.String outputdata)

Script, ScriptEx 함수의 명령어를 "save_memorystream"로 설정하여 실행한 경우 발생하는 이벤트입니다.
 
 outputdata는 {"파일 전체 경로":"base64로 인코딩되어 저장된 파일의 Memory Stream"} 형식의 문자열로 리턴됩니다.
 저장된 파일이 여러 개인 경우 콤마(,)를 구분자로하여 {"Path1":"Stream1","Path2":"Stream2",...,"Pathn":"Streamn"} 형식으로 리턴됩니다.
 저장을 취소하거나 에러가 발생한 경우에는 {}로 리턴됩니다.
 저장되는 파일이 여러 개인 경우 OZExportCommand는 여러 번 호출되나 OZExportMemoryStreamCallBack 이벤트는 모든 저장이 완료된 후 한 번만 호출됩니다.

Parameters:

outputdata - Memory Stream으로 저장된 결과