다른 제품과 통합 > API 가이드 > PTC Mathcad Prime 객체 > 객체: Worksheet
  
객체: Worksheet
이 객체는 PTC Mathcad PrimeWorksheet COM 인터페이스 Ptc.MathcadPrime.Automation.IMathcadPrimeWorksheet3을 나타냅니다.
메소드
• Activate() - PTC Mathcad Prime 열린 워크시트 막대에서 활성 상태로 만들 워크시트 탭을 설정(워크시트 탭 활성화)합니다.
• Close(SaveOption) - PTC Mathcad Prime에 워크시트가 열려 있는 경우 해당 워크시트를 닫습니다.
SaveOption
◦ SpSaveChanges - 워크시트가 닫히기 전에 사용자에게 메시지를 표시하지 않고 변경 내용을 강제로 저장합니다.
◦ spPromptToSaveChanges - 워크시트가 닫히기 전에 사용자에게 변경 내용을 저장하라는 메시지가 표시됩니다.
◦ spDiscardChanges - 모든 변경 내용을 취소하고 워크시트를 닫습니다.
◦ 새로 생성되어 수정되지 않은 워크시트에 대한 특수 동작:
▪ saveOptionArg가 spPromptToSaveChanges로 설정된 경우에도 사용자에게 메시지를 표시하지 않고 워크시트가 닫힙니다.
▪ saveOptionArg가 spSaveChanges로 설정된 경우에도 사용자에게 메시지를 표시하지 않고 워크시트가 닫힙니다.
• DefaultCalculationTimeout(arg as integer) - 워크시트의 DefaultCalculationTimeOut 값을 가져오거나 설정합니다. 엔진이 전체 문서를 다시 계산할 때까지 응용 프로그램이 대기하는 기본 시간을 정의하고, 타임 아웃이 매개변수로 전달되는 API를 제외한 다른 유형의 Get/SetValue API에 영향을 줍니다.
◦ arg는 초 단위로 정의됩니다.
◦ 0은 대기하지 않는 것을 의미합니다.
◦ –1은 무제한으로 대기하는 것을 의미합니다.
◦ 기본 타임 아웃은 60초입니다.
• CreateMatrix(rowsArg as integer, colsArg as integer) - NaNs로 채워진 특정 크기의 행렬을 생성합니다.
rowsArg는 행의 수입니다.
colsArg는 열의 수입니다.
반환 값:
생성된 행렬이거나, 오류가 발생하는 경우 Null입니다.
• CreateValuesSetter() - 별칭으로 입력 항목에 설정할 double 또는 행렬 배율이 적용된 값의 컬렉션을 생성합니다.
반환 값:
생성된 ValuesSetter이거나, 오류가 발생하는 경우 Null입니다.
• GetWorkSheetReadOnlyOptionValue(WorksheetReadonlyOptionNames) - 워크시트 읽기 전용 옵션 값을 가져옵니다.
WorksheetReadonlyOptionNames는 워크시트 옵션 이름입니다.
반환 값:
워크시트 옵션 값이거나, 옵션이 없거나 해당 값이 잘못된 경우 Null입니다.
• InputGetMatrixValue(aliasArg as string) - 입력 행렬 결과를 지정된 입력 별칭에 대한 InputMatrixResult 객체로 추출합니다.
aliasArg는 입력의 별칭입니다.
반환 값:
InputMatrixResult이거나, 행렬 입력 결과를 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• InputGetRealValue(aliasArg as string) - 입력 결과를 지정된 입력 별칭에 대한 InputResult 객체로 추출합니다.
aliasArg는 입력의 별칭입니다.
반환 값:
InputResult이거나, 행렬 결과를 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• InputGetSExprValue(aliasArg as string) - 지정된 입력 별칭에 대한 입력의 SExpression 값을 가져옵니다.
aliasArg는 입력의 별칭입니다.
반환 값:
문자열 형식의 SExpression 값이거나, 값을 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• InputGetValue(aliasArg as string) - 입력의 값 결과를 지정된 입력 별칭에 대한 ValueResult 객체로 가져옵니다.
aliasArg는 입력의 별칭입니다.
반환 값:
ValueResult 형식의 입력 값 결과이거나, 객체 인스턴스를 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• IsOpen() - 워크시트가 PTC Mathcad Prime에 열려 있는지 확인합니다.
반환 값:
워크시트가 열려 있는 경우 True입니다.
워크시트가 열려 있지 않은 경우 FALSE입니다.
• OutputGetMatrixValue(aliasArg as string) - 출력 행렬 결과를 지정된 출력 별칭에 대한 OutputMatrixResult 객체로 추출합니다.
aliasArg는 출력의 별칭입니다.
반환 값:
OutputMatrixResult이거나, 행렬 출력 결과를 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• OutputGetMatrixValueAs(aliasArg as string, unitsArg as string) - 출력 행렬 결과를 지정된 출력 별칭에 대한 OutputMatrixResult 객체로 추출합니다.
aliasArg는 출력의 별칭입니다.
unitsArg는 출력의 단위입니다.
반환 값:
OutputMatrixResult이거나, 행렬 출력 결과를 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• OutputGetRealValue(aliasArg as string) - 출력 결과를 지정된 출력 별칭에 대한 OutputResult 객체로 추출합니다.
aliasArg는 출력의 별칭입니다.
반환 값:
별칭으로 지정된 실제 값입니다.
• OutputGetRealValueAs(aliasArg as string, unitsArg as string) - 출력 결과를 지정된 단위의 지정된 출력 별칭에 대한 OutputResult 객체로 추출합니다.
aliasArg는 출력의 별칭입니다.
unitsArg는 출력의 단위입니다.
반환 값:
지정된 단위의 실제 값입니다.
• OutputGetValue(aliasArg as string) - 출력의 값 결과를 ValueResult 객체로 가져옵니다.
aliasArg는 출력의 별칭입니다.
반환 값:
ValueResult 형식의 출력 값 결과이거나, 객체 인스턴스를 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• PauseCalculation() - 계산을 일시정지합니다.
• ResumeCalculation() - 계산을 다시 시작합니다.
• SaveAs(newDocumentPathArg as string) - 워크시트를 새 이름으로 저장합니다.
newDocumentPathArg는 저장 대상입니다.
워크시트는 파일 확장자 .mcdx를 사용하는 표준 워크시트 또는 파일 확장자 .mctx를 사용하는 템플릿으로 저장할 수 있습니다.
• SetMatrixValue(aliasArg as string, valueArg as Matrix, unitsArg as string) - 행렬 값 및 단위를 지정된 별칭의 입력으로 설정합니다.
aliasArg는 입력의 별칭입니다.
valueArg는 입력으로 설정할 행렬 값입니다.
unitsArg는 입력으로 설정할 단위입니다.
반환 값:
–1
이 함수를 수행하는 동안 알 수 없는 오류가 발생했습니다. 워크시트가 열려 있지 않은 경우에도 발생할 수 있습니다.
0
오류가 아닙니다. 함수가 성공했습니다.
1
입력/출력 항목의 별칭을 찾을 수 없습니다.
2
입력/출력이 비활성화되었습니다.
3
비호환적인 단위입니다.
4
입력이 잘못되었습니다.
5
계산 오류입니다.
6
비호환적인 결과 유형입니다.
7
행렬 결과가 잘못되었습니다.
8
계산 타임 아웃입니다.
9
계산이 비활성화되었습니다.
• SetRealValue(aliasArg as string, valueArg as double, unitsArg as string) - double 값 및 단위를 지정된 별칭의 입력으로 설정합니다.
aliasArg는 입력의 별칭입니다.
valueArg는 입력으로 설정할 double 값입니다.
unitsArg는 입력으로 설정할 단위입니다.
반환 값:
–1
이 함수를 수행하는 동안 알 수 없는 오류가 발생했습니다. 워크시트가 열려 있지 않은 경우에도 발생할 수 있습니다.
0
오류가 아닙니다. 함수가 성공했습니다.
1
입력/출력 항목의 별칭을 찾을 수 없습니다.
2
입력/출력이 비활성화되었습니다.
3
비호환적인 단위입니다.
4
입력이 잘못되었습니다.
5
계산 오류입니다.
6
비호환적인 결과 유형입니다.
7
행렬 결과가 잘못되었습니다.
8
계산 타임 아웃입니다.
9
계산이 비활성화되었습니다.
• SetSExprValue(aliasArg as string, sexpressionArg as string) - SExpression 값을 지정된 별칭의 입력으로 설정합니다.
aliasArg는 입력의 별칭입니다.
sexpressionArg는 입력으로 설정할 SExpression 값입니다.
반환 값:
–1
이 함수를 수행하는 동안 알 수 없는 오류가 발생했습니다. 워크시트가 열려 있지 않은 경우에도 발생할 수 있습니다.
0
오류가 아닙니다. 함수가 성공했습니다.
1
입력/출력 항목의 별칭을 찾을 수 없습니다.
2
입력/출력이 비활성화되었습니다.
3
비호환적인 단위입니다.
4
입력이 잘못되었습니다.
5
계산 오류입니다.
6
비호환적인 결과 유형입니다.
7
행렬 결과가 잘못되었습니다.
8
계산 타임 아웃입니다.
9
계산이 비활성화되었습니다.
• SetStringValue(aliasArg as string, valueArg as string) - 문자열 값을 지정된 별칭의 입력으로 설정합니다.
aliasArg는 입력의 별칭입니다.
valueArg는 입력으로 설정할 문자열 값입니다.
반환 값:
–1
이 함수를 수행하는 동안 알 수 없는 오류가 발생했습니다. 워크시트가 열려 있지 않은 경우에도 발생할 수 있습니다.
0
오류가 아닙니다. 함수가 성공했습니다.
1
입력/출력 항목의 별칭을 찾을 수 없습니다.
2
입력/출력이 비활성화되었습니다.
3
비호환적인 단위입니다.
4
입력이 잘못되었습니다.
5
계산 오류입니다.
6
비호환적인 결과 유형입니다.
7
행렬 결과가 잘못되었습니다.
8
계산 타임 아웃입니다.
9
계산이 비활성화되었습니다.
• SetTitle(titleArg as string) - 워크시트의 PTC Mathcad Prime 창 제목을 설정합니다.
titleArg는 워크시트에 대해 설정할 제목입니다.
• Synchronize() - 워크시트를 동기화하거나 다시 계산합니다.
속성
• FullName - 워크시트의 전체 경로 및 이름을 가져옵니다.
반환 값:
워크시트의 전체 경로 및 이름이거나, 워크시트가 새 워크시트인 경우 빈 문자열입니다.
• Inputs - 워크시트 입력을 가져옵니다.
반환 값:
워크시트 입력이거나, 입력을 읽어들이는 동안 오류가 발생하는 경우 Null입니다.
• Modified - 워크시트의 수정된 속성 값을 가져오거나 설정합니다.
반환 값:
워크시트가 수정된 경우 True입니다.
워크시트가 수정되지 않은 경우 FALSE입니다.
• Name - 워크시트의 이름을 가져옵니다.
• Outputs - 워크시트 출력을 가져옵니다.
• 문자열 형식의 WorksheetClosingPrompt=TextArg. 워크시트 닫기 프롬프트 텍스트를 설정합니다.
• 문자열 형식의 WorksheetDisplayedFilePath=filePathArg. CustomizedFilePath를 설정합니다. 워크시트를 저장하는 파일에 대한 사용자 정의 파일 경로입니다. Null 또는 빈 문자열을 전달하면 이전에 설정된 표시 경로가 지워집니다.
• 문자열 형식의 WorksheetTabIcon=iconFullPathArg. 워크시트 탭 아이콘 iconFullPathArg - 아이콘에 대한 전체 경로를 설정합니다.
• 문자열 형식의 WorksheetTabName=tabNameArg. 워크시트 탭 이름 tabNameArg – 워크시트 탭 이름을 설정합니다.
• 문자열 형식의 WorksheetWorkingDirectory=workingDirArg. 워크시트 CWD를 설정합니다.