Metoda ApplicationFactory.CreateSmartTag —
Tworzy SmartTag obiekt, który reprezentuje tagów inteligentnych w dokumencie.Ten typ lub element członkowski jest przeznaczony do stosowania wyłącznie w projektach dla systemu Microsoft Office 2007. W systemie Office 2010 tagi inteligentne nie są już używane.
.
Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)
Składnia
'Deklaracja
Function CreateSmartTag ( _
smartTagType As String, _
caption As String, _
extension As ISmartTagExtension _
) As SmartTag
SmartTag CreateSmartTag(
string smartTagType,
string caption,
ISmartTagExtension extension
)
Parametry
- smartTagType
Typ: System.String
Identyfikator unikatowy dla tagu inteligentnego, składający się z identyfikatora URI obszaru nazw i nazwę typu znacznika oddzielonych znakiem numeru (#).
- caption
Typ: System.String
Nazwa tagu inteligentnego, który będzie wyświetlany w menu tagu inteligentnego.
- extension
Typ: Microsoft.Office.Tools.Word.ISmartTagExtension
Opcjonalne.Obiekt rozszerzeń, która definiuje niestandardowy aparat rozpoznawania tagów inteligentnych.
Wartość zwracana
Typ: Microsoft.Office.Tools.Word.SmartTag
Nowy tag inteligentny.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentException | smartTagTypelub caption jest albo nullodwołanie o wartości null (Nothing w języku Visual Basic) lub jest pusty, lub smartTagType jest nieprawidłowa. |
Uwagi
Przykładem prawidłowy ciąg dla smartTagType parametr jest http://smarttags.contoso.com#TagName.Ciąg typu poprawnie sformułowany tag inteligentny nie zawiera owiatło i zaczyna się od litery (a–z, A–z), znaku podkreślenia (_) lub dwukropka (:).)
Przykłady
Poniższy przykład kodu pokazuje sposób tworzenia tagów inteligentnych i akcji w projekcie dodatek programu Word.Aby wykorzystać ten przykład, należy uruchomić kod z ThisAddIn klasy.
Dim simpleSmartTag As Microsoft.Office.Tools.Word.SmartTag =
Globals.Factory.CreateSmartTag(
"www.microsoft.com/Demo#DemoSmartTag",
"Test Smart Tag")
Dim simpleAction As Microsoft.Office.Tools.Word.Action =
Globals.Factory.CreateAction("Test Action")
simpleSmartTag.Terms.Add("blue")
simpleSmartTag.Actions = New Microsoft.Office.Tools.Word.Action() { _
simpleAction}
Me.VstoSmartTags.Add(simpleSmartTag)
Microsoft.Office.Tools.Word.SmartTag simpleSmartTag =
Globals.Factory.CreateSmartTag(
"www.microsoft.com/Demo#DemoSmartTag",
"Test Smart Tag");
Microsoft.Office.Tools.Word.Action simpleAction =
Globals.Factory.CreateAction("Test Action");
simpleSmartTag.Terms.Add("blue");
simpleSmartTag.Actions = new Microsoft.Office.Tools.Word.Action[] {
simpleAction };
this.VstoSmartTags.Add(simpleSmartTag);
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..