COleControlSite osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Támogatja az egyéni ügyféloldali vezérlőfelületeket.

Szemantika

class COleControlSite : public CCmdTarget

Tagok

Nyilvános konstruktorok

Név	Leírás
COleControlSite::COleControlSite	Egy COleControlSite objektumot hoz létre.

Nyilvános metódusok

Név	Leírás
COleControlSite::BindDefaultProperty	Az üzemeltetett vezérlő alapértelmezett tulajdonságát egy adatforráshoz köti.
COleControlSite::BindProperty	A üzemeltetett vezérlő tulajdonságát egy adatforráshoz köti.
COleControlSite::CreateControl	Üzemeltetett ActiveX-vezérlőt hoz létre.
COleControlSite::D estroyControl	Elpusztítja a üzemeltetett vezérlőt.
COleControlSite::D oVerb	Végrehajtja a üzemeltetett vezérlő egy adott parancsát.
COleControlSite::EnableDSC	Engedélyezi az adatok forrását egy vezérlőhelyen.
COleControlSite::EnableWindow	Engedélyezi a vezérlőhelyet.
COleControlSite::FreezeEvents	Megadja, hogy a vezérlőhely fogad-e eseményeket.
COleControlSite::GetDefBtnCode	Lekéri az üzemeltetett vezérlő alapértelmezett gombkódját.
COleControlSite::GetDlgCtrlID	Lekéri a vezérlő azonosítóját.
COleControlSite::GetEventIID	Lekéri egy üzemeltetett vezérlő eseményfelületének azonosítóját.
COleControlSite::GetExStyle	Lekéri a vezérlőwebhely kiterjesztett stílusait.
COleControlSite::GetProperty	Lekéri a üzemeltetett vezérlő egy adott tulajdonságát.
COleControlSite::GetStyle	Lekéri a vezérlőwebhely stílusait.
COleControlSite::GetWindowText	Lekéri a üzemeltetett vezérlő szövegét.
COleControlSite::InvokeHelper	Az üzemeltetett vezérlő egy adott metódusának meghívása.
COleControlSite::InvokeHelperV	Az üzemeltetett vezérlő egy adott metódusának meghívása változó argumentumlistával.
COleControlSite::IsDefaultButton	Meghatározza, hogy a vezérlő az alapértelmezett gomb-e az ablakban.
COleControlSite::IsWindowEnabled	Ellenőrzi a vezérlőhely látható állapotát.
COleControlSite::ModifyStyle	Módosítja a vezérlőwebhely aktuális kiterjesztett stílusait.
COleControlSite::ModifyStyleEx	Módosítja a vezérlőwebhely aktuális stílusait.
COleControlSite::MoveWindow	Módosítja a vezérlőhely pozícióját.
COleControlSite::QuickActivate	A központi vezérlő gyors aktiválása.
COleControlSite::SafeSetProperty	A vezérlőelem tulajdonságát vagy metódusát úgy állítja be, hogy nem lehet kivételt kivenni.
COleControlSite::SetDefaultButton	Beállítja az alapértelmezett gombot az ablakban.
COleControlSite::SetDlgCtrlID	Lekéri a vezérlő azonosítóját.
COleControlSite::SetFocus	A fókuszt a vezérlőhelyre állítja.
COleControlSite::SetProperty	Beállítja a üzemeltetett vezérlő egy adott tulajdonságát.
COleControlSite::SetPropertyV	Beállítja a üzemeltetett vezérlőelem adott tulajdonságát az argumentumok változólistájával.
COleControlSite::SetWindowPos	Beállítja a vezérlőhely pozícióját.
COleControlSite::SetWindowText	Beállítja a üzemeltetett vezérlő szövegét.
COleControlSite::ShowWindow	Megjeleníti vagy elrejti a vezérlőwebhelyet.

Védett metódusok

Név	Leírás
COleControlSite::GetControlInfo	Lekéri a központi vezérlő billentyűzetadatait és mnemonikáit.

Nyilvános adatok tagjai

Név	Leírás
COleControlSite::m_bIsWindowless	Meghatározza, hogy a üzemeltetett vezérlő ablak nélküli vezérlő-e.
COleControlSite::m_ctlInfo	A vezérlő billentyűzetkezelésével kapcsolatos információkat tartalmaz.
COleControlSite::m_dwEventSink	A vezérlő csatlakozási pontjának cookie-ja.
COleControlSite::m_dwMiscStatus	A üzemeltetett vezérlő egyéb állapotai.
COleControlSite::m_dwPropNotifySink	A IPropertyNotifySink vezérlő cookie-ja.
COleControlSite::m_dwStyle	A üzemeltetett vezérlő stílusai.
COleControlSite::m_hWnd	A vezérlőhely fogópontja.
COleControlSite::m_iidEvents	Az üzemeltetett vezérlő eseményfelületének azonosítója.
COleControlSite::m_nID	A üzemeltetett vezérlő azonosítója.
COleControlSite::m_pActiveObject	Mutató a IOleInPlaceActiveObject üzemeltetett vezérlő objektumára.
COleControlSite::m_pCtrlCont	A üzemeltetett vezérlő tárolója.
COleControlSite::m_pInPlaceObject	Mutató a IOleInPlaceObject üzemeltetett vezérlő objektumára.
COleControlSite::m_pObject	A vezérlő felületére mutató mutató IOleObjectInterface .
COleControlSite::m_pWindowlessObject	A vezérlő felületére mutató mutató IOleInPlaceObjectWindowless .
COleControlSite::m_pWndCtrl	Mutató az üzemeltetett vezérlő ablakobjektumára.
COleControlSite::m_rect	A vezérlőhely méretei.

Megjegyzések

Ez a támogatás az elsődleges eszköz, amellyel egy beágyazott ActiveX-vezérlő információt szerez a megjelenítési helyéről és kiterjedéséről, a monikerről, a felhasználói felületéről, a környezeti tulajdonságairól és a tárolója által biztosított egyéb erőforrásokról. COleControlSiteteljes mértékben implementálja az IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEventsIRowSetNotify interfészeket. Emellett az IDispatch interfész (amely támogatja a környezeti tulajdonságokat és az eseményelnyelőket) is implementálva van.

ActiveX-vezérlőwebhely COleControlSitelétrehozásához hozzon létre egy osztályt a következőből COleControlSite: . CWndA tároló -származtatott osztályában (például a párbeszédpanelen) felülbírálja a függvénytCWnd::CreateControlSite.

Öröklési hierarchia

CObject

CCmdTarget

COleControlSite

Követelmények

Fejléc: afxocc.h

COleControlSite::BindDefaultProperty

A hívó objektum alapértelmezett egyszerű kötött tulajdonságát a típustárban megjelölt módon az adatforrás-vezérlő DataSource, UserName, Password és SQL tulajdonságai által meghatározott mögöttes kurzorhoz köti.

virtual void BindDefaultProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    LPCTSTR szFieldName,
    CWnd* pDSCWnd);

Paraméterek

dwDispID
Egy adatforrás-vezérlőhöz kötött, adathoz kötött vezérlőelemen lévő tulajdonság DISPID-ját adja meg.

vtProp
Megadja a kötendő tulajdonság típusát – például VT_BSTR, VT_VARIANT stb.

szFieldName
Megadja annak az oszlopnak a nevét az adatforrás-vezérlő által megadott kurzorban, amelyhez a tulajdonság kötött lesz.

pDSCWnd
Mutató arra a CWnd-származtatott objektumra, amely azt az adatforrás-vezérlőt tárolja, amelyhez a tulajdonságot köti.

Megjegyzések

Az CWnd objektumnak, amelyen ezt a függvényt meghívja, adathoz kötött vezérlőelemnek kell lennie.

COleControlSite::BindProperty

A hívó objektum egyszerű kötött tulajdonságát a típustárban megjelölt módon köti az adatforrás-vezérlő DataSource, UserName, Password és SQL tulajdonságai által meghatározott mögöttes kurzorhoz.

virtual void BindProperty(
    DISPID dwDispId,
    CWnd* pWndDSC);

Paraméterek

dwDispId
Egy adatforrás-vezérlőhöz kötött, adathoz kötött vezérlőelemen lévő tulajdonság DISPID-ját adja meg.

pWndDSC
Mutató arra a CWnd-származtatott objektumra, amely azt az adatforrás-vezérlőt tárolja, amelyhez a tulajdonságot köti.

Megjegyzések

Az CWnd objektumnak, amelyen ezt a függvényt meghívja, adathoz kötött vezérlőelemnek kell lennie.

COleControlSite::COleControlSite

Új COleControlSite objektumot hoz létre.

explicit COleControlSite(COleControlContainer* pCtrlCont);

Paraméterek

pCtrlCont
Mutató a vezérlő tárolójára (amely az AtiveX-vezérlőt üzemeltető ablakot jelöli).

Megjegyzések

Ezt a függvényt a COccManager::CreateContainer függvény hívja meg. A tárolók létrehozásának testreszabásáról további információt a COccManager::CreateSite című témakörben talál.

COleControlSite::CreateControl

Létrehoz egy ActiveX-vezérlőt, amelyet az COleControlSite objektum üzemeltet.

virtual HRESULT CreateControl(
    CWnd* pWndCtrl,
    REFCLSID clsid,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

virtual HRESULT CreateControl(
    CWnd* pWndCtrl,
    REFCLSID clsid,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const POINT* ppt,
    const SIZE* psize,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

Paraméterek

pWndCtrl
A vezérlőt jelképező ablakobjektumra mutató mutató.

clsid
A vezérlő egyedi osztályazonosítója.

lpszWindowName
A vezérlőelemben megjelenítendő szövegre mutató mutató. Beállítja a winodw Felirat vagy Szöveg tulajdonságának értékét (ha van ilyen).

dwStyle
Windows-stílusok. Az elérhető stílusok a Megjegyzések szakaszban találhatók.

téglalap
Megadja a vezérlő méretét és pozícióját. CRect Lehet objektum vagy RECT struktúra.

Nid
Megadja a vezérlő gyermekablak-azonosítóját.

pPersist
A vezérlőelem állandó állapotát tartalmazó mutató CFile . Az alapértelmezett érték NULL, amely azt jelzi, hogy a vezérlő inicializálja magát anélkül, hogy visszaállítja az állapotát bármilyen állandó tárterületről. Ha nem NULL, akkor egy olyan - származtatott objektumra mutató mutatónak CFilekell lennie, amely a vezérlő állandó adatait tartalmazza stream vagy tároló formájában. Ezeket az adatokat az ügyfél korábbi aktiválása során menthették. A CFile függvény más adatokat is tartalmazhat, de az olvasási-írási mutatónak az állandó adatok első bájtjára kell állítania a híváskor CreateControl.

bStorage
Azt jelzi, hogy a pPersistben lévő adatokat úgy kell-e értelmezni, mint IStorage vagy IStream az adatokat. Ha a pPersistben tárolt adatok tárolók, akkor a bStorage értékének IGAZnak kell lennie. Ha a pPersistben lévő adatok streamek, akkor a bStorage értéke HAMIS. Az alapértelmezett érték HAMIS.

bstrLicKey
Nem kötelező licenckulcs-adatok. Ezek az adatok csak olyan vezérlők létrehozásához szükségesek, amelyek futásidejű licenckulcsot igényelnek. Ha a vezérlő támogatja a licencelést, meg kell adnia egy licenckulcsot a vezérlő sikeres létrehozásához. Az alapértelmezett érték NULL.

Ppt
A vezérlőelem bal felső sarkát tartalmazó struktúra mutatója POINT . A vezérlő méretét a psize értéke határozza meg. A ppt és a psize értékek a vezérlőelem méretének és pozíciójának megadására nem kötelező módszer.

Psize
A vezérlőelem méretét tartalmazó struktúra mutatója SIZE . A bal felső sarkot a ppt értéke határozza meg. A ppt és a psize értékek a vezérlőelem méretének és pozíciójának megadására nem kötelező módszer.

Visszaadott érték

Standard HRESULT érték.

Megjegyzések

A Windows dwStyle jelzőknek csak egy részhalmazát támogatja a következő CreateControl:

• WS_VISIBLE Először látható ablakot hoz létre. Kötelező, ha azt szeretné, hogy a vezérlő azonnal látható legyen, például a szokásos ablakok.

• WS_DISABLED Először letiltott ablakot hoz létre. A letiltott ablak nem tud bemenetet fogadni a felhasználótól. Akkor állítható be, ha a vezérlő engedélyezve van.

• WS_BORDER Vékonyvonalas szegélyű ablakot hoz létre. Akkor állítható be, ha a vezérlőelem rendelkezik BorderStyle tulajdonságkal.

• WS_GROUP Egy vezérlőcsoport első vezérlőelemét adja meg. A felhasználó az iránybillentyűkkel módosíthatja a billentyűzet fókuszát a csoport egyik vezérlőeleméről a következőre. Az első vezérlőelem utáni WS_GROUP stílussal definiált összes vezérlő ugyanahhoz a csoporthoz tartozik. A következő vezérlőelem a WS_GROUP stílussal véget vet a csoportnak, és elindítja a következő csoportot.

• WS_TABSTOP Olyan vezérlőt ad meg, amely a TAB billentyű lenyomásakor képes fogadni a billentyűzetfókuszt. A TAB billentyű lenyomásával a billentyűzet fókusza a WS_TABSTOP stílus következő vezérlője lesz.

A második túlterheléssel alapértelmezett méretű vezérlőket hozhat létre.

COleControlSite::D estroyControl

Elpusztítja az COleControlSite objektumot.

virtual BOOL DestroyControl();

Visszaadott érték

Sikertelen, ha sikeres, egyébként 0.

Megjegyzések

Miután elkészült, az objektum felszabadul a memóriából, és az objektumra mutató mutatók már nem érvényesek.

COleControlSite::D oVerb

Végrehajtja a megadott igét.

virtual HRESULT DoVerb(
    LONG nVerb,
    LPMSG lpMsg = NULL);

Paraméterek

nVerb
A végrehajtandó igét adja meg. A következő lehetőségek közül választhat:

Érték	Értelmezés	Szimbólum
0	Elsődleges ige	OLEIVERB_PRIMARY
-1	Másodlagos ige	(Nincs)
1	Megjeleníti a szerkesztésre szánt objektumot.	OLEIVERB_SHOW
-2	Az elemet egy külön ablakban szerkessze.	OLEIVERB_OPEN
-3	Elrejti az objektumot.	OLEIVERB_HIDE
-4	Helyben aktivál egy vezérlőt.	OLEIVERB_UIACTIVATE
5-	A vezérlőt helyben aktiválja további felhasználói felületi elemek nélkül.	OLEIVERB_INPLACEACTIVATE
-7	A vezérlő tulajdonságainak megjelenítése.	OLEIVERB_PROPERTIES

lpMsg
Mutasson arra az üzenetre, amely az elemet aktiválta.

Visszaadott érték

Standard HRESULT érték.

Megjegyzések

Ez a függvény közvetlenül a vezérlő IOleObject felületén keresztül hívja meg a megadott igét. Ha ez a függvényhívás kivételt eredményez, a rendszer HRESULT hibakódot ad vissza.

További információ: IOleObject::D oVerb a Windows SDK-ban.

COleControlSite::EnableDSC

Engedélyezi az adatok forrását a vezérlőhelyhez.

virtual void EnableDSC();

Megjegyzések

A keretrendszer meghívta, hogy engedélyezze és inicializálja az adatok forrását a vezérlőhelyen. A függvény felülbírálása a testre szabott viselkedés biztosításához.

COleControlSite::EnableWindow

Engedélyezi vagy letiltja az egér- és billentyűzetbemenetet a vezérlőhelyen.

virtual BOOL EnableWindow(BOOL bEnable);

Paraméterek

bEnable
Megadja, hogy engedélyezze vagy tiltsa-e le az ablakot: IGAZ, ha az ablakbemenet engedélyezve van, ellenkező esetben HAMIS.

Visszaadott érték

Nonzero, ha az ablak korábban le volt tiltva, egyébként 0.

COleControlSite::FreezeEvents

Megadja, hogy a vezérlőwebhely kezeli-e vagy figyelmen kívül hagyja-e a vezérlőből aktivált eseményeket.

void FreezeEvents(BOOL bFreeze);

Paraméterek

bFreeze
Megadja, hogy a vezérlőwebhely le szeretné-e állítani az események fogadását. Nonzero, ha a vezérlő nem fogad el eseményeket; ellenkező esetben nulla.

Megjegyzések

Ha a bFreeze értéke IGAZ, a vezérlőhely kéri a vezérlőt, hogy állítsa le az égetést. Ha a bFreeze ÉRTÉKE HAMIS, a vezérlőhely kéri a vezérlőt, hogy folytassa a tüzelési eseményeket.

Megjegyzés:

A vezérlés nem szükséges az égési események leállításához, ha a vezérlőhely kéri. Folytathatja az égetést, de az összes további eseményt figyelmen kívül hagyja a vezérlőhely.

COleControlSite::GetControlInfo

Információkat kér le a vezérlők billentyűzetének beöntéséről és a billentyűzet viselkedéséről.

void GetControlInfo();

Megjegyzések

Az adatokat a COleControlSite::m_ctlInfo tárolja.

COleControlSite::GetDefBtnCode

Meghatározza, hogy a vezérlő alapértelmezett leküldéses gomb-e.

DWORD GetDefBtnCode();

Visszaadott érték

Az alábbi értékek egyike lehet:

• DLGC_DEFPUSHBUTTON Vezérlőelem az alapértelmezett gomb a párbeszédpanelen.

• DLGC_UNDEFPUSHBUTTON Vezérlőelem nem az alapértelmezett gomb a párbeszédpanelen.

• 0 A vezérlő nem gomb.

COleControlSite::GetDlgCtrlID

Lekéri a vezérlő azonosítóját.

virtual int GetDlgCtrlID() const;

Visszaadott érték

A vezérlő párbeszédpanelelem-azonosítója.

COleControlSite::GetEventIID

A vezérlő alapértelmezett eseményfelületére mutató mutatót kér le.

BOOL GetEventIID(IID* piid);

Paraméterek

piid
Egy illesztőazonosítóra mutató mutató.

Visszaadott érték

Sikertelen, ha sikeres, egyébként 0. Ha sikeres, a piid tartalmazza a vezérlő alapértelmezett eseményillesztőjének felületazonosítóját.

COleControlSite::GetExStyle

Lekéri az ablak bővített stílusait.

virtual DWORD GetExStyle() const;

Visszaadott érték

A vezérlőablak bővített stílusai.

Megjegyzések

A normál stílusok lekéréséhez hívja meg a COleControlSite::GetStyle parancsot.

COleControlSite::GetProperty

Lekéri a dwDispID által megadott vezérlőtulajdonságot.

virtual void GetProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    void* pvProp) const;

Paraméterek

dwDispID
A vezérlő alapértelmezett IDispatch felületén található, lekérendő tulajdonság feladóazonosítóját azonosítja.

vtProp
A lekérendő tulajdonság típusát adja meg. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

pvProp
Annak a változónak a címe, amely megkapja a tulajdonság értékét. Meg kell egyeznie a vtProp által megadott típussal.

Megjegyzések

Az értéket a pvProp függvény adja vissza.

COleControlSite::GetStyle

Lekéri a vezérlőwebhely stílusait.

virtual DWORD GetStyle() const;

Visszaadott érték

Az ablak stílusai.

Megjegyzések

A lehetséges értékek listáját a Windows Stílusok című témakörben találja. A vezérlőwebhely kiterjesztett stílusainak lekéréséhez hívja meg a COleControlSite::GetExStyle parancsot.

COleControlSite::GetWindowText

Lekéri a vezérlő aktuális szövegét.

virtual void GetWindowText(CString& str) const;

Paraméterek

Str
Hivatkozás egy CString objektumra, amely a vezérlőelem aktuális szövegét tartalmazza.

Megjegyzések

Ha a vezérlőelem támogatja a Caption stock tulajdonságot, a rendszer ezt az értéket adja vissza. Ha a Caption stock tulajdonság nem támogatott, a Szöveg tulajdonság értéke lesz visszaadva.

COleControlSite::InvokeHelper

Meghívja a dwDispID által megadott metódust vagy tulajdonságot a wFlags által megadott környezetben.

virtual void AFX_CDECL InvokeHelper(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo, ...);

Paraméterek

dwDispID
Azonosítja a meghívni kívánt tulajdonság vagy metódus feladóazonosítóját IDispatch a vezérlő felületén.

wFlags
Az IDispatch hívásának környezetét leíró jelzők::Invoke. A wFlags lehetséges értékeit a Windows SDK-ban talál IDispatch::Invoke .

vtRet
A visszatérési érték típusát adja meg. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

pvRet
Annak a változónak a címe, amely megkapja a tulajdonságértéket vagy a visszatérési értéket. Meg kell egyeznie a vtRet által megadott típussal.

pbParamInfo
Mutató egy null értékű bájtos sztringre, amely megadja a pbParamInfo utáni paraméterek típusait. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

...
A pbParamInfo-ban megadott paraméterek változólistája.

Megjegyzések

A pbParamInfo paraméter megadja a metódusnak vagy tulajdonságnak átadott paraméterek típusait. Az argumentumok változólistáját ... a szintaxis deklarációjában.

Ez a függvény a paramétereket VARIANTARG értékekké alakítja, majd meghívja a IDispatch::Invoke metódust a vezérlőn. Ha a hívás IDispatch::Invoke sikertelen, ez a függvény kivételt fog eredményezni. Ha a visszaadott IDispatch::Invoke állapotkód az DISP_E_EXCEPTION, akkor ez a függvény egy COleDispatchException objektumot dob, ellenkező esetben egy COleException.

COleControlSite::InvokeHelperV

Meghívja a dwDispID által megadott metódust vagy tulajdonságot a wFlags által megadott környezetben.

virtual void InvokeHelperV(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo,
    va_list argList);

Paraméterek

dwDispID
Azonosítja a meghívni kívánt tulajdonság vagy metódus feladóazonosítóját IDispatch a vezérlő felületén.

wFlags
Az IDispatch hívásának környezetét leíró jelzők::Invoke.

vtRet
A visszatérési érték típusát adja meg. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

pvRet
Annak a változónak a címe, amely megkapja a tulajdonságértéket vagy a visszatérési értéket. Meg kell egyeznie a vtRet által megadott típussal.

pbParamInfo
Mutató egy null értékű bájtos sztringre, amely megadja a pbParamInfo utáni paraméterek típusait. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

argList
Mutató egy változó argumentumlistájára.

Megjegyzések

A pbParamInfo paraméter megadja a metódusnak vagy tulajdonságnak átadott paraméterek típusait. A meghívandó metódushoz vagy tulajdonsághoz további paraméterek is átadhatók a va_list paraméterrel.

Ezt a függvényt COleControlSite::InvokeHelperáltalában a .

COleControlSite::IsDefaultButton

Meghatározza, hogy a vezérlő az alapértelmezett gomb-e.

BOOL IsDefaultButton();

Visszaadott érték

Nonzero, ha a vezérlő az alapértelmezett gomb az ablakban, egyébként nulla.

COleControlSite::IsWindowEnabled

Meghatározza, hogy a vezérlőhely engedélyezve van-e.

virtual BOOL IsWindowEnabled() const;

Visszaadott érték

Nonzero, ha a vezérlő engedélyezve van, ellenkező esetben nulla.

Megjegyzések

Az érték lekéri a vezérlő Engedélyezett részvénytulajdonságából.

COleControlSite::m_bIsWindowless

Meghatározza, hogy az objektum ablak nélküli vezérlőelem-e.

BOOL m_bIsWindowless;

Megjegyzések

Nonzero, ha a vezérlőnek nincs ablaka, ellenkező esetben nulla.

COleControlSite::m_ctlInfo

Információ arról, hogy a vezérlő hogyan kezeli a billentyűzetbemenetet.

CONTROLINFO m_ctlInfo;

Megjegyzések

Ezeket az információkat CONTROLINFO-struktúrában tárolja a rendszer.

COleControlSite::m_dwEventSink

A kapcsolati pont cookie-ját tartalmazza a vezérlő esemény-fogadójából.

DWORD m_dwEventSink;

COleControlSite::m_dwMiscStatus

A vezérlő egyéb információit tartalmazza.

DWORD m_dwMiscStatus;

Megjegyzések

További információ: OLEMISC a Windows SDK-ban.

COleControlSite::m_dwPropNotifySink

Az IPropertyNotifySink cookie-t tartalmazza.

DWORD m_dwPropNotifySink;

COleControlSite::m_dwStyle

A vezérlőelem ablakstílusait tartalmazza.

DWORD m_dwStyle;

COleControlSite::m_hWnd

A vezérlő HWND-ját vagy NULL értéket tartalmazza, ha a vezérlő ablak nélküli.

HWND m_hWnd;

COleControlSite::m_iidEvents

A vezérlő alapértelmezett esemény fogadófelületének felületazonosítóját tartalmazza.

IID m_iidEvents;

COleControlSite::m_nID

A vezérlő párbeszédpanelelem-azonosítóját tartalmazza.

UINT m_nID;

COleControlSite::m_pActiveObject

A vezérlő IOleInPlaceActiveObject felületét tartalmazza.

LPOLEINPLACEACTIVEOBJECT m_pActiveObject;

COleControlSite::m_pCtrlCont

A vezérlő tárolóját tartalmazza (amely az űrlapot jelöli).

COleControlContainer* m_pCtrlCont;

COleControlSite::m_pInPlaceObject

IOleInPlaceObject A vezérlő IOleInPlaceObject felületét tartalmazza.

LPOLEINPLACEOBJECT m_pInPlaceObject;

COleControlSite::m_pObject

IOleObjectInterface A vezérlő felületét tartalmazza.

LPOLEOBJECT m_pObject;

COleControlSite::m_pWindowlessObject

IOleInPlaceObjectWindowless A vezérlő felületét tartalmazza.

IOleInPlaceObjectWindowless* m_pWindowlessObject;

COleControlSite::m_pWndCtrl

A vezérlőt jelképező objektumra mutató mutatót CWnd tartalmaz.

CWnd* m_pWndCtrl;

COleControlSite::m_rect

A vezérlőnek a tároló ablakához viszonyított határait tartalmazza.

CRect m_rect;

COleControlSite::ModifyStyle

Módosítja a vezérlőelem stílusait.

virtual BOOL ModifyStyle(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags);

Paraméterek

dwRemove
Az aktuális ablakstílusokból eltávolítandó stílusok.

dwAdd
Az aktuális ablakstílusokból hozzáadandó stílusok.

nFlags
Ablakhelyezési jelzők. A lehetséges értékek listáját a Windows SDK SetWindowPos függvényében találja.

Visszaadott érték

Nonzero, ha a stílusok módosulnak, ellenkező esetben nulla.

Megjegyzések

A vezérlő készlet engedélyezve tulajdonsága úgy módosul, hogy megfeleljen a WS_DISABLED beállításának. A vezérlőelem készlet szegélystílus tulajdonsága úgy módosul, hogy megfeleljen a WS_BORDER kért beállításának. Az összes többi stílus közvetlenül a vezérlő ablakfogópontjára lesz alkalmazva, ha van ilyen.

Módosítja a vezérlőelem ablakstílusait. A hozzáadni vagy eltávolítani kívánt stílusok a bitenkénti VAGY (|) operátorral kombinálhatók. Az elérhető ablakstílusokról a Windows SDK CreateWindow függvényében tájékozódhat.

Ha az nFlags nem ero, meghívja a Win32 függvénytModifyStyle, SetWindowPos és újrarajzolva az ablakot az nFlags és a következő négy jelölő kombinálásával:

• SWP_NOSIZE Megtartja az aktuális méretet.

• SWP_NOMOVE Megtartja az aktuális pozíciót.

• SWP_NOZORDER Megtartja az aktuális Z sorrendet.

• SWP_NOACTIVATE Nem aktiválja az ablakot.

Az ablak bővített stílusainak módosításához hívja meg a ModifyStyleEx parancsot.

COleControlSite::ModifyStyleEx

Módosítja a vezérlőelem kiterjesztett stílusait.

virtual BOOL ModifyStyleEx(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags);

Paraméterek

dwRemove
Az aktuális ablakstílusokból eltávolítandó kiterjesztett stílusok.

dwAdd
Az aktuális ablakstílusokból hozzáadandó kiterjesztett stílusok.

nFlags
Ablakhelyezési jelzők. A lehetséges értékek listáját a Windows SDK SetWindowPos függvényében találja.

Visszaadott érték

Nonzero, ha a stílusok módosulnak, ellenkező esetben nulla.

Megjegyzések

A vezérlőelem tőzsdei Megjelenés tulajdonsága úgy módosul, hogy megfeleljen a WS_EX_CLIENTEDGE beállításának. Az összes többi kiterjesztett ablakstílus közvetlenül a vezérlő ablakleírójára lesz alkalmazva, ha van ilyen.

Módosítja a vezérlőhely objektumának bővített ablakstílusait. A hozzáadni vagy eltávolítani kívánt stílusok a bitenkénti VAGY (|) operátorral kombinálhatók. Az elérhető ablakstílusokról a Windows SDK CreateWindowEx függvényében tájékozódhat.

Ha az nFlags nem ero, meghívja a Win32 függvénytModifyStyleEx, SetWindowPos és újrarajzolva az ablakot az nFlags és a következő négy jelölő kombinálásával:

• SWP_NOSIZE Megtartja az aktuális méretet.

• SWP_NOMOVE Megtartja az aktuális pozíciót.

• SWP_NOZORDER Megtartja az aktuális Z sorrendet.

• SWP_NOACTIVATE Nem aktiválja az ablakot.

Az ablak bővített stílusainak módosításához hívja meg a ModifyStyle parancsot.

COleControlSite::MoveWindow

Módosítja a vezérlő pozícióját.

virtual void MoveWindow(
    int x,
    int y,
    int nWidth,
    int nHeight);

Paraméterek

x
Az ablak bal oldalának új pozíciója.

y
Az ablak tetejének új helye.

nWidth
Az ablak új szélessége

nHeight
Az ablak új magassága.

COleControlSite::QuickActivate

Gyorsan aktiválja a tartalmazott vezérlőt.

virtual BOOL QuickActivate();

Visszaadott érték

Nonzero, ha a vezérlőhely aktiválva lett, egyébként nulla.

Megjegyzések

Ezt a függvényt csak akkor kell meghívni, ha a felhasználó felülírja a vezérlő létrehozási folyamatát.

A IPersist*::Load gyors aktiválás után a metódusokat és IPersist*::InitNew a metódusokat kell meghívni. A vezérlőnek a gyors aktiválás során létre kell hoznia a tároló fogadóihoz való kapcsolatait. Ezek a kapcsolatok azonban addig nem élnek, amíg IPersist*::Load meg nem hívják vagy IPersist*::InitNew meghívták őket.

COleControlSite::SafeSetProperty

Beállítja a dwDispID által megadott vezérlőtulajdonságot.

virtual BOOL AFX_CDECL SafeSetProperty(
    DISPID dwDispID,
    VARTYPE vtProp, ...);

Paraméterek

dwDispID
A vezérlő felületén található, beállítandó tulajdonság vagy metódus kézbesítési azonosítóját azonosítja IDispatch .

vtProp
Megadja a beállítani kívánt tulajdonság típusát. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

...
A vtProp által megadott típus egyetlen paramétere.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Megjegyzés:

Eltérően SetProperty , és SetPropertyVha hiba történik (például nem létező tulajdonságot próbál beállítani), a rendszer nem ad kivételt.

COleControlSite::SetDefaultButton

Beállítja a vezérlőt alapértelmezett gombként.

void SetDefaultButton(BOOL bDefault);

Paraméterek

bDefault
Nonzero, ha a vezérlő legyen az alapértelmezett gomb; ellenkező esetben nulla.

Megjegyzések

Megjegyzés:

A vezérlőnek OLEMISC_ACTSLIKEBUTTON állapotbitkészlettel kell rendelkeznie.

COleControlSite::SetDlgCtrlID

Módosítja a vezérlő párbeszédpanelelem-azonosítójának értékét.

virtual int SetDlgCtrlID(int nID);

Paraméterek

Nid
Az új azonosító értéke.

Visszaadott érték

Ha sikeres, az ablak előző párbeszédpanelelem-azonosítója; egyéb esetben 0.

Megjegyzések

COleControlSite::SetFocus

A fókuszt a vezérlőre állítja.

virtual CWnd* SetFocus();
virtual CWnd* SetFocus(LPMSG lpmsg);

Paraméterek

lpmsg
Egy MSG-struktúrára mutató mutató. Ez a struktúra tartalmazza azt a Windows-üzenetet, amely elindítja az SetFocus aktuális vezérlőhelyen található vezérlőre vonatkozó kérést.

Visszaadott érték

A korábban fókuszban lévő ablakra mutató mutató.

COleControlSite::SetProperty

Beállítja a dwDispID által megadott vezérlőtulajdonságot.

virtual void AFX_CDECL SetProperty(
    DISPID dwDispID,
    VARTYPE vtProp, ...);

Paraméterek

dwDispID
A vezérlő felületén található, beállítandó tulajdonság vagy metódus kézbesítési azonosítóját azonosítja IDispatch .

vtProp
Megadja a beállítani kívánt tulajdonság típusát. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

...
A vtProp által megadott típus egyetlen paramétere.

Megjegyzések

Ha SetProperty hiba történik, a rendszer kivételt jelez.

A kivétel típusát a tulajdonság vagy metódus beállítására tett kísérlet visszatérési értéke határozza meg. Ha a visszatérési érték az DISP_E_EXCEPTION, COleDispatchExcpetion a lesz, ellenkező esetben a COleException.

COleControlSite::SetPropertyV

Beállítja a dwDispID által megadott vezérlőtulajdonságot.

virtual void SetPropertyV(
    DISPID dwDispID,
    VARTYPE vtProp,
    va_list argList);

Paraméterek

dwDispID
A vezérlő felületén található, beállítandó tulajdonság vagy metódus kézbesítési azonosítóját azonosítja IDispatch .

vtProp
Megadja a beállítani kívánt tulajdonság típusát. A lehetséges értékekért tekintse meg a COleDispatchDriver::InvokeHelper megjegyzéseket ismertető szakaszát.

argList
Mutasson az argumentumok listájára.

Megjegyzések

A meghívandó metódushoz vagy tulajdonsághoz további paraméterek is átadhatók a arg_list paraméterrel. Ha SetProperty hiba történik, a rendszer kivételt jelez.

A kivétel típusát a tulajdonság vagy metódus beállítására tett kísérlet visszatérési értéke határozza meg. Ha a visszatérési érték az DISP_E_EXCEPTION, COleDispatchExcpetion a lesz, ellenkező esetben a COleException.

COleControlSite::SetWindowPos

Beállítja a vezérlőhely méretét, pozícióját és Z sorrendjét.

virtual BOOL SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags);

Paraméterek

pWndInsertAfter
Az ablakra mutató mutató.

x
Az ablak bal oldalának új pozíciója.

y
Az ablak tetejének új helye.

cx
Az ablak új szélessége

Cy
Az ablak új magassága.

nFlags
Megadja az ablakméretezési és -elhelyezési jelzőket. A lehetséges értékekért tekintse meg a SetWindowPos Megjegyzések szakaszát a Windows SDK-ban.

Visszaadott érték

Sikertelen, ha sikeres, egyébként nulla.

COleControlSite::SetWindowText

Beállítja a vezérlőwebhely szövegét.

virtual void SetWindowText(LPCTSTR lpszString);

Paraméterek

lpszString
Mutasson egy null értékű sztringre, amelyet új címként vagy vezérlőszövegként szeretne használni.

Megjegyzések

Ez a függvény először megkísérli beállítani a Caption stock tulajdonságot. Ha a Caption stock tulajdonság nem támogatott, akkor a Text tulajdonság van beállítva.

COleControlSite::ShowWindow

Beállítja az ablak megjelenítési állapotát.

virtual BOOL ShowWindow(int nCmdShow);

Paraméterek

nCmdShow
Megadja, hogy a vezérlőwebhely hogyan jelenjen meg. Az alábbi értékek egyikének kell lennie:

• SW_HIDE Elrejti ezt az ablakot, és átadja az aktiválást egy másik ablaknak.

• SW_MINIMIZE Kis méretűre csökkenti az ablakot, és aktiválja a legfelső szintű ablakot a rendszer listájában.

• SW_RESTORE Aktiválja és megjeleníti az ablakot. Ha az ablak kis méretű vagy teljes méretű, a Windows visszaállítja az eredeti méretére és pozíciójára.

• SW_SHOW Aktiválja az ablakot, és az aktuális méretében és pozíciójában jeleníti meg.

• SW_SHOWMAXIMIZED Aktiválja az ablakot, és teljes méretű ablakként jeleníti meg.

• SW_SHOWMINIMIZED Aktiválja az ablakot, és ikonként jeleníti meg.

• SW_SHOWMINNOACTIVE Ikonként jeleníti meg az ablakot. A jelenleg aktív ablak aktív marad.

• SW_SHOWNA Az ablak aktuális állapotában jelenik meg. A jelenleg aktív ablak aktív marad.

• SW_SHOWNOACTIVATE Az ablak a legutóbbi méretében és pozíciójában jelenik meg. A jelenleg aktív ablak aktív marad.

• SW_SHOWNORMAL Aktiválja és megjeleníti az ablakot. Ha az ablak kis méretű vagy teljes méretű, a Windows visszaállítja az eredeti méretére és pozíciójára.

Visszaadott érték

Nonzero, ha az ablak korábban látható volt; 0, ha az ablak korábban rejtve volt.

Lásd még

CCmdTarget osztály
hierarchiadiagram
COleControlContainer osztály