跳轉到主要內容
此方法已在 Linux 和 Windows 的 FRE 中實作。
此方法會在用戶端實作。此方法可判斷來源的處理佇列中是否包含任何影像檔案。

語法

C++

HRESULT IsEmpty( VARIANT_BOOL* Result );

C#

bool IsEmpty();

Visual Basic .NET

Function IsEmpty() As Boolean

參數

Result [out, retval] 此參數表示是否有影像檔案需要處理。若此參數為 TRUE,則表示沒有影像可供處理。

回傳值

[僅限 C++] 如果此方法回傳的值不是 S_OK,表示用戶端發生錯誤。

備註

此方法的客戶端實作必須確保:在方法內拋出的所有例外狀況都會被攔截並妥善處理,且不會傳播到方法之外。若例外狀況傳播到方法之外,可能會導致不可預期的結果 (例如程式終止) 。

範例

// 自訂影像來源的範例實作,用於維護影像檔案佇列
public class ImageSourceCallback : FREngine.IImageSource
{
   public ImageSourceCallback( string imageFilesDirectory )
   {
       imageFiles = ImageSourceHelper.LoadFilesNames( imageFilesDirectory );
       nextFileIndex = 0;
   }
   public bool IsEmpty()
   {
       return nextFileIndex >= imageFiles.Length;
   }
   public FREngine.IFileAdapter GetNextImageFile()
   {
       if( !IsEmpty() ) {
           return new FileAdapterCallback( imageFiles[nextFileIndex++] );
       }
       return null;
   }
   public FREngine.IImageDocument GetNextImageDocument()
   {
       ...
   }
   private string[] imageFiles;
   private int nextFileIndex;
}
public class FileAdapterCallback : FREngine.IFileAdapter
{
    ...
}
public class ImageSourceHelper
{
    ...
}

另請參見

IImageSource GetNextImageDocument GetNextImageFile