CComControlBase-Klasse
Diese Klasse stellt Methoden zum Erstellen und Verwalten von ATL-Steuerelementen bereit.
Wichtig
Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.
Syntax
class ATL_NO_VTABLE CComControlBase
Member
Öffentliche Typedefs
| Name | Beschreibung |
|---|---|
| CComControlBase::AppearanceType | Überschreiben, wenn Ihre m_nAppearance Aktieneigenschaft nicht vom Typ shortist. |
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CComControlBase::CComControlBase | Der Konstruktor. |
| CComControlBase::~CComControlBase | Der Destruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CComControlBase::ControlQueryInterface | Ruft einen Zeiger auf die angeforderte Schnittstelle ab. |
| CComControlBase::D oesVerbActivate | Überprüft, ob der von IOleObjectImpl::DoVerb der Benutzeroberfläche des Steuerelements verwendete iVerb-Parameter aktiviert wird (iVerb entspricht OLEIVERB_UIACTIVATE), definiert die ausgeführte Aktion, wenn der Benutzer auf das Steuerelement doppelklicken (iVerb entspricht OLEIVERB_PRIMARY), zeigt das Steuerelement an (iVerb entspricht OLEIVERB_SHOW), oder aktiviert das Steuerelement (iVerb entspricht OLEIVERB_INPLACEACTIVATE). |
| CComControlBase::D oesVerbUIActivate | Überprüft, ob der von dem iVerb-Parameter IOleObjectImpl::DoVerb verwendete Parameter bewirkt, dass die Benutzeroberfläche des Steuerelements aktiviert wird und WAHR zurückgibt. |
| CComControlBase::D oVerbProperties | Zeigt die Eigenschaftenseiten des Steuerelements an. |
| CComControlBase::FireViewChange | Rufen Sie diese Methode auf, um dem Container mitzuteilen, dass das Steuerelement neu gezeichnet wird, oder benachrichtigen Sie die registrierten Empfehlungs-Senken, dass sich die Ansicht des Steuerelements geändert hat. |
| CComControlBase::GetAmbientAppearance | Ruft DISPID_AMBIENT_APPEARANCE ab, die aktuelle Darstellungseinstellung für das Steuerelement: 0 für flach und 1 für 3D. |
| CComControlBase::GetAmbientAutoClip | Ruft DISPID_AMBIENT_AUTOCLIP ab, ein Flag, das angibt, ob der Container die automatische Beschneidung des Steuerelementanzeigebereichs unterstützt. |
| CComControlBase::GetAmbientBackColor | Ruft DISPID_AMBIENT_BACKCOLOR, die Umgebungshintergrundfarbe für alle Vom Container definierten Steuerelemente ab. |
| CComControlBase::GetAmbientCharSet | Ruft DISPID_AMBIENT_CHARSET ab, der Umgebungszeichensatz für alle Vom Container definierten Steuerelemente. |
| CComControlBase::GetAmbientCodePage | Ruft DISPID_AMBIENT_CODEPAGE ab, der Umgebungszeichensatz für alle Vom Container definierten Steuerelemente. |
| CComControlBase::GetAmbientDisplayAsDefault | Ruft DISPID_AMBIENT_DISPLAYASDEFAULT ab, ein Flag, das TRUE ist, wenn der Container das Steuerelement auf dieser Website als Standardschaltfläche markiert hat, und daher sollte sich ein Schaltflächensteuerelement mit einem dickeren Frame zeichnen. |
| CComControlBase::GetAmbientDisplayName | Ruft DISPID_AMBIENT_DISPLAYNAME ab, der Name, den der Container für das Steuerelement bereitgestellt hat. |
| CComControlBase::GetAmbientFont | Ruft einen Zeiger auf die Umgebungsschnittstelle IFont des Containers ab. |
| CComControlBase::GetAmbientFontDisp | Ruft einen Zeiger auf die Umgebungs-Dispatch-Schnittstelle IFontDisp des Containers ab. |
| CComControlBase::GetAmbientForeColor | Ruft DISPID_AMBIENT_FORECOLOR, die Umgebungs-Vordergrundfarbe für alle Vom Container definierten Steuerelemente ab. |
| CComControlBase::GetAmbientLocaleID | Ruft DISPID_AMBIENT_LOCALEID ab, der Bezeichner der vom Container verwendeten Sprache. |
| CComControlBase::GetAmbientMessageReflect | Ruft DISPID_AMBIENT_MESSAGEREFLECT ab, ein Flag, das angibt, ob der Container Fensternachrichten (z. B. WM_DRAWITEM) als Ereignisse empfangen möchte. |
| CComControlBase::GetAmbientPalette | Ruft DISPID_AMBIENT_PALETTE ab, der für den Zugriff auf die HPALETTE des Containers verwendet wird. |
| CComControlBase::GetAmbientProperty | Ruft die durch id angegebene Containereigenschaft ab. |
| CComControlBase::GetAmbientRightToLeft | Ruft DISPID_AMBIENT_RIGHTTOLEFT ab, die Richtung, in der Der Inhalt vom Container angezeigt wird. |
| CComControlBase::GetAmbientScaleUnits | Ruft DISPID_AMBIENT_SCALEUNITS, die Umgebungseinheiten des Containers (z. B. Zoll oder Zentimeter) für die Beschriftungsanzeige ab. |
| CComControlBase::GetAmbientShowGrabHandles | Ruft DISPID_AMBIENT_SHOWGRABHANDLES ab, ein Flag, das angibt, ob der Container das Anzeigen von Ziehpunkten für sich selbst ermöglicht, wenn er aktiv ist. |
| CComControlBase::GetAmbientShowHatching | Ruft DISPID_AMBIENT_SHOWHATCHING ab, ein Flag, das angibt, ob der Container das Anzeigen des Steuerelements mit einem geschlüpften Muster ermöglicht, wenn die Benutzeroberfläche aktiv ist. |
| CComControlBase::GetAmbientSupportsMnemonics | Ruft DISPID_AMBIENT_SUPPORTSMNEMONICS ab, ein Flag, das angibt, ob der Container Tastatur-Mnemonics unterstützt. |
| CComControlBase::GetAmbientTextAlign | Ruft DISPID_AMBIENT_TEXTALIGN ab, die vom Container bevorzugte Textausrichtung: 0 für die allgemeine Ausrichtung (Zahlen rechts, Text links), 1 für die linke Ausrichtung, 2 für die zentrierte Ausrichtung und 3 für die rechte Ausrichtung. |
| CComControlBase::GetAmbientTopToBottom | Ruft DISPID_AMBIENT_TOPTOBOTTOM ab, die Richtung, in der Der Inhalt vom Container angezeigt wird. |
| CComControlBase::GetAmbientUIDead | Ruft DISPID_AMBIENT_UIDEAD ab, ein Flag, das angibt, ob das Steuerelement auf Benutzeroberflächenaktionen reagieren soll. |
| CComControlBase::GetAmbientUserMode | Ruft DISPID_AMBIENT_USERMODE ab, ein Flag, das angibt, ob sich der Container im Laufzeitmodus (TRUE) oder im Entwurfsmodus (FALSE) befindet. |
| CComControlBase::GetDirty | Gibt den Wert des Datenelements m_bRequiresSavezurück. |
| CComControlBase::GetZoomInfo | Ruft die x- und y-Werte des Zählers und Nenner des Zoomfaktors für ein Steuerelement ab, das für die direkte Bearbeitung aktiviert ist. |
| CComControlBase::InPlaceActivate | Bewirkt, dass das Steuerelement vom inaktiven Zustand zum zustand wechselt, den das Verb in iVerb angibt. |
| CComControlBase::InternalGetSite | Rufen Sie diese Methode auf, um die Kontrollwebsite für einen Zeiger auf die identifizierte Schnittstelle abzufragen. |
| CComControlBase::OnDraw | Überschreiben Sie diese Methode, um Das Steuerelement zu zeichnen. |
| CComControlBase::OnDrawAdvanced | Der Standardwert OnDrawAdvanced bereitet einen normalisierten Gerätekontext für die Zeichnung vor und ruft dann die Methode der Steuerelementklasse OnDraw auf. |
| CComControlBase::OnKillFocus | Überprüft, ob das Steuerelement aktiv ist und über einen gültigen Steuerelementstandort verfügt, und informiert dann den Container, dass das Steuerelement den Fokus verloren hat. |
| CComControlBase::OnMouseActivate | Überprüft, ob sich die Benutzeroberfläche im Benutzermodus befindet, und aktiviert dann das Steuerelement. |
| CComControlBase::OnPaint | Bereitet den Container für das Zeichnen vor, ruft den Clientbereich des Steuerelements ab und ruft dann die Methode der Steuerelementklasse OnDraw auf. |
| CComControlBase::OnSetFocus | Überprüft, ob das Steuerelement aktiv ist und über einen gültigen Kontrollstandort verfügt, und informiert den Container, dass das Steuerelement den Fokus erlangt hat. |
| CComControlBase::P reTranslateAccelerator | Überschreiben Sie diese Methode, um Eigene Zugriffstastenhandler bereitzustellen. |
| CComControlBase::SendOnClose | Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass die Kontrolle geschlossen wurde. |
| CComControlBase::SendOnDataChange | Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass sich die Kontrolldaten geändert haben. |
| CComControlBase::SendOnRename | Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass die Kontrolle über einen neuen Moniker verfügt. |
| CComControlBase::SendOnSave | Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass die Kontrolle gespeichert wurde. |
| CComControlBase::SendOnViewChange | Benachrichtigt alle registrierten Beratungssenken, dass sich die Ansicht des Steuerelements geändert hat. |
| CComControlBase::SetControlFocus | Legt den Tastaturfokus auf oder aus dem Steuerelement fest oder entfernt sie. |
| CComControlBase::SetDirty | Legt das Datenelement m_bRequiresSave auf den Wert in bDirty fest. |
Öffentliche Datenmember
| Name | Beschreibung |
|---|---|
| CComControlBase::m_bAutoSize | Flag, das angibt, dass das Steuerelement keine andere Größe aufweisen kann. |
| CComControlBase::m_bDrawFromNatural | Flag, das angibt, dass IDataObjectImpl::GetData und CComControlBase::GetZoomInfo die Steuerelementgröße m_sizeNatural anstelle von m_sizeExtent. |
| CComControlBase::m_bDrawGetDataInHimetric | Flag, das angibt, dass IDataObjectImpl::GetData beim Zeichnen HIMETRIC-Einheiten und nicht Pixel verwendet werden sollen. |
| CComControlBase::m_bInPlaceActive | Flag, das angibt, dass das Steuerelement aktiv ist. |
| CComControlBase::m_bInPlaceSiteEx | Flag, das angibt, dass der Container die IOleInPlaceSiteEx Schnittstellen- und OCX96-Steuerelementfeatures unterstützt, z. B. fensterlose und flackerfreie Steuerelemente. |
| CComControlBase::m_bNegotiatedWnd | Flag, das angibt, ob das Steuerelement mit dem Container über die Unterstützung von OCX96-Steuerelementfeatures (z. B. flackerfreie und fensterlose Steuerelemente) ausgehandelt wurde und ob das Steuerelement fensterlos oder fensterlos ist. |
| CComControlBase::m_bRecomposeOnResize | Flag, das angibt, dass das Steuerelement seine Präsentation erneut kompensieren möchte, wenn der Container die Anzeigegröße des Steuerelements ändert. |
| CComControlBase::m_bRequiresSave | Flag, das angibt, dass das Steuerelement seit dem letzten Speichern geändert wurde. |
| CComControlBase::m_bResizeNatural | Flag, das angibt, dass das Steuerelement seine natürliche Größe (seine nicht skalierte physische Größe) ändern möchte, wenn der Container die Anzeigegröße des Steuerelements ändert. |
| CComControlBase::m_bUIActive | Das Kennzeichen, das angibt, dass die Benutzeroberfläche des Steuerelements, z. B. Menüs und Symbolleisten, aktiv ist. |
| CComControlBase::m_bUsingWindowRgn | Flag, das angibt, dass das Steuerelement den vom Container bereitgestellten Fensterbereich verwendet. |
| CComControlBase::m_bWasOnceWindowless | Flag, das angibt, dass das Steuerelement fensterlos war, aber möglicherweise nicht fensterlos ist. |
| CComControlBase::m_bWindowOnly | Flag, das angibt, dass das Steuerelement angezeigt werden soll, auch wenn der Container fensterlose Steuerelemente unterstützt. |
| CComControlBase::m_bWndLess | Flag, das angibt, dass das Steuerelement fensterlos ist. |
| CComControlBase::m_hWndCD | Enthält einen Verweis auf das fensterhandle, das dem Steuerelement zugeordnet ist. |
| CComControlBase::m_nFreezeEvents | Eine Anzahl der Häufigkeit, mit der der Container gefrorene Ereignisse hat (die Annahme von Ereignissen verweigert wurde), ohne dass ereignisse dazwischen geschlagen werden (Annahme von Ereignissen). |
| CComControlBase::m_rcPos | Die Position in Pixeln des Steuerelements, ausgedrückt in den Koordinaten des Containers. |
| CComControlBase::m_sizeExtent | Der Umfang des Steuerelements in HIMETRIC-Einheiten (jede Einheit beträgt 0,01 Millimeter) für eine bestimmte Anzeige. |
| CComControlBase::m_sizeNatural | Die physische Größe des Steuerelements in HIMETRIC-Einheiten (jede Einheit beträgt 0,01 Millimeter). |
| CComControlBase::m_spAdviseSink | Ein direkter Zeiger auf die Empfehlungsverbindung auf dem Container (der IAdviseSink des Containers). |
| CComControlBase::m_spAmbientDispatch | Ein CComDispatchDriver Objekt, mit dem Sie die Eigenschaften des Containers über einen IDispatch Zeiger abrufen und festlegen können. |
| CComControlBase::m_spClientSite | Ein Zeiger auf den Clientstandort des Steuerelements innerhalb des Containers. |
| CComControlBase::m_spDataAdviseHolder | Stellt eine Standardmethode bereit, um Beratungsverbindungen zwischen Datenobjekten zu halten und Senken zu beraten. |
| CComControlBase::m_spInPlaceSite | Ein Zeiger auf den IOleInPlaceSite-, IOleInPlaceSiteEx- oder IOleInPlaceSiteWindowless-Schnittstellenzeiger . |
| CComControlBase::m_spOleAdviseHolder | Bietet eine Standardimplementierung einer Möglichkeit zum Halten von Beratungsverbindungen. |
Hinweise
Diese Klasse stellt Methoden zum Erstellen und Verwalten von ATL-Steuerelementen bereit. CComControl-Klasse wird von CComControlBase. Wenn Sie ein Standardsteuerelement oder DHTML-Steuerelement mithilfe des ATL-Steuerelement-Assistenten erstellen, leitet der Assistent Ihre Klasse automatisch von CComControlBase.
Weitere Informationen zum Erstellen eines Steuerelements finden Sie im ATL-Lernprogramm. Weitere Informationen zum ATL-Projekt-Assistenten finden Sie im Artikel Erstellen eines ATL-Projekts.
Anforderungen
Header: atlctl.h
CComControlBase::AppearanceType
Überschreiben, wenn Ihre m_nAppearance Aktieneigenschaft nicht vom Typ shortist.
typedef short AppearanceType;
Hinweise
Der ATL-Steuerelement-Assistent fügt m_nAppearance stock-Eigenschaft des Typs short hinzu. Überschreiben AppearanceType , wenn Sie einen anderen Datentyp verwenden.
CComControlBase::CComControlBase
Der Konstruktor.
CComControlBase(HWND& h);
Parameter
h
Der Ziehpunkt für das Fenster, das dem Steuerelement zugeordnet ist.
Hinweise
Initialisiert die Steuerelementgröße auf 5080X5080 HIMETRIC-Einheiten (2"X2") und initialisiert die CComControlBase Datenmememmwerte auf NULL oder FALSE.
CComControlBase::~CComControlBase
Der Destruktor.
~CComControlBase();
Hinweise
Wenn das Steuerelement fenstergefenstert ist, ~CComControlBase zerstört es durch Aufrufen von DestroyWindow.
CComControlBase::ControlQueryInterface
Ruft einen Zeiger auf die angeforderte Schnittstelle ab.
virtual HRESULT ControlQueryInterface(const IID& iid,
void** ppv);
Parameter
iid
Die GUID der angeforderten Schnittstelle.
ppv
Ein Zeiger auf den von iid identifizierten Schnittstellenzeiger oder NULL, wenn die Schnittstelle nicht gefunden wird.
Hinweise
Behandelt nur Schnittstellen in der COM-Zuordnungstabelle.
Beispiel
// Retrieve the control's IOleObject interface. Note interface
// is automatically released when pOleObject goes out of scope
CComPtr<IOleObject> pOleObject;
ControlQueryInterface(IID_IOleObject, (void**)&pOleObject);
CComControlBase::D oesVerbActivate
Überprüft, ob der von IOleObjectImpl::DoVerb der Benutzeroberfläche des Steuerelements verwendete iVerb-Parameter aktiviert wird (iVerb entspricht OLEIVERB_UIACTIVATE), definiert die ausgeführte Aktion, wenn der Benutzer auf das Steuerelement doppelklicken (iVerb entspricht OLEIVERB_PRIMARY), zeigt das Steuerelement an (iVerb entspricht OLEIVERB_SHOW), oder aktiviert das Steuerelement (iVerb entspricht OLEIVERB_INPLACEACTIVATE).
BOOL DoesVerbActivate(LONG iVerb);
Parameter
iVerb
Wert, der die auszuführende Aktion DoVerbangibt.
Rückgabewert
Gibt WAHR zurück, wenn iVerb gleich OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW oder OLEIVERB_INPLACEACTIVATE ist. Andernfalls wird FALSE zurückgegeben.
Hinweise
Sie können diese Methode überschreiben, um ihr eigenes Aktivierungsverb zu definieren.
CComControlBase::D oesVerbUIActivate
Überprüft, ob der von dem iVerb-Parameter IOleObjectImpl::DoVerb verwendete Parameter bewirkt, dass die Benutzeroberfläche des Steuerelements aktiviert wird und WAHR zurückgibt.
BOOL DoesVerbUIActivate(LONG iVerb);
Parameter
iVerb
Wert, der die auszuführende Aktion DoVerbangibt.
Rückgabewert
Gibt WAHR zurück, wenn iVerb OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW oder OLEIVERB_INPLACEACTIVATE entspricht. Andernfalls gibt die Methode FALSE zurück.
CComControlBase::D oVerbProperties
Zeigt die Eigenschaftenseiten des Steuerelements an.
HRESULT DoVerbProperties(LPCRECT /* prcPosRect */, HWND hwndParent);
Parameter
prcPosRec
Reserviert.
hwndParent
Handle des Fensters, das das Steuerelement enthält.
Rückgabewert
Einer der HRESULT-Standardwerte.
Beispiel
// The following implementation of the WM_RBUTTONDOWN message handler
// will pop up the ActiveX Control's PropertyPages
LRESULT CMyComposite::OnRButtonDown(UINT /*uMsg*/, WPARAM /*wParam*/,
LPARAM /*lParam*/, BOOL& /*bHandled*/)
{
DoVerbProperties(NULL, ::GetActiveWindow());
return 0L;
}
MESSAGE_HANDLER(WM_RBUTTONDOWN, OnRButtonDown)
CComControlBase::FireViewChange
Rufen Sie diese Methode auf, um dem Container mitzuteilen, dass das Steuerelement neu gezeichnet wird, oder benachrichtigen Sie die registrierten Empfehlungs-Senken, dass sich die Ansicht des Steuerelements geändert hat.
HRESULT FireViewChange();
Rückgabewert
Einer der HRESULT-Standardwerte.
Hinweise
Wenn das Steuerelement aktiv ist (das Steuerelementklassendatenmemm CComControlBase::m_bInPlaceActive true ist), benachrichtigt Sie den Container, den Sie das gesamte Steuerelement neu zeichnen möchten. Wenn das Steuerelement inaktiv ist, werden die registrierten Empfehlungen des Steuerelements benachrichtigt (über das Steuerelementklassendatenmemm CComControlBase::m_spAdviseSink), dass sich die Ansicht des Steuerelements geändert hat.
Beispiel
STDMETHODIMP CMyControl::put_Shape(int newVal)
{
// store newVal in m_nShape user-defined member
m_nShape = newVal;
// notify container to redraw control
FireViewChange();
return S_OK;
}
CComControlBase::GetAmbientAppearance
Ruft DISPID_AMBIENT_APPEARANCE ab, die aktuelle Darstellungseinstellung für das Steuerelement: 0 für flach und 1 für 3D.
HRESULT GetAmbientAppearance(short& nAppearance);
Parameter
nAppearance
Die Eigenschaft DISPID_AMBIENT_APPEARANCE.
Rückgabewert
Einer der HRESULT-Standardwerte.
Beispiel
HRESULT OnDraw(ATL_DRAWINFO& di)
{
short nAppearance;
RECT& rc = *(RECT*)di.prcBounds;
// draw 3D border if AmbientAppearance is not supported or is set to 1
HRESULT hr = GetAmbientAppearance(nAppearance);
if (hr != S_OK || nAppearance==1)
{
DrawEdge(di.hdcDraw, &rc, EDGE_SUNKEN, BF_RECT);
}
else
{
Rectangle(di.hdcDraw, rc.left, rc.top, rc.right, rc.bottom);
}
SetTextAlign(di.hdcDraw, TA_CENTER|TA_BASELINE);
LPCTSTR pszText = _T("ATL 8.0 : MyControl");
// For security reasons, we recommend that you use the lstrlen function
// with caution. Here, we can guarantee that pszText is NULL terminated,
// and therefore it is safe to use this function.
TextOut(di.hdcDraw,
(rc.left + rc.right) / 2,
(rc.top + rc.bottom) / 2,
pszText,
lstrlen(pszText));
return S_OK;
}
CComControlBase::GetAmbientAutoClip
Ruft DISPID_AMBIENT_AUTOCLIP ab, ein Flag, das angibt, ob der Container die automatische Beschneidung des Steuerelementanzeigebereichs unterstützt.
HRESULT GetAmbientAutoClip(BOOL& bAutoClip);
Parameter
bAutoClip
Die Eigenschaft DISPID_AMBIENT_AUTOCLIP.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientBackColor
Ruft DISPID_AMBIENT_BACKCOLOR, die Umgebungshintergrundfarbe für alle Vom Container definierten Steuerelemente ab.
HRESULT GetAmbientBackColor(OLE_COLOR& BackColor);
Parameter
BackColor
Die Eigenschaft DISPID_AMBIENT_BACKCOLOR.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientCharSet
Ruft DISPID_AMBIENT_CHARSET ab, der Umgebungszeichensatz für alle Vom Container definierten Steuerelemente.
HRESULT GetAmbientCharSet(BSTR& bstrCharSet);
Parameter
bstrCharSet
Die Eigenschaft DISPID_AMBIENT_CHARSET.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
CComControlBase::GetAmbientCodePage
Ruft DISPID_AMBIENT_CODEPAGE, die Umgebungscodeseite für alle Vom Container definierten Steuerelemente ab.
HRESULT GetAmbientCodePage(ULONG& ulCodePage);
Parameter
ulCodePage
Die Eigenschaft DISPID_AMBIENT_CODEPAGE.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
CComControlBase::GetAmbientDisplayAsDefault
Ruft DISPID_AMBIENT_DISPLAYASDEFAULT ab, ein Flag, das TRUE ist, wenn der Container das Steuerelement auf dieser Website als Standardschaltfläche markiert hat, und daher sollte sich ein Schaltflächensteuerelement mit einem dickeren Frame zeichnen.
HRESULT GetAmbientDisplayAsDefault(BOOL& bDisplayAsDefault);
Parameter
bDisplayAsDefault
Die Eigenschaft DISPID_AMBIENT_DISPLAYASDEFAULT.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientDisplayName
Ruft DISPID_AMBIENT_DISPLAYNAME ab, der Name, den der Container für das Steuerelement bereitgestellt hat.
HRESULT GetAmbientDisplayName(BSTR& bstrDisplayName);
Parameter
bstrDisplayName
Die Eigenschaft DISPID_AMBIENT_DISPLAYNAME.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientFont
Ruft einen Zeiger auf die Umgebungsschnittstelle IFont des Containers ab.
HRESULT GetAmbientFont(IFont** ppFont);
Parameter
ppFont
Ein Zeiger auf die Umgebungs-IFont-Schnittstelle des Containers.
Rückgabewert
Einer der HRESULT-Standardwerte.
Hinweise
Wenn die Eigenschaft NULL ist, ist der Zeiger NULL. Wenn der Zeiger nicht NULL ist, muss der Aufrufer den Zeiger freigeben.
CComControlBase::GetAmbientFontDisp
Ruft einen Zeiger auf die Umgebungs-Dispatch-Schnittstelle IFontDisp des Containers ab.
HRESULT GetAmbientFontDisp(IFontDisp** ppFont);
Parameter
ppFont
Ein Zeiger auf die Umgebungs-IFontDisp-Verteilerschnittstelle des Containers.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
Hinweise
Wenn die Eigenschaft NULL ist, ist der Zeiger NULL. Wenn der Zeiger nicht NULL ist, muss der Aufrufer den Zeiger freigeben.
CComControlBase::GetAmbientForeColor
Ruft DISPID_AMBIENT_FORECOLOR, die Umgebungs-Vordergrundfarbe für alle Vom Container definierten Steuerelemente ab.
HRESULT GetAmbientForeColor(OLE_COLOR& ForeColor);
Parameter
ForeColor
Die Eigenschaft DISPID_AMBIENT_FORECOLOR.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientLocaleID
Ruft DISPID_AMBIENT_LOCALEID ab, der Bezeichner der vom Container verwendeten Sprache.
HRESULT GetAmbientLocaleID(LCID& lcid);
Parameter
lcid
Die Eigenschaft DISPID_AMBIENT_LOCALEID.
Rückgabewert
Einer der HRESULT-Standardwerte.
Hinweise
Das Steuerelement kann diesen Bezeichner verwenden, um seine Benutzeroberfläche an verschiedene Sprachen anzupassen.
CComControlBase::GetAmbientMessageReflect
Ruft DISPID_AMBIENT_MESSAGEREFLECT ab, ein Flag, das angibt, ob der Container Fensternachrichten (z WM_DRAWITEM. B. Ereignisse) empfangen möchte.
HRESULT GetAmbientMessageReflect(BOOL& bMessageReflect);
Parameter
bMessageReflect
Die Eigenschaft DISPID_AMBIENT_MESSAGEREFLECT.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientPalette
Ruft DISPID_AMBIENT_PALETTE ab, der für den Zugriff auf die HPALETTE des Containers verwendet wird.
HRESULT GetAmbientPalette(HPALETTE& hPalette);
Parameter
hPalette
Die Eigenschaft DISPID_AMBIENT_PALETTE.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientProperty
Ruft die durch dispid angegebene Containereigenschaft ab.
HRESULT GetAmbientProperty(DISPID dispid, VARIANT& var);
Parameter
dispid
Bezeichner der abzurufenden Containereigenschaft.
var
Variable zum Empfangen der Eigenschaft.
Rückgabewert
Einer der HRESULT-Standardwerte.
Hinweise
ATL hat eine Reihe von Hilfsfunktionen zum Abrufen bestimmter Eigenschaften bereitgestellt, z. B. CComControlBase::GetAmbientBackColor. Wenn keine geeignete Methode verfügbar ist, verwenden Sie GetAmbientProperty.
CComControlBase::GetAmbientRightToLeft
Ruft DISPID_AMBIENT_RIGHTTOLEFT ab, die Richtung, in der Der Inhalt vom Container angezeigt wird.
HRESULT GetAmbientRightToLeft(BOOL& bRightToLeft);
Parameter
bRightToLeft
Die Eigenschaft DISPID_AMBIENT_RIGHTTOLEFT. Wird auf TRUE festgelegt, wenn Der Inhalt von rechts nach links angezeigt wird, FALSE, wenn er von links nach rechts angezeigt wird.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
CComControlBase::GetAmbientScaleUnits
Ruft DISPID_AMBIENT_SCALEUNITS, die Umgebungseinheiten des Containers (z. B. Zoll oder Zentimeter) für die Beschriftungsanzeige ab.
HRESULT GetAmbientScaleUnits(BSTR& bstrScaleUnits);
Parameter
bstrScaleUnits
Die Eigenschaft DISPID_AMBIENT_SCALEUNITS.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientShowGrabHandles
Ruft DISPID_AMBIENT_SHOWGRABHANDLES ab, ein Flag, das angibt, ob der Container das Anzeigen von Ziehpunkten für sich selbst ermöglicht, wenn er aktiv ist.
HRESULT GetAmbientShowGrabHandles(BOOL& bShowGrabHandles);
Parameter
bShowGrabHandles
Die Eigenschaft DISPID_AMBIENT_SHOWGRABHANDLES.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientShowHatching
Ruft DISPID_AMBIENT_SHOWHATCHING ab, ein Flag, das angibt, ob der Container das Anzeigen des Steuerelements mit einem geschlüpften Muster ermöglicht, wenn die Benutzeroberfläche des Steuerelements aktiv ist.
HRESULT GetAmbientShowHatching(BOOL& bShowHatching);
Parameter
bShowHatching
Die Eigenschaft DISPID_AMBIENT_SHOWHATCHING.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientSupportsMnemonics
Ruft DISPID_AMBIENT_SUPPORTSMNEMONICS ab, ein Flag, das angibt, ob der Container Tastatur-Mnemonics unterstützt.
HRESULT GetAmbientSupportsMnemonics(BOOL& bSupportsMnemonics);
Parameter
bSupportsMnemonics
Die Eigenschaft DISPID_AMBIENT_SUPPORTSMNEMONICS.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientTextAlign
Ruft DISPID_AMBIENT_TEXTALIGN ab, die vom Container bevorzugte Textausrichtung: 0 für die allgemeine Ausrichtung (Zahlen rechts, Text links), 1 für die linke Ausrichtung, 2 für die zentrierte Ausrichtung und 3 für die rechte Ausrichtung.
HRESULT GetAmbientTextAlign(short& nTextAlign);
Parameter
nTextAlign
Die Eigenschaft DISPID_AMBIENT_TEXTALIGN.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetAmbientTopToBottom
Ruft DISPID_AMBIENT_TOPTOBOTTOM ab, die Richtung, in der Der Inhalt vom Container angezeigt wird.
HRESULT GetAmbientTopToBottom(BOOL& bTopToBottom);
Parameter
bTopToBottom
Die Eigenschaft DISPID_AMBIENT_TOPTOBOTTOM. Auf TRUE festgelegt, wenn Text von oben nach unten angezeigt wird, FALSE, wenn er von unten nach oben angezeigt wird.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
CComControlBase::GetAmbientUIDead
Ruft DISPID_AMBIENT_UIDEAD ab, ein Flag, das angibt, ob das Steuerelement auf Benutzeroberflächenaktionen reagieren soll.
HRESULT GetAmbientUIDead(BOOL& bUIDead);
Parameter
bUIDead
Die Eigenschaft DISPID_AMBIENT_UIDEAD.
Rückgabewert
Einer der HRESULT-Standardwerte.
Hinweise
Wenn WAHR, sollte das Steuerelement nicht reagieren. Dieses Kennzeichen gilt unabhängig von der DISPID_AMBIENT_USERMODE Kennzeichnung. Siehe CComControlBase::GetAmbientUserMode.
CComControlBase::GetAmbientUserMode
Ruft DISPID_AMBIENT_USERMODE ab, ein Flag, das angibt, ob sich der Container im Laufzeitmodus (TRUE) oder im Entwurfsmodus (FALSE) befindet.
HRESULT GetAmbientUserMode(BOOL& bUserMode);
Parameter
bUserMode
Die Eigenschaft DISPID_AMBIENT_USERMODE.
Rückgabewert
Einer der HRESULT-Standardwerte.
CComControlBase::GetDirty
Gibt den Wert des Datenelements m_bRequiresSavezurück.
BOOL GetDirty();
Rückgabewert
Gibt den Wert des m_bRequiresSave des Datenelements zurück.
Hinweise
Dieser Wert wird mit CComControlBase::SetDirty festgelegt.
CComControlBase::GetZoomInfo
Ruft die x- und y-Werte des Zählers und Nenner des Zoomfaktors für ein Steuerelement ab, das für die direkte Bearbeitung aktiviert ist.
void GetZoomInfo(ATL_DRAWINFO& di);
Parameter
di
Die Struktur, die den Zähler und den Nenner des Zoomfaktors enthält. Weitere Informationen finden Sie unter ATL_DRAWINFO.
Hinweise
Der Zoomfaktor ist der Anteil der natürlichen Größe des Steuerelements in seinem aktuellen Ausmaß.
CComControlBase::InPlaceActivate
Bewirkt, dass das Steuerelement vom inaktiven Zustand zum zustand wechselt, den das Verb in iVerb angibt.
HRESULT InPlaceActivate(LONG iVerb, const RECT* prcPosRect = NULL);
Parameter
iVerb
Wert, der angibt, welche Aktion von IOleObjectImpl::D oVerb ausgeführt werden soll.
prcPosRect
Zeigen Sie auf die Position des direkten Steuerelements.
Rückgabewert
Einer der HRESULT-Standardwerte.
Hinweise
Vor der Aktivierung überprüft diese Methode, ob das Steuerelement über eine Clientwebsite verfügt, überprüft, wie viel des Steuerelements sichtbar ist, und ruft die Position des Steuerelements im übergeordneten Fenster ab. Nachdem das Steuerelement aktiviert wurde, aktiviert diese Methode die Benutzeroberfläche des Steuerelements und teilt dem Container mit, das Steuerelement sichtbar zu machen.
Diese Methode ruft auch einen IOleInPlaceSite, IOleInPlaceSiteExoder IOleInPlaceSiteWindowless Schnittstellenzeiger für das Steuerelement ab und speichert ihn im Datenmememm CComControlBase::m_spInPlaceSite der Steuerelementklasse. Die Steuerelementklassendatenmber CComControlBase::m_bInPlaceSiteEx, CComControlBase::m_bWndLess, CComControlBase::m_bWasOnceWindowless und CComControlBase::m_bNegotiatedWnd werden entsprechend auf "true" festgelegt.
CComControlBase::InternalGetSite
Rufen Sie diese Methode auf, um die Kontrollwebsite für einen Zeiger auf die identifizierte Schnittstelle abzufragen.
HRESULT InternalGetSite(REFIID riid, void** ppUnkSite);
Parameter
riid
Die IID des Schnittstellenzeigers, der in ppUnkSite zurückgegeben werden soll.
ppUnkSite
Adresse der Zeigervariable, die den in riid angeforderten Schnittstellenzeiger empfängt.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
Hinweise
Wenn die Website die in riid angeforderte Schnittstelle unterstützt, wird der Zeiger mithilfe von ppUnkSite zurückgegeben. Andernfalls wird ppUnkSite auf NULL festgelegt.
CComControlBase::m_bAutoSize
Flag, das angibt, dass das Steuerelement keine andere Größe aufweisen kann.
unsigned m_bAutoSize:1;
Hinweise
Dieses Kennzeichen wird von IOleObjectImpl::SetExtent und, wenn WAHR, bewirkt, dass die Funktion E_FAIL zurückgibt.
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Wenn Sie die Option "Automatische Größe " auf der Registerkarte "Aktieneigenschaften " des ATL-Steuerelement-Assistenten hinzufügen, erstellt der Assistent dieses Datenelement automatisch in Ihrer Steuerelementklasse, erstellt Put- und Get-Methoden für die Eigenschaft und unterstützt IPropertyNotifySink , den Container automatisch zu benachrichtigen, wenn sich die Eigenschaft ändert.
CComControlBase::m_bDrawFromNatural
Flag, das angibt, dass IDataObjectImpl::GetData und CComControlBase::GetZoomInfo die Steuerelementgröße m_sizeNatural anstelle von m_sizeExtent.
unsigned m_bDrawFromNatural:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bDrawGetDataInHimetric
Flag, das angibt, dass IDataObjectImpl::GetData beim Zeichnen HIMETRIC-Einheiten und nicht Pixel verwendet werden sollen.
unsigned m_bDrawGetDataInHimetric:1;
Hinweise
Jede logische HIMETRIC-Einheit beträgt 0,01 Millimeter.
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bInPlaceActive
Flag, das angibt, dass das Steuerelement aktiv ist.
unsigned m_bInPlaceActive:1;
Hinweise
Dies bedeutet, dass das Steuerelement sichtbar ist und das zugehörige Fenster ggf. sichtbar ist, die Menüs und Symbolleisten sind jedoch möglicherweise nicht aktiv. Das m_bUIActive Kennzeichen gibt an, dass die Benutzeroberfläche des Steuerelements, z. B. Menüs, ebenfalls aktiv ist.
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bInPlaceSiteEx
Flag, das angibt, dass der Container die IOleInPlaceSiteEx Schnittstellen- und OCX96-Steuerelementfeatures unterstützt, z. B. fensterlose und flackerfreie Steuerelemente.
unsigned m_bInPlaceSiteEx:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Das Datenelement m_spInPlaceSite verweist auf eine IOleInPlaceSite-, IOleInPlaceSiteEx- oder IOleInPlaceSiteWindowless-Schnittstelle , abhängig vom Wert der m_bWndLess Und m_bInPlaceSiteEx Flags. (Das Datenelement m_bNegotiatedWnd muss TRUE sein, damit der m_spInPlaceSite Zeiger gültig ist.)
Wenn m_bWndLess FALSE und m_bInPlaceSiteEx WAHR ist, m_spInPlaceSite handelt es sich um einen IOleInPlaceSiteEx Schnittstellenzeiger. Eine Tabelle mit der Beziehung zwischen diesen drei Datenmembern finden Sie unter m_spInPlaceSite .
CComControlBase::m_bNegotiatedWnd
Flag, das angibt, ob das Steuerelement mit dem Container über die Unterstützung von OCX96-Steuerelementfeatures (z. B. flackerfreie und fensterlose Steuerelemente) ausgehandelt wurde und ob das Steuerelement fensterlos oder fensterlos ist.
unsigned m_bNegotiatedWnd:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Das m_bNegotiatedWnd Kennzeichen muss TRUE sein, damit der m_spInPlaceSite Zeiger gültig ist.
CComControlBase::m_bRecomposeOnResize
Flag, das angibt, dass das Steuerelement seine Präsentation erneut kompensieren möchte, wenn der Container die Anzeigegröße des Steuerelements ändert.
unsigned m_bRecomposeOnResize:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Dieses Flag wird von IOleObjectImpl::SetExtent überprüft, und wenn TRUE, SetExtent benachrichtigt der Container von Ansichtsänderungen. Wenn dieses Flag festgelegt ist, sollte auch das OLEMISC_RECOMPOSEONRESIZE Bit in der OLEMISC-Aufzählung festgelegt werden.
CComControlBase::m_bRequiresSave
Flag, das angibt, dass das Steuerelement seit dem letzten Speichern geändert wurde.
unsigned m_bRequiresSave:1;
Hinweise
Der Wert kann m_bRequiresSave mit CComControlBase::SetDirty festgelegt und mit CComControlBase::GetDirty abgerufen werden.
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bResizeNatural
Flag, das angibt, dass das Steuerelement seine natürliche Größe (seine nicht skalierte physische Größe) ändern möchte, wenn der Container die Anzeigegröße des Steuerelements ändert.
unsigned m_bResizeNatural:1;
Hinweise
Dieses Kennzeichen wird überprüft, IOleObjectImpl::SetExtent und wenn TRUE, wird die übergebene SetExtent Größe zugewiesen m_sizeNatural.
Die übergebene SetExtent Größe wird unabhängig vom Wert m_bResizeNaturalimmer zugewiesenm_sizeExtent.
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bUIActive
Das Kennzeichen, das angibt, dass die Benutzeroberfläche des Steuerelements, z. B. Menüs und Symbolleisten, aktiv ist.
unsigned m_bUIActive:1;
Hinweise
Das m_bInPlaceActive Flag gibt an, dass das Steuerelement aktiv ist, aber nicht, dass die Benutzeroberfläche aktiv ist.
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bUsingWindowRgn
Flag, das angibt, dass das Steuerelement den vom Container bereitgestellten Fensterbereich verwendet.
unsigned m_bUsingWindowRgn:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bWasOnceWindowless
Flag, das angibt, dass das Steuerelement fensterlos war, aber möglicherweise nicht fensterlos ist.
unsigned m_bWasOnceWindowless:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bWindowOnly
Flag, das angibt, dass das Steuerelement angezeigt werden soll, auch wenn der Container fensterlose Steuerelemente unterstützt.
unsigned m_bWindowOnly:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_bWndLess
Flag, das angibt, dass das Steuerelement fensterlos ist.
unsigned m_bWndLess:1;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Der Datenmemm m_spInPlaceSite verweist auf eine IOleInPlaceSite-, IOleInPlaceSiteEx- oder IOleInPlaceSiteWindowless-Schnittstelle , abhängig vom Wert der m_bWndLess Flags "CComControlBase ::m_bInPlaceSiteEx ". (Das Datenelement CComControlBase::m_bNegotiatedWnd muss TRUE sein, damit der CComControlBase::m_spInPlaceSite Zeiger gültig ist.)
Ist m_bWndLess WAHR, m_spInPlaceSite ist ein IOleInPlaceSiteWindowless Schnittstellenzeiger. Eine Tabelle mit der vollständigen Beziehung zwischen diesen Datenmembern finden Sie unter "CComControlBase::m_spInPlaceSite ".
CComControlBase::m_hWndCD
Enthält einen Verweis auf das fensterhandle, das dem Steuerelement zugeordnet ist.
HWND& m_hWndCD;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_nFreezeEvents
Eine Anzahl der Häufigkeit, mit der der Container gefrorene Ereignisse hat (die Annahme von Ereignissen verweigert wurde), ohne dass ereignisse dazwischen geschlagen werden (Annahme von Ereignissen).
short m_nFreezeEvents;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_rcPos
Die Position in Pixeln des Steuerelements, ausgedrückt in den Koordinaten des Containers.
RECT m_rcPos;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_sizeExtent
Der Umfang des Steuerelements in HIMETRIC-Einheiten (jede Einheit beträgt 0,01 Millimeter) für eine bestimmte Anzeige.
SIZE m_sizeExtent;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Diese Größe wird von der Anzeige skaliert. Die physische Größe des Steuerelements wird im m_sizeNatural Datenmememm angegeben und ist fest.
Sie können die Größe mit der globalen Funktion AtlHiMetricToPixel in Pixel konvertieren.
CComControlBase::m_sizeNatural
Die physische Größe des Steuerelements in HIMETRIC-Einheiten (jede Einheit beträgt 0,01 Millimeter).
SIZE m_sizeNatural;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Diese Größe ist fest, während die Größe m_sizeExtent von der Anzeige skaliert wird.
Sie können die Größe mit der globalen Funktion AtlHiMetricToPixel in Pixel konvertieren.
CComControlBase::m_spAdviseSink
Ein direkter Zeiger auf die Empfehlungsverbindung auf dem Container (der IAdviseSink des Containers).
CComPtr<IAdviseSink>
m_spAdviseSink;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_spAmbientDispatch
Ein CComDispatchDriver Objekt, mit dem Sie die Eigenschaften eines Objekts über einen IDispatch Zeiger abrufen und festlegen können.
CComDispatchDriver m_spAmbientDispatch;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_spClientSite
Ein Zeiger auf den Clientstandort des Steuerelements innerhalb des Containers.
CComPtr<IOleClientSite>
m_spClientSite;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
CComControlBase::m_spDataAdviseHolder
Stellt eine Standardmethode bereit, um Beratungsverbindungen zwischen Datenobjekten zu halten und Senken zu beraten.
CComPtr<IDataAdviseHolder>
m_spDataAdviseHolder;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Ein Datenobjekt ist ein Steuerelement, das Daten übertragen kann und IDataObject implementiert, dessen Methoden das Format angeben und das Medium der Daten übertragen.
Die Schnittstelle m_spDataAdviseHolder implementiert die Methoden "IDataObject::D Advise " und "IDataObject::D Unadvise ", um Beratungsverbindungen mit dem Container einzurichten und zu löschen. Der Container des Steuerelements muss eine Empfehlungsspüle implementieren, indem die IAdviseSink-Schnittstelle unterstützt wird.
CComControlBase::m_spInPlaceSite
Ein Zeiger auf den IOleInPlaceSite-, IOleInPlaceSiteEx- oder IOleInPlaceSiteWindowless-Schnittstellenzeiger .
CComPtr<IOleInPlaceSiteWindowless>
m_spInPlaceSite;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Der m_spInPlaceSite Zeiger ist nur gültig, wenn das m_bNegotiatedWnd Flag WAHR ist.
In der folgenden Tabelle wird gezeigt, wie der m_spInPlaceSite Zeigertyp von den m_bWndLess - und m_bInPlaceSiteEx Datenmememingkennzeichnungen abhängt:
| m_spInPlaceSite Typ | m_bWndLess Wert | m_bInPlaceSiteEx Wert |
|---|---|---|
IOleInPlaceSiteWindowless |
TRUE | TRUE oder FALSE |
IOleInPlaceSiteEx |
FALSE | true |
IOleInPlaceSite |
false | FALSE |
CComControlBase::m_spOleAdviseHolder
Bietet eine Standardimplementierung einer Möglichkeit zum Halten von Beratungsverbindungen.
CComPtr<IOleAdviseHolder>
m_spOleAdviseHolder;
Hinweise
Hinweis
Um dieses Datenelement in Ihrer Steuerelementklasse zu verwenden, müssen Sie es als Datenmemmemm in Ihrer Steuerelementklasse deklarieren. Ihre Steuerelementklasse erbt dieses Datenmember nicht von der Basisklasse, da es in einer Union in der Basisklasse deklariert wird.
Die Schnittstelle m_spOleAdviseHolder implementiert die Methoden "IOleObject::Advise " und "IOleObject::Unadvise ", um Beratungsverbindungen mit dem Container einzurichten und zu löschen. Der Container des Steuerelements muss eine Empfehlungsspüle implementieren, indem die IAdviseSink-Schnittstelle unterstützt wird.
CComControlBase::OnDraw
Überschreiben Sie diese Methode, um Das Steuerelement zu zeichnen.
virtual HRESULT OnDraw(ATL_DRAWINFO& di);
Parameter
di
Ein Verweis auf die ATL_DRAWINFO Struktur, die Zeichnungsinformationen enthält, z. B. den Zeichnungsaspekt, die Grenzen des Steuerelements und ob die Zeichnung optimiert ist oder nicht.
Rückgabewert
Ein HRESULT-Standardwert.
Hinweise
Die Standardeinstellung OnDraw löscht oder stellt den Gerätekontext wieder her oder führt nichts aus, je nachdem, welche Flags in CComControlBase::OnDrawAdvanced festgelegt sind.
Beim Erstellen des Steuerelements mit dem ATL-Steuerelement-Assistenten wird der Steuerelementklasse automatisch eine OnDraw Methode hinzugefügt. Die Standardeinstellung OnDraw des Assistenten zeichnet ein Rechteck mit der Beschriftung "ATL 8.0".
Beispiel
Sehen Sie sich das Beispiel für CComControlBase::GetAmbientAppearance an.
CComControlBase::OnDrawAdvanced
Der Standardwert OnDrawAdvanced bereitet einen normalisierten Gerätekontext für die Zeichnung vor und ruft dann die Methode der Steuerelementklasse OnDraw auf.
virtual HRESULT OnDrawAdvanced(ATL_DRAWINFO& di);
Parameter
di
Ein Verweis auf die ATL_DRAWINFO Struktur, die Zeichnungsinformationen enthält, z. B. den Zeichnungsaspekt, die Grenzen des Steuerelements und ob die Zeichnung optimiert ist oder nicht.
Rückgabewert
Ein HRESULT-Standardwert.
Hinweise
Überschreiben Sie diese Methode, wenn Sie den vom Container übergebenen Gerätekontext akzeptieren möchten, ohne ihn zu normalisieren.
Weitere Informationen finden Sie unter CComControlBase::OnDraw .
CComControlBase::OnKillFocus
Überprüft, ob das Steuerelement aktiv ist und über einen gültigen Steuerelementstandort verfügt, und informiert dann den Container, dass das Steuerelement den Fokus verloren hat.
LRESULT OnKillFocus(UINT /* nMsg */,
WPARAM /* wParam */,
LPARAM /* lParam */,
BOOL& bHandled);
Parameter
nMsg
Reserviert.
wParam
Reserviert.
lParam
Reserviert.
bHandled
Flag, das angibt, ob die Fensternachricht erfolgreich verarbeitet wurde. Der Standardwert lautet FALSE.
Rückgabewert
Gibt immer 1 zurück.
CComControlBase::OnMouseActivate
Überprüft, ob sich die Benutzeroberfläche im Benutzermodus befindet, und aktiviert dann das Steuerelement.
LRESULT OnMouseActivate(UINT /* nMsg */,
WPARAM /* wParam */,
LPARAM /* lParam */,
BOOL& bHandled);
Parameter
nMsg
Reserviert.
wParam
Reserviert.
lParam
Reserviert.
bHandled
Flag, das angibt, ob die Fensternachricht erfolgreich verarbeitet wurde. Der Standardwert lautet FALSE.
Rückgabewert
Gibt immer 1 zurück.
CComControlBase::OnPaint
Bereitet den Container für das Zeichnen vor, ruft den Clientbereich des Steuerelements ab und ruft dann die Methode der Steuerelementklasse OnDrawAdvanced auf.
LRESULT OnPaint(UINT /* nMsg */,
WPARAM wParam,
LPARAM /* lParam */,
BOOL& /* lResult */);
Parameter
nMsg
Reserviert.
wParam
Ein vorhandenes HDC.
lParam
Reserviert.
lResult
Reserviert.
Rückgabewert
Es wird immer NULL zurückgegeben.
Hinweise
Wenn wParam nicht NULL ist, wird davon ausgegangen, OnPaint dass es einen gültigen HDC enthält und anstelle von CComControlBase::m_hWndCD verwendet wird.
CComControlBase::OnSetFocus
Überprüft, ob das Steuerelement aktiv ist und über einen gültigen Kontrollstandort verfügt, und informiert den Container, dass das Steuerelement den Fokus erlangt hat.
LRESULT OnSetFocus(UINT /* nMsg */,
WPARAM /* wParam */,
LPARAM /* lParam */,
BOOL& bHandled);
Parameter
nMsg
Reserviert.
wParam
Reserviert.
lParam
Reserviert.
bHandled
Flag, das angibt, ob die Fensternachricht erfolgreich verarbeitet wurde. Der Standardwert lautet FALSE.
Rückgabewert
Gibt immer 1 zurück.
Hinweise
Sendet eine Benachrichtigung an den Container, dass das Steuerelement den Fokus erhalten hat.
CComControlBase::P reTranslateAccelerator
Überschreiben Sie diese Methode, um Eigene Zugriffstastenhandler bereitzustellen.
BOOL PreTranslateAccelerator(LPMSG /* pMsg */,
HRESULT& /* hRet */);
Parameter
pMsg
Reserviert.
hRet
Reserviert.
Rückgabewert
Standardmäßig wird FALSE zurückgegeben.
CComControlBase::SendOnClose
Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass die Kontrolle geschlossen wurde.
HRESULT SendOnClose();
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
Hinweise
Sendet eine Benachrichtigung, dass das Steuerelement seine Beratenden Senken geschlossen hat.
CComControlBase::SendOnDataChange
Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass sich die Kontrolldaten geändert haben.
HRESULT SendOnDataChange(DWORD advf = 0);
Parameter
advf
Empfehlen Sie Flags, die angeben, wie der Aufruf von IAdviseSink::OnDataChange erfolgt. Werte stammen aus der ADVF-Aufzählung .
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
CComControlBase::SendOnRename
Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass die Kontrolle über einen neuen Moniker verfügt.
HRESULT SendOnRename(IMoniker* pmk);
Parameter
pmk
Zeigen Sie auf den neuen Moniker des Steuerelements.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
Hinweise
Sendet eine Benachrichtigung, dass der Moniker für das Steuerelement geändert wurde.
CComControlBase::SendOnSave
Benachrichtigt alle bei dem Beratungsinhaber registrierten Beratungssenken, dass die Kontrolle gespeichert wurde.
HRESULT SendOnSave();
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
Hinweise
Sendet eine Benachrichtigung, dass das Steuerelement gerade seine Daten gespeichert hat.
CComControlBase::SendOnViewChange
Benachrichtigt alle registrierten Beratungssenken, dass sich die Ansicht des Steuerelements geändert hat.
HRESULT SendOnViewChange(DWORD dwAspect, LONG lindex = -1);
Parameter
dwAspect
Der Aspekt oder die Ansicht des Steuerelements.
lindex
Der Teil der Ansicht, der geändert wurde. Nur -1 ist gültig.
Rückgabewert
S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.
Hinweise
SendOnViewChange ruft IAdviseSink::OnViewChange auf. Der einzige zurzeit unterstützte Lindex-Wert ist -1, was angibt, dass die gesamte Ansicht von Interesse ist.
CComControlBase::SetControlFocus
Legt den Tastaturfokus auf oder aus dem Steuerelement fest oder entfernt sie.
BOOL SetControlFocus(BOOL bGrab);
Parameter
bGrab
Wenn TRUE, legt den Tastaturfokus auf das aufrufende Steuerelement fest. Wenn FALSE, wird der Tastaturfokus aus dem aufrufenden Steuerelement entfernt, sofern er den Fokus hat.
Rückgabewert
Gibt WAHR zurück, wenn das Steuerelement erfolgreich den Fokus erhält; andernfalls FALSE.
Hinweise
Für ein Fenstersteuerelement wird die Windows-API-Funktion SetFocus aufgerufen. Für ein fensterloses Steuerelement wird IOleInPlaceSiteWindowless::SetFocus aufgerufen. Durch diesen Aufruf erhält ein fensterloses Steuerelement den Tastaturfokus und kann auf Fenstermeldungen reagieren.
CComControlBase::SetDirty
Legt das Datenelement m_bRequiresSave auf den Wert in bDirty fest.
void SetDirty(BOOL bDirty);
Parameter
bDirty
Wert des Datenelements CComControlBase::m_bRequiresSave.
Hinweise
SetDirty(TRUE) sollte aufgerufen werden, um zu kennzeichnen, dass sich das Steuerelement seit dem letzten Speichern geändert hat. Der Wert von m_bRequiresSave wird mit CComControlBase::GetDirty abgerufen.