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