MCHITTESTINFO-Struktur (commctrl.h)

  • Artikel

Enthält spezifische Informationen zu Treffertestpunkten für ein Monatskalendersteuerelement. Diese Struktur wird mit der MCM_HITTEST-Nachricht und dem entsprechenden MonthCal_HitTest-Makro verwendet.

Syntax

typedef struct {
  UINT       cbSize;
  POINT      pt;
  UINT       uHit;
  SYSTEMTIME st;
  RECT       rc;
  int        iOffset;
  int        iRow;
  int        iCol;
} MCHITTESTINFO, *PMCHITTESTINFO;

Member

cbSize

Typ: UINT

Die Größe dieser Struktur in Bytes.

pt

Typ: POINT

Punkt, der treffergeprüft werden soll.

uHit

Typ: UINT

Ausgabeelement, das ein Bitflag empfängt, das das Ergebnis des Treffertestvorgangs darstellt. Dieser Wert ist einer der folgenden:

Wert Bedeutung
MCHT_CALENDARBK
 Der angegebene Punkt befand sich im Hintergrund des Kalenders.
MCHT_CALENDARCONTROL
 Der angegebene Punkt befindet sich außerhalb eines Kalenders, aber innerhalb des Kalenders steuert RECT.
MCHT_CALENDARDATE
 Der angegebene Punkt befand sich an einem bestimmten Datum innerhalb des Kalenders. Die SYSTEMTIME-Struktur bei lpMCHitTest>st wird auf das Datum am angegebenen Punkt festgelegt.
MCHT_CALENDARDATEMIN
 Der angegebene Punkt lag über den Mindestdatum(n) im Kalender.
MCHT_CALENDARDATEMAX
 Der angegebene Punkt lag über den maximalen Datumsangabe(n) im Kalender.
MCHT_CALENDARDATENEXT
 Der angegebene Punkt lag über einem Datum aus dem nächsten Monat (teilweise angezeigt am Ende des aktuell angezeigten Monats). Wenn der Benutzer hier klickt, scrollt der Monatskalender in seiner Anzeige bis zum nächsten Monat oder einer Reihe von Monaten.
MCHT_CALENDARDATEPREV
 Der angegebene Punkt lag über einem Datum aus dem vorigen Monat (teilweise am Ende des aktuell angezeigten Monats angezeigt). Wenn der Benutzer hier klickt, scrollt der Monatskalender in seiner Anzeige auf den vorherigen Monat oder auf einen Satz von Monaten.
MCHT_CALENDARDAY
 Der angegebene Punkt war mehr als eine Tageskürzel ("Fri", z. B. ). Die SYSTEMTIME-Struktur bei lpMCHitTest>st wird auf das entsprechende Datum in der obersten Zeile festgelegt.
MCHT_CALENDARWEEKNUM
 Der angegebene Punkt lag über eine Wochenzahl (nur MCS_WEEKNUMBERS Formatvorlage). Die SYSTEMTIME-Struktur bei lpMCHitTest>st wird auf das entsprechende Datum in der spalte ganz links festgelegt.
MCHT_NOWHERE
 Der angegebene Punkt befand sich nicht im Monatskalendersteuerelement oder in einem inaktiven Teil des Steuerelements.
MCHT_TITLEBK
 Der angegebene Punkt lag über dem Hintergrund des Titels eines Monats.
MCHT_TITLEBTNNEXT
 Der angegebene Punkt befand sich über der Schaltfläche in der oberen rechten Ecke des Steuerelements. Wenn der Benutzer hier klickt, scrollt der Monatskalender in seiner Anzeige bis zum nächsten Monat oder einer Reihe von Monaten.
MCHT_TITLEBTNPREV
 Der angegebene Punkt befand sich über der Schaltfläche in der oberen linken Ecke des Steuerelements. Wenn der Benutzer hier klickt, scrollt der Monatskalender in seiner Anzeige auf den vorherigen Monat oder auf einen Satz von Monaten.
MCHT_TITLEMONTH
 Der angegebene Punkt befand sich in der Titelleiste eines Monats, und zwar über einen Monatsnamen.
MCHT_TITLEYEAR
 Der angegebene Punkt befand sich in der Titelleiste eines Monats über dem Jahreswert.

st

Typ: SYSTEMTIME

Empfängt Datums- und Uhrzeitinformationen, die spezifisch für den Ort sind, an dem der Treffer getestet wurde.

rc

Typ: RECT

Standort mit Treffertest.

iOffset

Typ: int

Bei der Anzeige mehrerer Kalender ist dies der Offset des Kalenders am treffergeprüften Punkt (nullbasiert).

iRow

Typ: int

Die Zeilennummer für das Kalenderraster, über das der angegebene Trefferpunkt abgelaufen ist. Beispiel: Wenn Sie den 8. eines Monats (in der zweiten Woche des Monats) getestet haben, ist iRow eins, da der Index der Zeile nullbasierter Zeilenindex ist.

iCol

Typ: int

Die Spaltennummer für das Kalenderraster, über das der angegebene Punkt abgelaufen ist. Wenn Ihre Woche z. B. am Sonntag beginnt und der 1. des Monats Freitag ist, gibt der 1. Treffertest fünf (5) für iCol zurück, da Sich Freitag in der fünften Spalte vom Anfang der Zeile befindet und einen nullbasierten Spaltenindex verwendet.

Hinweise

Spalten und Zeilen in diesem Steuerelement verwenden ein nullbasiertes Indexsystem, d. h. die erste Spalte oder Zeile weist einen Index von 0 (null) auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h