Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender


瀏覽文字

圖 14中的此函數群組會找出要以高亮度標示的術語。然後再啟動瀏覽階段作業、 開啟文件,並取得形式為應用程式(會呼叫瀏覽器)可剖析之資料串流的相符資訊。

取得瀏覽資訊 (DesGetBrowseInfo)

DesGetBrowseInfo 函數會接收搜尋引數及 handle。 並傳回 DesStartBrowseSession 所需之瀏覽資訊的指標。 瀏覽資訊包括要以高亮度標示的所有術語列示。

另一種取得瀏覽資訊的方法是在 DesGetSearchResultTable 函數中指定「瀏覽」選項。

輸入

輸入參數為:

資料庫連接的 handle

handle

搜尋引數。

輸出

此函數會傳回瀏覽資訊的指標。

啟動瀏覽階段作業 (DesStartBrowseSession)

DesStartBrowseSession 函數會啟動瀏覽階段作業, 建立瀏覽文字文件時所需的環境,並以高亮度標示相符的項目。 它會接收指向瀏覽資訊的指標 (接收來源可能是 DesGetBrowseInfo 或 DesGetSearchResultTable), 並且會傳回要供其它瀏覽函數使用的瀏覽階段作業 handle。

輸入

輸入參數為:

來自 DesGetBrowseInfo 或 DesGetSearchResultTable 的瀏覽資訊指標

使用者 ID

通行碼。

輸出

此函數會傳回瀏覽階段作業的 handle。

開啟文件 (DesOpenDocument)

DesOpenDocument 函數會接收瀏覽階段作業指標、handle, 及 DES_FAST 或 DES_EXTENDED 選項 (可指出高亮度標示之找到術語所用的語言處理類型)。請參閱階段 2:擴充相符。 DES_FAST 會使用基本文字分析(不使用字典)來決定要用高亮度標示的術語。DES_EXTENDED 使用的是擴充相符。

DesOpenDocument 會準備與 handle 對應的文字文件, 以取得文件文字及高亮度標示資訊, 且會傳回互動呼叫 DesGetMatches 所用的文件 handle。

輸入

輸入參數為:

來自 DesStartBrowseSession 的瀏覽階段作業 handle

文字 handle

相符選項:DES_FAST 或 DES_EXTENDED。

輸出

此函數會傳回 DesGetMatches 及 DesCloseDocument 所用的文件 handle。

取得符合項目 (DesGetMatches)

DesGetMatches 函數會傳回文字文件(文件 handle 所說明的文件) 的高亮度標示資訊指標。高亮度標示資訊為一資料串流。 它包含文字上下文 (至少一個段落) 及該上下文中的強調顯示文字的資訊。 在資料串流語法中會說明資料串流。應用程式可剖析資料串流, 並使用使用者自己的瀏覽器來處理它。

DesGetMatches 只會傳回一部份的資料串流,表示該部份在輸出結構中的長度。

呼叫 DesGetMatches 的序列可取得整個文字文件內容。 到達文字文件結尾時,會傳回指示符。

輸入

輸入參數為:

瀏覽階段作業 handle

來自 DesOpenDocument 的文件 handle。

輸出

此函數會傳回含有資料串流部份及其長度的指標給結構。

關閉文件 (DesCloseDocument)

DesCloseDocument 函數會關閉 DesOpenDocument 所開啟的文字文件, 並釋出傳回文件文字及高亮度標示資訊期間所配置的儲存體。

輸入

輸入參數為:

瀏覽階段作業 handle

來自 DesOpenDocument 的文件 handle。

輸出

無。

End 鍵瀏覽階段作業 (DesEndBrowseSession)

DesEndBrowseSession 函數會結束 DesStartBrowseSession 所啟動的瀏覽階段作業, 並釋出配置給瀏覽階段作業的儲存體。

輸入

輸入參數為:

瀏覽階段作業控點。

輸出

無。

清出瀏覽資訊 (DesFreeBrowseInfo)

DesFreeBrowseInfo 函數會清出 DesGetBrowseInfo 配置給瀏覽資訊的儲存體。

輸入

輸入參數為:

瀏覽資訊的指標。

輸出

無。


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]