PDFiumPas 文档

OnSelectionChange 事件

此 API 条目保留标识符、签名、代码块和 PDF 术语的原始形式。
组件: TPdfView  ·  单元: PDFium
当具现化后的文本选区范围实际发生变化时触发

语法

property OnSelectionChange: TNotifyEvent;

说明

通知宿主文本选区已经发生变化。只要具现化的 FSelection 范围与先前状态不同,就会触发该事件 — 包括空 → 非空(拖拽开始抓取字符)、非空 → 空(ClearSelection、页面变化、停用、文档切换),以及中间的任何范围变化(Shift+Right、鼠标拖拽扩展、双击展开单词)

当再次设置相同的选区时不会触发(例如在同一页上连续调用两次 SelectAll)。内部的范围相等检查会直接跳过相同内容的重复应用,因此该事件可以直接绑定到状态栏文本或按钮启用状态,而不需要防抖

备注

示例

procedure TForm1.PdfViewSelectionChange(Sender: TObject);
begin
  StatusBar1.Panels[0].Text :=
    Format('%d 个字符已选中', [PdfView1.SelectionCharCount]);
  CopyButton.Enabled := PdfView1.HasSelection;
end;

另请参阅

AllowUserTextSelection, HasSelection, SelectionCharCount, SelectedText