ObjectId - 圖表函數
ObjectId() 圖表函數傳回用以評估運算式的物件 ID。 該函數採用選用引數,指定該函數顧慮哪個物件類型。物件可以是工作表或視覺化。此函數僅可用於圖表運算式。
語法:
ObjectId([object_type_str])
傳回的資料類型: 字串
函數的唯一引數 object_type_str 是選用性質,意指呈現物件類型的字串值。
引數 | 描述 |
---|---|
object_type_str | 呈現評估中物件類型的字串值。 |
若在函數運算式中未指定任何引數, ObjectId() 會傳回使用運算式的物件 ID 。若要傳回其中顯示視覺化的工作表物件 ID,使用 ObjectId('sheet')。
若視覺化物件內嵌於其他視覺化物件內部,請在函數引數中指定所需物件類型以獲得不同結果。例如,對於容器內部的文字與 影像圖表,使用 'text-image' 以傳回文字與 影像物件,並使用 'container' 以傳回容器 ID 。
請執行下列動作:
-
在分析模式中,將下列文字新增至 URL:
/options/developer
-
用滑鼠右鍵按一下視覺化,然後按一下 開發人員。
-
在屬性之下,從對話方塊標頭取得物件 ID,然後從 "qType" 屬性取得物件類型。
限制:
在作為主項目之容器內部的物件 (例如按鈕) 中叫用時,此函數可以提供意外結果。此限制也適用於篩選窗格主項目,這是一些清單方塊的容器。其原因是主項目使用物件階層的方式。
圖表運算式 ObjectId('sheet') 將會在這些情況下傳回空的字串,其中 ObjectId('masterobject') 將會顯示擁有主項目的識別碼。
ObjectId() 通常用於組合下列函數:
函數 | 互動 |
---|---|
if - 指令碼與圖表函數 | if 和 ObjectId 函數可以一起使用,以建立條件運算式。例如,視覺化可能會透過使用這些函數的運算式實現條件式著色。 |
InObject - 圖表函數 | 與 if 類似,InObject 也能搭配 ObjectId 使用,以建立條件運算式。 |
範例 1 – 傳回圖表物件 ID
範例 2 – 傳回工作表 ID
範例 3 – 巢狀運算式
如需更詳細的條件式著色使用範例,請參閱 InObject - 圖表函數 的範例。