Eventy obiektu Application - Symfonia ERP Finanse i Księgowość

Eventy wysyłane są przez obiekt aplikacji (OA) do wszystkich obiektów typu com, które "podłączyły" się do obiektu aplikacji.

TemplateCreate

Bezpośrednio po załadowaniu templejtów są one przeglądane w pętli i dla każdego z nich tworzone są obiekty menu (CommandBar, CommandBarButton itd.) i odpalany jest ten event. Również dla menu niezwiązanych bezpośrednio z template (menu default-owe + menu firmowe przy zamkniętych oknach zakładek) ten event jest odpalany. Pozwala na manipulowanie elementami menu. Pozwala również "podłączyć" się ze swoim menu tylko do wybranych template w określony sposób (np. inaczej dla stanu bezfirmowego, inaczej dla stanu firmowego etc.).

Dane wejściowe

Nazwa	Typ VBA	Typ Tlb	Opis
TemplName	String	BSTR	Nazwa template, który jest tworzony lub "DefaultMenu" dla menu default-owego (które nie pochodzi z template). Również dla których menu, które nie pochodzą z template będą to ich nazwy ("DefaultMenuXXX") gdy w templejcie brakuje nazwy będzie to "MenuXXX". UWAGA! Nie ma gwarancji unikalności nazw. Należy w resource-ach ewentualnie o to zadbać
Bar	CommandBar	CommandBar*	Command Bar odpowiadający menu dla danego template Poprzez ten obiekt jest dostęp do wszystkich elementów menu i możliwość dowolnej modyfikacji (dodawanie, usuwanie, zmiana tekstu, zmiana reakcji etc.)

CreatedAmControl

Obiekt aplikacji odpala event, zmianie kontrolki w panelu okna. Kontrolka mogła zostać utworzona lub skasowana. Jeżeli w danym panelu istniała już kontrolka to jest ona niszczona, tworzona jest nowa, a następnie odpalany jest event.

Dane wejściowe

Nazwa	Typ VBA	Typ Tlb	Opis
CtrlType	AmControlType	AmControlType	Typ kontrolki utworzonej w panelu okna
IpCtrl	Object	LPDISPATCH	Dispatch obiektu utworzonego w oknie (np. MXGrid, WebBrowser, NULL)
PaneNo	Long	long	Numer panelu okna, w którym została utworzona kontrolka

TryToOpen

Event odpalany jest przed otwarciem dokumentu (zarówno pliku sbc, jak i dokumentu FK), przekazywany jest kolejno do wszystkich "subskrybentów", jeżeli którykolwiek ustawi parametr Cancel na True – procedura zostaje przerwana. Wykorzystanie tego eventu pozwala na pewne przekierowanie – np. zamiast standardowego okna FK można uruchomić nowe okno VBA.

Dane wejściowe

Nazwa	Typ VBA	Typ Tlb	Opis
Category	String	BSTR	Nazwa grupy np. "Konto"
Group	String	BSTR	Nazwa grupy np. "Konto"
ActionType	AmOpenAction	AmOpenAction	Rodzaj podejmowanej akcji: amOAUnknown, amOAReport, amOALink, amOATemplate, amOABookmark, amOAVBADoc

Dane wejściowo / wyjściowe

Nazwa	Typ VBA	Typ Tlb	Opis
Name	String	BSTR*	Np. "Obroty konta" lub ścieżka do pliku sbc. Nazwa może zostać zmieniona przez użytkownika – wtedy nazwa zostanie potraktowana jak ścieżka do pliku sbc i zostanie podjęta próba otworzenia tego pliku.
Cancel	Boolean	VARIANT_BOOL*	Parametr wejściowo – wyjściowy. Jeżeli zostanie ustawiony na True procedura wysyłania eventów do kolejnych subskrybentów zostanie przerwana, a akcja przerwana. Jeżeli "Nazwa" została zmieniona zostanie podjęta próba otwarcia dokumentu sbc nawet jeżli parametr cancel został ustawiony na True.

OnFirmaOpen

Uruchamianie tego eventu związane jest z otwarciem firmy.

Nazwa	Typ VBA	Typ Tlb	Opis
DBName	String	BSTR	String opisujący połączenie z bazą danych dla firmy
UserName	String	BSTR	Nazwa użytkownika, który próbuje otworzyć firmę
EvType	AmEventState	AmEventState	Typ eventu; etap wykonywania akcji – pytanie (amAsk), przed (amBegin) po (amEnd)
Cancel	Boolean	[in]VARIANT_BOOL [out] VARIANT_BOOL*	Informacja zwrotna ustawiana w obsłudze eventu. Ustawienie na True powoduje zaniechanie akcji. Parametr ten jest weryfikowany tylko w przypadku eventu typu amAsk.

OnFirmaClose

Event związany jest z zamykaniem firmy.

Nazwa

Typ VBA

Typ Tlb

Opis

EvType

AmEventState

Typ eventu; etap wykonywania akcji – pytanie (amAsk), przed (amBegin) po (amEnd)

Cancel

Boolean

[in]VARIANT_BOOL

[out] VARIANT_BOOL*

Informacja zwrotna ustawiana w obsłudze eventu. Ustawienie na True powoduje zaniechanie akcji. Parametr ten jest weryfikowany tylko w przypadku eventu typu amAsk.

OnRokOpen

Event związany jest z otwieraniem roku

Nazwa

Typ VBA

Typ Tlb

Opis

EvType

AmEventState

Typ eventu; etap wykonywania akcji – pytanie (amAsk), przed (amBegin) po (amEnd)

Cancel

Boolean

[in]VARIANT_BOOL

[out] VARIANT_BOOL*

Informacja zwrotna ustawiana w obsłudze eventu. Ustawienie na True powoduje zaniechanie akcji. Parametr ten jest weryfikowany tylko w przypadku eventu typu amAsk.

OnRokClose

Event związany jest z zamykaniem roku

Nazwa

Typ VBA

Typ Tlb

Opis

EvType

AmEventState

Typ eventu; etap wykonywania akcji – pytanie (amAsk), przed (amBegin) po (amEnd)

Cancel

Boolean

[in]VARIANT_BOOL

[out] VARIANT_BOOL*

Informacja zwrotna ustawiana w obsłudze eventu. Ustawienie na True powoduje zaniechanie akcji. Parametr ten jest weryfikowany tylko w przypadku eventu typu amAsk.

OnEventAp

Event ogólnego przeznaczenia

Nazwa	Typ VBA	Typ Tlb	Opis
Name	Strin	BSTR	Nazwa akcji, o której informuje ten event
EvType	AmEventState	AmEventState	Typ eventu; etap wykonywania akcji – pytanie (amAsk), przed (amBegin) po (amEnd)
Par1	Variant	VARIANT	Parametr ogólnego przeznaczenia
Par2	Variant	VARIANT	Parametr ogólnego przeznaczenia
Cancel	Boolean	VARIANT_BOOL*	Informacja zwrotna ustawiana w obsłudze eventu. Ustawienie na True powoduje zaniechanie akcji. Parametr ten jest weryfikowany tylko w przypadku eventu typu amAsk.

DocumentOpen

Event ten jest odpalany podczas obsługi otwierania dokumentu SBC.

Nazwa	Typ VBA	Typ Tlb	Opis
Path	String	BSTR	Ścieżka do pliku SBC, który jest otwierany
EvType	AmEventState	AmEventState	Parametr przyjmuje wartość AmAsk gdy można anulować zamykanie dokumentu (parametr Cancel) lub amBegin, gdy rozpoczyna się zamykanie dokumentu.
Doc	Document	IDualDocument	Obiekt otwartego dokumentu, parametr jest wypełniony tylko wtedy, gdy EvType = amEnd, czyli gdy dokument został poprawnie otwarty.
Cancel	Boolean	VARIANT_BOOL*	Parametr, który pozwala na anulowanie otwierania pliku, brany jest pod uwagę tylko w przypadku, gdy EvType = amAsk

DocumentClose

Event jest odpalany podczas obsługi zamykania dokumentu SBC.

Nazwa	Typ VBA	Typ Tlb	Opis
Name	String	BSTR	Tytuł dokumentu (zwykle wyświetlany jako nazwa okna MDI)
EvType	AmEventState	AmEventState	Parametr przyjmuje wartość AmAsk gdy można anulować zamykanie dokumentu (parametr Cancel) lub amBegin, gdy rozpoczyna się zamykanie dokumentu.
Doc	Document	IDualDocument	Obiekt zamykanego dokumentu, parametr jest wypełniony wtedy, gdy EvType = amAsk lyb amBegin, czyli gdy dokument nie został jeszcze zamknięty.
Cancel	Boolean	VARIANT_BOOL*	Parametr, który pozwala na anulowanie zamykania dokumentu, brany jest pod uwagę tylko w przypadku gdy EvType = AmAsk

DocumentNew

Event ten jest odpalany podczas obsługi tworzenia nowego dokumentu SBC.

Nazwa	Typ VBA	Typ Tlb	Opis
EvType	AmEventState	AmEventState	Parametr przyjmuje wartość AmAsk gdy można anulować zamykanie dokumentu (parametr Cancel) lub amBegin, gdy rozpoczyna się zamykanie dokumentu.
Doc	Document	IDualDocument	Obiekt nowo utworzonego dokumentu, parametr jest wypełniony tylko wtedy, gdy EvType = amEnd, czyli gdy dokument został poprawnie utworzony.
Cancel	Boolean	VARIANT_BOOL*	Parametr, który pozwala na anulowanie tworzenia nowego dokumentu, rany jest pod uwagę tylko w przypadku, gdy EvType = amAsk.

Eventy Application