customUI 元素

選擇性 的 customUI 元素會指定要顯示在用戶端電腦上的自定義使用者介面。

customUI 元素定義在此 URI 的 asyncui 命名空間中：

https://schemas.microsoft.com/2003/print/asyncui/v1/request

某些語言和國家/地區可能無法使用此資源。

使用方式

<customUI
  dll = "xs:string"
  entrypoint = "xs:string"
  bidi = "xs:string">
  child elements
</customUI>

屬性

屬性	類型	必要	Description
bidi	xs:string	Yes	必要屬性，指定印表機驅動程式與事件通知訊息之間的通訊類型。 如果值為 true，則通訊是雙向的，而且資源 DLL 中的驅動程式函式必須傳回字串;請參閱範例一節。 如果值為 false，則通訊是單向通訊，從印表機驅動程式到事件通知訊息。
Dll	xs:string	Yes	必要屬性，指定包含自定義使用者介面顯示函式的資源 DLL。 此 DLL 應該是印表機驅動程式的相依檔案，而且必須存在於驅動程式資源資料夾中 (，例如%SYSTEMROOT%\system32\spool\drivers\w32x86\3) 。
entrypoint	xs:string	Yes	必要屬性，指定要在資源 DLL 中呼叫的函式。

子元素

元素	Description
什麼	根據自定義使用者介面架構指定任何子專案。 請參閱＜範例＞一節。

父元素

元素	Description
requestOpen	用來在用戶端電腦上開啟事件通知訊息的專案。

備註

由於 bidi 屬性在下列範例中設定為 true，因此將會呼叫 Abc.dll DLL 中的 IHVFunction 進入點函式。 IHVfunction 會傳回 CDATA 類型數據。

範例

下列程式代碼範例示範如何使用 customUI 元素來呼叫和顯示用戶端電腦上的自定義使用者介面。

<?xml version="1.0"?>
  <asyncPrintUIRequest xmlns="https://schemas.microsoft.com/2003/print/asyncui/1.0"
      xmlns:myco="https://www.myprintercompany.com">
    <requestOpen>
      <customUI dll="abc.dll" entrypoint="IHVFunction" bidi="true">
        <IHV:anyXMLData />
          CDATA
      </customUI>
    </requestOpen>
  </asyncPrintUIRequest>

另請參閱

requestOpen