Echelon LonMaker - Handbuch (Seite 277)

LcaSubsystemName Ein BSTR-Wert, der den Namen des LonMaker Subsystems
angibt, in dem sich das benutzerdefinierte LNS ActiveX-
Steuerelement befindet. Der Name kann vom benutzerdefinierten
LNS ActiveX-Steuerelement zur Implementierung der relativen
Subsystemadressierung verwendet werden. Diese Eigenschaft ist
optional.
LcaUserName Ein BSTR-Wert, der den aktuellen LonMaker Benutzernamen für
die Anmeldung angibt. Der Wert kann vom benutzerdefinierten
LNS ActiveX-Steuerelement zum Beschränken des
Benutzerzugriffs auf das Steuerelement verwendet werden. Diese
Eigenschaft ist optional.
LcaValue Ein
BSTR
-Wert, der den aktuellen LNS Wert angibt
(Netzwerkvariable, Konfigurationseigenschaft oder
Überschreibstatus). Wenn das benutzerdefinierte LNS ActiveX-
Steuerelement beispielsweise für das Aktualisieren einer
Eingangsvariablen oder Konfigurationseigenschaft festgelegt ist,
wird mit dieser Eigenschaft der festzulegende Eingangswert
angegeben. Ist das Steuerelement zum Überwachen einer
Netzwerkvariablen festgelegt, wird mit dieser Eigenschaft der
Überwachungswert gespeichert, sodass er abgerufen werden kann.
Diese Eigenschaft ist optional.
Benutzerdefiniertes, auf LNS basierendes ActiveX-
Steuerelement – Beispiel
BEGIN_DISPATCH_MAP(CMyControl, COleControl)
//{{AFX_DISPATCH_MAP(CMyControl)
DISP_PROPERTY_EX(CMyControl,
"LcaDispatch",
GetLcaDispatch, SetLcaDispatch, VT_DISPATCH)
DISP_PROPERTY_EX(CMyControl,
"LcaUserName",
GetLcaUserName, SetLcaUserName, VT_BSTR)
DISP_PROPERTY_EX(CMyControl,
"LcaSubsystemName",
GetLcaSubsystemName, SetLcaSubsystemName, VT_BSTR)
DISP_PROPERTY_EX(CMyControl,
"LcaActive",
GetLcaActive, SetLcaActive, VT_BOOL)
DISP_PROPERTY_EX(CMyControl, "LcaValue", GetLcaValue,
SetLcaValue, VT_VARIANT)
:
//}}AFX_DISPATCH_MAP
END_DISPATCH_MAP()
LPDISPATCH CMyControl::GetLcaDispatch() {
return m_LcaDispatch;
}
void CMyControl::SetLcaDispatch(LPDISPATCH newValue) {
// HINWEIS: Bei der Verwendung der Get/Set-
// Eigenschaftsmethode zur Weitergabe eines
// Schnittstellenzeigers ist der Zeiger AddRef-ed vor
// der Set-Routine, jedoch Released bei der Rückgabe.
// Das ist nicht der Fall, wenn die Membervariablen-
// Eigenschaftsmethode verwendet wird (der Zeiger ist
LonMaker Benutzerhandbuch 12-13