本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

SmartTagRecognizeContext.PersistTag 方法 (ISmartTagProperties)

 

發佈時間: 2016年4月

存放關於智慧標籤的資訊。

此類型或成員僅適用於 2007 Microsoft Office 系統的專案。智慧標籤在 Office 2010 中已被取代。

.

命名空間:   Microsoft.Office.Tools.Excel
組件:  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

void PersistTag(
	ISmartTagProperties propertyBag = null
)

參數

propertyBag

內含語彙基元 (Token) 索引鍵值組的屬性包。 可以是 null

Exception Condition
InvalidOperationException

PersistTag 不是從 Recognize 方法呼叫的。

Recognize 方法的實作呼叫 PersistTag,表示在文字中找到智慧標籤。 使用 propertyBag 參數認可智慧標籤的任何自訂屬性。 您可以使用這些屬性,自訂在選取智慧標籤捷徑功能表項目時所採取的動作。

下列程式碼範例示範如何從 Recognize 方法的實作呼叫 PersistTag 這項實作會將每個智慧標籤詞彙與儲存格內容做比較。 程式碼會針對儲存格中的每個智慧標籤詞彙分別加入自訂智慧標籤屬性,然後使用 PersistTag 方法辨認智慧標籤。 本範例假設您已從 [加入參考] 對話方塊的 [.NET] 索引標籤,新增 [Microsoft.Office.Interop.SmartTag] 的參考。 這個程式碼範例是 ISmartTagExtension 介面完整範例的一部分。

void ISmartTagExtension.Recognize(string text, ISmartTagRecognizerSite site, 
    ISmartTagTokenList tokenList, SmartTagRecognizeContext context)
{

    // Determine whether each smart tag term exists in the document text.
    foreach (string term in smartTagDemo.Terms)
    {
        // Search the cell text for the first instance of the current smart tag term.
        int index = context.CellText.IndexOf(term, 0);

        if (index >= 0)
        {
            // Create a smart tag token and a property bag for the recognized term.
            ISmartTagProperties propertyBag = site.GetNewPropertyBag();

            // Write a new property value.                 
            string key = "Key1";
            propertyBag.Write(key, DateTime.Now.ToString());

            // Attach the smart tag to the term in the document
            context.PersistTag(propertyBag);

            // This implementation only finds the first instance of a 
            // smart tag term in the cell. 
            break;
        }
    }
}
回到頁首
顯示: