報告運算式的函式

前面標星號 (*) 的項目表示惟獨報告運算式語言才有。

ABS（<運算式>）
此功能傳回輸入值的絕對值。

ACOS（<運算式>）
此功能傳回輸入值的反餘弦。輸入和結果的單位均爲弧度。

ANGLEBETWEEN（<運算式 1>、<運算式 2>）
此功能傳回兩個輸入，即運算式 1 和運算式 2 之間的角度，此角度應爲 point 型。結果的單位爲度。

ARRAY（<運算式 1>、<運算式 2> 和 <運算式 N>）
此功能建立超出輸入值的陣列。

ASIN（<運算式>）
此功能傳回輸入值的反正弦。輸入和結果的單位均爲弧度。

ASIN（<運算式>）
此功能傳回輸入值的反正弦。輸入和結果的單位均爲弧度。

AVERAGE（<運算式>）
與 PC-DMIS 運算式語言中相同。

COMMANDDATA（<運算式 1>、<運算式 2>）
此運算式可計算或顯示「報告資料」事件中命令物件參考的特徵資訊。這為運算式 1提供了一個必需參數。該參數告訴 PC-DMIS 在特徵中要顯示的資訊。未來將支援第二個可選參數，即運算式 2，但目前無法使用。

您可以透過表達式1 傳遞字符串值：

您還可以透過運算式 1 傳遞運算式，如 ISOUTTOL() 函數：

在本示例中，從 TEXTANDCAD_OOT.RTP 報告範本中，運算式檢查超差值是否大於零：

如果 "COMMANDDATA("=ISOUTTOL()","")>0" 然後使用範本「Reference_ID.lbl」

如果是這樣，它使用 Reference_ID.lbl 標籤範本。有關 ISOUTTOL 的更多資訊，請參閱下面的 ISOUTTOL 運算式描述。

CHR（<運算式>）
此功能傳回 integer 型輸入值相應的 ASCII 字元值。

*COLOR（<運算式 1>、<運算式 2>）
將運算式 1 的文字值設爲使用 4 種顏色中的一種作爲顏色樹中目前定義的顏色。1= 標記色；2= 未標記色；3= 步驟模式色；4 = 錯誤色。請參閱「變更字串的文字顏色」。

*GetTolColor（運算式 1、運算式 2、運算式 3）
這個函式有三個運算式：偏差、正公差和負公差。它根據偏差情況傳回 COLORREF 類型的目前公差顏色。

運算式 1 是 double 型偏差值，運算式 2 是 double 型正公差值，運算式 3 是 double 型負公差值。

可以結合使用傳回的顏色和報告中物件的顏色屬性，如 ForeColor 和 BackColor，動態變更物件顏色，以示出目前公差值。

這些顏色在編輯 尺寸顏色對話方塊中指定。請參考「編輯 CAD 顯示」一章中的「編輯尺寸顏色」。

CONCAT（<運算式 1>、<運算式 2> 和 <運算式 N>）
此功能將運算式 1 至 N 中指定的所有字串連結成 1 個字串。

COS（<運算式>）
此功能傳回輸入值的反餘弦。輸入和結果的單位均爲弧度。

*COUNT（運算式 1）
此功能傳回運算式 1 中指定的目前命令資料類型的實例數。

CROSS（<運算式 1>、<運算式 2>）
此功能傳回向量型運算式 1 和運算式 2 的向量積。

*DATAFIELD（<運算式1>，<運算式2>，<運算式3>）
此函數僅在自訂報表編輯器中使用。此功能從特徵，維度或命令中的特定資料欄位返回資訊。該函數有三個參數：運算式 1 是表示命令的唯一 id 或 id 的字串，運算式 2 是表示資料類型的字串，運算式 3 是類型索引。類型指數一般為 0，但在多次發生 dtype 的情況中其值將為 1 或更大的值。

在將項目從編輯視窗拖放到自訂報告中時，將自動建立和使用此運算式。

DATEVALUE()
與 PC-DMIS 運算式語言中相同。

DEG2RAD（<運算式>）
此功能將輸入的度轉換爲弧度。

DELTA（<運算式 1>、<運算式 2>、<運算式 3>）
輸出一個沿運算式 2 中指定的向量從運算式 1 中指定的點，移動運算式 3 中指定的距離的新點。

DISTANCEFROMEDGE()
此功能獲取到 CAD 上最近棱邊的命令所指特徵之測量質心的距離。

可以在規則樹編輯器中使用此函式依據傳回的距離指定不同標籤範本。

DOT（<運算式 1>、<運算式 2>）
此功能傳回運算式 1 和運算式 2 的點積。輸入值應爲 point 型。

DOUBLE（<運算式>）
此功能將輸入值從目前類型轉換爲 double 型。如果是 point 型，則傳回點與原點之間的距離。

*ELAPSEDTIME()
此功能傳回執行花費的時間量。

ELEMENT（<運算式 1>、<運算式 2>、<運算式 3>）
與 PC-DMIS 運算式語言中相同。

EQUAL（<運算式 1>、<運算式 2>）
測試兩個陣列是否完全相同，如相同傳回 1，否則傳回 0。

<運算式 1> ^ <運算式 2>
與 PC-DMIS 運算式語言中相同。

EXPON（<運算式>）
與 PC-DMIS 運算式語言中相同。

*FILENAME()
此功能傳回測量常式的完整路徑和檔名。

FORMAT（<運算式 1>、<運算式 2>）
與 PC-DMIS 運算式語言中相同。

*GETCOUNT（運算式 1）
此功能傳回 ENUM_FIELD_TYPES 資料類型（在運算式 1 中指定）的 Long 型實例數。例如，報告了 X、Y、Z 和 D 的位置尺寸，將爲「軸」資料類型傳回 4。

GETFEATURESSETID（<運算式 1>）
在執行過程中，若目前命令爲尺寸，該函式確定該尺寸的基準特徵是否在特徵集中。若在某個集合中找到該基準特徵，將以字串值傳回該集合的 ID，并在字串末尾附加副檔名 ".lbl"。若未找到有該基準特徵的特徵集命令，則傳回 <運算式 1> 中提供的預設字串值。預設值應爲包括 .lbl 副檔名的標籤檔名。

檢視範例

GETTEMP（<運算式 1>）
此功能傳回指定的溫度或閾值。運算式 1 所用的字串值之一可確定要傳回的值：

GETPROGRAMINFO（<字串>、<可選字串>）
與 PC-DMIS 運算式語言中相同。

IF（<運算式 1>、<運算式 2>、<運算式 3>）
如果運算式 1 的結果爲非零值，則傳回運算式 2 的值，否則傳回運算式 3 的值。

INDEX（<運算式 1>、<運算式 2>）
與 PC-DMIS 運算式語言中相同。

INTEGER（<運算式>）
與 PC-DMIS 運算式語言中相同。

ISMARKEDFORARM（<運算式>）
該函數在多臂模式環境中使用。若標記的是 <運算式> 中指定的臂的命令則返回 1，否則返回 0。這樣可以依據命令的執行臂控制報告中顯示的內容。

檢視範例

*ISOUTTOL()
該功能檢查命令是否超出容差。這只與上面討論的 COMMANDATA 運算式一起使用。

LEFT（<運算式 1>、<運算式 2>）
與 PC-DMIS 運算式語言中相同。

LEN（<運算式>）
對於字串，此功能傳回字串中的字元數。對於陣列，傳回陣列中的元素個數。

LN（<運算式>）
與 PC-DMIS 運算式語言中相同。

*LOADSTR（<運算式>）
此功能從資源檔案載入使用數值的字串。若載入負值，將引致字串從字串資源載入。詳細資訊請參閱「從 PC-DMIS 載入字串」。

LOG（<運算式>）
與 PC-DMIS 運算式語言中相同。

LOWERCASE（<運算式>）
與 PC-DMIS 運算式語言中相同。

<運算式 1> < <運算式 2>
與 PC-DMIS 運算式語言中相同。

MAX（<運算式>）
與 PC-DMIS 運算式語言中相同。

MAXINDEX( <運算式>)
與 PC-DMIS 運算式語言中相同。

MAXINDICES( <運算式>)
與 PC-DMIS 運算式語言中相同。

*MEASSCALE()
此功能傳回測量時重新標度的係數。

MIN（<運算式>）
與 PC-DMIS 運算式語言中相同。

MININDEX（<運算式>）
與 PC-DMIS 運算式語言中相同。

MININDICES（<運算式>）
與 PC-DMIS 運算式語言中相同。

MID（<運算式 1>、<運算式 2>、<運算式 3>）
與 PC-DMIS 運算式語言中相同。

MPOINT（<運算式 1>、<運算式 2>、<運算式 3>）
與 PC-DMIS 運算式語言中相同。

*NUMMEAS()
該功能顯示代表報告的尺寸數的數值。

*NUMOUTTOL()
此功能顯示報告的超出公差的尺寸數。

ORD（<運算式>）
與 PC-DMIS 運算式語言中相同。

PCDMISUSERHIDDENDATAPATH()
與 PC-DMIS 運算式語言中相同。

PCDMISUSERVISIBLEDATAPATH()
與 PC-DMIS 運算式語言中相同。

PCDMISSYSTEMHIDDENDATAPATH()
與 PC-DMIS 運算式語言中相同。

PCDMISSYSTEMVISIBLEDATAPATH()
與 PC-DMIS 運算式語言中相同。

PCDMISSYSTEMREPORTINGPATH()
與 PC-DMIS 運算式語言中相同。

PCDMISAPPLICATIONPATH()
與 PC-DMIS 運算式語言中相同。

*PARTNAME()
此功能顯示工件名稱（與顯示在檔案標頭中的名稱相同）。

*PAGE()
此功能顯示目前頁數。

*PAGES()
此功能顯示總頁數。

PAGEDIMCOUNT（「ObjectID」，範圍）
本函式取兩個參數。若第一個參數爲空（引號中爲空），則傳回目前頁面中最大偏差小於「範圍*公差」的尺寸數，第二個參數爲「範圍」，係一個浮點數。若第一個參數中包含 CadReportObject ID 或 TextReportObject ID，則此參數傳回與 CADReportObject 或 TextReportObject ID 關聯的公差中的尺寸數。

例如，假定要傳回的 CadReportObject1 超出公差的尺寸數。您可使用以下代碼執行此操作：

=TotalPageDimCount("CadReportObject1") - PageDimCount("CadReportObject1",1.0)

此外， 亦可透過向 ID 附加 ":N"（其中 N 係表示軸數的數字）來計算包含特定軸數的尺寸數。

例如，鍵入 =PageDimCount("CadReportObject1:4",1.0) 將傳回與 CadReportObject1 關聯的至少包含四條軸，並且其第四條軸在指定的 1.0 公差之內的尺寸數。若不知道軸數，則會傳回與 CadReportObject1 相關的尺寸數，如果所有軸都在指定公差 1.0 之內。

對於「自訂報告」，只能將此函數與 CADReportObject 一起使用，因為 TextReportObject 無法處理自訂報告。

RAD2DEG（<運算式>）
與 PC-DMIS 運算式語言中相同。

REAL（<運算式>）
與 PC-DMIS 運算式語言中相同。

*REGSETTING（<運算式 1>、<運算式 2>）
此功能顯示特定登錄設定的值。它有兩個參數：運算式 1 確定章節，運算式 2 確定項目。

REPORTDIMCOUNT（「<運算式 1>」、<運算式 2>）
該函式與 PageDimCount() 函式的作用相似，祇是該函式顯示的不是目前頁面超出公差的尺寸數，而是整個報告中超出公差的總尺寸數。此外對於 <運算式 1>，要使用 CadReportObject1 或 TextReportObject ID 作爲 ID，或者將其留空（祇有引號）。

對於「自訂報告」，只能將此函數與 CADReportObject 一起使用，因為 TextReportObject 無法處理自訂報告。

*REPORTVALUE（<運算式 1>）
此功能顯示另一物件的屬性值。它有一個參數，即運算式 1。此 運算式是物件的唯一 ID（爲 string 型值），其後爲一句點，然後就是屬性名稱。例如 =REPORTVALUE("text1.text")

*REVNUM()
此功能顯示版本號（與檔案標頭中所示內容相同）。

*RGB（<運算式 1>、<運算式 2>、<運算式 3>、<運算式 4>）
爲運算式 1 中指定的字串著上運算式 2、3 和 4 的 RGB 值指定的顏色。請參閱「變更字串的文字顏色」。

RIGHT（<運算式 1>、<運算式 2>）
與 PC-DMIS 運算式語言中相同。

ROUND（<運算式 1>、<運算式 2>）
與 PC-DMIS 運算式語言中相同。

*SECTION()
顯示目前章節號。

*SERNUM()
顯示序號（與檔案標頭中所示內容相同）。

SIN（<運算式>）
與 PC-DMIS 運算式語言中相同。

SORTUP（<運算式>）
與 PC-DMIS 運算式語言中相同。

SORTDOWN（<運算式>）
與 PC-DMIS 運算式語言中相同。

SQRT（<運算式>）
與 PC-DMIS 運算式語言中相同。

*STATCOUNT()
傳回統計計數（與檔案標題中相同）。

STR（<運算式>）
與 PC-DMIS 運算式語言中相同。

STRING（<運算式>）
與 PC-DMIS 運算式語言中相同。

SUM（<運算式>）
與 PC-DMIS 運算式語言中相同。

SYSTIME()
與 PC-DMIS 運算式語言中相同。

SYSTEMDATE（<運算式>）
與 PC-DMIS 運算式語言中相同。

SYSTEMTIME（<運算式>）
與 PC-DMIS 運算式語言中相同。

*TOGGLESTR（<運算式 1>、<運算式 2>）
根據運算式 1 中的資源 ID 值，此功能從該資源提取切換字串。同樣，若字串係來自於字串資源，則使用負數。運算式 2 之值係用於指定想要此切字串的哪一個子字串。其結果爲子字串。

*TOGGLESTRING(DATA_TYPE)
若給定命令的指定資料類型爲切換字串，則傳回完整的切換字串。

*TOGGLEVALUE(DATA_TYPE)
若給定命令的指定資料類型爲切換字串，則傳回切換字串的索引值（或切換值）。

*TOL（<運算式 1>、<運算式 2>、<運算式 3>、<運算式 4>）
運算式 1 是要著色的字串，運算式 2 是測試值，運算式 3 是最大容差值，而運算式 4 是最小容差值。如果測試值在公差範圍內（在運算式 3 與運算式 4 之值之間），則軟體使用黑色對文本著色。否則，軟體會使用錯誤顏色（一般為紅色）對文本著色。您可在顏色編輯器對話方塊（編輯 | 首選項 | 編輯視窗顏色）中定義錯誤顏色。

例如，此代碼以黑色顯示「在公差範圍內」文字：

=TOL（“在公差範圍內”，100,100.5,99.5）

此代碼以錯誤色（預設為紅色）顯示「超出公差」文字：

=TOL（“超出公差”，99,100.5,99.5）

*TOLF（<運算式 1>、<運算式 2>、<運算式 3>、<運算式 4>、<運算式 5>）
此功能提供 TOL 運算式之外的其他格式化功能。前四個參數與以上 TOL 中所列的相同。第五個運算式決定超差條件的字型、字型大小、格式和顏色。其語法為：

"f:s:w:c"

f 係要使用的字型的名稱。

s 係字型的大小（單位：點）。

w 係字型的格式，可為以下任一格式：

B 或 BOLD，用於粗體格式。

I or ITALIC，用於斜體格式。

R 或 REGULAR，用於常規格式。

BI, BOLDITALIC, IB、 或 ITALICBOLD，用於粗體加斜體格式。

c 係 RGB(r,g,b) 顏色格式，其中，r = 紅色，g = 綠色，b = 藍色。每個值的範圍為 0 至 255。

上述每個項目均為選用，必須使用冒號 (:) 字元分隔。例如，要僅設定字型大小，可設定 ":14"，但要僅設定顏色，需設定 ":::RGB(0,0,0)"。

以下範例將超差的測量尺寸格式化為 Arial 字型、大小 12、粗體、紅色。

=TOLF(DIM_MEASURED:N,DIM_OUTTOL:N,0.0,0.0,"Arial:12:B:RGB(255,0,0)")

TOTALPAGEDIMCOUNT("ObjectID")
此函式包含一個參數。若其爲空（引號中不含任何內容），傳回目前頁面中的總尺寸數。若在此參數中鍵入 CadReportOjbect 或 TextReportObject 的 ID，PC-DMIS 傳回與此 CadReportObject 關聯的總尺寸數。

例如，若使用的是運算式 =TotalPageDimCount("CadReportObject3")，則 PC-DMIS 將傳回與 CadReportObject3 關聯的總尺寸數。

此外， 亦可透過向 ID 附加 ":N"（其中 N 係表示軸數的數字）來計算包含特定軸數的尺寸數。

例如，鍵入 =TotalPageDimCount("CadReportObject1:4") 將傳回與 CadReportObject1 關聯並且至少包含 4 條軸的總尺寸數。

對於「自訂報告」，只能將此函數與 CADReportObject 一起使用，因為 TextReportObject 無法處理自訂報告。

TOTALREPORTDIMCOUNT("CADREPORTOJECTID")
該函式與 TotalPageDimCount() 函式的作用相似，主要區別：本函式傳回的不是目前頁的尺寸數，而是整個報告的總尺寸數。若存在 CadReportObject 或 TextReportObject，則以上所述成立。若以物件 ID 作爲參數，需將此物件 ID 命名爲 CadReportObject1 或 TextReportObject1。

對於「自訂報告」，只能將此函數與 CADReportObject 一起使用，因為 TextReportObject 無法處理自訂報告。

TRACEFIELD（<運算式>）
此功能顯示報告中給定的追蹤欄位的名稱和值。運算式的值祇是代表測量常式中自上至下列示的追蹤欄位順序的值而已。因此要顯示列示的第一個追蹤欄位，代碼應爲：=TRACEFIELD(1)

UNIT（<運算式>）
與 PC-DMIS 運算式語言中相同。

USERSTRING（<運算式 1>、<運算式 2>）
此函式可從逗號分隔值 (CSV) 文字檔提取自訂的字串，同時在標籤中顯示該字串。有關此函式的範例，請參考「從文字檔載入字串」。

*VARIABLE（<運算式 1>、<運算式 2>）
此功能顯示定義的變數值。該函數有三個參數：運算式 1 是表示命令的唯一 id 或 id 的字串，運算式 2 是表示資料類型的字串，運算式 3 是類型索引。詳細資訊請參閱「顯示變數值」。

VECX（<運算式>）
與 PC-DMIS 運算式語言中相同。

VECY（<運算式>）
與 PC-DMIS 運算式語言中相同。

VECZ（<運算式>）
與 PC-DMIS 運算式語言中相同。