CComCompositeControl-Klasse

Diese Klasse stellt die Methoden bereit, die zum Implementieren eines zusammengesetzten Steuerelements erforderlich sind.

Syntax

template <class T>
class CComCompositeControl : public CComControl<T,CAxDialogImpl<T>>

Parameter

T
Ihre Von CComObjectRoot oder CComObjectRootEx abgeleitete Klasse sowie alle anderen Schnittstellen, die Sie für Ihr zusammengesetztes Steuerelement unterstützen möchten.

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Datenmember

Hinweise

Von der Klasse CComCompositeControl abgeleitete Klassen erben die Funktionalität eines Zusammengesetzten ActiveX-Steuerelements. Von einem Standarddialogfeld abgeleitete CComCompositeControl ActiveX-Steuerelemente werden gehostet. Diese Arten von Steuerelementen werden als zusammengesetzte Steuerelemente bezeichnet, da sie andere Steuerelemente hosten können (systemeigene Windows-Steuerelemente und ActiveX-Steuerelemente).

CComCompositeControl identifiziert die Dialogressource zum Erstellen des zusammengesetzten Steuerelements, indem nach einem aufgezählten Datenmemmemm in der untergeordneten Klasse gesucht wird. Die Member-IDD dieser untergeordneten Klasse wird auf die Ressourcen-ID der Dialogressource festgelegt, die als Fenster des Steuerelements verwendet wird. Im Folgenden sehen Sie ein Beispiel für das Datenmemm, von dem die von der Klasse abgeleitete CComCompositeControl Klasse enthalten soll, um die Dialogressource zu identifizieren, die für das Fenster des Steuerelements verwendet werden soll:

enum { IDD = IDD_MYCOMPOSITE };

Ein von einer abgeleiteten CComCompositeControlKlasse implementiertes Steuerelement verfügt über ein standardmäßiges Tabulatorverhalten. Wenn das Steuerelement den Fokus erhält, indem es in einer enthaltenden Anwendung tabstopps ist, bewirkt das aufeinander folgende Drücken der TAB-TASTE, dass der Fokus durch alle enthaltenen Steuerelemente des zusammengesetzten Steuerelements durchlaufen wird, dann aus dem zusammengesetzten Steuerelement und dem nächsten Element in der Aktivierreihenfolge des Containers. Die Aktivierreihenfolge der gehosteten Steuerelemente wird von der Dialogressource bestimmt und bestimmt die Reihenfolge, in der tabbing erfolgt.

Beispiel

// Example for overriding IOleControlImpl::GetControlInfo()
// This example uses the accelerator table from the project resources
// with the identifier IDR_ACCELTABLE
// Define GetControlInfo() in the header of your composite 
// control class as follows:

STDMETHOD(GetControlInfo)(CONTROLINFO* pCI)
{
    // Load the accelerator table from the resource
    pCI->hAccel = LoadAccelerators(_AtlBaseModule.GetResourceInstance(), 
       MAKEINTRESOURCE(IDR_ACCELTABLE));

    if (pCI->hAccel == NULL)
        return E_FAIL;

    // Get the number of accelerators in the table
    pCI->cAccel = (USHORT)CopyAcceleratorTable(pCI->hAccel, NULL, 0);
    // The following is optional if you want your control
    // to process the return and/or escape keys
    // pCI.dwFlags = CTRLINFO_EATS_RETURN | CTRLINFO_EATS_ESCAPE;
    pCI->dwFlags = 0;

    return S_OK;
}

Vererbungshierarchie

WinBase

CComControlBase

CComControl

CComCompositeControl

Anforderungen

Header: atlctl.h

CComCompositeControl::AdviseSinkMap

Rufen Sie diese Methode auf, um alle vom zusammengesetzten Steuerelement gehosteten Steuerelemente zu beraten oder zu aufheben.

HRESULT AdviseSinkMap(bool bAdvise);

Parameter

bAdvise
True, wenn alle Steuerelemente empfohlen werden sollen; andernfalls "false".

Rückgabewert

Hinweise

Die Basisimplementierung dieser Methode durchsucht die Einträge in der Ereignissenkenzuordnung. Anschließend wird die Verbindung mit den COM-Objekten empfohlen oder deaktiviert, die von den Sinkeinträgen der Ereignissenkekarte beschrieben werden. Diese Membermethode basiert auch darauf, dass die abgeleitete Klasse von einer Instanz jedes IDispEventImpl Steuerelements in der Senkenzuordnung erbt, das empfohlen oder nicht überwacht werden soll.

CComCompositeControl::CalcExtent

Rufen Sie diese Methode auf, um die Größe in HIMETRIC-Einheiten der Dialogressource zu berechnen, die zum Hosten des zusammengesetzten Steuerelements verwendet wird.

BOOL CalcExtent(SIZE& size);

Parameter

size
Ein Verweis auf eine SIZE Struktur, die von dieser Methode ausgefüllt werden soll.

Rückgabewert

TRUE, wenn das Steuerelement in einem Dialogfeld gehostet wird; andernfalls FALSE.

Hinweise

Die Größe wird im Parameter "size " zurückgegeben.

CComCompositeControl::Create

Diese Methode wird aufgerufen, um das Steuerelementfenster für das zusammengesetzte Steuerelement zu erstellen.

HWND Create(
    HWND hWndParent,
    RECT& /* rcPos */,
    LPARAM dwInitParam = NULL);

Parameter

hWndParent
Ein Handle für das übergeordnete Fenster des Steuerelements.

rcPos
Reserviert.

dwInitParam
Daten, die beim Erstellen von Steuerelementen an das Steuerelement übergeben werden sollen. Die als dwInitParam übergebenen Daten werden als LPARAM-Parameter der WM_INITDIALOG Nachricht angezeigt, die beim Erstellen an das zusammengesetzte Steuerelement gesendet wird.

Rückgabewert

Ein Handle für das neu erstellte zusammengesetzte Steuerelementdialogfeld.

Hinweise

Diese Methode wird in der Regel während der direkten Aktivierung des Steuerelements aufgerufen.

CComCompositeControl::CComCompositeControl

Der Konstruktor.

CComCompositeControl();

Hinweise

Initialisiert die CComCompositeControl::m_hbrBackground - und CComCompositeControl::m_hWndFocus-Datenmmber in NULL.

CComCompositeControl::~CComCompositeControl

Der Destruktor.

~CComCompositeControl();

Hinweise

Löscht das Hintergrundobjekt, sofern vorhanden.

CComCompositeControl::CreateControlWindow

Rufen Sie diese Methode auf, um das Steuerelementfenster zu erstellen und gehostete Steuerelemente zu empfehlen.

virtual HWND CreateControlWindow(
    HWND hWndParent,
    RECT& rcPos);

Parameter

hWndParent
Ein Handle für das übergeordnete Fenster des Steuerelements.

rcPos
Das Positionsrechteck des zusammengesetzten Steuerelements in Clientkoordinaten relativ zu hWndParent.

Rückgabewert

Gibt ein Handle an das neu erstellte zusammengesetzte Steuerelementdialogfeld zurück.

Hinweise

Diese Methode ruft CComCompositeControl::Create and CComCompositeControl::AdviseSinkMap auf.

CComCompositeControl::m_hbrBackground

Der Hintergrundpinsel.

HBRUSH m_hbrBackground;

CComCompositeControl::m_hWndFocus

Das Handle des Fensters, das derzeit den Fokus besitzt.

HWND m_hWndFocus;

CComCompositeControl::SetBackgroundColorFromAmbient

Rufen Sie diese Methode auf, um die Hintergrundfarbe des zusammengesetzten Steuerelements mithilfe der Hintergrundfarbe des Containers festzulegen.

HRESULT SetBackgroundColorFromAmbient();

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Siehe auch

CComControl-Klasse
Grundlagen von zusammengesetzten Steuerelementen
Klassenübersicht