CComControlBase-osztály

Megjegyzés:

Az aktív sablontár (ATL) továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Ez az osztály metódusokat biztosít az ATL-vezérlők létrehozásához és kezeléséhez.

Fontos

Ez az osztály és tagjai nem használhatók a Windows futtatókörnyezetben futó alkalmazásokban.

Szemantika

class ATL_NO_VTABLE CComControlBase

Tagok

Nyilvános típustdefiníciók

Név	Description
CComControlBase::AppearanceType	Felülbírálás, ha a m_nAppearance részvénytulajdonság nem típus .short

Nyilvános konstruktorok

Név	Description
CComControlBase::CComControlBase	A konstruktor.
CComControlBase::~CComControlBase	A destruktor.

Nyilvános módszerek

Név	Description
CComControlBase::ControlQueryInterface	A kért felületre mutató mutatót kér le.
CComControlBase::D oesVerbActivate	Ellenőrzi, hogy az általuk használt IOleObjectImpl::DoVerbiVerb paraméter aktiválja-e a vezérlő felhasználói felületét (az iVerb OLEIVERB_UIACTIVATE egyenlő), meghatározza azokat a műveletet, amelyeket akkor hajt végre, amikor a felhasználó duplán kattint a vezérlőre (iVerb egyenlő OLEIVERB_PRIMARY), megjeleníti a vezérlőt (iVerb egyenlő OLEIVERB_SHOW), vagy aktiválja a vezérlőt (az iVerb egyenlő OLEIVERB_INPLACEACTIVATE).
CComControlBase::D oesVerbUIActivate	Ellenőrzi, hogy az általuk használt IOleObjectImpl::DoVerbiVerb paraméter aktiválja-e a vezérlő felhasználói felületét, és true értéket ad-e vissza.
CComControlBase::D oVerbProperties	Megjeleníti a vezérlő tulajdonságlapjait.
CComControlBase::FireViewChange	Hívja meg ezt a metódust, és kérje meg a tárolót, hogy módosítsa újra a vezérlőt, vagy értesítse a regisztrált tanácsadó fogadókat arról, hogy a vezérlő nézete megváltozott.
CComControlBase::GetAmbientAppearance	Lekéri DISPID_AMBIENT_APPEARANCE, a vezérlő aktuális megjelenési beállítását: 0 lapos és 1 3D esetén.
CComControlBase::GetAmbientAutoClip	Lekéri a DISPID_AMBIENT_AUTOCLIP, egy jelzőt, amely jelzi, hogy a tároló támogatja-e a vezérlő megjelenítési területének automatikus kivágását.
CComControlBase::GetAmbientBackColor	Lekéri DISPID_AMBIENT_BACKCOLOR, a tároló által definiált összes vezérlő környezeti háttérszínét.
CComControlBase::GetAmbientCharSet	Lekéri DISPID_AMBIENT_CHARSET, a tároló által definiált összes vezérlő környezeti karakterét.
CComControlBase::GetAmbientCodePage	Lekéri DISPID_AMBIENT_CODEPAGE, a tároló által definiált összes vezérlő környezeti karakterét.
CComControlBase::GetAmbientDisplayAsDefault	Lekéri a DISPID_AMBIENT_DISPLAYASDEFAULT, amely igaz, ha a tároló alapértelmezett gombként jelölte meg a vezérlőt ezen a webhelyen, ezért a gombvezérlőnek vastagabb kerettel kell rajzolnia magát.
CComControlBase::GetAmbientDisplayName	Lekéri DISPID_AMBIENT_DISPLAYNAME, a tároló által a vezérlőnek megadott nevet.
CComControlBase::GetAmbientFont	A tároló környezeti IFont felületére mutató mutatót kér le.
CComControlBase::GetAmbientFontDisp	Egy mutatót kér le a tároló környezeti IFontDisp diszpécserfelületére.
CComControlBase::GetAmbientForeColor	Lekéri a tároló által definiált összes vezérlő környezeti előtérszínét, a DISPID_AMBIENT_FORECOLOR.
CComControlBase::GetAmbientLocaleID	Lekéri DISPID_AMBIENT_LOCALEID, a tároló által használt nyelv azonosítóját.
CComControlBase::GetAmbientMessageReflect	Lekéri a DISPID_AMBIENT_MESSAGEREFLECT, egy jelzőt, amely jelzi, hogy a tároló eseményként szeretné-e fogadni az ablaküzeneteket (például WM_DRAWITEM).
CComControlBase::GetAmbientPalette	Lekéri a tároló HPALETTE-jének eléréséhez használt DISPID_AMBIENT_PALETTE.
CComControlBase::GetAmbientProperty	Lekéri az azonosító által megadott tárolótulajdonságot.
CComControlBase::GetAmbientRightToLeft	Lekéri a DISPID_AMBIENT_RIGHTTOLEFT, a tároló által megjelenített tartalom irányát.
CComControlBase::GetAmbientScaleUnits	Lekéri a DISPID_AMBIENT_SCALEUNITS, a tároló környezeti egységeit (például hüvelyket vagy centimétert) a címkék megjelenítéséhez.
CComControlBase::GetAmbientShowGrabHandles	Lekéri DISPID_AMBIENT_SHOWGRABHANDLES, egy jelzőt, amely jelzi, hogy a tároló lehetővé teszi-e a vezérlő számára a fogópontok megjelenítését, amikor aktív.
CComControlBase::GetAmbientShowHatching	Lekéri a DISPID_AMBIENT_SHOWHATCHING, amely jelzi, hogy a tároló lehetővé teszi-e, hogy a vezérlő kikelt mintával jelenítse meg magát, amikor a felhasználói felület aktív.
CComControlBase::GetAmbientSupportsMnemonics	Lekéri DISPID_AMBIENT_SUPPORTSMNEMONICS, amely jelzi, hogy a tároló támogatja-e a billentyűzet mnemonikát.
CComControlBase::GetAmbientTextAlign	Lekéri a DISPID_AMBIENT_TEXTALIGN, a tároló által előnyben részesített szöveg igazítását: 0 az általános igazításhoz (jobbra, szöveg balra), 1 a bal igazításhoz, 2 a középső igazításhoz, 3 pedig a jobb igazításhoz.
CComControlBase::GetAmbientTopToBottom	Lekéri DISPID_AMBIENT_TOPTOBOTTOM, a tároló által megjelenített tartalom irányát.
CComControlBase::GetAmbientUIDead	Lekéri a DISPID_AMBIENT_UIDEAD, egy jelzőt, amely jelzi, hogy a tároló szeretné-e, hogy a vezérlő válaszoljon a felhasználói felület műveleteire.
CComControlBase::GetAmbientUserMode	Lekéri a DISPID_AMBIENT_USERMODE, egy jelzőt, amely jelzi, hogy a tároló futtatási módban (IGAZ) vagy tervező módban (FALSE) van-e.
CComControlBase::GetDirty	Az adattag m_bRequiresSaveértékét adja vissza.
CComControlBase::GetZoomInfo	Lekéri a helyszíni szerkesztéshez aktivált vezérlőelem nagyítási tényezőjének számlálójának és nevezőjének x és y értékeit.
CComControlBase::InPlaceActivate	A vezérlő az inaktív állapotról az iVerbben látható bármilyen állapotra vált.
CComControlBase::InternalGetSite	Ennek a metódusnak a meghívásával lekérdezheti a vezérlőwebhelyet az azonosított felületre mutató mutatóhoz.
CComControlBase::OnDraw	Felülbírálhatja ezt a módszert a vezérlő rajzolásához.
CComControlBase::OnDrawAdvanced	Az alapértelmezett beállítás OnDrawAdvanced előkészít egy normalizált eszközkörnyezetet a rajzhoz, majd meghívja a vezérlőosztály metódusát OnDraw .
CComControlBase::OnKillFocus	Ellenőrzi, hogy a vezérlő aktív-e, és érvényes vezérlőhellyel rendelkezik-e, majd tájékoztatja a tárolót arról, hogy a vezérlő elvesztette a fókuszt.
CComControlBase::OnMouseActivate	Ellenőrzi, hogy a felhasználói felület felhasználói módban van-e, majd aktiválja a vezérlőt.
CComControlBase::OnPaint	Előkészíti a tárolót festésre, lekéri a vezérlő ügyfélterületét, majd meghívja a vezérlőosztály metódusát OnDraw .
CComControlBase::OnSetFocus	Ellenőrzi, hogy a vezérlő helyben aktív-e, és érvényes vezérlőhellyel rendelkezik-e, majd tájékoztatja a tárolót, amellyel a vezérlő fókuszba került.
CComControlBase::P reTranslateAccelerator	Bírálja felül ezt a módszert, hogy saját billentyűzetgyorsító-kezelőket biztosítson.
CComControlBase::SendOnClose	Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzést lezárták.
CComControlBase::SendOnDataChange	Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzési adatok megváltoztak.
CComControlBase::SendOnRename	Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzés új bevétellel rendelkezik.
CComControlBase::SendOnSave	Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzést megmentették.
CComControlBase::SendOnViewChange	Értesíti az összes regisztrált tanácsadó fogadót, hogy a vezérlő nézete megváltozott.
CComControlBase::SetControlFocus	Beállítja vagy eltávolítja a billentyűzetfókuszt a vezérlőbe vagy onnan.
CComControlBase::SetDirty	Az adattagot m_bRequiresSave a bDirty értékére állítja.

Nyilvános adatok tagjai

Név	Description
CComControlBase::m_bAutoSize	A vezérlőt jelző jelölő nem lehet más méretű.
CComControlBase::m_bDrawFromNatural	Ezt jelző jelölő, IDataObjectImpl::GetData és CComControlBase::GetZoomInfo a vezérlő méretét nem a forrástól, hanem a jelölőtől m_sizeNaturalm_sizeExtentkell beállítania.
CComControlBase::m_bDrawGetDataInHimetric	A jelölő azt jelzi, hogy IDataObjectImpl::GetData a rajzoláskor ne képpontokat, hanem HIMETRIC egységeket használjon.
CComControlBase::m_bInPlaceActive	A vezérlőt helyi aktívként jelző jelző.
CComControlBase::m_bInPlaceSiteEx	A tárolót jelző jelző támogatja az interfész és az IOleInPlaceSiteEx OCX96 vezérlőfunkcióit, például az ablak nélküli és a villódzásmentes vezérlőket.
CComControlBase::m_bNegotiatedWnd	Jelző, amely jelzi, hogy a vezérlő egyeztetett-e a tárolóval az OCX96 vezérlőfunkciók (például villódzó és ablak nélküli vezérlők) támogatásáról, valamint arról, hogy a vezérlő ablakos vagy ablak nélküli-e.
CComControlBase::m_bRecomposeOnResize	Jelző, amely azt jelzi, hogy a vezérlő újra szeretné összeállítani a bemutatóját, amikor a tároló módosítja a vezérlő megjelenítési méretét.
CComControlBase::m_bRequiresSave	A vezérlő utolsó mentése óta megváltozott vezérlőt jelző jelző.
CComControlBase::m_bResizeNatural	Jelölő, amely jelzi, hogy a vezérlő a vezérlő megjelenítési méretének módosításakor a természetes kiterjedését (a méretezetlen fizikai méretét) szeretné átméretezni.
CComControlBase::m_bUIActive	A vezérlő felhasználói felületét , például menüket és eszköztárakat jelző jelző aktív.
CComControlBase::m_bUsingWindowRgn	A vezérlőt jelző jelző a tároló által megadott ablakterületet használja.
CComControlBase::m_bWasOnceWindowless	A vezérlő ablak nélküli, de lehet, hogy nem ablak nélküli.
CComControlBase::m_bWindowOnly	A vezérlőt jelző jelzőt akkor is ablakba kell helyezni, ha a tároló támogatja az ablak nélküli vezérlőket.
CComControlBase::m_bWndLess	A vezérlőt jelző jelző ablak nélküli.
CComControlBase::m_hWndCD	A vezérlőhöz társított ablakfogópontra mutató hivatkozást tartalmaz.
CComControlBase::m_nFreezeEvents	Azon esetek száma, amikor a tároló befagyasztotta az eseményeket (megtagadta az események fogadását) az események beavatkozás nélküli felolvassa nélkül (az események elfogadása).
CComControlBase::m_rcPos	A vezérlő képpontban megadott pozíciója, a tároló koordinátáiban kifejezve.
CComControlBase::m_sizeExtent	A HIMETRIC egységek vezérlőjének mértéke (minden egység 0,01 milliméter) egy adott kijelzőhöz.
CComControlBase::m_sizeNatural	A vezérlő fizikai mérete HIMETRIC egységekben (mindegyik egység 0,01 milliméter).
CComControlBase::m_spAdviseSink	Közvetlen mutató a tároló tanácsadó kapcsolatára (a tároló IAdviseSinkje).
CComControlBase::m_spAmbientDispatch	Egy CComDispatchDriver objektum, amely lehetővé teszi a tároló tulajdonságainak lekérését és beállítását egy IDispatch mutatóval.
CComControlBase::m_spClientSite	Mutató a vezérlő ügyfélwebhelyére a tárolón belül.
CComControlBase::m_spDataAdviseHolder	Szabványos eszközt biztosít az adatobjektumok közötti tanácsadási kapcsolatok tárolására és a fogadók tanácsára.
CComControlBase::m_spInPlaceSite	Mutató a tároló IOleInPlaceSite, IOleInPlaceSiteEx vagy IOleInPlaceSiteWindowless interfészmutatójára.
CComControlBase::m_spOleAdviseHolder	A tanácsadási kapcsolatok tárolásának szabványos implementációját biztosítja.

Megjegyzések

Ez az osztály metódusokat biztosít az ATL-vezérlők létrehozásához és kezeléséhez. A CComControl osztály a CComControlBase. Amikor az ATL vezérlővarázslóval létrehoz egy standard vagy DHTML-vezérlőt, a varázsló automatikusan lekéri az osztályt.CComControlBase

A vezérlők létrehozásával kapcsolatos további információkért tekintse meg az ATL-oktatóanyagot. Az ATL-projektvarázslóról további információt az ATL-projekt létrehozása című cikkben talál.

Requirements

Fejléc: atlctl.h

CComControlBase::AppearanceType

Felülbírálás, ha a m_nAppearance részvénytulajdonság nem típus .short

typedef short AppearanceType;

Megjegyzések

Az ATL vezérlővarázsló rövid típusú részvénytulajdonságot ad m_nAppearance hozzá. Felülbírálás AppearanceType , ha más adattípust használ.

CComControlBase::CComControlBase

A konstruktor.

CComControlBase(HWND& h);

Paraméterek

h
A vezérlőhöz társított ablak fogópontja.

Megjegyzések

Inicializálja a vezérlő méretét 5080X5080 HIMETRIC egységre (2"X2"), és inicializálja az CComControlBase adattagértékeket NULL vagy FALSE értékre.

CComControlBase::~CComControlBase

A destruktor.

~CComControlBase();

Megjegyzések

Ha a vezérlő ablakba kerül, ~CComControlBase elpusztítja a DestroyWindow meghívásával.

CComControlBase::ControlQueryInterface

A kért felületre mutató mutatót kér le.

virtual HRESULT ControlQueryInterface(const IID& iid,
    void** ppv);

Paraméterek

iid
A kért felület GUID azonosítója.

Ppv
Az iid által azonosított illesztőmutatóra mutató mutató, vagy null értékű, ha a felület nem található.

Megjegyzések

Csak a COM-térképtáblában lévő felületeket kezeli.

Example

// 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

Ellenőrzi, hogy az általuk használt IOleObjectImpl::DoVerbiVerb paraméter aktiválja-e a vezérlő felhasználói felületét (az iVerb OLEIVERB_UIACTIVATE egyenlő), meghatározza azokat a műveletet, amelyeket akkor hajt végre, amikor a felhasználó duplán kattint a vezérlőre (iVerb egyenlő OLEIVERB_PRIMARY), megjeleníti a vezérlőt (iVerb egyenlő OLEIVERB_SHOW), vagy aktiválja a vezérlőt (az iVerb egyenlő OLEIVERB_INPLACEACTIVATE).

BOOL DoesVerbActivate(LONG iVerb);

Paraméterek

iVerb
A végrehajtandó DoVerbműveletet jelző érték.

Visszaadott érték

IGAZ értéket ad vissza, ha az iVerb értéke OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW vagy OLEIVERB_INPLACEACTIVATE; ellenkező esetben HAMIS értéket ad vissza.

Megjegyzések

Ezt a metódust felülbírálhatja a saját aktiválási ige definiálásához.

CComControlBase::D oesVerbUIActivate

Ellenőrzi, hogy az általuk használt IOleObjectImpl::DoVerbiVerb paraméter aktiválja-e a vezérlő felhasználói felületét, és true értéket ad-e vissza.

BOOL DoesVerbUIActivate(LONG iVerb);

Paraméterek

iVerb
A végrehajtandó DoVerbműveletet jelző érték.

Visszaadott érték

IGAZ értéket ad vissza, ha az iVerb értéke OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW vagy OLEIVERB_INPLACEACTIVATE. Ellenkező esetben a metódus HAMIS értéket ad vissza.

CComControlBase::D oVerbProperties

Megjeleníti a vezérlő tulajdonságlapjait.

HRESULT DoVerbProperties(LPCRECT /* prcPosRect */, HWND hwndParent);

Paraméterek

prcPosRec
Fenntartott.

hwndParent
A vezérlőt tartalmazó ablak fogópontja.

Visszaadott érték

Az egyik standard HRESULT érték.

Example

// 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

Hívja meg ezt a metódust, és kérje meg a tárolót, hogy módosítsa újra a vezérlőt, vagy értesítse a regisztrált tanácsadó fogadókat arról, hogy a vezérlő nézete megváltozott.

HRESULT FireViewChange();

Visszaadott érték

Az egyik standard HRESULT érték.

Megjegyzések

Ha a vezérlő aktív (a CComControlBase vezérlőosztály adattagja::m_bInPlaceActive IGAZ), értesíti a tárolót, amelyet a teljes vezérlő újrarajzolni szeretne. Ha a vezérlő inaktív, értesíti a vezérlő regisztrált fogadóit (a CComControlBase vezérlőosztály adattagján keresztül::m_spAdviseSink), hogy a vezérlő nézete megváltozott.

Example

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

Lekéri DISPID_AMBIENT_APPEARANCE, a vezérlő aktuális megjelenési beállítását: 0 lapos és 1 3D esetén.

HRESULT GetAmbientAppearance(short& nAppearance);

Paraméterek

nAppearance
A tulajdonság DISPID_AMBIENT_APPEARANCE.

Visszaadott érték

Az egyik standard HRESULT érték.

Example

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

Lekéri a DISPID_AMBIENT_AUTOCLIP, egy jelzőt, amely jelzi, hogy a tároló támogatja-e a vezérlő megjelenítési területének automatikus kivágását.

HRESULT GetAmbientAutoClip(BOOL& bAutoClip);

Paraméterek

bAutoClip
A tulajdonság DISPID_AMBIENT_AUTOCLIP.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientBackColor

Lekéri DISPID_AMBIENT_BACKCOLOR, a tároló által definiált összes vezérlő környezeti háttérszínét.

HRESULT GetAmbientBackColor(OLE_COLOR& BackColor);

Paraméterek

BackColor
A tulajdonság DISPID_AMBIENT_BACKCOLOR.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientCharSet

Lekéri DISPID_AMBIENT_CHARSET, a tároló által definiált összes vezérlő környezeti karakterét.

HRESULT GetAmbientCharSet(BSTR& bstrCharSet);

Paraméterek

bstrCharSet
A tulajdonság DISPID_AMBIENT_CHARSET.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

CComControlBase::GetAmbientCodePage

Lekéri DISPID_AMBIENT_CODEPAGE, a tároló által definiált összes vezérlő környezeti kódlapját.

HRESULT GetAmbientCodePage(ULONG& ulCodePage);

Paraméterek

ulCodePage
A tulajdonság DISPID_AMBIENT_CODEPAGE.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

CComControlBase::GetAmbientDisplayAsDefault

Lekéri a DISPID_AMBIENT_DISPLAYASDEFAULT, amely igaz, ha a tároló alapértelmezett gombként jelölte meg a vezérlőt ezen a webhelyen, ezért a gombvezérlőnek vastagabb kerettel kell rajzolnia magát.

HRESULT GetAmbientDisplayAsDefault(BOOL& bDisplayAsDefault);

Paraméterek

bDisplayAsDefault
A tulajdonság DISPID_AMBIENT_DISPLAYASDEFAULT.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientDisplayName

Lekéri DISPID_AMBIENT_DISPLAYNAME, a tároló által a vezérlőnek megadott nevet.

HRESULT GetAmbientDisplayName(BSTR& bstrDisplayName);

Paraméterek

bstrDisplayName
A tulajdonság DISPID_AMBIENT_DISPLAYNAME.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientFont

A tároló környezeti IFont felületére mutató mutatót kér le.

HRESULT GetAmbientFont(IFont** ppFont);

Paraméterek

ppFont
Mutató a tároló környezeti IFont-felületére .

Visszaadott érték

Az egyik standard HRESULT érték.

Megjegyzések

Ha a tulajdonság NULL, akkor a mutató NULL. Ha a mutató nem NULL, a hívónak fel kell szabadítania a mutatót.

CComControlBase::GetAmbientFontDisp

Egy mutatót kér le a tároló környezeti IFontDisp diszpécserfelületére.

HRESULT GetAmbientFontDisp(IFontDisp** ppFont);

Paraméterek

ppFont
Mutató a tároló környezeti IFontDisp diszpécserfelületére.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

Megjegyzések

Ha a tulajdonság NULL, akkor a mutató NULL. Ha a mutató nem NULL, a hívónak fel kell szabadítania a mutatót.

CComControlBase::GetAmbientForeColor

Lekéri a tároló által definiált összes vezérlő környezeti előtérszínét, a DISPID_AMBIENT_FORECOLOR.

HRESULT GetAmbientForeColor(OLE_COLOR& ForeColor);

Paraméterek

ForeColor
A tulajdonság DISPID_AMBIENT_FORECOLOR.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientLocaleID

Lekéri DISPID_AMBIENT_LOCALEID, a tároló által használt nyelv azonosítóját.

HRESULT GetAmbientLocaleID(LCID& lcid);

Paraméterek

A tulajdonság DISPID_AMBIENT_LOCALEID.

Visszaadott érték

Az egyik standard HRESULT érték.

Megjegyzések

A vezérlő ezt az azonosítót használhatja a felhasználói felület különböző nyelvekhez való igazításához.

CComControlBase::GetAmbientMessageReflect

Lekéri a DISPID_AMBIENT_MESSAGEREFLECT, egy jelzőt, amely jelzi, hogy a tároló ablaküzeneteket (például WM_DRAWITEM) szeretne-e eseményként fogadni.

HRESULT GetAmbientMessageReflect(BOOL& bMessageReflect);

Paraméterek

bMessageReflect
A tulajdonság DISPID_AMBIENT_MESSAGEREFLECT.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientPalette

Lekéri a tároló HPALETTE-jének eléréséhez használt DISPID_AMBIENT_PALETTE.

HRESULT GetAmbientPalette(HPALETTE& hPalette);

Paraméterek

hPalette
A tulajdonság DISPID_AMBIENT_PALETTE.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientProperty

Lekéri a dispid által megadott tárolótulajdonságot.

HRESULT GetAmbientProperty(DISPID dispid, VARIANT& var);

Paraméterek

dispid
A lekérendő tárolótulajdonság azonosítója.

var
A tulajdonság fogadásához használt változó.

Visszaadott érték

Az egyik standard HRESULT érték.

Megjegyzések

Az ATL több segédfüggvényt is biztosított bizonyos tulajdonságok lekéréséhez, például : CComControlBase::GetAmbientBackColor. Ha nem áll rendelkezésre megfelelő módszer, használja GetAmbientPropertya .

CComControlBase::GetAmbientRightToLeft

Lekéri a DISPID_AMBIENT_RIGHTTOLEFT, a tároló által megjelenített tartalom irányát.

HRESULT GetAmbientRightToLeft(BOOL& bRightToLeft);

Paraméterek

bRightToLeft
A tulajdonság DISPID_AMBIENT_RIGHTTOLEFT. Állítsa IGAZ értékre, ha a tartalom jobbról balra, HAMIS értékre van állítva, ha balról jobbra jelenik meg.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

CComControlBase::GetAmbientScaleUnits

Lekéri a DISPID_AMBIENT_SCALEUNITS, a tároló környezeti egységeit (például hüvelyket vagy centimétert) a címkék megjelenítéséhez.

HRESULT GetAmbientScaleUnits(BSTR& bstrScaleUnits);

Paraméterek

bstrScaleUnits
A tulajdonság DISPID_AMBIENT_SCALEUNITS.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientShowGrabHandles

Lekéri DISPID_AMBIENT_SHOWGRABHANDLES, egy jelzőt, amely jelzi, hogy a tároló lehetővé teszi-e a vezérlő számára a fogópontok megjelenítését, amikor aktív.

HRESULT GetAmbientShowGrabHandles(BOOL& bShowGrabHandles);

Paraméterek

bShowGrabHandles
A tulajdonság DISPID_AMBIENT_SHOWGRABHANDLES.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientShowHatching

Lekéri a DISPID_AMBIENT_SHOWHATCHING, egy jelzőt, amely jelzi, hogy a tároló lehetővé teszi-e, hogy a vezérlő kikelt mintával jelenítse meg magát, amikor a vezérlő felhasználói felülete aktív.

HRESULT GetAmbientShowHatching(BOOL& bShowHatching);

Paraméterek

bShowHatching
A tulajdonság DISPID_AMBIENT_SHOWHATCHING.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientSupportsMnemonics

Lekéri DISPID_AMBIENT_SUPPORTSMNEMONICS, amely jelzi, hogy a tároló támogatja-e a billentyűzet mnemonikát.

HRESULT GetAmbientSupportsMnemonics(BOOL& bSupportsMnemonics);

Paraméterek

bSupportsMnemonics
A tulajdonság DISPID_AMBIENT_SUPPORTSMNEMONICS.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientTextAlign

Lekéri a DISPID_AMBIENT_TEXTALIGN, a tároló által előnyben részesített szöveg igazítását: 0 az általános igazításhoz (jobbra, szöveg balra), 1 a bal igazításhoz, 2 a középső igazításhoz, 3 pedig a jobb igazításhoz.

HRESULT GetAmbientTextAlign(short& nTextAlign);

Paraméterek

nTextAlign
A tulajdonság DISPID_AMBIENT_TEXTALIGN.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetAmbientTopToBottom

Lekéri DISPID_AMBIENT_TOPTOBOTTOM, a tároló által megjelenített tartalom irányát.

HRESULT GetAmbientTopToBottom(BOOL& bTopToBottom);

Paraméterek

bTopToBottom
A tulajdonság DISPID_AMBIENT_TOPTOBOTTOM. Ha a szöveg felülről lefelé jelenik meg, igaz értékre, ha alulról fentre jelenik meg.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

CComControlBase::GetAmbientUIDead

Lekéri a DISPID_AMBIENT_UIDEAD, egy jelzőt, amely jelzi, hogy a tároló szeretné-e, hogy a vezérlő válaszoljon a felhasználói felület műveleteire.

HRESULT GetAmbientUIDead(BOOL& bUIDead);

Paraméterek

bUIDead
A tulajdonság DISPID_AMBIENT_UIDEAD.

Visszaadott érték

Az egyik standard HRESULT érték.

Megjegyzések

Ha IGAZ, a vezérlőnek nem szabad válaszolnia. Ez a jelző a DISPID_AMBIENT_USERMODE jelzőtől függetlenül érvényes. Lásd: CComControlBase::GetAmbientUserMode.

CComControlBase::GetAmbientUserMode

Lekéri a DISPID_AMBIENT_USERMODE, egy jelzőt, amely jelzi, hogy a tároló futtatási módban (IGAZ) vagy tervező módban (FALSE) van-e.

HRESULT GetAmbientUserMode(BOOL& bUserMode);

Paraméterek

bUserMode
A tulajdonság DISPID_AMBIENT_USERMODE.

Visszaadott érték

Az egyik standard HRESULT érték.

CComControlBase::GetDirty

Az adattag m_bRequiresSaveértékét adja vissza.

BOOL GetDirty();

Visszaadott érték

Az adattag m_bRequiresSave értékét adja vissza.

Megjegyzések

Ez az érték a CComControlBase::SetDirty használatával van beállítva.

CComControlBase::GetZoomInfo

Lekéri a helyszíni szerkesztéshez aktivált vezérlőelem nagyítási tényezőjének számlálójának és nevezőjének x és y értékeit.

void GetZoomInfo(ATL_DRAWINFO& di);

Paraméterek

Di
A nagyítási tényező számlálóját és nevezőjét tartalmazó struktúra. További információ: ATL_DRAWINFO.

Megjegyzések

A nagyítási tényező a vezérlő természetes méretének a jelenlegi mérethez viszonyított aránya.

CComControlBase::InPlaceActivate

A vezérlő az inaktív állapotról az iVerbben látható bármilyen állapotra vált.

HRESULT InPlaceActivate(LONG iVerb, const RECT* prcPosRect = NULL);

Paraméterek

iVerb
Az IOleObjectImpl::D oVerb által végrehajtandó műveletet jelző érték.

prcPosRect
Mutasson a helyben lévő vezérlő helyére.

Visszaadott érték

Az egyik standard HRESULT érték.

Megjegyzések

Az aktiválás előtt ez a metódus ellenőrzi, hogy a vezérlő rendelkezik-e ügyfélhellyel, ellenőrzi, hogy a vezérlő mekkora része látható, és a vezérlő helyét a szülőablakban kapja meg. A vezérlő aktiválása után ez a metódus aktiválja a vezérlő felhasználói felületét, és tájékoztatja a tárolót, hogy tegye láthatóvá a vezérlőt.

Ez a metódus lekéri a vezérlő egy IOleInPlaceSite, IOleInPlaceSiteExvagy IOleInPlaceSiteWindowless interfész mutatóját is, és a vezérlőosztály CComControlBase adattagjában tárolja:m_spInPlaceSite. A CComControlBase::m_bInPlaceSiteEx, a CComControlBase::m_bWndLess, a CComControlBase::m_bWasOnceWindowless és a CComControlBase::m_bNegotiatedWnd vezérlőosztály-adattagok a megfelelő értékre vannak állítva.

CComControlBase::InternalGetSite

Ennek a metódusnak a meghívásával lekérdezheti a vezérlőwebhelyet az azonosított felületre mutató mutatóhoz.

HRESULT InternalGetSite(REFIID riid, void** ppUnkSite);

Paraméterek

riid
A ppUnkSite-ben visszaadandó felületmutató IID azonosítója.

ppUnkSite
Annak a mutatóváltozónak a címe, amely a riidben kért interfészmutatót fogadja.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

Megjegyzések

Ha a webhely támogatja a riidben kért felületet, a mutatót a ppUnkSite segítségével adja vissza. Ellenkező esetben a ppUnkSite értéke NULL.

CComControlBase::m_bAutoSize

A vezérlőt jelző jelölő nem lehet más méretű.

unsigned m_bAutoSize:1;

Megjegyzések

Ezt a jelölőt IOleObjectImpl::SetExtent a rendszer ellenőrzi, és ha IGAZ, akkor a függvény E_FAIL ad vissza.

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Ha hozzáadja az Automatikus méret beállítást az ATL vezérlővarázsló Készlettulajdonságok lapján, a varázsló automatikusan létrehozza ezt az adattagot a vezérlőosztályban, létrehoz egy put és get metódust a tulajdonsághoz, és támogatja az IPropertyNotifySinket , hogy automatikusan értesítse a tárolót a tulajdonság változásakor.

CComControlBase::m_bDrawFromNatural

Ezt jelző jelölő, IDataObjectImpl::GetData és CComControlBase::GetZoomInfo a vezérlő méretét nem a forrástól, hanem a jelölőtől m_sizeNaturalm_sizeExtentkell beállítania.

unsigned m_bDrawFromNatural:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bDrawGetDataInHimetric

A jelölő azt jelzi, hogy IDataObjectImpl::GetData a rajzoláskor ne képpontokat, hanem HIMETRIC egységeket használjon.

unsigned m_bDrawGetDataInHimetric:1;

Megjegyzések

Minden logikai HIMETRIC egység 0,01 milliméter.

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bInPlaceActive

A vezérlőt helyi aktívként jelző jelző.

unsigned m_bInPlaceActive:1;

Megjegyzések

Ez azt jelenti, hogy a vezérlő látható, és az ablaka , ha van ilyen, látható, de a menük és az eszköztárak nem aktívak. A m_bUIActive jelölő azt jelzi, hogy a vezérlő felhasználói felülete ( például menük) is aktív.

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bInPlaceSiteEx

A tárolót jelző jelző támogatja az interfész és az IOleInPlaceSiteEx OCX96 vezérlőfunkcióit, például az ablak nélküli és a villódzásmentes vezérlőket.

unsigned m_bInPlaceSiteEx:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Az adattag m_spInPlaceSite az IOleInPlaceSite, az IOleInPlaceSiteEx vagy az IOleInPlaceSiteWindowless felületre mutat, a m_bWndLess jelzők értékétől m_bInPlaceSiteEx függően. (Az adattagnak m_bNegotiatedWnd igaznak kell lennie ahhoz, hogy az m_spInPlaceSite egérmutató érvényes legyen.)

Ha m_bWndLess HAMIS és m_bInPlaceSiteEx IGAZ, m_spInPlaceSite akkor egy IOleInPlaceSiteEx felületmutató. A három adattag közötti kapcsolatot bemutató táblázat m_spInPlaceSite.

CComControlBase::m_bNegotiatedWnd

Jelző, amely jelzi, hogy a vezérlő egyeztetett-e a tárolóval az OCX96 vezérlőfunkciók (például villódzó és ablak nélküli vezérlők) támogatásáról, valamint arról, hogy a vezérlő ablakos vagy ablak nélküli-e.

unsigned m_bNegotiatedWnd:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

A m_bNegotiatedWnd mutató érvényességéhez a m_spInPlaceSite jelölőnek IGAZ értékűnek kell lennie.

CComControlBase::m_bRecomposeOnResize

Jelző, amely azt jelzi, hogy a vezérlő újra szeretné összeállítani a bemutatóját, amikor a tároló módosítja a vezérlő megjelenítési méretét.

unsigned m_bRecomposeOnResize:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Ezt a jelzőt az IOleObjectImpl::SetExtent ellenőrzi, és ha IGAZ, SetExtent értesíti a nézet változásainak tárolóját. ha ez a jelző be van állítva, az OLEMISC számbavétel OLEMISC_RECOMPOSEONRESIZE bitet is be kell állítani.

CComControlBase::m_bRequiresSave

A vezérlő utolsó mentése óta megváltozott vezérlőt jelző jelző.

unsigned m_bRequiresSave:1;

Megjegyzések

Az érték m_bRequiresSave a CComControlBase::SetDirty beállítással állítható be, és a CComControlBase::GetDirty használatával kérhető le.

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bResizeNatural

Jelölő, amely jelzi, hogy a vezérlő a vezérlő megjelenítési méretének módosításakor a természetes kiterjedését (a méretezetlen fizikai méretét) szeretné átméretezni.

unsigned m_bResizeNatural:1;

Megjegyzések

Ezt a jelzőt IOleObjectImpl::SetExtent a rendszer ellenőrzi, és ha IGAZ, akkor a rendszer hozzárendeli a megadott SetExtent méretet m_sizeNatural.

A megadott SetExtent méret mindig hozzá van rendelve m_sizeExtent, függetlenül a megadott értéktől m_bResizeNatural.

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bUIActive

A vezérlő felhasználói felületét , például menüket és eszköztárakat jelző jelző aktív.

unsigned m_bUIActive:1;

Megjegyzések

A m_bInPlaceActive jelző azt jelzi, hogy a vezérlő aktív, de a felhasználói felülete nem aktív.

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bUsingWindowRgn

A vezérlőt jelző jelző a tároló által megadott ablakterületet használja.

unsigned m_bUsingWindowRgn:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bWasOnceWindowless

A vezérlő ablak nélküli, de lehet, hogy nem ablak nélküli.

unsigned m_bWasOnceWindowless:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bWindowOnly

A vezérlőt jelző jelzőt akkor is ablakba kell helyezni, ha a tároló támogatja az ablak nélküli vezérlőket.

unsigned m_bWindowOnly:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_bWndLess

A vezérlőt jelző jelző ablak nélküli.

unsigned m_bWndLess:1;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Az adattag m_spInPlaceSite egy IOleInPlaceSite, IOleInPlaceSiteEx vagy IOleInPlaceSiteWindowless interfészre mutat a CComControlBase::m_bInPlaceSiteEx jelzők értékétől m_bWndLess függően. (A CComControlBase adatelemnek::m_bNegotiatedWnd igaznak kell lennie a CComControlBase esetében::m_spInPlaceSite mutatónak érvényesnek kell lennie.)

Ha m_bWndLess IGAZ, m_spInPlaceSite akkor egy IOleInPlaceSiteWindowless felületmutató. Tekintse meg a CComControlBase::m_spInPlaceSite táblázatot, amely az adattagok közötti teljes kapcsolatot mutatja.

CComControlBase::m_hWndCD

A vezérlőhöz társított ablakfogópontra mutató hivatkozást tartalmaz.

HWND& m_hWndCD;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_nFreezeEvents

Azon esetek száma, amikor a tároló befagyasztotta az eseményeket (megtagadta az események fogadását) az események beavatkozás nélküli felolvassa nélkül (az események elfogadása).

short m_nFreezeEvents;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_rcPos

A vezérlő képpontban megadott pozíciója, a tároló koordinátáiban kifejezve.

RECT m_rcPos;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_sizeExtent

A HIMETRIC egységek vezérlőjének mértéke (minden egység 0,01 milliméter) egy adott kijelzőhöz.

SIZE m_sizeExtent;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Ezt a méretet a kijelző skálázza. A vezérlő fizikai mérete az m_sizeNatural adattagban van megadva, és rögzített.

A méretet képpontokra konvertálhatja az AtlHiMetricToPixel globális függvénnyel.

CComControlBase::m_sizeNatural

A vezérlő fizikai mérete HIMETRIC egységekben (mindegyik egység 0,01 milliméter).

SIZE m_sizeNatural;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Ez a méret rögzített, míg a méretet m_sizeExtent a kijelző skálázza.

A méretet képpontokra konvertálhatja az AtlHiMetricToPixel globális függvénnyel.

CComControlBase::m_spAdviseSink

Közvetlen mutató a tároló tanácsadó kapcsolatára (a tároló IAdviseSinkje).

CComPtr<IAdviseSink>
    m_spAdviseSink;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_spAmbientDispatch

Egy CComDispatchDriver objektum, amely lehetővé teszi egy objektum tulajdonságainak lekérését és beállítását egy IDispatch mutatón keresztül.

CComDispatchDriver m_spAmbientDispatch;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_spClientSite

Mutató a vezérlő ügyfélwebhelyére a tárolón belül.

CComPtr<IOleClientSite>
    m_spClientSite;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

CComControlBase::m_spDataAdviseHolder

Szabványos eszközt biztosít az adatobjektumok közötti tanácsadási kapcsolatok tárolására és a fogadók tanácsára.

CComPtr<IDataAdviseHolder>
    m_spDataAdviseHolder;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Az adatobjektumok olyan vezérlők, amelyek adatokat továbbíthatnak, és implementálják az IDataObjectet, amelynek metódusai megadják az adatok formátumát és átviteli adathordozóját.

Az interfész m_spDataAdviseHolder implementálja az IDataObject::D Advise és az IDataObject::D Unadvise metódusokat a tárolóval létesítendő tanácsadó kapcsolatok létrehozásához és törléséhez. A vezérlő tárolójának az IAdviseSink interfész támogatásával egy tanácsadó fogadót kell implementálnia.

CComControlBase::m_spInPlaceSite

Mutató a tároló IOleInPlaceSite, IOleInPlaceSiteEx vagy IOleInPlaceSiteWindowless interfészmutatójára.

CComPtr<IOleInPlaceSiteWindowless>
    m_spInPlaceSite;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

A m_spInPlaceSite mutató csak akkor érvényes, ha a m_bNegotiatedWnd jelölő IGAZ.

Az alábbi táblázat bemutatja, hogy a m_spInPlaceSite mutató típusa hogyan függ a m_bWndLess és m_bInPlaceSiteEx adattagok jelzőitől:

m_spInPlaceSite típus	m_bWndLess érték	m_bInPlaceSiteEx érték
IOleInPlaceSiteWindowless	TRUE	TRUE (igaz) vagy FALSE (hamis)
IOleInPlaceSiteEx	FALSE	TRUE
IOleInPlaceSite	FALSE	FALSE

CComControlBase::m_spOleAdviseHolder

A tanácsadási kapcsolatok tárolásának szabványos implementációját biztosítja.

CComPtr<IOleAdviseHolder>
    m_spOleAdviseHolder;

Megjegyzések

Megjegyzés:

Ha ezt az adattagot a vezérlőosztályon belül szeretné használni, deklarálnia kell azt a vezérlőosztály adattagjaként. A vezérlőosztály nem örökli ezt az adattagot az alaposztályból, mert az az alaposztályban lévő egyesítőn belül van deklarálva.

Az interfész m_spOleAdviseHolder implementálja az IOleObject::Advise és az IOleObject::Unadvise metódusokat a tárolóhoz kapcsolódó tanácsadói kapcsolatok létrehozására és törlésére. A vezérlő tárolójának az IAdviseSink interfész támogatásával egy tanácsadó fogadót kell implementálnia.

CComControlBase::OnDraw

Felülbírálhatja ezt a módszert a vezérlő rajzolásához.

virtual HRESULT OnDraw(ATL_DRAWINFO& di);

Paraméterek

Di
Hivatkozás a ATL_DRAWINFO szerkezetre, amely olyan rajzi információkat tartalmaz, mint a rajz aspektusa, a vezérlőelem határai, és hogy a rajz optimalizálva van-e vagy sem.

Visszaadott érték

Standard HRESULT érték.

Megjegyzések

Az alapértelmezett OnDraw beállítás törli vagy visszaállítja az eszközkörnyezetet, vagy semmit sem tesz a CComControlBase::OnDrawAdvanced elemben beállított jelzőktől függően.

Amikor az ATL-vezérlővarázslóval hozza létre a vezérlőt, a rendszer automatikusan hozzáad egy OnDraw metódust a vezérlőosztályhoz. A varázsló alapértelmezés szerint OnDraw egy téglalapot rajzol az "ATL 8.0" címkével.

Example

Lásd a CComControlBase::GetAmbientAppearance példáját.

CComControlBase::OnDrawAdvanced

Az alapértelmezett beállítás OnDrawAdvanced előkészít egy normalizált eszközkörnyezetet a rajzhoz, majd meghívja a vezérlőosztály metódusát OnDraw .

virtual HRESULT OnDrawAdvanced(ATL_DRAWINFO& di);

Paraméterek

Di
Hivatkozás a ATL_DRAWINFO szerkezetre, amely olyan rajzi információkat tartalmaz, mint a rajz aspektusa, a vezérlőelem határai, és hogy a rajz optimalizálva van-e vagy sem.

Visszaadott érték

Standard HRESULT érték.

Megjegyzések

Bírálja felül ezt a metódust, ha normalizálás nélkül szeretné elfogadni a tároló által átadott eszközkörnyezetet.

További részletekért lásd : CComControlBase::OnDraw .

CComControlBase::OnKillFocus

Ellenőrzi, hogy a vezérlő aktív-e, és érvényes vezérlőhellyel rendelkezik-e, majd tájékoztatja a tárolót arról, hogy a vezérlő elvesztette a fókuszt.

LRESULT OnKillFocus(UINT /* nMsg */,
    WPARAM /* wParam */,
    LPARAM /* lParam */,
    BOOL& bHandled);

Paraméterek

nMsg
Fenntartott.

wParam
Fenntartott.

lParam
Fenntartott.

b Kezelt
Jelző, amely jelzi, hogy az ablaküzenet kezelése sikeresen megtörtént-e. Az alapértelmezett HAMIS.

Visszaadott érték

Mindig 1-et ad vissza.

CComControlBase::OnMouseActivate

Ellenőrzi, hogy a felhasználói felület felhasználói módban van-e, majd aktiválja a vezérlőt.

LRESULT OnMouseActivate(UINT /* nMsg */,
    WPARAM /* wParam */,
    LPARAM /* lParam */,
    BOOL& bHandled);

Paraméterek

nMsg
Fenntartott.

wParam
Fenntartott.

lParam
Fenntartott.

b Kezelt
Jelző, amely jelzi, hogy az ablaküzenet kezelése sikeresen megtörtént-e. Az alapértelmezett HAMIS.

Visszaadott érték

Mindig 1-et ad vissza.

CComControlBase::OnPaint

Előkészíti a tárolót festésre, lekéri a vezérlő ügyfélterületét, majd meghívja a vezérlőosztály metódusát OnDrawAdvanced .

LRESULT OnPaint(UINT /* nMsg */,
    WPARAM wParam,
    LPARAM /* lParam */,
    BOOL& /* lResult */);

Paraméterek

nMsg
Fenntartott.

wParam
Egy meglévő HDC.

lParam
Fenntartott.

lResult
Fenntartott.

Visszaadott érték

Mindig nullát ad.

Megjegyzések

Ha a wParam nem NULL, feltételezi, hogy érvényes HDC-t tartalmaz, OnPaint és a CComControlBase helyett használja::m_hWndCD.

CComControlBase::OnSetFocus

Ellenőrzi, hogy a vezérlő helyben aktív-e, és érvényes vezérlőhellyel rendelkezik-e, majd tájékoztatja a tárolót, amellyel a vezérlő fókuszba került.

LRESULT OnSetFocus(UINT /* nMsg */,
    WPARAM /* wParam */,
    LPARAM /* lParam */,
    BOOL& bHandled);

Paraméterek

nMsg
Fenntartott.

wParam
Fenntartott.

lParam
Fenntartott.

b Kezelt
Jelző, amely jelzi, hogy az ablaküzenet kezelése sikeresen megtörtént-e. Az alapértelmezett HAMIS.

Visszaadott érték

Mindig 1-et ad vissza.

Megjegyzések

Értesítést küld a tárolónak arról, hogy a vezérlő fókuszba került.

CComControlBase::P reTranslateAccelerator

Bírálja felül ezt a módszert, hogy saját billentyűzetgyorsító-kezelőket biztosítson.

BOOL PreTranslateAccelerator(LPMSG /* pMsg */,
    HRESULT& /* hRet */);

Paraméterek

pMsg
Fenntartott.

hRet
Fenntartott.

Visszaadott érték

Alapértelmezés szerint HAMIS értéket ad vissza.

CComControlBase::SendOnClose

Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzést lezárták.

HRESULT SendOnClose();

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

Megjegyzések

Értesítést küld arról, hogy a vezérlő bezárta a tanácsadó fogadóit.

CComControlBase::SendOnDataChange

Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzési adatok megváltoztak.

HRESULT SendOnDataChange(DWORD advf = 0);

Paraméterek

advf
Az IAdviseSink::OnDataChange hívásának módját meghatározó jelzők ajánlása. Az értékek az ADVF enumerálásából származnak.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

CComControlBase::SendOnRename

Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzés új bevétellel rendelkezik.

HRESULT SendOnRename(IMoniker* pmk);

Paraméterek

Pmk
Mutasson a vezérlő új monikerére.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

Megjegyzések

Értesítést küld arról, hogy a vezérlő monikerje megváltozott.

CComControlBase::SendOnSave

Értesíti a tanácsadó tulajdonosnál regisztrált összes tanácsadó fogadót, hogy az ellenőrzést megmentették.

HRESULT SendOnSave();

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

Megjegyzések

Értesítést küld arról, hogy a vezérlő mentette az adatait.

CComControlBase::SendOnViewChange

Értesíti az összes regisztrált tanácsadó fogadót, hogy a vezérlő nézete megváltozott.

HRESULT SendOnViewChange(DWORD dwAspect, LONG lindex = -1);

Paraméterek

dwAspect
A vezérlő aspektusa vagy nézete.

lindex
A nézet megváltozott része. Csak -1 érvényes.

Visszaadott érték

A sikeres S_OK, vagy a sikertelen HRESULT hibát adja vissza.

Megjegyzések

SendOnViewChange hívások IAdviseSink::OnViewChange. A jelenleg támogatott lindex egyetlen értéke a -1, ami azt jelzi, hogy a teljes nézet érdekes.

CComControlBase::SetControlFocus

Beállítja vagy eltávolítja a billentyűzetfókuszt a vezérlőbe vagy onnan.

BOOL SetControlFocus(BOOL bGrab);

Paraméterek

bGrab
Ha IGAZ, a billentyűzet fókuszát a hívásvezérlőre állítja. Ha HAMIS, eltávolítja a billentyűzetfókuszt a hívásvezérlőből, feltéve, hogy a fókusza van.

Visszaadott érték

IGAZ értéket ad vissza, ha a vezérlő sikeresen megkapja a fókuszt; egyéb esetben HAMIS.

Megjegyzések

Ablakos vezérlőelem esetén a Rendszer meghívja a SetFocus Windows API-függvényt. Ablak nélküli vezérlők esetén az IOleInPlaceSiteWindowless::SetFocus a neve. Ezen a híváson keresztül egy ablak nélküli vezérlő megkapja a billentyűzet fókuszát, és képes válaszolni az ablaküzenetekre.

CComControlBase::SetDirty

Az adattagot m_bRequiresSave a bDirty értékére állítja.

void SetDirty(BOOL bDirty);

Paraméterek

bDirty
Az adattag CComControlBase értéke::m_bRequiresSave.

Megjegyzések

SetDirty(TRUE) meg kell hívni, hogy jelölje meg, hogy a vezérlő megváltozott a legutóbbi mentés óta. Az érték lekérése m_bRequiresSave a CComControlBase::GetDirty használatával történik.

Lásd még

CComControl-osztály
osztály áttekintése