MATLAB에서 Excel 추가 기능 만들기

지원되는 플랫폼: Microsoft^®Windows^®만 해당.

이 예제는 MATLAB^® Compiler™를 사용하여, Excel^® 내에서 사용할 수 있는 사용자 지정 함수가 포함된 Microsoft Excel 추가 기능을 만드는 방법을 보여줍니다. 함수 mymagic은 행의 합과 열의 합이 같은 n×n 마방진 행렬을 반환합니다. 타깃 시스템은 추가 기능을 실행하기 위해 라이선스가 부여된 MATLAB이 필요하지는 않습니다.

시작하기 전에 MATLAB Compiler에 대한 Excel 타깃 요구 사항을 모두 충족했는지 확인하십시오. 자세한 내용은 Excel Target Requirements and Limitations for MATLAB Compiler 항목을 참조하십시오.

참고

Visual Basic^® 파일을 생성하려면 Excel에서 VBA 프로젝트 개체 모델에 안전하게 액세스할 수 있음를 활성화해야 합니다. 활성화하지 않은 경우에는 .bas 파일을 Excel로 가져와 직접 추가 기능을 만들 수 있습니다.

MATLAB에서 함수 만들기

MATLAB에서 Excel 추가 기능으로 배포하려는 MATLAB 코드의 위치를 찾습니다.

이 예제에서는 matlabroot\toolbox\matlabxl\examples\xlmagic에 있는 함수 mymagic.m를 컴파일합니다.

function y = mymagic(x)
y = magic(x)

MATLAB 명령 프롬프트에서 mymagic(5)를 입력합니다.

출력값은 5×5 정사각 행렬입니다.

    17    24     1     8    15
    23     5     7    14    16
     4     6    13    20    22
    10    12    19    21     3
    11    18    25     2     9

`compiler.build.excelAddIn`을 사용하여 Excel 추가 기능 만들기

프로그래밍 방식을 사용하여 Excel 추가 기능을 빌드할 수 있습니다. 또는 그래픽 인터페이스를 사용하여 Excel 추가 기능을 만들려면 Create Excel Add-In Using Excel Add-In Compiler App 항목을 참조하십시오.

MATLAB에서 독립 실행형 애플리케이션으로 배포하려는 MATLAB 코드의 위치를 찾습니다. 이 예제에서는 matlabroot\toolbox\matlabxl\examples\xlmagic에 있는 mymagic.m 파일을 사용하여 컴파일하십시오.
```
appFile = fullfile(matlabroot,'toolbox','matlabxl','examples','xlmagic','mymagic.m');
```
compiler.build.excelAddIn 함수를 사용하여 Excel 추가 기능을 빌드합니다. 이름-값 인수를 사용하여 라이브러리와 클래스 이름을 설정하고 Visual Basic 파일의 생성을 활성화합니다.
```
buildResults = compiler.build.excelAddIn(appFile, ...
'AddInName','xlmagic', ...
'ClassName','xlmagicclass', ...
'GenerateVisualBasicFile','on');
```
compiler.build 명령에서 이름-값 인수를 사용하여 추가 옵션을 지정할 수 있습니다. 자세한 내용은 compiler.build.excelAddIn 항목을 참조하십시오.
compiler.build.Results 객체 buildResults에는 빌드 유형, 생성된 파일, 포함된 지원 패키지, 빌드 옵션에 대한 정보가 포함됩니다.
이 함수는 현재 작업 디렉터리에 있는 mymagicexcelAddIn이라는 이름의 폴더 내에 다음 파일을 생성합니다.
- dlldata.c
- GettingStarted.html
- includedSupportPackages.txt
- xlmagic.def
- xlmagic.bas
- xlmagic.rc
- xlmagic.xla
- xlmagic_1_0.dll
- xlmagic_dll.cpp
- xlmagic_idl.h
- xlmagic_idl.idl
- xlmagic_idl.tlb
- xlmagic_idl_i.c
- xlmagic_idl_p.c
- xlmagicClass_com.cpp
- xlmagicClass_com.hpp
- mccExcludedFiles.log
- mwcomtypes.h
- mwcomtypes_i.c
- mwcomtypes_p.c
- readme.txt
- requiredMCRProducts.txt
- unresolvedSymbols.txt
참고
생성된 추가 기능은 MATLAB Runtime 또는 인스톨러를 포함하지 않습니다. buildResults 객체를 사용하여 인스톨러를 만들려면 compiler.package.installer 항목을 참조하십시오.

Excel에 추가 기능 설치하기

Microsoft Excel을 엽니다.
파일 탭을 클릭하고, 옵션을 클릭한 다음, 추가 기능 범주를 클릭합니다.
관리 상자에서 Excel 추가 기능을 클릭한 다음 이동을 클릭합니다. 추가 기능 대화 상자가 나타납니다.
찾아보기를 클릭하고 추가 기능 xlmagic.xla를 찾습니다.
사용자 이름과 연결된 Addins 폴더로 xlmagic.xla를 복사하라는 메시지가 표시됩니다. 추가 기능을 복사하거나 직접 실행할 수 있습니다. 이 예제에서는 예를 선택합니다. 추가 기능이 복사되어 통합 문서에 추가됩니다.
확인을 클릭하여 추가 기능 대화 상자를 닫습니다.

추가 기능 테스트하기

Excel 통합 문서에서 3x3 셀 그리드를 선택합니다.
수식 입력줄에 다음 사용자 지정 함수를 입력합니다.
```
=mymagic(3)
```
Excel에서 수식 입력줄에 my를 입력하면 mymagic가 사용자 지정 함수로 나타납니다.
키보드에서 Ctrl+Shift+Enter를 누릅니다.
선택된 셀에 다음 출력값이 표시됩니다.
```
8	1	6
3	5	7
4	9	2
```
추가 예제의 경우 matlabroot\toolbox\matlabxl\examples\xlmagic에 있는 파일 xlmagic.xls를 여십시오. 이 스프레드시트에는 컴파일된 MATLAB 함수를 사용하는 다양한 방법을 보여주는 세 개의 사용자 지정 VBA 매크로가 포함되어 있습니다.

추가 기능 배포하기

최종 사용자에게 추가 기능을 배포하려면 Distribute Add-Ins and Integrate into Microsoft Excel 항목을 참조하십시오.

참고 항목

compiler.build.excelAddIn