PDFium Component Docs

OnKeyUp-Ereignis

Component: TPdfView  ·  Unit: PDFium
Tritt ein, wenn eine Taste losgelassen wird, während das Viewer-Steuerelement den Fokus hat.

Syntax

property OnKeyUp: TKeyEvent;

Beschreibung

OnKeyUp ist das standardmäßige VCL-Tastaturereignis, das auf TPdfView publiziert wird. Der Handler wird ausgeführt, nachdem das Betriebssystem eine WM_KEYUP- / WM_SYSKEYUP-Nachricht meldet, während das Steuerelement den Fokus hat. Die Ereignissignatur lautet procedure(Sender: TObject; var Key: Word; Shift: TShiftState)Key ist der Virtual-Key-Code (VK_ESCAPE, VK_NEXT, VK_PRIOR, …) und Shift meldet den Status der Modifikatoren im Moment des Loslassens.

OnKeyUp wird für jede Taste ausgelöst — einschließlich Nicht-Zeichen-Tasten wie Pfeiltasten und Funktionstasten — vorausgesetzt, TPdfView hat den Tastaturfokus. Setzen Sie Key im Handler auf null, um das Ereignis zu konsumieren, damit es nicht weiter propagiert wird (z. B. um zu verhindern, dass Tabulatoren den Fokus durchwechseln, wenn ein Formularfeld bearbeitet wird).

Verwenden Sie OnKeyUp, um Viewer-Verknüpfungen zu implementieren, die beim Loslassen ausgelöst werden sollen, anstatt beim Halten — Bild-ab / Bild-auf zur Navigation, F3 für die Weitersuche, Escape zum Verwerfen einer Auswahl. Kontinuierliche Interaktionen (Schwenken, Auswahlrahmen) werden besser über OnKeyDown gesteuert, da das Betriebssystem KeyDown automatisch wiederholt, aber nur ein KeyUp pro physischem Loslassen ausgibt.

Bemerkungen

Beispiel

procedure TForm1.PdfView1KeyUp(Sender: TObject; var Key: Word; Shift: TShiftState);
begin
  case Key of
    VK_NEXT:  PdfView1.PageNumber := PdfView1.PageNumber + 1;
    VK_PRIOR: PdfView1.PageNumber := PdfView1.PageNumber - 1;
    VK_HOME:  PdfView1.PageNumber := 1;
    VK_END:  PdfView1.PageNumber := Pdf1.PageCount;
    VK_ESCAPE: PdfView1.ClearHighlight;
  end;
end;

Siehe auch

OnKeyDown, OnKeyPress, PageNumber, ClearHighlight