技術標籤：pythonjavajvmjsjavascript

類LoadOptions

• java.lang.Object
• com.aspose.words.LoadOptions

• 直接已知子類：

  HtmlLoadOptions，PdfLoadOptions，RtfLoadOptions，TxtLoadOptions

  公共類LoadOptions
  

  擴充套件java.lang.Object

例：

顯示如何載入加密的Microsoft Word文件。

檔案doc;

    //如果我們嘗試開啟沒有密碼的加密文件，則Aspose.Words會引發異常。
    Assert.assertThrows(IncorrectPasswordException.class，()->新文件(getMyDir()+“ Encrypted.docx”));

    //載入此類文件時，密碼將使用LoadOptions物件傳遞給文件的建構函式。
    LoadOptions選項=新的LoadOptions(“ docPassword”);

    //有兩種使用LoadOptions物件載入加密文件的方式。
    // 1-按檔名從本地檔案系統載入文件。
    doc =新文件(getMyDir()+“ Encrypted.docx”，選項)；

    // 2-從流中載入文件。
    InputStream流=新的FileInputStream(getMyDir()+“ Encrypted.docx”);
    嘗試
            {
        doc =新文件(流，選項)；
}
    最後{if(stream！= null)stream.close(); }
 

• • 構造器詳細資訊

    • 載入選項

      公共LoadOptions()
      

      例：

      顯示如何使用基本URI開啟來自流的影象的HTML文件。

      InputStream流=新的FileInputStream(getMyDir()+“ Document.html”);
          嘗試/ * JAVA：正在使用* /
          {
              //載入時傳遞基本資料夾的URI
              //，以便可以找到HTML文件中具有相對URI的任何影象。
              LoadOptions loadOptions = new LoadOptions();
              loadOptions.setBaseUri(getImageDir());
      
              Document doc = new Document(stream，loadOptions);
      
              //驗證文件的第一個形狀包含有效影象。
              形狀shape =(Shape)doc.getChild(NodeType.SHAPE，0，true);
      
          Assert.assertTrue(shape.isImage());
          Assert.assertNotNull(shape.getImageData()。getImageBytes());
          Assert.assertEquals(32.0，ConvertUtil.pointToPixel(shape.getWidth())，0.01);
          Assert.assertEquals(32.0，ConvertUtil.pointToPixel(shape.getHeight())，0.01);
      }
          最後{if(stream！= null)stream.close(); }
      

    • 載入選項

      公共LoadOptions(java.lang.String密碼)
      

      引數：

      password-開啟加密文件的密碼。可以為null或空字串。

      例：

      顯示如何載入加密的Microsoft Word文件。

      檔案doc;
      
          //如果我們嘗試開啟沒有密碼的加密文件，則Aspose.Words會引發異常。
          Assert.assertThrows(IncorrectPasswordException.class，()->新文件(getMyDir()+“ Encrypted.docx”));
      
          //載入此類文件時，密碼將使用LoadOptions物件傳遞給文件的建構函式。
          LoadOptions選項=新的LoadOptions(“ docPassword”);
      
          //有兩種使用LoadOptions物件載入加密文件的方式。
          // 1-按檔名從本地檔案系統載入文件。
          doc =新文件(getMyDir()+“ Encrypted.docx”，選項)；
      
          // 2-從流中載入文件。
          InputStream流=新的FileInputStream(getMyDir()+“ Encrypted.docx”);
          嘗試
                  {
              doc =新文件(流，選項)；
      }
          最後{if(stream！= null)stream.close(); }
      

    • 載入選項

      public LoadOptions(int loadFormat，java.lang.String password，java.lang.String baseUri)
      

      引數：

      loadFormat- 一種載入格式值。要載入的文件格式。

      password-開啟加密文件的密碼。可以為null或空字串。

      baseUri-將用於將相對URI解析為絕對值的字串。可以為null或空字串。

      例：

      顯示如何將網頁中的HTML內容插入到新文件中。

      //要載入的頁面的網址
      URL url =新URL(“ http://www.aspose.com/”);
      
      //從Internet載入文件的最簡單方法是使用URLConnection類
      URLConnection webClient = url.openConnection();
      
      //從URL引用的位置下載位元組
      InputStream inputStream = webClient.getInputStream();
      
      //將輸入流轉換為位元組陣列
      int pos;
      ByteArrayOutputStream bos = new ByteArrayOutputStream();
      while((pos = inputStream.read())！= -1)bos.write(pos);
      
      byte [] dataBytes = bos.toByteArray();
      
      //將代表記憶體中文件的位元組包裝到流物件中
      ByteArrayInputStream byteStream =新的ByteArrayInputStream(dataBytes);
      
      //應該設定baseUri屬性，以確保正確檢索任何相對img路徑
      LoadOptions選項=新的LoadOptions(LoadFormat.HTML，“”，url.getPath());
      
      //從流中載入HTML文件並傳遞LoadOptions物件
      Document doc = new Document(byteStream，options);
      
      //將文件轉換為.docx時將其儲存到本地檔案系統
      doc.save(getArtifactsDir()+“ Document.InsertHtmlFromWebPage.docx”);
      

  • 財產獲取者/設定者詳細資訊

    • getBaseUri / setBaseUri

      公共java.lang.String getBaseUri()/公共無效setBaseUri(java.lang.String值)
      
      

      在以下情況下，此屬性用於將相對URI解析為絕對URI：

      1. 從流中載入HTML文件時，該文件包含具有相對URI的影象，並且在BASE HTML元素中沒有指定基本URI。
      2. 將文件儲存為PDF和其他格式時，可以檢索使用相對URI連結的影象，以便可以將影象儲存到輸出文件中。

      例：

      顯示如何使用基本URI開啟來自流的影象的HTML文件。

      InputStream流=新的FileInputStream(getMyDir()+“ Document.html”);
          嘗試/ * JAVA：正在使用* /
          {
              //載入時傳遞基本資料夾的URI
              //，以便可以找到HTML文件中具有相對URI的任何影象。
              LoadOptions loadOptions = new LoadOptions();
              loadOptions.setBaseUri(getImageDir());
      
              Document doc = new Document(stream，loadOptions);
      
              //驗證文件的第一個形狀包含有效影象。
              形狀shape =(Shape)doc.getChild(NodeType.SHAPE，0，true);
      
          Assert.assertTrue(shape.isImage());
          Assert.assertNotNull(shape.getImageData()。getImageBytes());
          Assert.assertEquals(32.0，ConvertUtil.pointToPixel(shape.getWidth())，0.01);
          Assert.assertEquals(32.0，ConvertUtil.pointToPixel(shape.getHeight())，0.01);
      }
          最後{if(stream！= null)stream.close(); }
      

使用預設值初始化此類的新例項。使用指定的密碼初始化此類的新例項以載入加密文件的快捷方式。用於將屬性設定為指定值的此類的新例項初始化的快捷方式。獲取或設定在需要時將用於將文件中找到的相對URI解析為絕對URI的字串。可以為null或空字串。預設為空。獲取或設定是否轉換圖元檔案(世界貨幣基金組織要麼電動勢)圖片到ng圖片格式。

• getConvertMetafilesToPng / setConvertMetafilesToPng

  public boolean getConvertMetafilesToPng()/ public void setConvertMetafilesToPng(boolean value)
  
  

  世界貨幣基金組織要麼電動勢)是未壓縮的影象格式，有時需要大量RAM來儲存和處理文件。此選項允許將所有圖元檔案影象轉換為ng關於文件載入。請注意-將向量圖形轉換為光柵會降低影象質量。

獲取或設定是否將帶有EquationXML的形狀轉換為Office Math物件。

• getConvertShapeToOfficeMath / setConvertShapeToOfficeMath

  public boolean getConvertShapeToOfficeMath()/ public void setConvertShapeToOfficeMath(boolean value)
  
  

如果未在文件中指定編碼，則獲取或設定將用於載入HTML，TXT或CHM文件的編碼。可以為null。預設為空。

• getEncoding / setEncoding

  公共java.nio.charset.Charset getEncoding()/公共無效setEncoding(java.nio.charset.Charset值)
  
  

  僅在載入HTML，TXT或CHM文件時使用此屬性。

  如果未在文件中指定編碼，並且此屬性為null，則系統將嘗試自動檢測編碼。

允許指定文件字型設定。

• getFontSettings / setFontSettings

  public FontSettings getFontSettings()/ public void setFontSettings(FontSettings value)
  
  

  載入某些格式時，Aspose.Words可能需要解析字型。例如，在載入HTML文件時，Aspose.Words可以解析字型以執行字型後備。

  如果設定為null，則為預設靜態字型設定FontSettings.DefaultInstance將會被使用。

  預設值為空。

獲取在載入文件時將使用的語言首選項。

• getLanguagePreferences

  公共LanguagePreferences getLanguagePreferences()
  
  

指定要載入的文件的格式。預設是載入格式。該屬性的值為LoadFormat整數常量。

• getLoadFormat / setLoadFormat

  public int getLoadFormat()/ public void setLoadFormat(int value)
  
  

  建議您指定載入格式值，然後讓Aspose.Words自動檢測檔案格式。如果知道要載入的文件的格式，則可以顯式指定格式，這將通過自動檢測格式帶來的開銷而略微減少載入時間。如果您指定了顯式載入格式，但結果卻是錯誤的，則將呼叫自動檢測並再次嘗試載入檔案。

  例：

  顯示開啟html文件時如何指定基本URI。

  //如果要載入.html文件，其中包含通過相對URI連結的影象
  //當圖片位於其他位置時，我們需要將相對URI解析為絕對的URI
  //通過建立HtmlLoadOptions並提供基本URI
  HtmlLoadOptions loadOptions =新的HtmlLoadOptions(LoadFormat.HTML，“”，getImageDir());
  
  Assert.assertEquals(LoadFormat.HTML，loadOptions.getLoadFormat());
  
  Document doc = new Document(getMyDir()+“ Missing image.html”，loadOptions);
  
  //當圖片在輸入.html中損壞時，已在我們的基本URI中成功找到它
  形狀imageShape =(Shape)doc.getChildNodes(NodeType.SHAPE，true).get(0);
  Assert.assertTrue(imageShape.isImage());
  
  //圖片將在輸出文件中正確顯示
  doc.save(getArtifactsDir()+“ HtmlLoadOptions.BaseUri.docx”);
  

允許指定文件載入過程應與特定的MS Word版本匹配。預設值為MsWordVersion.WORD_2007該屬性的值為MsWordVersion整數常量。

• getMswVersion / setMswVersion

  public int getMswVersion()/ public void setMswVersion(int value)
  
  

獲取或設定用於開啟加密文件的密碼。可以為null或空字串。預設為空。

• getPassword / setPassword

  公共java.lang.String getPassword()/公共無效setPassword(java.lang.String值)
  
  

  您需要知道密碼才能開啟加密的文件。如果文件未加密，請將其設定為null或空字串。

  例：

  顯示如何對加密的文件檔案進行簽名。

  //從PKCS＃12儲存區建立X.509證書，該儲存區應包含私鑰。
  CertificateHolder certificateHolder = CertificateHolder.create(getMyDir()+“ morzal.pfx”，“ aw”);
  
  //建立註釋，日期和解密密碼，這些密碼將與我們的新數字簽名一起使用。
  SignOptions signOptions = new SignOptions();
  {
  signOptions.setComments(“ Comment”);
      signOptions.setSignTime(new Date());
  signOptions.setDecryptionPassword(“ docPassword”);
  }
  
  //為未簽名的輸入文件設定本地系統檔名，為其新的數字簽名副本設定輸出檔名。
  字串inputFileName = getMyDir()+“ Encrypted.docx”;
  字串outputFileName = getArtifactsDir()+“ DigitalSignatureUtil.DecryptionPassword.docx”;
  
  DigitalSignatureUtil.sign(inputFileName，outputFileName，certificateHolder，signOptions);
  

獲取或設定在讀取Microsoft Word格式時是否保留INCLUDEPICTURE欄位。預設值為false。

• getPreserveIncludePictureField / setPreserveIncludePictureField

  public boolean getPreserveIncludePictureField()/ public void setPreserveIncludePictureField(boolean value)
  
  

  預設情況下，INCLUDEPICTURE欄位將轉換為形狀物件。如果需要保留欄位，例如，如果您希望以程式設計方式進行更新，則可以覆蓋該欄位。但是請注意，這種方法在Aspose.Words中並不常見。自行承擔使用風險。

  可能的一種使用情況可能是使用MERGEFIELD作為子欄位來動態更改圖片的源路徑。在這種情況下，您需要將INCLUDEPICTURE保留在模型中。

允許控制從HTML，MHTML匯入文件時如何載入外部資源(影象，樣式表)。

• getResourceLoadingCallback / setResourceLoadingCallback

  公共IResourceLoadingCallback getResourceLoadingCallback()/公共無效setResourceLoadingCallback(IResourceLoadingCallback值)
  
  

讀取文件時允許使用臨時檔案。預設情況下，此屬性為null並且不使用任何臨時檔案。

• getTempFolder / setTempFolder

  公共java.lang.String getTempFolder()/公共無效setTempFolder(java.lang.String值)
  
  

  該資料夾必須存在並且可寫，否則將引發異常。

  讀取完成後，Aspose.Words會自動刪除所有臨時檔案。

  例：

  顯示如何使用臨時檔案載入文件。

  //請注意，這種方法可以減少記憶體使用，但會降低速度。
  LoadOptions loadOptions = new LoadOptions();
  loadOptions.setTempFolder(“ C：\\ TempFolder \\”);
  
  //確保目錄存在並載入。
  新File(loadOptions.getTempFolder())。mkdir();
  
  Document doc = new Document(getMyDir()+“ Document.docx”，loadOptions);
  

指定是否使用dirty屬性更新欄位。

• getUpdateDirtyFields / setUpdateDirtyFields

  public boolean getUpdateDirtyFields()/ public void setUpdateDirtyFields(boolean value)
  
  

  例：

  顯示如何使用特殊屬性更新欄位結果。

  Document doc = new Document();
  DocumentBuilder builder =新的DocumentBuilder(doc);
  
  //提供文件的內建“ Author”屬性值，然後在欄位中顯示它。
  doc.getBuiltInDocumentProperties()。setAuthor(“ John Doe”);
  FieldAuthor欄位=(FieldAuthor)builder.insertField(FieldType.FIELD_AUTHOR，true);
  
  Assert.assertFalse(field.isDirty());
  Assert.assertEquals(“ John Doe”，field.getResult());
  
  //更新屬性。該欄位仍顯示舊值。
  doc.getBuiltInDocumentProperties()。setAuthor(“ John＆Jane Doe”);
  
  Assert.assertEquals(“ John Doe”，field.getResult());
  
  //由於該欄位的值已過期，因此我們可以將其標記為“髒”。
  //此值將保持過期，直到我們使用Field.Update()方法手動更新該欄位為止。
  field.isDirty(true);
  
  OutputStream docStream = new FileOutputStream(getArtifactsDir()+“ Filed.UpdateDirtyFields.docx”);
  嘗試{
      //如果我們儲存而未呼叫更新方法，
      //該欄位將繼續在輸出文件中顯示過期值。
      doc.save(docStream，SaveFormat.DOCX);
  
      // LoadOptions物件具有更新所有欄位的選項
      //載入文件時標記為“髒”。
      LoadOptions options = new LoadOptions();
      options.setUpdateDirtyFields(updateDirtyFields);
  
      doc = new Document(String.valueOf(docStream)，options);
  
      Assert.assertEquals(“ John＆Jane Doe”，doc.getBuiltInDocumentProperties()。getAuthor());
  
      field =(FieldAuthor)doc.getRange()。getFields()。get(0);
  
      //這樣更新髒字段會自動將其“ IsDirty”標誌設定為false。
      如果(updateDirtyFields)
      {
          Assert.assertEquals(“ John＆Jane Doe”，field.getResult());
          Assert.assertFalse(field.isDirty());
      }其他{
          Assert.assertEquals(“ John Doe”，field.getResult());
          Assert.assertTrue(field.isDirty());
      }
  }最後{
      如果(docStream！= null)docStream.close();
  }
  

在載入操作期間被呼叫，當檢測到可能導致資料或格式保真度損失的問題時。

• getWarningCallback / setWarningCallback

  公共IWarningCallback getWarningCallback()/公共無效setWarningCallback(IWarningCallback值)