ON_EVENT_RANGE

Artykuł
02/27/2013

Użyj ON_EVENT_RANGE makra, aby zdefiniować funkcję obsługi zdarzenia dla zdarzenia wywoływane przez dowolny formant OLE, posiadające identyfikator formantu w ciągły zakres identyfikatorów.

ON_EVENT_RANGE(theClass, idFirst, idLast, dispid, pfnHandler, vtsParams )

Parametry

theClass
Klasy, do której należy ta mapa obiektu sink zdarzenia.
idFirst
Identyfikator formantu pierwszego formantu OLE w zakresie.
idLast
Identyfikator ostatniego formantu OLE w zakresie kontroli.
dispid
Identyfikator wysyłki zdarzenia wywoływane przez formant.
pfnHandler
Wskaźnik do funkcji składowej, która obsługuje zdarzenie.Ta funkcja powinna mieć BOOL zwraca typ, pierwszy parametr typu UINT (dla Identyfikatora formantu) i typach parametru dodatkowe parametry zdarzenia (zobacz vtsParams).Funkcja powinna zwrócić TRUE do wskazania obsłużono zdarzenie; w przeciwnym razie FALSE.
vtsParams
Sekwencja VTS_ stałych, które określa typy parametrów dla zdarzenia.Pierwszej stałej powinny być typu VTS_I4, identyfikator formantu.Są to ten sam stałych, które są używane w wpisów map wysyłki, takie jak DISP_FUNCTION.

Uwagi

vtsParams Argument jest rozdzielaną spacjami listę wartości z VTS_ stałych.Jeden lub więcej z tych wartości oddzielonych spacjami (nie przecinkami) określa listy parametrów funkcji.Na przykład:

VTS_I2 VTS_BOOL

Określa listę zawierającą krótka liczba całkowita, następuje BOOL.

Aby uzyskać listę VTS_ , zobacz EVENT_CUSTOM.

Przykład

Poniższy przykład ilustruje obsługi zdarzenia dla zdarzenia MouseDown, wprowadzone w życie trzy formanty (IDC_MYCTRL1 przez IDC_MYCTRL3).Funkcji obsługi zdarzenia OnRangeMouseDown, jest zadeklarowany w pliku nagłówkowym klasy okna dialogowego (CMyDlg) jako:

BOOL OnRangeMouseDown(UINT CtlID, short MouseButton, short Shift,
   long x, long y);

Poniższy kod jest zdefiniowany w pliku implementacji klasy okna dialogowego.

BEGIN_EVENTSINK_MAP(CMyDlg, CDialog)
   ON_EVENT_RANGE(CMyDlg, IDC_MYCTRL1, IDC_MYCTRL3, -605, OnRangeMouseDown,
      VTS_I4 VTS_I2 VTS_I2 VTS_I4 VTS_I4)
END_EVENTSINK_MAP()