PdfRenderer 類別

定義

命名空間:

Android.Graphics.Pdf

組件:

Mono.Android.dll

這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。

[Android.Runtime.Register("android/graphics/pdf/PdfRenderer", DoNotGenerateAcw=true)]
public sealed class PdfRenderer : Java.Lang.Object, IDisposable, Java.Lang.IAutoCloseable

[<Android.Runtime.Register("android/graphics/pdf/PdfRenderer", DoNotGenerateAcw=true)>]
type PdfRenderer = class
    inherit Object
    interface IAutoCloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

PdfRenderer

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IAutoCloseable IDisposable

備註

此類別允許從 Android V 中呈現 PDF 文件，並可選擇、搜尋、快速捲動、註解等功能。此類別對執行緒安全，且可由多個執行緒呼叫，但一次只會執行一個執行緒，因為存取是透過內部鎖定同步的。

如果你想渲染 PDF，你要建立一個渲染器，對於每一個想要渲染的頁面，打開該頁面、渲染它，然後關閉頁面。 渲染完成後，關閉渲染器。 渲染器關閉後，它就不應該再被使用了。 請注意，這些頁面是逐頁渲染的，也就是說，你在任何時候只能開啟一頁。

API用來呈現PDF的典型用途如下：

// create a new renderer
            PdfRenderer renderer = new PdfRenderer(getSeekableFileDescriptor());

            // let us just render all pages
            final int pageCount = renderer.getPageCount();
            for (int i = 0; i < pageCount; i++) {
                Page page = renderer.openPage(i);

                // say we render for showing on the screen
                page.render(mBitmap, null, null, Page.RENDER_MODE_FOR_DISPLAY);

                // do stuff with the bitmap

                // close the page
                page.close();
            }

            // close the renderer
            renderer.close();

<h3>列印預覽與列印輸出</h3>

如果你使用此類別來點陣化 PDF 以便列印或顯示列印預覽，建議遵守以下合約，以確保使用者在預覽與列印時的體驗一致，也就是使用者看到的預覽與列印結果相同。 <尊重><>該性質，文件是否希望按比例#shouldScaleForPrinting()印刷。 </li><li> 在列印文件縮放時，應保留長寬比。 </li><li> 請勿在內容中加任何邊界 android.print.PrintAttributes ，因為應用程式有責任讓邊界得到尊重。 </li><li> 如果文件頁面大小大於印刷媒體尺寸，內容應錨定在頁面左上角（由左至右的區域），右至左的區域則固定在右上角。 </li></ul>

Java 文件 android.graphics.pdf.PdfRenderer。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
PdfRenderer(ParcelFileDescriptor, LoadParams)	建立一個新的 PdfRenderer 類別實例。
PdfRenderer(ParcelFileDescriptor)	建立新的實例。

欄位

名稱	Description
DocumentLinearizedTypeLinearized	已淘汰. 代表線性化的 PDF 文件。
DocumentLinearizedTypeNonLinearized	已淘汰. 代表一份非線性化的 PDF 文件。
PdfFormTypeAcroForm	已淘汰. 代表以 AcroForm 規範指定表單欄位的 PDF
PdfFormTypeNone	已淘汰. 表示無表單欄位的 PDF
PdfFormTypeXfaForeground	已淘汰. 代表一個以 XFAF 規範中 XFAF 子集指定表單欄位的 PDF
PdfFormTypeXfaFull	已淘汰. 代表一個包含表單欄位的 PDF，並依照整個 XFA 規範指定

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
DocumentLinearizationType	會取得 PDF 文件的類型。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
JniPeerMembers	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。
PageCount	取得文件頁數。
PdfFormType	回傳已載入 PDF 的表單類型
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Close()	關閉這個渲染器。
Construct(JniObjectReference, JniObjectReferenceOptions)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
Equals(Object)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OpenPage(Int32)	開啟一個渲染頁面。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
ShouldScaleForPrinting()	了解文件是否偏好放大以便列印。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Write(ParcelFileDescriptor, Boolean)	將載入後的 PDF 文件目前狀態儲存到給定的可 ParcelFileDescriptor寫入文件。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	這門課可以渲染 PDF 文件，並選擇、搜尋、快速捲動、註解等功能。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。