[comment]: # translation:outdated

[comment]: # ({82eb5968-78824c3b})
# 获取

[comment]: # ({/82eb5968-78824c3b})

[comment]: # ({c1f300a1-32c0a3f2})
### 描述

`integer/array templatescreenitem.get(object parameters)`

此方法允许根据指定的参数检索聚合图形项模板。

[comment]: # ({/c1f300a1-32c0a3f2})

[comment]: # ({33edd8fa-cb4b0a21})
### 参数

`(object)`定义所需输出的参数。 该方法提供以下参数。

|参数                     类|描述|<|
|------------------------------|------|-|
|screenids|string/array|仅返回指定所属聚合图形模板的聚合图形项模板ID。|
|screenitemids|string/array|仅返回指定ID的聚合图形项模板。|
|hostids|string/array|为每个聚合图形项模板返回一个额外的“real\_resourceid”属性，该属性属于指定主机或模板的聚合图形。`real_resourceid`属性包含显示在聚合图形中的对象ID。|
|sortfield|string/array|按给定属性对结果排序。<br><br>可能值：`screenitemid`和`screenid`。|
|countOutput|boolean|这些参数很常用，适用于所有`get`方法，详情可参考[reference commentary](/zh/manual/api/ reference_commentary#common_get_method_parameters)。|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/33edd8fa-cb4b0a21})

[comment]: # ({880c4468-7223bab1})
### 返回值

`(integer/array)` 返回两者其中任一：

-   一组对象；
-   若已使用了`countOutput`参数，则检索对象的计数。

[comment]: # ({/880c4468-7223bab1})

[comment]: # ({4811a99c-b41637d2})
### 示例

[comment]: # ({/4811a99c-b41637d2})

[comment]: # ({e690539d-ac3164f6})
#### 为聚合图形检索聚合图形项模板

从聚合图形模板"15"中返回所有聚合图形项模板。

请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "templatescreenitem.get",
    "params": {
        "output": "extend",
        "screenids": "15"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": [
        {
            "screenitemid": "42",
            "screenid": "15",
            "resourcetype": "0",
            "resourceid": "454",
            "width": "500",
            "height": "200",
            "x": "0",
            "y": "0",
            "colspan": "1",
            "rowspan": "1",
            "elements": "0",
            "valign": "1",
            "halign": "0",
            "style": "0",
            "url": "",
            "max_columns": "3"
        },
        {
            "screenitemid": "43",
            "screenid": "15",
            "resourcetype": "0",
            "resourceid": "455",
            "width": "500",
            "height": "270",
            "x": "1",
            "y": "0",
            "colspan": "1",
            "rowspan": "1",
            "elements": "0",
            "valign": "1",
            "halign": "0",
            "style": "0",
            "url": "",
            "max_columns": "3"
        }
    ],
    "id": 1
}
```

[comment]: # ({/e690539d-ac3164f6})

[comment]: # ({dcb4463c-73b27d1c})
### 来源

CTemplateScreenItem::get() in
*frontends/php/include/classes/api/services/CTemplateScreenItem.php*.
CTemplateScreenItem::get()方法可在*frontends/php/include/classes/api/services/CTemplateScreenItem.php*中参考。

[comment]: # ({/dcb4463c-73b27d1c})