PDFium Component Docs

Gebeurtenis (event) OnKeyUp

Component: TPdfView  ·  Unit: PDFium
Occurs when a key is released while the viewer control has focus.

Syntaxis

property OnKeyUp: TKeyEvent;

Beschrijving

OnKeyUp is de standaard VCL-toetsenbordgebeurtenis gepubliceerd op TPdfView. De handler wordt uitgevoerd nadat het besturingssysteem een WM_KEYUP / WM_SYSKEYUP-bericht rapporteert terwijl het besturingselement focus heeft. De gebeurtenishandtekening is procedure(Sender: TObject; var Key: Word; Shift: TShiftState)Key is de virtuele-toetscode (VK_ESCAPE, VK_NEXT, VK_PRIOR, …) en Shift rapporteert de modificatiestatus op het moment van loslaten.

OnKeyUp wordt geactiveerd voor elke toets — inclusief niet-tekentoetsen zoals pijltoetsen en functietoetsen — op voorwaarde dat TPdfView toetsenbordfocus heeft. Stel Key in op nul binnen de handler om de gebeurtenis te consumeren zodat deze zich niet verder verspreidt (bijvoorbeeld om te voorkomen dat Tab de focus rouleert wanneer een formulierveld wordt bewerkt).

Gebruik OnKeyUp om viewer-sneltoetsen te implementeren die moeten worden geactiveerd bij loslaten in plaats van ingedrukt houden — Page Down / Page Up voor navigatie, F3 voor volgende zoeken, Escape om een selectie te negeren. Continue interacties (pannen, marquee-selectie) kunnen beter worden aangestuurd vanuit OnKeyDown omdat het besturingssysteem KeyDown automatisch herhaalt, maar slechts één KeyUp per fysieke loslating uitzendt.

Opmerkingen

Voorbeeld

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;

Zie ook

OnKeyDown, OnKeyPress, PageNumber, ClearHighlight