Freigeben über


CSmartDockingInfo-Klasse

Definiert die Darstellung von intelligenten Andockmarkern.

Syntax

class CSmartDockingInfo : public CObject

Member

Öffentliche Konstruktoren

Name Beschreibung
CSmartDockingInfo::CSmartDockingInfo Der Standardkonstruktor.

Öffentliche Methoden

Name Beschreibung
CSmartDockingInfo::CopyTo Kopiert die aktuellen Smart Docking-Infoparameter in das bereitgestellte CSmartDockingInfo -Objekt.

Datenelemente

Name Beschreibung
CSmartDockingInfo::m_bUseThemeColorInShading Gibt an, ob die aktuelle Designfarbe verwendet werden soll, wenn das Framework intelligente Andockmarkierungen anzeigt.
CSmartDockingInfo::m_clrBaseBackground Gibt die Basishintergrundfarbe von smarten Docking-Markern an.
CSmartDockingInfo::m_clrToneDest Gibt die Farbe an, die in smarten Docking-Marker-Bitmaps ersetzt m_clrToneSrc wird.
CSmartDockingInfo::m_clrToneSrc Gibt die Farbe von Bitmaps für intelligente Andockmarkierungen an.
CSmartDockingInfo::m_clrTransparent Gibt die Farbe intelligenter Docking-Marker-Bitmaps an, wenn sie transparent sind.
CSmartDockingInfo::m_nCentralGroupOffset Gibt den Offset der zentralen Gruppe von intelligenten Andockpunkten aus den Grenzen des zentralen Gruppenrechtecks an.
CSmartDockingInfo::m_sizeTotal Gibt die Gesamtgröße aller smarten Andockpunkte in einer Gruppe an.
CSmartDockingInfo::m_uiMarkerBmpResID Definiert die Ressourcen-IDs der Bitmaps, die das Framework für intelligente Andockmarkierungen verwendet, die nicht hervorgehoben sind.
CSmartDockingInfo::m_uiMarkerLightBmpResID Definiert die Ressourcen-IDs der Bitmaps, die das Framework für intelligente Andockmarkierungen verwendet, die hervorgehoben sind.

Hinweise

Das Framework verarbeitet intelligente Docking-Marker intern. Die folgende Abbildung zeigt die standardmäßigen intelligenten Docking-Marker:

Standardmarkierungen für intelligentes Andocken.

In dieser Abbildung zeigt das Bild auf der linken Seite eine intelligente Docking-Markierung für eine zentrale Gruppe, die nicht an eine Registerkarte angedockt ist. Das Bild in der Mitte zeigt eine intelligente Docking-Markierung am rechten Rand. Das Bild auf der rechten Seite zeigt eine zentrale Gruppe intelligenter Docking-Markierungen, die an eine Registerkarte angedockt haben. Die intelligente Verankerungsmarkierung der zentralen Gruppe weist eine Hauptbitmap und fünf smarte Docking-Marker-Bitmaps auf.

Sie können die folgenden Parameter von intelligenten Docking-Markern anpassen:

  • Farbe Sie können z. B. die blaue Farbe der Markierungen in der Abbildung durch eine beliebige benutzerdefinierte Farbe ersetzen.

  • Transparenzfarbe.

  • Offset einer intelligenten Docking-Markierung in der zentralen Gruppe vom Rand des umgebenden Rechtecks.

  • Die Hauptbitmap, die die zentrale Gruppe darstellt.

  • Die Bitmaps, die die regulären und hervorgehobenen smarten Andockmarkierungen darstellen.

Die folgende Abbildung zeigt ein Beispiel für intelligente Andockmarker, die angepasst wurden:

Benutzerdefinierte Markierungen für intelligentes Andocken.

Vererbungshierarchie

CObject

CSmartDockingInfo

Anforderungen

Header: afxDockingManager.h

CSmartDockingInfo::CopyTo

Kopiert die aktuellen Smart-Docking-Parameter in das bereitgestellte CSmartDockingInfo -Objekt.

void CopyTo(CSmartDockingInfo& params);

Parameter

params
[out] Ein Objekt vom Typ CSmartDockingInfo , das mit den aktuellen Smart-Docking-Parametern aufgefüllt wird.

CSmartDockingInfo::m_bUseThemeColorInShading

Gibt an, ob die aktuelle Designfarbe verwendet werden soll, wenn das Framework intelligente Andockmarkierungen anzeigt.

BOOL m_bUseThemeColorInShading;

Hinweise

Wenn WAHR, werden die Markierungen mit der aktuellen Designfarbe gezeichnet. andernfalls werden die Markierungen mit einer hellblauen Farbe gezeichnet.

Der Standardwert ist FALSCH.

CSmartDockingInfo::m_clrBaseBackground

Gibt die Basishintergrundfarbe von smarten Docking-Markern an.

COLORREF m_clrBaseBackground;

CSmartDockingInfo::m_clrToneDest

Gibt die Farbe an, die in smarten Docking-Marker-Bitmaps ersetzt m_clrToneSrc wird.

COLORREF m_clrToneDest;

Hinweise

Legen Sie diesen Wert fest, um die Farbe von Markerbitmaps programmgesteuert zu ändern. Wenn Sie beispielsweise die Farbe der standardmarkierungen ändern möchten, die mit dem Framework bereitgestellt werden, legen Sie diesen Wert auf die gewünschte Farbe fest. Standardmäßig ist CSmartDockingInfo::m_clrToneSrc auf RGB (61, 123, 241) (eine blumige Farbe) festgelegt.

Um die Farbe von benutzerdefinierten Markierungen zu ändern, müssen Sie beide m_clrToneDest und m_clrToneSrc.

CSmartDockingInfo::m_clrToneSrc

Gibt die Farbe von Bitmaps für intelligente Andockmarkierungen an.

COLORREF m_clrToneSrc;

Hinweise

Legen Sie diesen Wert nur fest, wenn Sie die Farbe einer benutzerdefinierten Bitmap durch eine andere Farbe ersetzen möchten. Sie müssen diesen Wert nicht festlegen, wenn Sie die Farbe einer Standardmarkierung (Framework bereitgestellt) ändern.

Wird verwendet (COLORREF)-1 , um ein Mitglied der intelligenten Docking-Gruppe leer zu lassen.

CSmartDockingInfo::m_clrTransparent

Gibt die Farbe intelligenter Docking-Marker-Bitmaps an, wenn sie transparent sind.

COLORREF m_clrTransparent;

Hinweise

Sie müssen diesen Wert festlegen, wenn Sie benutzerdefinierte Markierungen und benutzerdefinierte Bitmaps in der Andockgruppe anzeigen.

CSmartDockingInfo::m_nCentralGroupOffset

Gibt den Offset zwischen der zentralen Gruppe von intelligenten Andockpunkten und den Begrenzungen des zentralen Gruppenrechtecks an.

int m_nCentralGroupOffset;

Hinweise

Geben Sie diesen Wert an, wenn Sie den Standardoffset zwischen benutzerdefinierten Markierungen und den Grenzen der zentralen Gruppe von intelligenten Andockpunkten ändern möchten. Der Standardoffset beträgt 5 Pixel.

CSmartDockingInfo::m_sizeTotal

Gibt die Gesamtgröße eines umgebenden Rechtecks an, das alle intelligenten Docking-Markierungen in der zentralen Gruppe einschließt.

CSize m_sizeTotal;

Hinweise

Legen Sie m_sizeTotal die Größe des umgebenden Rechtecks der zentralen Gruppenmarkierung fest. Sie müssen diesen Wert angeben, wenn Sie benutzerdefinierte Bitmaps für Markierungen verwenden.

CSmartDockingInfo::m_uiMarkerBmpResID

Definiert die Ressourcen-IDs der Bitmaps, die für nicht hervorgehobene benutzerdefinierte Smart-Docking-Marker verwendet werden.

UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];

Hinweise

Füllen Sie dieses Array mit den Ressourcen-IDs der Bitmaps aus, die die intelligenten Andockmarkierungen darstellen. AFX_SD_MARKERS_NUM ist derzeit als 5 definiert. Sie füllen das Array wie folgt aus:

params.m_uiMarkerBmpResID[0] = IDB_MARKER_LEFT;
params.m_uiMarkerBmpResID[1] = IDB_MARKER_RIGHT;
params.m_uiMarkerBmpResID[2] = IDB_MARKER_TOP;
params.m_uiMarkerBmpResID[3] = IDB_MARKER_BOTTOM;
params.m_uiMarkerBmpResID[4] = IDB_MARKER_CENTER;

CSmartDockingInfo::m_uiMarkerLightBmpResID

Definiert die Ressourcen-IDs der Bitmaps, die für hervorgehobene benutzerdefinierte intelligente Andockmarkierungen verwendet werden.

UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];

Hinweise

Füllen Sie dieses Array mit den Ressourcen-IDs der Bitmaps aus, die die hervorgehobenen intelligenten Andockmarkierungen darstellen. AFX_SD_MARKERS_NUM ist derzeit als 5 definiert. Sie füllen das Array wie folgt aus:

params.m_uiMarkerLightBmpResID[0] = IDB_MARKER_LEFT_LIGHT;
params.m_uiMarkerLightBmpResID[1] = IDB_MARKER_RIGHT_LIGHT;
params.m_uiMarkerLightBmpResID[2] = IDB_MARKER_TOP_LIGHT;
params.m_uiMarkerLightBmpResID[3] = IDB_MARKER_BOTTOM_LIGHT;
params.m_uiMarkerLightBmpResID[4] = IDB_MARKER_CENTER_LIGHT;

Siehe auch

Hierarchiediagramm
Klassen
CObject-Klasse