QbSetAutoCatalog API 或 SET QBIC AUTOCATALOG 指令, 可用來將自動編目變更為手動編目,或從手動變為自動。
在變更型錄設定之前,必須開啟用於更新的 QBIC 型錄。
變更不會追溯既往:當您變更自動編目設定時,僅在變更後才引用到 加入使用者表格直欄中的影像。已儲存在使用者表格直欄中的影像不會受到影響。例如,如果您將設定從手動編目變更為自動編目, 則只有變更後加入使用者表格直欄中的影像會自動被編目。如果要將已存在於表格直欄中的影像編入型錄,您必須以手動方式編目它們。(有關如何手動將影像編入型錄的資訊,請參閱手動編目影像。)
使用 API:在使用 QbSetAutoCatalog API 時,指定 QBIC 型錄的 handle (使用 QbOpenCatalog API 開啟型錄時,將傳回該 handle)。 並指定自動編目值 1 代表自動編目,或 0 值代表手動編目。
在下列範例中,為 QBIC 型錄指定手動編目,此型錄與員工表格圖形直欄中的影像相關聯。 請注意:首先開啟的是更新 QBIC 型錄的作業所使用的型錄。
SQLINTEGER mode; SQLINTEGER autoCatalog=0; /* manual cataloging */ QbCatalogHandle *CatHdl; mode=qbiUpdate; /* open catalog for */ /* update */ /* Open a QBIC catalog */ rc=QbOpenCatalog( "employee", /* user table */ "picture", /* image column */ mode, /* open catalog mode */ &CatHdl); /* catalog handle */ /* Change the auto catalog setting */ rc=QbSetAutoCatalog( CatHdl, /* catalog handle */ autoCatalog); /* auto catalog flag */
使用指令行:在發出 SET QBIC AUTOCATALOG 指令時,您可以指定 ON 來指示自動編目。指定 OFF 表示手動編目。此指令可作用於目前開啟的型錄。
例如,下列指令可為目前開啟的 QBIC 型錄,將自動編目設成 off:
SET QBIC AUTOCATALOG off