COleControlSite – třída

Poskytuje podporu vlastních rozhraní pro ovládací prvky na straně klienta.

Syntaxe

class COleControlSite : public CCmdTarget

Členové

Veřejné konstruktory

Název	Popis
COleControlSite::COleControlSite	COleControlSite Vytvoří objekt.

Veřejné metody

Název	Popis
COleControlSite::BindDefaultProperty	Vytvoří vazbu výchozí vlastnosti hostovaného ovládacího prvku na zdroj dat.
COleControlSite::BindProperty	Vytvoří vazbu vlastnosti hostovaného ovládacího prvku na zdroj dat.
COleControlSite::CreateControl	Vytvoří hostovaný ovládací prvek ActiveX.
COleControlSite::D estroyControl	Zničí hostovaný ovládací prvek.
COleControlSite::D oVerb	Spustí konkrétní příkaz hostovaného ovládacího prvku.
COleControlSite::EnableDSC	Umožňuje zdroj dat pro řídicí lokalitu.
COleControlSite::EnableWindow	Povolí řídicí web.
COleControlSite::FreezeEvents	Určuje, jestli řídicí web přijímá události.
COleControlSite::GetDefBtnCode	Načte výchozí kód tlačítka pro hostovaný ovládací prvek.
COleControlSite::GetDlgCtrlID	Načte identifikátor ovládacího prvku.
COleControlSite::GetEventIID	Načte ID rozhraní událostí pro hostovaný ovládací prvek.
COleControlSite::GetExStyle	Načte rozšířené styly řídicího webu.
COleControlSite::GetProperty	Načte konkrétní vlastnost hostovaného ovládacího prvku.
COleControlSite::GetStyle	Načte styly řídicího webu.
COleControlSite::GetWindowText	Načte text hostovaného ovládacího prvku.
COleControlSite::InvokeHelper	Vyvolá konkrétní metodu hostovaného ovládacího prvku.
COleControlSite::InvokeHelperV	Vyvolá konkrétní metodu hostovaného ovládacího prvku se seznamem argumentů proměnných.
COleControlSite::IsDefaultButton	Určuje, zda je ovládací prvek výchozím tlačítkem v okně.
COleControlSite::IsWindowEnabled	Zkontroluje viditelný stav řídicí lokality.
COleControlSite::ModifyStyle	Upraví aktuální rozšířené styly ovládacího webu.
COleControlSite::ModifyStyleEx	Upraví aktuální styly ovládacího webu.
COleControlSite::MoveWindow	Změní pozici řídicí lokality.
COleControlSite::QuickActivate	Rychlé aktivace hostovaného ovládacího prvku.
COleControlSite::SafeSetProperty	Nastaví vlastnost nebo metodu ovládacího prvku bez možnosti vyvolání výjimky.
COleControlSite::SetDefaultButton	Nastaví výchozí tlačítko v okně.
COleControlSite::SetDlgCtrlID	Načte identifikátor ovládacího prvku.
COleControlSite::SetFocus	Nastaví fokus na řídicí web.
COleControlSite::SetProperty	Nastaví konkrétní vlastnost hostovaného ovládacího prvku.
COleControlSite::SetPropertyV	Nastaví konkrétní vlastnost hostovaného ovládacího prvku se seznamem argumentů proměnných.
COleControlSite::SetWindowPos	Nastaví pozici řídicí lokality.
COleControlSite::SetWindowText	Nastaví text hostovaného ovládacího prvku.
COleControlSite::ShowWindow	Zobrazí nebo skryje řídicí web.

Chráněné metody

Název	Popis
COleControlSite::GetControlInfo	Načte informace o klávesnici a měmonics pro hostovaný ovládací prvek.

Veřejné datové členy

Název	Popis
COleControlSite::m_bIsWindowless	Určuje, jestli je hostovaný ovládací prvek bez oken.
COleControlSite::m_ctlInfo	Obsahuje informace o manipulaci s klávesnicí pro ovládací prvek.
COleControlSite::m_dwEventSink	Soubor cookie spojovacího bodu ovládacího prvku.
COleControlSite::m_dwMiscStatus	Různé stavy hostovaného ovládacího prvku.
COleControlSite::m_dwPropNotifySink	Soubor IPropertyNotifySink cookie ovládacího prvku.
COleControlSite::m_dwStyle	Styly hostovaného ovládacího prvku.
COleControlSite::m_hWnd	Popisovač řídicí lokality.
COleControlSite::m_iidEvents	ID rozhraní událostí pro hostovaný ovládací prvek.
COleControlSite::m_nID	ID hostovaného ovládacího prvku.
COleControlSite::m_pActiveObject	Ukazatel na IOleInPlaceActiveObject objekt hostovaného ovládacího prvku.
COleControlSite::m_pCtrlCont	Kontejner hostovaného ovládacího prvku.
COleControlSite::m_pInPlaceObject	Ukazatel na IOleInPlaceObject objekt hostovaného ovládacího prvku.
COleControlSite::m_pObject	Ukazatel na IOleObjectInterface rozhraní ovládacího prvku.
COleControlSite::m_pWindowlessObject	Ukazatel na IOleInPlaceObjectWindowless rozhraní ovládacího prvku.
COleControlSite::m_pWndCtrl	Ukazatel na objekt okna hostovaného ovládacího prvku.
COleControlSite::m_rect	Rozměry řídicí lokality.

Poznámky

Tato podpora je primárním prostředkem, pomocí kterého vložený ovládací prvek ActiveX získá informace o umístění a rozsahu jeho zobrazované lokality, jeho monikeru, jeho uživatelském rozhraní, jeho okolí vlastností a dalších prostředcích poskytovaných jeho kontejnerem. COleControlSiteplně implementuje IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, , IBoundObjectSite, INotifyDBEventsIRowSetNotify rozhraní. Kromě toho se implementuje také rozhraní IDispatch (poskytující podporu pro okolní vlastnosti a jímky událostí).

Chcete-li vytvořit web ovládacího prvku ActiveX pomocí COleControlSite, odvození třídy z COleControlSite. CWndV -odvozené třídě pro kontejner (například dialogové okno) přepsat CWnd::CreateControlSite funkci.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

COleControlSite

Požadavky

Hlavička: afxocc.h

COleControlSite::BindDefaultProperty

Vytvoří vazbu výchozí jednoduché vázané vlastnosti volajícího objektu, jak je označeno v knihovně typů, k podkladovému kurzoru, který je definován dataSource, UserName, Password a SQL vlastnosti ovládacího prvku zdroje dat.

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

Parametry

dwDispID
Určuje DISPID vlastnosti u ovládacího prvku vázaného na data, který má být vázán na ovládací prvek zdroje dat.

vtProp
Určuje typ vlastnosti, která má být vázána , například VT_BSTR, VT_VARIANT atd.

szFieldName
Určuje název sloupce v kurzoru poskytnutém ovládacím prvek zdroje dat, ke kterému bude vlastnost vázána.

pDSCWnd
Ukazatel na -odvozený CWndobjekt, který je hostitelem ovládacího prvku zdroje dat, ke kterému bude vlastnost vázána.

Poznámky

Objekt CWnd , na kterém tuto funkci voláte, musí být ovládací prvek vázaný na data.

COleControlSite::BindProperty

Vytvoří vazbu jednoduché vázané vlastnosti volajícího objektu, jak je označeno v knihovně typů, k podkladovému kurzoru, který je definován DataSource, UserName, Password a SQL vlastnosti ovládacího prvku zdroje dat.

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

Parametry

dwDispId
Určuje DISPID vlastnosti u ovládacího prvku vázaného na data, který má být vázán na ovládací prvek zdroje dat.

pWndDSC
Ukazatel na -odvozený CWndobjekt, který je hostitelem ovládacího prvku zdroje dat, ke kterému bude vlastnost vázána.

Poznámky

Objekt CWnd , na kterém tuto funkci voláte, musí být ovládací prvek vázaný na data.

COleControlSite::COleControlSite

Vytvoří nový COleControlSite objekt.

explicit COleControlSite(COleControlContainer* pCtrlCont);

Parametry

pCtrlCont
Ukazatel na kontejner ovládacího prvku (který představuje okno, které je hostitelem ovládacího prvku AtiveX).

Poznámky

Tato funkce je volána funkcí COccManager::CreateContainer . Další informace o přizpůsobení vytváření kontejnerů naleznete v tématu COccManager::CreateSite.

COleControlSite::CreateControl

Vytvoří ovládací prvek ActiveX hostovaný objektem COleControlSite .

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);

Parametry

pWndCtrl
Ukazatel na objekt okna představující ovládací prvek.

clsid
Jedinečné ID třídy ovládacího prvku.

lpszWindowName
Ukazatel na text, který se má v ovládacím prvku zobrazit. Nastaví hodnotu vlastnosti titulku nebo textu winodw (pokud existuje).

dwStyle
Styly Windows. Dostupné styly jsou uvedeny v části Poznámky .

Rect
Určuje velikost a umístění ovládacího prvku. Může to být CRect objekt nebo RECT struktura.

Nid
Určuje ID podřízeného okna ovládacího prvku.

pPersist
Ukazatel na CFile obsahující trvalý stav ovládacího prvku. Výchozí hodnota je NULL, což znamená, že se ovládací prvek inicializuje bez obnovení stavu z jakéhokoli trvalého úložiště. Pokud není null, měl by to být ukazatel na -odvozený CFileobjekt, který obsahuje trvalá data ovládacího prvku ve formě datového proudu nebo úložiště. Tato data mohla být uložena v předchozí aktivaci klienta. Může CFile obsahovat jiná data, ale musí mít ukazatel pro čtení i zápis nastavený na první bajt trvalých dat v době volání CreateControl.

bStorage
Určuje, zda mají být data v nástroji pPersist interpretována jako IStorage nebo IStream data. Pokud jsou data v nástroji pPersist úložištěm, bStorage by měla být TRUE. Pokud jsou data v nástroji pPersist datový proud, měl by být bStorage FALSE. Výchozí hodnota je FALSE.

bstrLicKey
Nepovinná data licenčního klíče. Tato data jsou potřebná pouze pro vytváření ovládacích prvků, které vyžadují licenční klíč za běhu. Pokud ovládací prvek podporuje licencování, musíte zadat licenční klíč pro úspěšné vytvoření ovládacího prvku. Výchozí hodnota je NULL.

Ppt
Ukazatel na POINT strukturu, která obsahuje levý horní roh ovládacího prvku. Velikost ovládacího prvku je určena hodnotou psize. Hodnoty ppt a psize jsou volitelnou metodou určení velikosti a pozice opf ovládacího prvku.

psize
Ukazatel na SIZE strukturu, která obsahuje velikost ovládacího prvku. Levý horní roh je určen hodnotou ppt. Hodnoty ppt a psize jsou volitelnou metodou určení velikosti a pozice opf ovládacího prvku.

Návratová hodnota

Standardní hodnota HRESULT.

Poznámky

Podporují CreateControlse pouze podmnožina příznaků Windows dwStyle:

• WS_VISIBLE Vytvoří okno, které je zpočátku viditelné. Vyžaduje se, pokud chcete, aby byl ovládací prvek viditelný okamžitě, například běžná okna.

• WS_DISABLED Vytvoří okno, které je původně zakázáno. Zakázané okno nemůže přijímat vstup od uživatele. Lze nastavit, pokud má ovládací prvek vlastnost Enabled.

• WS_BORDER Vytvoří okno s ohraničením tenké čáry. Lze nastavit, pokud ovládací prvek má BorderStyle vlastnost.

• WS_GROUP Určuje první ovládací prvek skupiny ovládacích prvků. Uživatel může změnit fokus klávesnice z jednoho ovládacího prvku ve skupině na další pomocí směrových kláves. Všechny ovládací prvky definované stylem WS_GROUP po prvním ovládacím prvku patří do stejné skupiny. Další ovládací prvek se stylem WS_GROUP ukončí skupinu a spustí další skupinu.

• WS_TABSTOP Určuje ovládací prvek, který může přijímat fokus klávesnice, když uživatel stiskne klávesu TAB. Stisknutím klávesy TAB změníte fokus klávesnice na další ovládací prvek WS_TABSTOP stylu.

Druhé přetížení použijte k vytvoření výchozích ovládacích prvků velikosti.

COleControlSite::D estroyControl

COleControlSite Zničí objekt.

virtual BOOL DestroyControl();

Návratová hodnota

Nenulové, pokud je úspěšné, jinak 0.

Poznámky

Po dokončení je objekt uvolněn z paměti a všechny ukazatele na objekt již nejsou platné.

COleControlSite::D oVerb

Spustí zadaný příkaz.

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

Parametry

nVerb
Určuje příkaz, který se má provést. Může obsahovat jednu z následujících možností:

Hodnota	Význam	Symbol
0	primární požadavek	OLEIVERB_PRIMARY
-1	Sekundární sloveso	(Žádné)
0	Zobrazí objekt pro úpravy.	OLEIVERB_SHOW
-2	Upraví položku v samostatném okně.	OLEIVERB_OPEN
-3	Skryje objekt.	OLEIVERB_HIDE
-4	Aktivuje ovládací prvek na místě.	OLEIVERB_UIACTIVATE
-5	Aktivuje ovládací prvek na místě bez dalších prvků uživatelského rozhraní.	OLEIVERB_INPLACEACTIVATE
-7	Zobrazí vlastnosti ovládacího prvku.	OLEIVERB_PROPERTIES

lpMsg
Ukazatel na zprávu, která způsobila aktivaci položky.

Návratová hodnota

Standardní hodnota HRESULT.

Poznámky

Tato funkce přímo volá prostřednictvím rozhraní ovládacího prvku IOleObject , aby se spustil zadaný příkaz. Pokud je v důsledku tohoto volání funkce vyvolán výjimka, vrátí se kód chyby HRESULT.

Další informace naleznete v tématu IOleObject::D oVerb v sadě Windows SDK.

COleControlSite::EnableDSC

Umožňuje zdroj dat pro řídicí lokalitu.

virtual void EnableDSC();

Poznámky

Volal ho architektura pro povolení a inicializaci zdroje dat pro řídicí lokalitu. Přepište tuto funkci tak, aby poskytovala přizpůsobené chování.

COleControlSite::EnableWindow

Povolí nebo zakáže vstup myši a klávesnice na řídicí web.

virtual BOOL EnableWindow(BOOL bEnable);

Parametry

bEnable
Určuje, jestli se má okno povolit nebo zakázat: PRAVDA, pokud má být povolen vstup okna, jinak NEPRAVDA.

Návratová hodnota

Nenulové, pokud bylo okno dříve zakázané, jinak 0.

COleControlSite::FreezeEvents

Určuje, zda řídicí web bude zpracovávat nebo ignorovat události aktivované z ovládacího prvku.

void FreezeEvents(BOOL bFreeze);

Parametry

bFreeze
Určuje, jestli řídicí web chce přestat přijímat události. Nenulové, pokud ovládací prvek nepřijímá události; jinak nula.

Poznámky

Pokud bFreeze je PRAVDA, kontrolní web požádá ovládací prvek, aby zastavil aktivaci událostí. Pokud bFreeze je NEPRAVDA, kontrolní web požádá ovládací prvek, aby pokračoval v aktivaci událostí.

Poznámka:

Ovládací prvek není nutný k zastavení aktivace událostí, pokud je požadován řídicí web. Může pokračovat ve aktivaci, ale všechny následné události budou webem ovládacího prvku ignorovány.

COleControlSite::GetControlInfo

Načte informace o chování klávesnice a klávesnice ovládacího prvku.

void GetControlInfo();

Poznámky

Informace jsou uloženy v COleControlSite::m_ctlInfo.

COleControlSite::GetDefBtnCode

Určuje, zda je ovládací prvek výchozím tlačítkem.

DWORD GetDefBtnCode();

Návratová hodnota

Může to být jedna z následujících hodnot:

• DLGC_DEFPUSHBUTTON Ovládací prvek je výchozí tlačítko v dialogovém okně.

• DLGC_UNDEFPUSHBUTTON Ovládací prvek není výchozím tlačítkem v dialogovém okně.

• 0 Ovládací prvek není tlačítko.

COleControlSite::GetDlgCtrlID

Načte identifikátor ovládacího prvku.

virtual int GetDlgCtrlID() const;

Návratová hodnota

Identifikátor položky dialogového okna ovládacího prvku.

COleControlSite::GetEventIID

Načte ukazatel na výchozí rozhraní událostí ovládacího prvku.

BOOL GetEventIID(IID* piid);

Parametry

piid
Ukazatel na ID rozhraní.

Návratová hodnota

Nenulové, pokud je úspěšné, jinak 0. V případě úspěchu obsahuje piid ID rozhraní pro výchozí rozhraní události ovládacího prvku.

COleControlSite::GetExStyle

Načte rozšířené styly okna.

virtual DWORD GetExStyle() const;

Návratová hodnota

Rozšířené styly okna ovládacího prvku.

Poznámky

Chcete-li načíst běžné styly, zavolejte COleControlSite::GetStyle.

COleControlSite::GetProperty

Získá vlastnost ovládacího prvku určená dwDispID.

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

Parametry

dwDispID
Identifikuje ID dispečeru vlastnosti nalezené ve výchozím IDispatch rozhraní ovládacího prvku, které se má načíst.

vtProp
Určuje typ vlastnosti, která se má načíst. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

pvProp
Adresa proměnné, která obdrží hodnotu vlastnosti. Musí odpovídat typu určenému nástrojem vtProp.

Poznámky

Hodnota je vrácena prostřednictvím pvProp.

COleControlSite::GetStyle

Načte styly řídicího webu.

virtual DWORD GetStyle() const;

Návratová hodnota

Styly okna.

Poznámky

Seznam možných hodnot najdete v tématu Styly windows. Chcete-li načíst rozšířené styly ovládacího webu, zavolejte COleControlSite::GetExStyle.

COleControlSite::GetWindowText

Načte aktuální text ovládacího prvku.

virtual void GetWindowText(CString& str) const;

Parametry

Str
Odkaz na CString objekt, který obsahuje aktuální text ovládacího prvku.

Poznámky

Pokud ovládací prvek podporuje skladovou vlastnost Titulek, vrátí se tato hodnota. Pokud není vlastnost Titulek podporována, vrátí se hodnota vlastnosti Text.

COleControlSite::InvokeHelper

Vyvolá metodu nebo vlastnost určenou dwDispID v kontextu určeném wFlags.

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

Parametry

dwDispID
Identifikuje ID dispečeru vlastnosti nebo metody nalezené v rozhraní ovládacího prvku IDispatch , který má být vyvolán.

wFlags
Příznaky popisující kontext volání IDispatch::Invoke. Možné hodnoty wFlags najdete IDispatch::Invoke v sadě Windows SDK.

vtRet
Určuje typ návratové hodnoty. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

pvRet
Adresa proměnné, která obdrží hodnotu vlastnosti nebo návratovou hodnotu. Musí odpovídat typu určenému nástrojem vtRet.

pbParamInfo
Ukazatel na řetězec ukončený hodnotou null s bajty určující typy parametrů následující pbParamInfo. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

...
Seznam proměnných parametrů, typů zadaných v pbParamInfo.

Poznámky

Parametr pbParamInfo určuje typy parametrů předaných metodě nebo vlastnosti. Seznam argumentů proměnných je reprezentován ... v deklaraci syntaxe.

Tato funkce převede parametry na hodnoty VARIANTARG a pak vyvolá metodu IDispatch::Invoke na ovládacím prvku. Pokud volání IDispatch::Invoke selže, tato funkce vyvolá výjimku. Pokud je DISP_E_EXCEPTIONstavový kód vrácenIDispatch::Invoke, tato funkce vyvolá COleDispatchException objekt, jinak vyvolá COleException.

COleControlSite::InvokeHelperV

Vyvolá metodu nebo vlastnost určenou dwDispID v kontextu určeném wFlags.

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

Parametry

dwDispID
Identifikuje ID dispečeru vlastnosti nebo metody nalezené v rozhraní ovládacího prvku IDispatch , který má být vyvolán.

wFlags
Příznaky popisující kontext volání IDispatch::Invoke.

vtRet
Určuje typ návratové hodnoty. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

pvRet
Adresa proměnné, která obdrží hodnotu vlastnosti nebo návratovou hodnotu. Musí odpovídat typu určenému nástrojem vtRet.

pbParamInfo
Ukazatel na řetězec ukončený hodnotou null s bajty určující typy parametrů následující pbParamInfo. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

argList
Ukazatel na seznam argumentů proměnných

Poznámky

Parametr pbParamInfo určuje typy parametrů předaných metodě nebo vlastnosti. Pomocí parametru va_list lze předat další parametry pro vyvolánou metodu nebo vlastnost.

Obvykle je tato funkce volána .COleControlSite::InvokeHelper

COleControlSite::IsDefaultButton

Určuje, zda je ovládací prvek výchozím tlačítkem.

BOOL IsDefaultButton();

Návratová hodnota

Nenulové, pokud je ovládací prvek výchozím tlačítkem v okně, jinak nula.

COleControlSite::IsWindowEnabled

Určuje, zda je povolena řídicí lokalita.

virtual BOOL IsWindowEnabled() const;

Návratová hodnota

Nenulové, pokud je ovládací prvek povolený, jinak nula.

Poznámky

Hodnota se načte z vlastnosti Akcie s povolenou vlastností ovládacího prvku.

COleControlSite::m_bIsWindowless

Určuje, zda objekt je ovládací prvek bez oken.

BOOL m_bIsWindowless;

Poznámky

Nenulové, pokud ovládací prvek nemá žádné okno, jinak nula.

COleControlSite::m_ctlInfo

Informace o tom, jak ovládací prvek zpracovává vstup pomocí klávesnice

CONTROLINFO m_ctlInfo;

Poznámky

Tyto informace jsou uloženy ve struktuře CONTROLINFO .

COleControlSite::m_dwEventSink

Obsahuje soubor cookie spojovacího bodu z jímky událostí ovládacího prvku.

DWORD m_dwEventSink;

COleControlSite::m_dwMiscStatus

Obsahuje různé informace o ovládacím prvku.

DWORD m_dwMiscStatus;

Poznámky

Další informace naleznete v tématu OLEMISCv sadě Windows SDK.

COleControlSite::m_dwPropNotifySink

Obsahuje soubor cookie IPropertyNotifySink.

DWORD m_dwPropNotifySink;

COleControlSite::m_dwStyle

Obsahuje styly okna ovládacího prvku.

DWORD m_dwStyle;

COleControlSite::m_hWnd

Obsahuje HWND ovládacího prvku nebo NULL, pokud je ovládací prvek bez oken.

HWND m_hWnd;

COleControlSite::m_iidEvents

Obsahuje ID rozhraní výchozího rozhraní jímky událostí ovládacího prvku.

IID m_iidEvents;

COleControlSite::m_nID

Obsahuje ID položky dialogového okna ovládacího prvku.

UINT m_nID;

COleControlSite::m_pActiveObject

Obsahuje IOleInPlaceActiveObject rozhraní ovládacího prvku.

LPOLEINPLACEACTIVEOBJECT m_pActiveObject;

COleControlSite::m_pCtrlCont

Obsahuje kontejner ovládacího prvku (představující formulář).

COleControlContainer* m_pCtrlCont;

COleControlSite::m_pInPlaceObject

IOleInPlaceObject Obsahuje IOleInPlaceObject rozhraní ovládacího prvku.

LPOLEINPLACEOBJECT m_pInPlaceObject;

COleControlSite::m_pObject

IOleObjectInterface Obsahuje rozhraní ovládacího prvku.

LPOLEOBJECT m_pObject;

COleControlSite::m_pWindowlessObject

IOleInPlaceObjectWindowlessObsahuje IOleInPlaceObjectWindowless rozhraní ovládacího prvku.

IOleInPlaceObjectWindowless* m_pWindowlessObject;

COleControlSite::m_pWndCtrl

Obsahuje ukazatel na CWnd objekt, který představuje samotný ovládací prvek.

CWnd* m_pWndCtrl;

COleControlSite::m_rect

Obsahuje hranice ovládacího prvku vzhledem k oknem kontejneru.

CRect m_rect;

COleControlSite::ModifyStyle

Upraví styly ovládacího prvku.

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

Parametry

dwRemove
Styly, které se mají odebrat z aktuálních stylů oken.

dwAdd
Styly, které se mají přidat z aktuálních stylů oken.

nFlags
Příznaky umístění okna. Seznam možných hodnot naleznete ve funkci SetWindowPos v sadě Windows SDK.

Návratová hodnota

Nenulové, pokud se styly změní, jinak nula.

Poznámky

Vlastnost Enabled ovládacího prvku se upraví tak, aby odpovídala nastavení pro WS_DISABLED. Vlastnost Styl ohraničení ovládacího prvku se upraví tak, aby odpovídala požadovanému nastavení pro WS_BORDER. Všechny ostatní styly se použijí přímo na úchyt okna ovládacího prvku, pokud je k dispozici.

Upraví styly oken ovládacího prvku. Styly, které se mají přidat nebo odebrat, lze kombinovat pomocí bitového operátoru OR (|). Informace o dostupných stylech oken najdete ve funkci CreateWindow v sadě Windows SDK.

Pokud nFlags je nenulové, ModifyStyle volá funkci SetWindowPosWin32 a překreslí okno kombinací nFlags s následujícími čtyřmi příznaky:

• SWP_NOSIZE zachová aktuální velikost.

• SWP_NOMOVE Zachová aktuální pozici.

• SWP_NOZORDER Zachová aktuální pořadí Z.

• SWP_NOACTIVATE Neaktivuje okno.

Chcete-li upravit rozšířené styly okna, zavolejte ModifyStyleEx.

COleControlSite::ModifyStyleEx

Upraví rozšířené styly ovládacího prvku.

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

Parametry

dwRemove
Rozšířené styly, které se mají odebrat z aktuálních stylů oken.

dwAdd
Rozšířené styly, které se mají přidat z aktuálních stylů oken.

nFlags
Příznaky umístění okna. Seznam možných hodnot naleznete ve funkci SetWindowPos v sadě Windows SDK.

Návratová hodnota

Nenulové, pokud se styly změní, jinak nula.

Poznámky

Vlastnost Vzhled akcií ovládacího prvku se upraví tak, aby odpovídala nastavení pro WS_EX_CLIENTEDGE. Všechny ostatní rozšířené styly oken se použijí přímo na úchyt okna ovládacího prvku, pokud je k dispozici.

Upraví rozšířené styly okna objektu webu ovládacího prvku. Styly, které se mají přidat nebo odebrat, lze kombinovat pomocí bitového operátoru OR (|). Informace o dostupných stylech oken najdete ve funkci CreateWindowEx v sadě Windows SDK.

Pokud nFlags je nenulové, ModifyStyleEx volá funkci SetWindowPosWin32 a překreslí okno kombinací nFlags s následujícími čtyřmi příznaky:

• SWP_NOSIZE zachová aktuální velikost.

• SWP_NOMOVE Zachová aktuální pozici.

• SWP_NOZORDER Zachová aktuální pořadí Z.

• SWP_NOACTIVATE Neaktivuje okno.

Chcete-li upravit rozšířené styly okna, zavolejte ModifyStyle.

COleControlSite::MoveWindow

Změní pozici ovládacího prvku.

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

Parametry

x
Nové umístění levé strany okna.

y
Nové umístění horní části okna.

nWidth
Nová šířka okna

nHeight
Nová výška okna.

COleControlSite::QuickActivate

Rychlé aktivace obsaženého ovládacího prvku.

virtual BOOL QuickActivate();

Návratová hodnota

Nenulové, pokud byla aktivována řídicí lokalita, jinak nula.

Poznámky

Tato funkce by měla být volána pouze v případě, že uživatel přepisuje proces vytváření ovládacího prvku.

Metody IPersist*::Load a IPersist*::InitNew metody by se měly volat po rychlé aktivaci. Během rychlé aktivace by měl ovládací prvek navázat svá připojení k jímce kontejneru. Tato připojení však nejsou aktivní, dokud IPersist*::Load není volána nebo IPersist*::InitNew nebyla volána.

COleControlSite::SafeSetProperty

Nastaví vlastnost ovládacího prvku určenou dwDispID.

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

Parametry

dwDispID
Identifikuje ID odeslání vlastnosti nebo metody nalezené v rozhraní ovládacího prvku IDispatch , který se má nastavit.

vtProp
Určuje typ vlastnosti, která se má nastavit. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

...
Jeden parametr typu určeného nástrojem vtProp.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Poznámka:

Na rozdíl od SetProperty a SetPropertyV, pokud je zjištěna chyba (například pokus o nastavení neexistující vlastnosti), není vyvolán žádná výjimka.

COleControlSite::SetDefaultButton

Nastaví ovládací prvek jako výchozí tlačítko.

void SetDefaultButton(BOOL bDefault);

Parametry

bDefault
Nenulové, pokud by se ovládací prvek měl stát výchozím tlačítkem; jinak nula.

Poznámky

Poznámka:

Ovládací prvek musí mít nastavenou OLEMISC_ACTSLIKEBUTTON stavovou sadu.

COleControlSite::SetDlgCtrlID

Změní hodnotu identifikátoru položky dialogového okna ovládacího prvku.

virtual int SetDlgCtrlID(int nID);

Parametry

Nid
Nová hodnota identifikátoru.

Návratová hodnota

V případě úspěchu identifikátor předchozí položky dialogového okna; jinak 0.

Poznámky

COleControlSite::SetFocus

Nastaví fokus na ovládací prvek.

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

Parametry

lpmsg
Ukazatel na strukturu MSG. Tato struktura obsahuje zprávu systému Windows, která SetFocus aktivuje požadavek na ovládací prvek obsažený v aktuální lokalitě ovládacího prvku.

Návratová hodnota

Ukazatel na okno, na které bylo fokus dříve.

COleControlSite::SetProperty

Nastaví vlastnost ovládacího prvku určenou dwDispID.

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

Parametry

dwDispID
Identifikuje ID odeslání vlastnosti nebo metody nalezené v rozhraní ovládacího prvku IDispatch , který se má nastavit.

vtProp
Určuje typ vlastnosti, která se má nastavit. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

...
Jeden parametr typu určeného nástrojem vtProp.

Poznámky

Pokud SetProperty dojde k chybě, vyvolá se výjimka.

Typ výjimky je určen návratová hodnota pokusu o nastavení vlastnosti nebo metody. Pokud je DISP_E_EXCEPTIONnávratová hodnota , COleDispatchExcpetion je vyvolán; v opačném případě .COleException

COleControlSite::SetPropertyV

Nastaví vlastnost ovládacího prvku určenou dwDispID.

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

Parametry

dwDispID
Identifikuje ID odeslání vlastnosti nebo metody nalezené v rozhraní ovládacího prvku IDispatch , který se má nastavit.

vtProp
Určuje typ vlastnosti, která se má nastavit. Možné hodnoty naleznete v části Poznámky pro COleDispatchDriver::InvokeHelper.

argList
Ukazatel na seznam argumentů

Poznámky

Pomocí parametru arg_list lze předat další parametry pro vyvolánou metodu nebo vlastnost. Pokud SetProperty dojde k chybě, vyvolá se výjimka.

Typ výjimky je určen návratová hodnota pokusu o nastavení vlastnosti nebo metody. Pokud je DISP_E_EXCEPTIONnávratová hodnota , COleDispatchExcpetion je vyvolán; v opačném případě .COleException

COleControlSite::SetWindowPos

Nastaví velikost, umístění a pořadí Z řídicí lokality.

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

Parametry

pWndInsertAfter
Ukazatel na okno.

x
Nové umístění levé strany okna.

y
Nové umístění horní části okna.

cx
Nová šířka okna

Cy
Nová výška okna.

nFlags
Určuje nastavení velikosti a umístění příznaků okna. Možné hodnoty najdete v části Poznámky pro SetWindowPos v sadě Windows SDK.

Návratová hodnota

Nenulové, pokud je úspěšné, jinak nula.

COleControlSite::SetWindowText

Nastaví text pro řídicí web.

virtual void SetWindowText(LPCTSTR lpszString);

Parametry

lpszString
Ukazatel na řetězec ukončený hodnotou null, který se má použít jako nový název nebo řídicí text.

Poznámky

Tato funkce se nejprve pokusí nastavit vlastnost Titulek akcií. Pokud není vlastnost Titulek akcií podporována, je nastavena vlastnost Text.

COleControlSite::ShowWindow

Nastaví stav zobrazení okna.

virtual BOOL ShowWindow(int nCmdShow);

Parametry

nCmdShow
Určuje způsob zobrazení řídicí lokality. Musí to být jedna z následujících hodnot:

• SW_HIDE Skryje toto okno a předá aktivaci do jiného okna.

• SW_MINIMIZE Minimalizuje okno a aktivuje okno nejvyšší úrovně v seznamu systému.

• SW_RESTORE Aktivuje a zobrazí okno. Pokud je okno minimalizované nebo maximalizované, Windows ho obnoví na původní velikost a pozici.

• SW_SHOW Aktivuje okno a zobrazí ho v aktuální velikosti a poloze.

• SW_SHOWMAXIMIZED Aktivuje okno a zobrazí ho jako maximalizované okno.

• SW_SHOWMINIMIZED Aktivuje okno a zobrazí ho jako ikonu.

• SW_SHOWMINNOACTIVE Zobrazí okno jako ikonu. Okno, které je aktuálně aktivní, zůstane aktivní.

• SW_SHOWNA Zobrazí okno v aktuálním stavu. Okno, které je aktuálně aktivní, zůstane aktivní.

• SW_SHOWNOACTIVATE Zobrazí okno v jeho nejnovější velikosti a umístění. Okno, které je aktuálně aktivní, zůstane aktivní.

• SW_SHOWNORMAL Aktivuje a zobrazí okno. Pokud je okno minimalizované nebo maximalizované, Windows ho obnoví na původní velikost a pozici.

Návratová hodnota

Nenulové, pokud bylo okno dříve viditelné; 0, pokud bylo okno dříve skryté.

Viz také

CCmdTarget – třída
Graf hierarchie
COleControlContainer – třída