Excel Dna를 사용하여 설명서 사용하기

Question

Excel Dna를 사용하여 .NET xll을 만들고이를 내 addin 및 Excel 워크 시트 기능에 사용했습니다. 또한 ExcelDnaPack.exe를 사용하여 내 xll 패키지를 만듭니다.

excel dna가 내 라이브러리 API에 대한 문서를 생성하는 방법을 지원하는지 궁금합니다.

감사합니다, 마니 첫째

Answer 1

는, 엑셀-DNA는 기능과 다른 인수에 대한 설명과 함께 엑셀 함수 마법사에 통합 할 수 있습니다. 이들은 속성을 사용하여 함수에 추가됩니다.

[ExcelFunction(Category="My functions", Description="My useful function")] 
public static double MyFunc(
    [ExcelArgument(Description="is an important parameter.")] double param1, 
    [ExcelArgument(Description="is unimportant.")] double param2) 
{...} 

또한 함수 마법사는 각 함수에 대한 도움말 링크를 허용합니다. 당신이 도움말 파일이있는 경우

는,이 .chm 형식으로 말하고,이 같은 도움말 링크를 연결하는 엑셀 DNA를 알 수 있습니다 :

[ExcelFunction(HelpTopic="MyHelp.chm!102")] 
public static double MyFunction() ... 

어떻게 도움말 파일을 얻으려면? C# 또는 VB.NET 컴파일러는 코드의 xml /// 주석에서 xml 파일을 생성 할 수 있습니다. 이 .xml 파일은 Sandcastle과 같은 것으로 처리됩니다.이 부분에 대한 전체 토론은 Generating Documentation from C# XML Comments입니다.

그러나 Excel-DNA에는 기능과 주제를 자동으로 관련시키는 순간이 없습니다. 생성 된 TopicIds를 Sandcastle 출력에서 ​​파악하거나 XML 주석의 코드에서 설정하는 것이 얼마나 어려운지 잘 모르겠습니다. 문제가있는 경우 자동 화제 연결 또는 도움말 생성 도구가 Excel-DNA에 추가 할 수있는 좋은 기능입니다.

전체 애드 인에 대한 도움말 파일을 표시하는 단추가있는 Excel-DNA 추가 기능에 리본을 추가하는 것이 일반적입니다.

편집 : Excel-DNA를 처리하여 도움말 파일을보다 쉽게 ​​생성하는 사용자 제공 프로젝트가 있습니다. https://github.com/mndrake/ExcelDnaDoc

을 참조하십시오.