native.showPopup() — 快速浏览

类型 函数
库 native.*
修订版 版本 2024.3703
关键字 native、showPopup、快速浏览、预览

概览

显示操作系统的默认弹出窗口，用于预览/查看文档。

语法

native.showPopup( name, options )
名称（必需）

字符串. 要显示的弹出的字符串名称。对于快速浏览插件，请使用 "quickLook"。

选项（必需）

表格. 指定弹出窗口属性的表格 — 有关详细信息，请参阅下一节。

选项参考

options 表格中的有效属性包括以下内容

文件（必需）

表格. 子表格的表格，每个表格指定要查看的文件。在每个子表格中， 文件名 指示文件，基本目录 指示文件所在的系统目录 常量。

files = 
{
    { filename="myFile.txt", baseDir=system.ResourceDirectory },
}
起始索引（可选）

表格. 预览将开始的文件索引。例如，如果您在files 表格中有两个文件子表格，并且您将此值设置为 2，它将先预览第二个文件，而不是从第一个文件开始。默认值为 1，表示第一个文件。

侦听器（可选）

函数. 在关闭弹出窗口时要调用的侦听器函数。此函数会传递一个 event 表格，其中包含以下属性

  • event.name (字符串) — "popup" 的值。
  • event.type (字符串) — "quickLook" 的值。
  • event.action (字符串) — "done" 的值。
  • event.file (表格) — 在关闭之前预览的最后一个项目的文件表格。

示例

local function quickLookListener( event )
    print( event.name )    --"popup"
    print( event.type )    --"quickLook"
    print( event.action )  --"done"
    print( event.file )    --file table of last item previewed prior to dismissing, for example: { filename="myFile.txt", baseDir=system.ResourceDirectory }
end

-- Quick Look options
local quickLookOptions = 
{
    files =
    {
        { filename="myPDF.pdf", baseDir=system.ResourceDirectory },
        { filename="myImage.jpg", baseDir=system.ResourceDirectory },
    },
    startIndex = 1,
    listener = quickLookListener
}

native.showPopup( "quickLook", quickLookOptions )