모듈

버전

사용 파일

설치 경로

ANSI

MiPlatform 3.10

310\ExtCommonApi.dll

%Program Files%\TobeSoft\MiPlatorm310\Component

MiPlatform 3.10L

310L\ExtCommonApiL.dll

%Program Files%\TobeSoft\MiPlatorm310L\Component

MiPlatform 3.11

311\ExtCommonApi.dll

%Program Files%\TobeSoft\MiPlatorm311\Component

UNICODE

MiPlatform 3.10

310U\ExtCommonApiU.dll

%Program Files%\TobeSoft\MiPlatorm310\Component

MiPlatform 3.10L

310LU\ExtCommonApiLU.dll

%Program Files%\TobeSoft\MiPlatorm310LU\Component

MiPlatform 3.11

311U\ExtCommonApiU.dll

%Program Files%\TobeSoft\MiPlatorm311U\Component

Prototype

Description

Version

ext_ExecuteApp(strAppName, left, top, width, height)

외부 프로그램을 특정 위치, 크기로 실행한다.

2005, 10, 13, 1

ext_GetFileVersion(strFileName)

파일의 버전을 리턴한다.

ext_SelectFolder()

폴더 선택 대화창을 오픈하며 선택한 폴더명을 리턴한다.

ext_GetFileList(strFolder, strOpt)

strFolder내의 파일 리스트를 리턴한다.

strOpt는 “F”(default), “D”로 “D”일 때, 디렉토리 리스트를 리턴한다.

ext_GetTextExtent(componentid, strtext)

componentID의 폰트 크기를 이용해 strtext의 pixcel 단위 width, height 길이를 리턴한다.

ext_GetIPAddress()

사용중인 컴퓨터의 IP Address를 린턴한다. 두 개이상 사용시에는 array로 리턴한다.

2005, 10, 21, 1

ext_GetMacAddress()

사용중인 컴퓨터의 Mac Address를 리턴한다. 두 개이상 사용시에는 array로 리턴한다.

ext_GetPrinterList()

등록되어 있는 프린터 리스트를 array로 리턴한다.

ext_GetDefaultPrinter()

기본 프린터 이름을 리턴한다.

ext_SetDefaultPrinter(strPrinter)

기본 프린터를 strPrinter로 변경한다.

ext_MsgBox ( strTitle, strMsg, strStyle )

윈도우 표준 메시지 박스 표시. ( 3 button 표현 가능 )

사용예 :

li_result = ext_MsgBox ("Title.....",

"메시지 내용",

"MB_ICONSTOP|MB_YESNO|MB_DEFBUTTON1");

Style 사용 가능 명령

- 아이콘 형태

MB_ICONINFORMATION / MB_ICONASTERISK - 소문자 i

MB_ICONSTOP / MB_ICONHAND - Stop 아이콘

MB_ICONQUESTION - 물음표

MB_ICONEXCLAMATION - 느낌표

- 버튼 형태

MB_ABORTRETRYIGNORE

MB_OK

MB_OKCANCEL

MB_RETRYCANCEL

MB_YESNO

MB_YESNOCANCEL

- 디폴트 버튼 위치

MB_DEFBUTTON1

MB_DEFBUTTON2

MB_DEFBUTTON3

2005, 11, 22, 1

ext_RegSetValue(strKey, strPath, strName, strValue)

ext_RegSetValue(strKey, strPath, strName, intValue)

레지스트리에 값을 설정 기록함.

성공시 True(1), 에러시에 False(0)을 리턴한다.

strKey:

             HKEY_CLASSES_ROOT

             HKEY_CURRENT_USER

             HKEY_LOCAL_MACHINE

             HKEY_USERS

 중 택 1

strPath: key 이하의 경로

strName: 기록할 name

strValue, intValue: 기록할 값

2005, 12, 12, 1

ext_RegGetValue(strKey, strPath, strName, strType)

레지스트리에 값을 설정 기록함.

성공시 strName의 va;lue 값을 리턴하며, 에러시에 False(0)을 리턴한다.

strKey:

             HKEY_CLASSES_ROOT

             HKEY_CURRENT_USER

             HKEY_LOCAL_MACHINE

             HKEY_USERS

 중 택 1

strPath: key 이하의 경로

strName: 기록할 name

strType:  읽을 값이 숫자형이면“I”, <?xml:namespace prefix = st1 ns = "urn:schemas-microsoft-com:office:smarttags" /><?xml:namespace prefix = st1 /><?xml:namespace prefix = st2 ns = "urn:schemas:contacts" /><?xml:namespace prefix = st2 />문자형이면“S”를 이용한다.

2005, 12, 12, 1

ext_Xml2Bin(compress, in_filename, out_folder)

in_filename XML 파일을 precompile 한 후 압축해 파일을 생성한다. out_folder 폴더를 지정하면 같은 이름으로 out_folder에 파일을 생성하고, out_folder 폴더를 지정하지 않으면 기존의 파일명에 “_b”을 붙여 새로운 이름으로 저장한다.

compress: 압축 여부 플래그. True이면 Precompile + 압축, False 이면 Precompile만 한다.

in_filename: 변환하고자 하는 파일. full path.

out_folder: 변환한 새로운 파일이 저장될 경로. 옵션으로 지정하지 않을때에는 in_filename과 같은 위치에 파일을 생성한다.

2005, 12, 15, 1

ext_GetTime

현재 시간을 문자열로 리턴한다. (년월일시분초:yyyyMMddhhmmss)

2005, 12, 15, 1

ext_SetTime(strTime)

컴퓨터의 시간을 변경한다.

에러가 발생하면 에러 메시지 또는 0을 러턴하며, 성공하면 1을 리턴한다.

strTime: 년월일을 포함한(yyyyMMddhhmmss) 문자열 또는 시간만 포함한(ddhhmmss) 문자열

2005, 12, 15, 1

ext_SetImeNativeMode(Flag)

IME 모드를 변경한다.

Flag: True이면 현재 Window System의 언어로 설정되며, False이면 영어로 전환된다. ImeMode 프로퍼티가 설정되어 있는 컴퍼넌트에는 적용되지 않는다.

2006, 1, 12, 1

ext_FindRow(strDatasetID,strColID,strVal);

ext_FindRow(strDatasetID,strColID,strVal,nStartIdx);

ext_FindRow(strDatasetID,strColID,strVal,nStartIdx,nEndIdx);

strDatasetID Dataset의 strColID 값과 strVal의 값이 일치하는 레코드 Index를 모두 찾아 array로 리턴한다.

strDatasetID: 검색할 Dataset ID

strColID: 검색할 Dataset의 Column ID.

strVal: 검색할 Dataset의 Column Value.

nStartIdx: 검색할 시작 레코드 Index. 시작 Index값은 0 이다.

           nStartIdx가 0보다 작으면, 전체를 검색합니다.

           Default Value = 0

nEndIdx: 검색할 마지막 레코드 Index+1.

         지정된 값보다 1 작은 레코드까지 검색합니다.

         nEndIdx가 0보다 작으면 nStartIdx에서 끝까지 검색합니다.

         Default Value = -1

2006, 3, 3, 1

ext_FindRowAs(strDataset,strColID,strVal);

ext_FindRowAs(strDataset,strColID,strVal,nStartIdx);

ext_FindRowAs(strDataset,strColID,strVal,nStartIdx,nEndIdx);

strDatasetID Dataset의 strColID 값과 strVal의 값을 포함하는 레코드 Index를 모두 찾아 array로 리턴한다.

strDatasetID: 검색할 Dataset ID

strColID: 검색할 Dataset의 Column ID.

strVal: 검색할 Dataset의 Column Value.

nStartIdx: 검색할 시작 레코드 Index. 시작 Index값은 0 이다.

           nStartIdx가 0보다 작으면, 전체를 검색합니다.

           Default Value = 0

nEndIdx: 검색할 마지막 레코드 Index+1.

         지정된 값보다 1 작은 레코드까지 검색합니다.

         nEndIdx가 0보다 작으면 nStartIdx에서 끝까지 검색합니다.

         Default Value = -1

2006, 3, 3, 1

ext_FindRowNF(strDatasetID,strColID,strVal);

ext_FindRowNF(strDatasetID,strColID,strVal,nStartIdx);

ext_FindRowNF(strDatasetID,strColID,strVal,nStartIdx,nEndIdx);

Filter된 데이타를 포함한 strDatasetID Dataset의 strColID 값과 strVal의 값이 일치하는 레코드 Index를 모두 찾아 array로 리턴한다.

strDatasetID: 검색할 Dataset ID

strColID: 검색할 Dataset의 Column ID.

strVal: 검색할 Dataset의 Column Value.

nStartIdx: 검색할 시작 레코드 Index. 시작 Index값은 0 이다.

           nStartIdx가 0보다 작으면, 전체를 검색합니다.

           Default Value = 0

nEndIdx: 검색할 마지막 레코드 Index+1.

         지정된 값보다 1 작은 레코드까지 검색합니다.

         nEndIdx가 0보다 작으면 nStartIdx에서 끝까지 검색합니다.

         Default Value = -1

2006, 3, 3, 1

ext_FindRowNFAs(strDataset,strColID,strVal);

ext_FindRowNFAs(strDataset,strColID,strVal,nStartIdx);

ext_FindRowNFAs(strDataset,strColID,strVal,nStartIdx,nEndIdx);

Filter된 데이타를 포함한 strDatasetID Dataset의 strColID 값과 strVal의 값을 포함하는 레코드 Index를 모두 찾아 array로 리턴한다.

strDatasetID: 검색할 Dataset ID

strColID: 검색할 Dataset의 Column ID.

strVal: 검색할 Dataset의 Column Value.

nStartIdx: 검색할 시작 레코드 Index. 시작 Index값은 0 이다.

           nStartIdx가 0보다 작으면, 전체를 검색합니다.

           Default Value = 0

nEndIdx: 검색할 마지막 레코드 Index+1.

         지정된 값보다 1 작은 레코드까지 검색합니다.

         nEndIdx가 0보다 작으면 nStartIdx에서 끝까지 검색합니다.

         Default Value = -1

2006, 3, 3, 1

ext_GetSystemDir(strFlag)

strFlag에 따른 현재 컴퓨터의 디렉터리를 리턴 한다.

SYSETM: 컴퓨터의 system 폴더

PROGRAMS: 컴퓨터의 program files 폴더

PROGRAM_COMMON: 컴퓨터의 program files 폴더

WINDOWS: 컴퓨터의 window 폴더

TEMP : Templates 폴더

2006, 4, 4, 1

ext_SetTopWindow(Flag)

MiPlatform 프로그램을 다른 프로그램의 맨 상위로 올린다

Flag: True이면 맨 상위로 지정, False이면 Normal 상태로 지정

단, MDI 전용브라우저에서 사용할 때는 SessionURL로 지정된 화면이 아닌 그 이후의 첫 화면에 지정하도록 해야 한다.

2006, 4, 25, 1

ext_ExcelImportByIndex(strExcelFilename, intSheetIndex,

 strTargetDatasetID,

 [intUseColInfo, intExp,

intDecimal,intStartRow])

strExcelFilename: 엑셀파일에서 intSheetIndex 번째 sheet의 내용을 strTargetDatasetID dataset에 저장한다. 성공: 0, 실패: -1.

strExcelFilename: 엑셀 파일명

intSheetIndex: 데이터를 가져오기 위한 sheet index(0 부터 시작)

strTargetDatasetID: 데이터를 저장할 dataset

intUseColInfo : 데이터셋의 컬럼정보를 사용 1

               데이터셋 컬럼정보를 무시 0

기존에 정의 되어 있던 dataset column info와 데이터는 모두 초기화 되며 리턴되는 컬럼은 모두 String 타입으로 처리 된다.

intExp: 데이터가 숫자형의 12자리 이상일 경우 지수형으로 표현되어 나오는데, 이를 일반 숫자 형식으로 표현하고자 할 때 사용한다.

        1 이면 지수형의 데이터를 일반 숫자 형식으로 추출.

        0 이면 지수형식으로 추출

intDecimal: intExp의 값이 1일 때 사용하는 것으로 숫자의 소숫점 자릿수를 지정한다. 모든 숫자데이터에 일괄적으로 적용된다.. Default = 0

데이터 양이 많거나 PC의 사양에 따라 응답시간이 차이가 날 수 있다.

EXCEL 프로그램이 반드시 설치되어 있어야 한다.

intStartRow : Excel파일의 시작 행위치(default 1)

2006, 7, 7, 1

ext_ExcelImportByName(strExcelFilename, strSheetName,

 strDatasetID,

[intUseColInfo, intExp,

intDecimal,intStartRow])

strExcelFilename 엑셀파일에서 strSheetName sheet의 내용을 strTargetDatasetID dataset에 저장한다. 성공: 0, 실패: -1.

strExcelFilename: 엑셀 파일명

strSheetName: 데이터를 가져오기 위한 sheet name

strTargetDatasetID: 데이터를 저장할 dataset

intuseColInfo : 데이터셋의 컬럼정보를 사용 1

             데이터셋 컬럼정보를 무시 0

기존에 정의 되어 있던 dataset column info와 데이터는 모두 초기화 되며

리턴되는 컬럼은 모두 String 타입으로 처리 된다.

intExp: 데이터가 숫자형의 12자리 이상일 경우 지수형으로 표현되어 나오는데, 이를 일반 숫자 형식으로 표현하고자 할 때 사용한다.

        1 이면 지수형의 데이터를 일반 숫자 형식으로 추출.

        0 이면 지수형식으로 추출

intDecimal: intExp의 값이 1일 때 사용하는 것으로 숫자의 소숫점 자릿수를 지정한다. 모든 숫자데이터에 일괄적으로 적용된다.. Default = 0

EXCEL 프로그램이 반드시 설치되어 있어야 한다.

intStartRow : Excel파일의 시작 행위치(default 1)

2006, 7, 7, 1

ext_ExcelGetSheetList(strExcelFilename)

strExcelFilename 엑셀파일에서 Sheet 목록을 array 로 리턴 한다.

strExcelFilename: 엑셀 파일명

데이터 양이 많거나 PC의 사양에 따라 응답시간이 차이가 날 수 있다.

EXCEL 프로그램이 반드시 설치되어 있어야 한다.

2006, 7, 7, 1

ext_ExcelSaveAs(strFilename, strTargetFilename, strFileType)

strExcelFilename 엑셀파일을 strTargetFilename 파일로 저장한다.

strFileType 값을 지정하지 않으면 모든 내용이 저장되며, “csv”로 지정하면 엑셀 파일로 마지막 저장될 때의 active sheet의 내용이 csv 형태로 저장된다.  성공: 0, 실패: -1.

데이터 양이 많거나 PC의 사양에 따라 응답시간이 차이가 날 수 있다.

EXCEL 프로그램이 반드시 설치되어 있어야 한다.

2006, 7, 7, 1

ext_FindWindow(strClassName, strTitle)

strClassName: 찾고자 하는 윈도우 class name

strTitle: 찾고자 하는 윈도우의 title

class name을 알 수 없으면 strTitle 값만을 넣는다.

해당 윈도우를 찾지 못하면 0을 리턴한다.

ext_ExecuteProccess(strExeName, strArgs, strStartdir)

strExeName: 실행 파일 명(절대경로)

strArgs: 아규먼트 정보

strStartdir: 실행 파일 시작 디렉터리

성공: 0, 실패: -1

ext_WriteUProfileString(strAppNm, strKey,strValue,

                      strFilename)

strAppNm : 그룹명

strKey : 그룹내의 Key명

strValue : 지정할 값

strFilename : 경로가 포함된 파일명

ext_GetUProfileString(strAppNm, strKey,

strDefault, strFileName)

strAppNm : 그룹명

strKey : 그룹내의 Key명

strDefault : 없을 경우 디폴트값

strFilename : 경로가 포함된 파일명

Ext_KeyCheck(strKey)

strKey : CAPSLOCK , NUMLOCK, SCROLLOCK

on : 1 , off : 0

Ext_GetHostName()

사용자 컴퓨터의 이름을 가져옴

성공 : 컴퓨터이름 실패 : null

Ext_Csv2Ds(strFileName,strDatasetName,

HeadFlag,strColumnId)

strFileName : open할 filename

strDatasetname : dataset id

HeadFlag : column정보를 clear여부

true인 경우 clearall를 수행후 처리함

strColumnId : column info ( 콤마로 처리함)

             ex) “col01,col02,col03……”

ext_Ds2Csv(strDatasetName,strFileName,

HeadFlag,strColumnId,commaYN)

strDatasetname : dataset id

strFileName : open할 filename

HeadFlag : column정보를 clear여부

true인 경우 clearall를 수행후 처리함

strColumnId : column info ( 콤마로 처리함)

             ex) “col01,col02,col03……”

commaYN : RD와 연동시 레코드의 끝에 , 를 넣을 때 사용

Ext_Ds2CsvEx(strDsname,strFileName,

             Quoteyn,headyn,columnGbn,newlinestr)

strDsname : dataset id

strFileName : 저장할 filename(파일명이 없으면 return값으로 줌)

quoteYn : 따옴표 사용여부(default 1)

headyn : head 출력여부(default 1)

columnGbn : column분리자 (default comma)

nelinestr : newLine으로 사용할 문자(default \r\n)

ext_InternetGetConnectedState()

인터넷 연결여부

1: 연결

0: 연결안됨

ext_OleServerBusyTimeout(reg/unreg,

DelayTime,

EnableNotRespondingDialog,

bBusyDialog)

BusyTimeOut시간 설정

Ex)설정시 : ext_OleServerBusyTimeOut(true,3000,false,false)

   해제시 : ext_OleServerBusyTimeOut(false)

Ext_checkDirectory(dirName,option)

dirName : 찾을 directory명

option : 1 – 없으면 create

return : 1 – exist , 0 – not exist

Ext_Base64Encode(str)

Str : base64로 encode할 string

Return : base64 문자열

Ext_Base64Decode(str)

Str : base64 문자열

Return : ascill 문자열

Ext_getSystemEnv(str)

Str : 환경변수

Return : 환경변수값

Ext_getDriveInfo()

Return : 컴퓨터의 하드 디스크 드라이브정보

Ext_getBitCalc(gubun,val1,val2)

Bit연산

Gubun : 문자열로 &,|,>>,<<,~ 중 하나

Val1   : bit연산할 첫번째값

Val2   : bit연산할 2번째 값(shift연산은 shift수)