Właściwość LinkTopic

Właściwość LinkTopic dla kontrolek-celów konwersacji DDE, zwraca lub ustala aplikację-źródło i temat połączenia (podstawowy zbiór danych używanych w aplikacji) Aby ustalić całkowite połączenie należy określić właściwości LinkTopic i LinkItem.
Dla form-źródeł - ustala lub zwraca temat dla formy-źródła odpowiedającej na konwersację DDE.

Składnia właściwości LinkTopic:

obiekt.LinkTopic [= wartość]

Składnia właściwości LinkTopic składa się z części:

obiekt	obiekt który wykorzystuje właściwość LinkTopic, dostępny na liście
wartość	Wyrażenie łańcuchowe określające element DDE

Właściwość LinkTopic zawiera łańcuch, który jest częścią informacji koniecznej do ustanowienia połączenia zarówno celu jak i źródła. Łańcuch ten zależy od wykorzystywanej kontrolki-celu lub formy-źródła. Każdy łańcuch odpowiada jednemu lub więcej elementowi składni DDE, która zawiera aplikację, temat, element.

Standartowe definicja połączenia DDE zawiera aplikację, temat, element. Jednak składnia ta zależy od aplikacji, w której jest wykorzystywana. Np. Microsoft Excel wykorzystuje składnię:

aplikacja|temat!element

Microsoft Word wykorzystuje:

aplikacja temat element

Visual Basic wykorzystuje składnię:

aplikacja|temat

Kontrolki-cele
Aby ustalić właściwość LinkTopic kontrolki-celu, należy użyć składni aplikacja|temat:

aplikacja jest nazwą aplikacji, z której pochodzą dane, zwykle jest to nazwa pliku bez rozszerzenia - np. Excel (dla Microsoft Excel)
znak | oddziela aplikację od tematu
temat jest podstawowym zbiorem danych używanych w aplikacji-źródle - np. arkusz w Microsoft Excel

Dodatkowo, dla kontrolki-celu należy ustalić właściwość LinkItem, określajacy, który element ma zostać połączony, jak np. komórki (np. W1K1) arkusza Microsoft Excel.

Formy-źródła
Właściwość LinkTopic dla formy-źródła nalezy ustawić na indentyfikator formy. Aplikacja-cel używa tego łańcucha jako tematu podczas ustanawiania konwersacji DDE z formą. Chociaż łańcuch ten wystarczy dla formy-źródła Visual Basic, to aplikacja-cel wymaga dodatkowo:

składnik aplikacja wykorzystywany przez apliację-cel, który jest nazwą projektu Visual Basic (bez rozszerzenia .vbp) - jeżeli aplikacja jest uruchamiana pod kontrolą środowiska Visual Basic, lub nazwą pliku aplikacji Visual Basic (bez rozszerzenia .exe) - jeżeli jest uruchamiana jako plik wykonywalny. Właściwość EXEName obiektu App zwraca ten łańcuch, chyba, że nazwa pliku została zmieniona przez użytkownika (EXEName zawsze zwraca aktulalną nazwę pliku aplikacji natomiast DDE zawsze wykorzystuje oryginalną nazwę określoną w oknie dialogowym Project Properties)
element wykorzystywany przez aplikację-cel, odpowiada właściwości Name kontrolki Label, PictureBox lub TextBox na formie-źródle

Poniższa składnia jest przykładem poprawnego odwołania z Microsoft Excel do aplikacji Visual Basic jako źródła:

=Project1|Form1!Text1

Można wprowadzić to odwołanie do komórki-celu Microsoft Excel. A właściwości formy nalezy ustawić na LinkMode=Source, LinkTopic=Form1

Aby aktywować połączenie danych ustawione przez LinkTopic należy ustawić właściwość LinkMode na odpowiednią niezerową wartość, aby określić typ połączenia. Z zasady, właściwość LinkMode ustawia się po ustawieniu właściwości LinkTopic. Dla kontrolek-celów, zmiana właściwości LinkTopic przerwie istniejące połączenie i przerywa konwersację DDE. Dla form-źródeł, zmiana właściwości LinkTopic przewie wszystkie połączenia celu, które używają tego tematu. Z tego powodu, zawsze należy ustawiać właściwość LinkMode na 0 przed zmianą właściwości LinkTopic. Po zmianie właściwości LinkTopic dla kontrolki-celu, należy ustawić LinkMode na 1 (Automatic), 2 (Manual) or 3 (Notify) aby ustanowić połączenie dla nowego tematu.

Trwałe połączenie w fazie projektowania przez użycie polecenia Paste Link z menu Edit również ustawia właściwości LinkMode, LinkTopic i LinkItem. Tworzy to połączenie, które jest zapisywane z formą. Za każdym razem, gdy forma jest ładowana, Visual Basic próbuje ponownie ustanowić konwersację.

Lista obiektów wykorzystujących właściwość LinkTopic:
Form
Label
MDIForm
PictureBox
TextBox

na górę strony...