ObjectHandle - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Surowy wskaźnik FPDF_PAGEOBJECT PDFium dla wskazanego obiektu strony, przeznaczony do bezpośrednich wywołań natywnego C API PDFium

Syntax

property ObjectHandle[Index: Integer]: Pointer; // read only

Description

Zwraca nieprzezroczysty wskaźnik FPDF_PAGEOBJECT, którego PDFium używa do identyfikacji obiektu strony na pozycji Index na bieżącej stronie. Ten sam uchwyt, który ObjectBounds, ObjectType i pozostałe indeksowane właściwości obiektów rozstrzygają wewnętrznie, jest tutaj udostępniany, aby zaawansowani wywołujący mogli korzystać z funkcji FPDFPageObj_*, FPDFPath_*, FPDFText_* lub FPDFImageObj_*, które nie są jeszcze opakowane przez komponent

Uchwyt należy do bieżącej strony i pozostaje prawidłowy tylko, gdy strona jest załadowana. Wywołanie ReloadPage, przełączenie PageNumber, usunięcie obiektu przez RemoveObject albo ustawienie Active na False unieważnia każdy wcześniej zapisany ObjectHandle. Nigdy nie wywołuj FPDFPageObj_Destroy na uchwycie już dołączonym do strony — dwukrotne zniszczenie spowoduje awarię PDFium

Najpierw użyj ObjectType, aby rozdzielić obsługę według rodzaju obiektu, na który wskazujesz, a następnie wykonaj rzutowanie i wywołaj odpowiednią rodzinę pomocników PDFium. Wskaźnik można też porównywać pod kątem tożsamości między wywołaniami w ramach jednej sesji strony, co jest przydatne przy korelowaniu operacji edycji z ich obiektami wynikowymi

Parameters

Index Indeks obiektu strony liczony od zera, 0 ≤ Index < ObjectCount

Remarks

Typ wskaźnika jest zadeklarowany jako Pointer dla przenośności ABI; przed przekazaniem do wywołań natywnych wykonaj rzutowanie na FPDF_PAGEOBJECT
Indeksy spoza zakresu zwracają nil zamiast zgłaszać wyjątek
Po zmodyfikowaniu obiektu przez natywne wywołania PDFium wykonaj UpdatePage, aby zbuforowany strumień treści strony został wygenerowany ponownie
Dwa różne obiekty strony mogą chwilowo współdzielić ten sam adres po RemoveObject, jeśli PDFium ponownie użyje gniazda — nie przechowuj uchwytu przez edycje strukturalne

Example

// Read the blend mode of the first object using the raw PDFium API.
uses PDFiumLib;
var Obj: FPDF_PAGEOBJECT;
var Blend: array[0..15] of AnsiChar;
begin
  Obj := Pdf1.ObjectHandle[0];
  if Assigned(Obj) then
    FPDFPageObj_GetBlendMode(Obj, @Blend[0], SizeOf(Blend));
  ShowMessage(string(Blend));
end;

ObjectHandle Właściwość