Freigeben über


CComControlBase Class

Diese Klasse stellt Methoden zum Erstellen und Verwalten von ATL-Steuerelementen bereit.

Wichtig

Diese Klasse und ihre Member können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.

class ATL_NO_VTABLE CComControlBase

Mitglieder

Öffentliche Typedefs

Name

Description

CComControlBase::AppearanceType

Überschreiben Sie, wenn die m_nAppearance Vorrateigenschaft nicht vom Typ short ist.

Öffentliche Konstruktoren

Name

Description

CComControlBase::CComControlBase

Der -Konstruktor.

CComControlBase::~CComControlBase

Der Destruktor.

Öffentliche Methoden

Name

Description

CComControlBase::ControlQueryInterface

Ruft einen Zeiger auf die angeforderte Schnittstelle ab.

CComControlBase::DoesVerbActivate

Überprüft, ob der iVerb-Parameter durch IOleObjectImpl::DoVerb verwendete, entweder aktiviert die Benutzeroberfläche des Steuerelements (iVerb entspricht OLEIVERB_UIACTIVATE), definiert die Aktion, wenn der Benutzer auf das Steuerelement (iVerb entspricht OLEIVERB_PRIMARY), doppelklicken, wird das Steuerelement (iVerb entspricht OLEIVERB_SHOW) oder aktiviert das Steuerelement (iVerb entspricht OLEIVERB_INPLACEACTIVATE).

CComControlBase::DoesVerbUIActivate

Überprüft, ob der iVerb-Parameter, der von IOleObjectImpl::DoVerb verwendet wird, die Benutzeroberfläche des Steuerelements wird zu aktivieren und gibt TRUE zurück.

CComControlBase::DoVerbProperties

Zeigt die Eigenschaftenseiten des Steuerelements an.

CComControlBase::FireViewChange

Rufen Sie diese Methode auf, um den Container mitzuteilen, dass das Steuerelement neu zu zeichnen, oder benachrichtigen Sie die registrierten Advise-Senken, dass die Ansicht des Steuerelements geändert hat.

CComControlBase::GetAmbientAppearance

Ruft DISPID_AMBIENT_APPEARANCE, die aktuelle Darstellungseinstellung für das Steuerelement ab: Ebene 0 für und 1 für 3D.

CComControlBase::GetAmbientAutoClip

Ruft DISPID_AMBIENT_AUTOCLIP ab, ein Flag, ob der Container automatische Clipping des Kontrollanzeigebereichs unterstützt.

CComControlBase::GetAmbientBackColor

Ruft DISPID_AMBIENT_BACKCOLOR, die eine Hintergrundfarbe für alle Steuerelemente ab, definiert vom Container.

CComControlBase::GetAmbientCharSet

Ruft DISPID_AMBIENT_CHARSET, den Ambienten Zeichensatz für alle Steuerelemente ab, definiert vom Container.

CComControlBase::GetAmbientCodePage

Ruft DISPID_AMBIENT_CODEPAGE, den Ambienten Zeichensatz für alle Steuerelemente ab, definiert vom Container.

CComControlBase::GetAmbientDisplayAsDefault

Ruft DISPID_AMBIENT_DISPLAYASDEFAULT, ein Flag ab, das TRUE ist, wenn der Container das Steuerelement in dieser Website markiert wurde, um eine Standardschaltfläche zu sein, daher sollte ein Schaltflächen-Steuerelement mit stärkeren Frame sich selbst zeichnen.

CComControlBase::GetAmbientDisplayName

Ruft DISPID_AMBIENT_DISPLAYNAME, den Namen ab, der den Container zum Steuerelement angegeben hat.

CComControlBase::GetAmbientFont

Ruft einen Zeiger auf die Ambienten IFont-Schnittstelle des Containers ab.

CComControlBase::GetAmbientFontDisp

Ruft einen Zeiger auf die Ambienten IFontDisp Dispatchschnittstelle des Containers ab.

CComControlBase::GetAmbientForeColor

Ruft DISPID_AMBIENT_FORECOLOR, die eine Vordergrundfarbe für alle Steuerelemente ab, definiert vom Container.

CComControlBase::GetAmbientLocaleID

Ruft DISPID_AMBIENT_LOCALEID, den Bezeichner der Sprache ab, die vom Container verwendet wird.

CComControlBase::GetAmbientMessageReflect

Ruft DISPID_AMBIENT_MESSAGEREFLECT ab, ein Flag, ob der Container Fenstermeldungen (z WM_DRAWITEM) als Ereignisse empfangen möchte.

CComControlBase::GetAmbientPalette

Ruft DISPID_AMBIENT_PALETTE ab, verwendet, um auf HPALETTE des Containers zuzugreifen.

CComControlBase::GetAmbientProperty

Ruft die Containereigenschaft ab, die von id angegeben wird.

CComControlBase::GetAmbientRightToLeft

Ruft DISPID_AMBIENT_RIGHTTOLEFT ab, in die die Richtung angezeigt wird vom Container erfüllen.

CComControlBase::GetAmbientScaleUnits

Ruft DISPID_AMBIENT_SCALEUNITS, die Ambienten Einheiten des Containers (wie Zoll oder Zentimeter) zum Bezeichnen von Anzeigen ab.

CComControlBase::GetAmbientShowGrabHandles

Ruft DISPID_AMBIENT_SHOWGRABHANDLES, ein Flag, das angibt, ob der Container das Steuerelement an Anzeigenziehpunkten sich zulässt, wenn aktiv.

CComControlBase::GetAmbientShowHatching

Ruft DISPID_AMBIENT_SHOWHATCHING ab, ein Flag, ob der Container dem Steuerelement ermöglicht, um mit einer Schraffur anzuzeigen, wenn die Benutzeroberfläche aktiv ist.

CComControlBase::GetAmbientSupportsMnemonics

Ruft DISPID_AMBIENT_SUPPORTSMNEMONICS ab, ein Flag, ob der Container Tastaturmnemotechnik unterstützt.

CComControlBase::GetAmbientTextAlign

Ruft DISPID_AMBIENT_TEXTALIGN, die Textausrichtung ab, die vom Container bevorzugt wird: 0 für allgemeine Ausrichtung (Zahlen berichtigen, der mehr übrig Text), 1 für linke Ausrichtung, 2 für und 3 für Ausrichtung mittlere rechte Ausrichtung.

CComControlBase::GetAmbientTopToBottom

Ruft DISPID_AMBIENT_TOPTOBOTTOM ab, in die die Richtung angezeigt wird vom Container erfüllen.

CComControlBase::GetAmbientUIDead

Ruft DISPID_AMBIENT_UIDEAD ab, ein Flag, ob der Container das Steuerelement auf Benutzeroberflächeaktionen reagieren wünscht.

CComControlBase::GetAmbientUserMode

Ruft DISPID_AMBIENT_USERMODE ab, ein Flag, ob der Container Ausführmodus (TRUE) oder im Entwurfsmodus (FALSE) ist.

CComControlBase::GetDirty

Gibt den Wert des Datenmembers m_bRequiresSave zurück.

CComControlBase::GetZoomInfo

Ruft die x und die y-Werte des Zählers und des Nenners des Zoomfaktors für ein Steuerelement ab, das für die direkte Bearbeitung aktiviert ist.

CComControlBase::InPlaceActivate

Bewirkt das Steuerelement für den Übergang vom inaktiven Zustand zu, was Zustand das Verb in iVerb angibt.

CComControlBase::InternalGetSite

Rufen Sie diese Methode auf, um die Steuerungssite für einen Zeiger auf die identifizierten Schnittstelle abzufragen.

CComControlBase::OnDraw

Überschreiben Sie diese Methode, um das Steuerelement zu zeichnen.

CComControlBase::OnDrawAdvanced

Standard OnDrawAdvanced bereitet einen normalisierten Gerätekontext zum Zeichnen vor, ruft OnDraw-Methode der Steuerklasse auf.

CComControlBase::OnKillFocus

Überprüft, ob das Steuerelement direkt aktiviert und gültigen Steuerungssite hat, dann informiert den Container, dass das Steuerelement den Fokus verloren hat.

CComControlBase::OnMouseActivate

Überprüft, ob das Benutzeroberfläche im Benutzermodus ist, dann kann das Steuerelement.

CComControlBase::OnPaint

Bereitet den Container für das Zeichnen vor, ruft den Clientbereich des Steuerelements ab, ruft die OnDraw-Methode der Steuerelementklasse auf.

CComControlBase::OnSetFocus

Überprüft, ob das Steuerelement direkt aktiviert und gültigen Steuerungssite hat, dann informiert den Container, den das Steuerelement den Fokus erhalten hat.

CComControlBase::PreTranslateAccelerator

Überschreiben Sie diese Methode, um eigene Zugriffstastenhandler bereitzustellen.

CComControlBase::SendOnClose

Benachrichtigt alle Advise-Senken, die mit dem Advise-Halter registriert werden, dass das Steuerelement geschlossen wurde.

CComControlBase::SendOnDataChange

Benachrichtigt alle Advise-Senken, die mit dem Advise-Halter registriert werden, dass die Steuerelementdaten geändert haben.

CComControlBase::SendOnRename

Benachrichtigt alle Advise-Senken, die mit dem Advise-Halter registriert werden, dass das Steuerelement einen neuen Moniker verfügt.

CComControlBase::SendOnSave

Benachrichtigt alle Advise-Senken, die mit dem Advise-Halter registriert werden, dass das Steuerelement gespeichert wurde.

CComControlBase::SendOnViewChange

Benachrichtigt alle registrierten Advise-Senken, dass die Ansicht des Steuerelements geändert hat.

CComControlBase::SetControlFocus

Setzt oder entfernt den Tastaturfokus in oder aus dem Steuerelement.

CComControlBase::SetDirty

Legt den Datenmember m_bRequiresSave zum Wert in bDirty fest.

Öffentliche Datenmember

Name

Description

CComControlBase::m_bAutoSize

Das Flag, das das Steuerelement angibt, kann keine andere Größe aufweisen.

CComControlBase::m_bDrawFromNatural

Kennzeichnen Sie das Angeben von diesem IDataObjectImpl::GetData und CComControlBase::GetZoomInfo sollte die der Steuerelementgröße von m_sizeNatural statt von m_sizeExtent festlegen.

CComControlBase::m_bDrawGetDataInHimetric

Kennzeichnen Sie das Angeben von diesem IDataObjectImpl::GetData sollte HIMETRIC-Einheiten und keine Pixel beim Zeichnen verwenden.

CComControlBase::m_bInPlaceActive

Das Flag, das das Steuerelement angibt, kann direkt aktiviert.

CComControlBase::m_bInPlaceSiteEx

Das Flag, das den Container angibt, unterstützt die IOleInPlaceSiteEx-Schnittstelle und -steuerocx96 Funktionen, wie fensterlose und flimmerfreie Steuerelemente.

CComControlBase::m_bNegotiatedWnd

Kennzeichnen Sie das angibt, ob das Steuerelement mit dem Container über die Features des Steuerelements OCX96 (z flimmerfreie und fensterlose Steuerelemente) ausgehandelt hat und ob das Steuerelement mit Fenster oder fensterlos ist.

CComControlBase::m_bRecomposeOnResize

Das Flag, das das Steuerelement angibt, möchte seine Darstellung neu anordnen, wenn der Container die Anzeigengröße des Steuerelements ändert.

CComControlBase::m_bRequiresSave

Das Flag, das das Steuerelement angibt, wurde geändert, seit der zuletzt gespeichert wurde.

CComControlBase::m_bResizeNatural

Das Flag, das das Steuerelement angibt, möchte den natürlichen Wertebereich (die unskalierte physische Größe) Größe ändern wenn der Container die Anzeigengröße des Steuerelements ändert.

CComControlBase::m_bUIActive

Kennzeichnen Sie das Angeben der Benutzeroberfläche des Steuerelements, wie Menüs und Symbolleisten, ist aktiv.

CComControlBase::m_bUsingWindowRgn

Das Flag, das das Steuerelement angibt, verwendet den Container-angegebenen Fensterbereich.

CComControlBase::m_bWasOnceWindowless

Das Flag, das angibt, welches Steuerelement betraf fensterlos, ist jedoch möglicherweise jetzt fensterlos.

CComControlBase::m_bWindowOnly

Das Flag, das das Steuerelement angibt, sollte mit Fenster sein, wenn der Container fensterlose Steuerelemente unterstützt.

CComControlBase::m_bWndLess

Das Flag, das das Steuerelement angibt, ist fensterlos.

CComControlBase::m_hWndCD

Enthält einen Verweis auf das Fensterhandle, das dem Steuerelement zugeordnet ist.

CComControlBase::m_nFreezeEvents

Eine Anzahl der Häufigkeit der Container hat die Ereignisse (abgelehnt, Ereignisse zu akzeptieren) ohne ein dazwischenliegendes Tauwetter von Ereignissen (Übernahme von Ereignissen) fixiert.

CComControlBase::m_rcPos

Die Position in Pixel des Steuerelements, ausgedrückt in den Koordinaten des Containers.

CComControlBase::m_sizeExtent

Der Umfang eines Steuerelements in den HIMETRIC-Einheiten (jede Einheit ist 0,01 mm), für eine bestimmte Anzeige.

CComControlBase::m_sizeNatural

Die physische Größe des Steuerelements in der HIMETRIC-Einheiten (jede Einheit ist 0,01 mm).

CComControlBase::m_spAdviseSink

Ein direkten Zeiger zur Advise-Verbindung im Container ( IAdviseSink des Containers).

CComControlBase::m_spAmbientDispatch

Ein CComDispatchDriver-Objekt, das Sie die Eigenschaften des Containers durch einen Zeiger IDispatch abrufen und festlegen können.

CComControlBase::m_spClientSite

Ein Zeiger auf die Clientsite des Steuerelements innerhalb des Containers.

CComControlBase::m_spDataAdviseHolder

Stellt ein Mittel eines Standards bereit, um Advise-Verbindungen zwischen Datenobjekten und Advise-Senken aufzunehmen.

CComControlBase::m_spInPlaceSite

Ein Zeiger auf IOleInPlaceSite, IOleInPlaceSiteEx oder IOleInPlaceSiteWindowless-Schnittstellenzeiger des Containers.

CComControlBase::m_spOleAdviseHolder

Stellt eine Standardimplementierung einer Methode, Advise-Verbindungen anzuhalten bereit.

Hinweise

Diese Klasse stellt Methoden zum Erstellen und Verwalten von ATL-Steuerelementen bereit. CComControl-Klasse wird von abgeleitet CComControlBase. Wenn Sie ein Standardsteuerelement oder DHTML-Steuerelement mit dem ATL-Steuerelement-Assistenten erstellen, berechnet der Assistent automatisch die Klasse von CComControlBase.

Weitere Informationen zum Erstellen eines Steuerelements, finden Sie unter ATL-Lernprogramm. Weitere Informationen zu den ATL-Projekt-Assistenten, finden Sie im Artikel Erstellen eines ATL-Projekts.

Anforderungen

Header: atlctl.h

Siehe auch

Referenz

CComControl Class

Weitere Ressourcen

ATL Class Overview