GetLayoutObjectAttribute

返回由计算中当前活动的“对象名称”提供的布局对象的指定属性。

格式 

GetLayoutObjectAttribute (对象名称;属性名称{;重复项编号;入口行号})

参数 

对象名称 - 当前布局上的命名布局对象的名称。

属性名称 - 支持的属性的名称（如下所示）。

重复项编号 - 重复项编号（针对重复字段）。

入口行号 - 入口中的行号。

括号 { } 中的参数是可选的。

返回的数据类型 

文本

原始版本 

8.5

属性

属性

返回

objectType

对象的类型（英语）。

hasFocus

如果对象名称具有焦点，则返回“1”；否则返回“0”。可以有焦点的对象包括字段、入口、选项卡面板、滑动面板、按钮、弹出框按钮、图表和组。如果选择了入口行，则还为入口返回“1”。

containsFocus

如果对象名称具有焦点，或者，如果其中包含具有焦点的对象，则返回“1”；否则返回“0”。可以有焦点的对象包括字段、入口、选项卡面板、滑动面板、按钮栏、按钮、弹出框按钮、弹出框、图表和组。

isFrontPanel

如果目标对象是在最上层显示的选项卡面板或滑动面板，则返回“1”。

isActive

如果目标对象当前处于活动状态，则返回“1”；否则返回“0”。

isObjectHidden

如果对于当前记录，对象名称处于隐藏状态，则返回“1”；否则返回“0”。对于除了位于布局边界右侧的弹出框的对象，返回“1”。

bounds

一个由空格分隔的数值列表，该列表描述了指定对象的位置（左上到右下）及其旋转。

left

指定对象的左侧边缘坐标。

right

指定对象的右侧边缘坐标。

top

指定对象的顶部边缘坐标。

bottom

指定对象的底部边缘坐标。

width

指定对象的宽度。

height

指定对象的高度。

rotation

指定对象的旋转（以度为单位）。

startPoint,
endPoint

一个由空格分隔的数值对（水平、垂直），表示线条对象的起点或终点。其他对象将返回 startPoint 的左上角点和 endPoint 的右下角点。

source

指定对象的源描述，如下所示。

Web 查看器 - 返回当前 URL。

字段 - 返回完全限定的字段名称 (表名称::字段名称)。

文本对象 - 返回文本（不返回合并字段）。

入口 - 返回表摹本的名称。

图形 - 返回图像数据，如图像文件名。

图表 - 返回图表对象的 XML 描述。

所有其他对象 - 返回一个空字符串。

content

指定对象的内容，如下所示。

Web 查看器 - 返回当前内容（如 HTML 代码）。

字段 - 返回使用指定对象的属性设置格式的字段数据。

文本对象 - 返回文本（包括合并字段中的文本）。

图形 - 如果已存储图像（存储在字段中或在外部存储），将返回图像数据，如容器字段中的文件名；如果未存储图像，将返回文件的引用。

图表 - 返回图表对象的位图表示形式。

按钮和弹出框按钮 - 返回按钮的文本。

所有其他对象 - 返回一个空字符串。

enclosingObject

返回括起布局对象的“对象名称”；否则返回空字符串。只有组、选项卡面板、滑动面板、按钮栏、弹出框按钮、弹出框和入口才能包含其他对象。

containedObjects

“对象名称”中包含的指定对象的列表。只有组、选项卡面板、滑动面板、按钮栏、弹出框按钮、弹出框和入口才能包含其他对象。

注释 

  • 对象坐标按相对于主屏幕工作区域左上角的点数形式提供。工作区域是除任务栏外的屏幕区域 (Windows) 或除菜单栏和 Dock 外的屏幕区域 (macOS)。在 iOS 和 iPadOS 中，工作区域是整个屏幕。使用这些座标的属性是 bounds、left、top、bottom、startPoint 和 endPoint。
  • 在 FileMaker WebDirect 中，当此函数作用于 Web 查看器时，content 属性将返回空字符串。
  • 如果将对象设置为自动调整大小，则返回的属性基于该对象在当前状态下的调整后界限。

    在 FileMaker WebDirect 中，属性基于 FileMaker WebDirect 最后一次与服务器通信布局数据时（例如用户切换到布局时）对象的界限。

  • 如果对象位于状态工具栏上方，则将返回负坐标值。
  • 当重复项编号或入口行号为 0 时，函数的行为与未指定参数时相同。对于入口行号，函数将返回来自第一个入口行的数据。对于重复项编号，函数将对第一个重复项运行（返回 content 或 source），或对作为一个整体的整个字段运行（返回 bounds）。两个参数都必不可少，因为您必须能够在特定的入口行内参考特定的字段重复项。

示例 1 

在“搜索::主页”字段中存储 Web 查看器的当前 URL。

复制 
设置字段 [搜索::主页 ; GetLayoutObjectAttribute ( "Web 查看器" ; "source" )]

相关主题