COleControlSite-klass

Ger stöd för anpassade kontrollgränssnitt på klientsidan.

Syntax

class COleControlSite : public CCmdTarget

Medlemmar

Offentliga konstruktorer

Offentliga metoder

Skyddade metoder

Medlemmar i offentliga data

Anmärkningar

Det här stödet är det primära sättet på vilket en inbäddad ActiveX-kontroll hämtar information om platsen och omfattningen av dess visningsplats, dess moniker, användargränssnittet, dess omgivande egenskaper och andra resurser som tillhandahålls av containern. COleControlSite implementerar fullständigt gränssnitten IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEvents, IRowSetNotify . Dessutom implementeras även IDispatch-gränssnittet (som ger stöd för omgivande egenskaper och händelsemottagare).

Om du vill skapa en ActiveX-kontrollplats med hjälp av COleControlSitehärleder du en klass från COleControlSite. I - CWndderived-klassen för containern (till exempel dialogrutan) åsidosätter du CWnd::CreateControlSite funktionen.

Arvshierarki

CObject

CCmdTarget

COleControlSite

Kravspecifikation

Rubrik: afxocc.h

COleControlSite::BindDefaultProperty

Binder det anropande objektets standardegenskap med enkel bindning, som markerats i typbiblioteket, till den underliggande markören som definieras av egenskaperna DataSource, UserName, Password och SQL för datakällkontrollen.

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

Parameterar

dwDispID
Anger DISPID för en egenskap på en databunden kontroll som ska bindas till en datakällakontroll.

vtProp
Anger vilken typ av egenskap som ska bindas– till exempel VT_BSTR, VT_VARIANT och så vidare.

szFieldName
Anger namnet på kolumnen, i markören som tillhandahålls av datakällkontrollen, som egenskapen ska bindas till.

pDSCWnd
En pekare till - CWndderived-objektet som är värd för datakällans kontroll som egenskapen ska bindas till.

Anmärkningar

Objektet CWnd som du anropar den här funktionen på måste vara en databunden kontroll.

COleControlSite::BindProperty

Binder det anropande objektets enkla bundna egenskap, som markerats i typbiblioteket, till den underliggande markören som definieras av egenskaperna DataSource, UserName, Password och SQL för datakällkontrollen.

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

Parameterar

dwDispId
Anger DISPID för en egenskap på en databunden kontroll som ska bindas till en datakällakontroll.

pWndDSC
En pekare till - CWndderived-objektet som är värd för datakällans kontroll som egenskapen ska bindas till.

Anmärkningar

Objektet CWnd som du anropar den här funktionen på måste vara en databunden kontroll.

COleControlSite::COleControlSite

Konstruerar ett nytt COleControlSite objekt.

explicit COleControlSite(COleControlContainer* pCtrlCont);

Parameterar

pCtrlCont
En pekare till kontrollens container (som representerar fönstret som är värd för AtiveX-kontrollen).

Anmärkningar

Den här funktionen anropas av funktionen COccManager::CreateContainer . Mer information om hur du anpassar skapandet av containrar finns i COccManager::CreateSite.

COleControlSite::CreateControl

Skapar en ActiveX-kontroll som hanteras av COleControlSite objektet.

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

Parameterar

pWndCtrl
En pekare till fönsterobjektet som representerar kontrollen.

clsid
Kontrollens unika klass-ID.

lpszWindowName
En pekare till texten som ska visas i kontrollen. Anger värdet för winodws egenskap Text eller Text (om någon).

dwStyle
Windows-formatmallar. De tillgängliga formatmallarna visas under avsnittet Kommentarer .

rekt
Anger kontrollens storlek och position. Det kan vara antingen ett CRect objekt eller en RECT struktur.

Nid
Anger kontrollens underordnade fönster-ID.

pPersist
En pekare till en CFile som innehåller det beständiga tillståndet för kontrollen. Standardvärdet är NULL, vilket indikerar att kontrollen initierar sig själv utan att återställa dess tillstånd från någon beständig lagring. Om inte NULL bör det vara en pekare till ett CFile-härlett objekt som innehåller kontrollens beständiga data, i form av antingen en dataström eller en lagring. Dessa data kunde ha sparats i en tidigare aktivering av klienten. CFile Kan innehålla andra data, men måste ha dess skrivpekare inställd på den första byte av beständiga data vid tidpunkten för anropet till CreateControl.

bStorage
Anger om data i pPersist ska tolkas som IStorage eller IStream data. Om data i pPersist är en lagringsplats bör bStorage vara TRUE. Om data i pPersist är en dataström bör bStorage vara FALSE. Standardvärdet är FALSE.

bstrLicKey
Valfria licensnyckeldata. Dessa data behövs bara för att skapa kontroller som kräver en körningslicensnyckel. Om kontrollen stöder licensiering måste du ange en licensnyckel för att kontrollen ska kunna skapas. Standardvärdet är NULL.

Ppt
En pekare till en POINT struktur som innehåller kontrollens övre vänstra hörn. Kontrollens storlek bestäms av värdet för psize. Värdena ppt och psize är en valfri metod för att ange kontrollens storlek och position.

Psize
En pekare till en SIZE struktur som innehåller kontrollens storlek. Det övre vänstra hörnet bestäms av värdet för ppt. Värdena ppt och psize är en valfri metod för att ange kontrollens storlek och position.

Returvärde

Ett standardvärde för HRESULT.

Anmärkningar

Endast en delmängd av Windows dwStyle-flaggor stöds av CreateControl:

• WS_VISIBLE Skapar ett fönster som först visas. Krävs om du vill att kontrollen ska visas omedelbart, till exempel vanliga fönster.

• WS_DISABLED Skapar ett fönster som ursprungligen är inaktiverat. Ett inaktiverat fönster kan inte ta emot indata från användaren. Kan anges om kontrollen har en aktiverad egenskap.

• WS_BORDER Skapar ett fönster med en tunn kantlinje. Kan ställas in om kontrollen har en BorderStyle-egenskap.

• WS_GROUP Anger den första kontrollen för en grupp kontroller. Användaren kan ändra tangentbordsfokus från en kontroll i gruppen till nästa med hjälp av riktningstangenterna. Alla kontroller som definierats med WS_GROUP formatmall efter den första kontrollen tillhör samma grupp. Nästa kontroll med formatmallen WS_GROUP avslutar gruppen och startar nästa grupp.

• WS_TABSTOP Anger en kontroll som kan ta emot tangentbordsfokus när användaren trycker på TAB-tangenten. Om du trycker på TABB-tangenten ändras tangentbordsfokus till nästa kontroll av WS_TABSTOP formatmall.

Använd den andra överlagringen för att skapa standardstora kontroller.

COleControlSite::D estroyControl

Förstör objektet COleControlSite .

virtual BOOL DestroyControl();

Returvärde

Nonzero om det lyckas, annars 0.

Anmärkningar

När det är klart frigörs objektet från minnet och eventuella pekare till objektet är inte längre giltiga.

COleControlSite::D oVerb

Kör det angivna verbet.

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

Parameterar

nVerb
Anger verbet som ska köras. Den kan innehålla något av följande:

lpMsg
Pekare till meddelandet som gjorde att objektet aktiverades.

Returvärde

Ett standardvärde för HRESULT.

Anmärkningar

Den här funktionen anropar direkt via kontrollens IOleObject gränssnitt för att köra det angivna verbet. Om ett undantag utlöses till följd av det här funktionsanropet returneras en HRESULT-felkod.

Mer information finns i IOleObject::D oVerb i Windows SDK.

COleControlSite::EnableDSC

Aktiverar datakällor för kontrollplatsen.

virtual void EnableDSC();

Anmärkningar

Anropas av ramverket för att aktivera och initiera datakällor för kontrollplatsen. Åsidosätt den här funktionen för att tillhandahålla anpassat beteende.

COleControlSite::EnableWindow

Aktiverar eller inaktiverar mus- och tangentbordsindata till kontrollplatsen.

virtual BOOL EnableWindow(BOOL bEnable);

Parameterar

bEnable
Anger om fönstret ska aktiveras eller inaktiveras: SANT om fönsterindata ska aktiveras, annars FALSE.

Returvärde

Nonzero om fönstret tidigare var inaktiverat, annars 0.

COleControlSite::FreezeEvents

Anger om kontrollplatsen ska hantera eller ignorera händelser som utlösts från en kontroll.

void FreezeEvents(BOOL bFreeze);

Parameterar

bFreeze
Anger om kontrollwebbplatsen vill sluta acceptera händelser. Nonzero om kontrollen inte accepterar händelser; annars noll.

Anmärkningar

Om bFreeze är TRUE begär kontrollwebbplatsen kontrollen för att stoppa avfyrning av händelser. Om bFreeze är FALSE begär kontrollwebbplatsen att kontrollen fortsätter att starta händelser.

COleControlSite::GetControlInfo

Hämtar information om en kontrolls tangentbordsmnemonics och tangentbordsbeteende.

void GetControlInfo();

Anmärkningar

Informationen lagras i COleControlSite::m_ctlInfo.

COleControlSite::GetDefBtnCode

Avgör om kontrollen är en standardknapp.

DWORD GetDefBtnCode();

Returvärde

Kan vara något av följande värden:

• DLGC_DEFPUSHBUTTON Control är standardknappen i dialogrutan.

• DLGC_UNDEFPUSHBUTTON Control är inte standardknappen i dialogrutan.

• 0 Kontrollen är inte en knapp.

COleControlSite::GetDlgCtrlID

Hämtar kontrollens identifierare.

virtual int GetDlgCtrlID() const;

Returvärde

Dialogrutans objektidentifierare för kontrollen.

COleControlSite::GetEventIID

Hämtar en pekare till kontrollens standardhändelsegränssnitt.

BOOL GetEventIID(IID* piid);

Parameterar

piid
En pekare till ett gränssnitts-ID.

Returvärde

Nonzero om det lyckas, annars 0. Om det lyckas innehåller piid gränssnitts-ID:t för kontrollens standardhändelsegränssnitt.

COleControlSite::GetExStyle

Hämtar fönstrets utökade formatmallar.

virtual DWORD GetExStyle() const;

Returvärde

Kontrollfönstrets utökade formatmallar.

Anmärkningar

Om du vill hämta vanliga formatmallar anropar du COleControlSite::GetStyle.

COleControlSite::GetProperty

Hämtar kontrollegenskapen som anges av dwDispID.

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

Parameterar

dwDispID
Identifierar dispatch-ID:t för egenskapen, som finns i kontrollens standardgränssnitt IDispatch , som ska hämtas.

vtProp
Anger vilken typ av egenskap som ska hämtas. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

pvProp
Adress för variabeln som ska ta emot egenskapsvärdet. Den måste matcha den typ som anges av vtProp.

Anmärkningar

Värdet returneras via pvProp.

COleControlSite::GetStyle

Hämtar formatmallarna för kontrollwebbplatsen.

virtual DWORD GetStyle() const;

Returvärde

Fönstrets formatmallar.

Anmärkningar

En lista över möjliga värden finns i Windows-formatmallar. Om du vill hämta de utökade formaten på kontrollplatsen anropar du COleControlSite::GetExStyle.

COleControlSite::GetWindowText

Hämtar den aktuella texten i kontrollen.

virtual void GetWindowText(CString& str) const;

Parameterar

Str
En referens till ett CString objekt som innehåller den aktuella texten i kontrollen.

Anmärkningar

Om kontrollen stöder egenskapen Caption stock returneras det här värdet. Om egenskapen Caption stock inte stöds returneras värdet för egenskapen Text.

COleControlSite::InvokeHelper

Anropar den metod eller egenskap som anges av dwDispID i den kontext som anges av wFlags.

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

Parameterar

dwDispID
Identifierar sändnings-ID:t för den egenskap eller metod som finns i kontrollens IDispatch gränssnitt och som ska anropas.

wFlags
Flaggor som beskriver kontexten för anropet till IDispatch::Invoke. Möjliga wFlags-värdenIDispatch::Invoke finns i Windows SDK.

vtRet
Anger typen av returvärde. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

pvRet
Adress för variabeln som ska ta emot egenskapsvärdet eller returvärdet. Den måste matcha den typ som anges av vtRet.

pbParamInfo
Pekare till en null-avslutad sträng med byte som anger typerna av parametrarna efter pbParamInfo. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

...
Variabellista över parametrar, av typer som anges i pbParamInfo.

Anmärkningar

Parametern pbParamInfo anger vilka typer av parametrar som skickas till metoden eller egenskapen. Variabellistan över argument representeras av ... i syntaxdeklarationen.

Den här funktionen konverterar parametrarna till VARIANTARG-värden och anropar IDispatch::Invoke sedan -metoden på kontrollen. Om anropet till IDispatch::Invoke misslyckas utlöser den här funktionen ett undantag. Om statuskoden som returneras av IDispatch::Invoke är DISP_E_EXCEPTIONgenererar den här funktionen ett COleDispatchException objekt, annars genererar den en COleException.

COleControlSite::InvokeHelperV

Anropar den metod eller egenskap som anges av dwDispID i den kontext som anges av wFlags.

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

Parameterar

dwDispID
Identifierar sändnings-ID:t för den egenskap eller metod som finns i kontrollens IDispatch gränssnitt och som ska anropas.

wFlags
Flaggor som beskriver kontexten för anropet till IDispatch::Invoke.

vtRet
Anger typen av returvärde. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

pvRet
Adress för variabeln som ska ta emot egenskapsvärdet eller returvärdet. Den måste matcha den typ som anges av vtRet.

pbParamInfo
Pekare till en null-avslutad sträng med byte som anger typerna av parametrarna efter pbParamInfo. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

argList
Pekare till en variabelargumentlista.

Anmärkningar

Parametern pbParamInfo anger vilka typer av parametrar som skickas till metoden eller egenskapen. Extra parametrar för den metod eller egenskap som anropas kan skickas med parametern va_list .

Normalt anropas den här funktionen av COleControlSite::InvokeHelper.

COleControlSite::IsDefaultButton

Avgör om kontrollen är standardknappen.

BOOL IsDefaultButton();

Returvärde

Nonzero om kontrollen är standardknappen i fönstret, annars noll.

COleControlSite::IsWindowEnabled

Avgör om kontrollplatsen är aktiverad.

virtual BOOL IsWindowEnabled() const;

Returvärde

Nonzero om kontrollen är aktiverad, annars noll.

Anmärkningar

Värdet hämtas från kontrollens egenskapen Enabled stock (Aktiverad aktie).

COleControlSite::m_bIsWindowless

Avgör om objektet är en fönsterlös kontroll.

BOOL m_bIsWindowless;

Anmärkningar

Nonzero om kontrollen inte har något fönster, annars noll.

COleControlSite::m_ctlInfo

Information om hur tangentbordsindata hanteras av kontrollen.

CONTROLINFO m_ctlInfo;

Anmärkningar

Den här informationen lagras i en CONTROLINFO-struktur .

COleControlSite::m_dwEventSink

Innehåller anslutningspunktens cookie från kontrollens händelsemottagare.

DWORD m_dwEventSink;

COleControlSite::m_dwMiscStatus

Innehåller diverse information om kontrollen.

DWORD m_dwMiscStatus;

Anmärkningar

Mer information finns i OLEMISC i Windows SDK.

COleControlSite::m_dwPropNotifySink

Innehåller cookien IPropertyNotifySink .

DWORD m_dwPropNotifySink;

COleControlSite::m_dwStyle

Innehåller kontrollens fönsterformat.

DWORD m_dwStyle;

COleControlSite::m_hWnd

Innehåller HWND för kontrollen eller NULL om kontrollen är fönsterlös.

HWND m_hWnd;

COleControlSite::m_iidEvents

Innehåller gränssnitts-ID för kontrollens standardgränssnitt för händelsemottagare.

IID m_iidEvents;

COleControlSite::m_nID

Innehåller kontrollens dialogobjekt-ID.

UINT m_nID;

COleControlSite::m_pActiveObject

Innehåller IOleInPlaceActiveObject-gränssnittet för kontrollen.

LPOLEINPLACEACTIVEOBJECT m_pActiveObject;

COleControlSite::m_pCtrlCont

Innehåller kontrollens container (som representerar formuläret).

COleControlContainer* m_pCtrlCont;

COleControlSite::m_pInPlaceObject

Innehåller IOleInPlaceObjectIOleInPlaceObject-gränssnittet för kontrollen.

LPOLEINPLACEOBJECT m_pInPlaceObject;

COleControlSite::m_pObject

Innehåller kontrollens IOleObjectInterface gränssnitt.

LPOLEOBJECT m_pObject;

COleControlSite::m_pWindowlessObject

Innehåller kontrollens IOleInPlaceObjectWindowless gränssnitt.

IOleInPlaceObjectWindowless* m_pWindowlessObject;

COleControlSite::m_pWndCtrl

Innehåller en pekare till objektet CWnd som representerar själva kontrollen.

CWnd* m_pWndCtrl;

COleControlSite::m_rect

Innehåller gränserna för kontrollen i förhållande till containerns fönster.

CRect m_rect;

COleControlSite::ModifyStyle

Ändrar kontrollens formatmallar.

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

Parameterar

dwRemove
De format som ska tas bort från de aktuella fönsterformaten.

dwAdd
De format som ska läggas till från de aktuella fönsterformaten.

nFlags
Fönsterplaceringsflaggor. En lista över möjliga värden finns i funktionen SetWindowPos i Windows SDK.

Returvärde

Nonzero om formatmallarna ändras, annars noll.

Anmärkningar

Kontrollens lageraktiverade egenskap ändras så att den matchar inställningen för WS_DISABLED. Kontrollens egenskap för kantlinjeformat ändras så att den matchar den begärda inställningen för WS_BORDER. Alla andra format tillämpas direkt på kontrollens fönsterhandtag, om det finns en.

Ändrar kontrollens fönsterformat. Format som ska läggas till eller tas bort kan kombineras med hjälp av operatorn bitvis ELLER (|). Mer information om tillgängliga fönsterformat finns i funktionen CreateWindow i Windows SDK.

Om nFlags inte är noll ModifyStyle anropar du funktionen SetWindowPosWin32 och ritar om fönstret genom att kombinera nFlags med följande fyra flaggor:

• SWP_NOSIZE Behåller den aktuella storleken.

• SWP_NOMOVE Behåller den aktuella positionen.

• SWP_NOZORDER Behåller den aktuella Z-ordningen.

• SWP_NOACTIVATE Aktiverar inte fönstret.

Om du vill ändra ett fönsters utökade formatmallar anropar du ModifyStyleEx.

COleControlSite::ModifyStyleEx

Ändrar kontrollens utökade formatmallar.

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

Parameterar

dwRemove
De utökade formatmallar som ska tas bort från de aktuella fönsterformaten.

dwAdd
De utökade formatmallar som ska läggas till från de aktuella fönsterformaten.

nFlags
Fönsterplaceringsflaggor. En lista över möjliga värden finns i funktionen SetWindowPos i Windows SDK.

Returvärde

Nonzero om formatmallarna ändras, annars noll.

Anmärkningar

Kontrollens aktieegenskap Utseende ändras så att den matchar inställningen för WS_EX_CLIENTEDGE. Alla andra utökade fönsterformat tillämpas direkt på kontrollens fönsterhandtag, om en finns.

Ändrar fönstrets utökade formatmallar för kontrollplatsobjektet. Format som ska läggas till eller tas bort kan kombineras med hjälp av operatorn bitvis ELLER (|). Mer information om tillgängliga fönsterformat finns i funktionen CreateWindowEx i Windows SDK.

Om nFlags inte är noll ModifyStyleEx anropar du funktionen SetWindowPosWin32 och ritar om fönstret genom att kombinera nFlags med följande fyra flaggor:

• SWP_NOSIZE Behåller den aktuella storleken.

• SWP_NOMOVE Behåller den aktuella positionen.

• SWP_NOZORDER Behåller den aktuella Z-ordningen.

• SWP_NOACTIVATE Aktiverar inte fönstret.

Om du vill ändra ett fönsters utökade formatmallar anropar du ModifyStyle.

COleControlSite::MoveWindow

Ändrar kontrollens position.

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

Parameterar

x
Den nya positionen för fönstrets vänstra sida.

y
Den nya positionen överst i fönstret.

nWidth
Fönstrets nya bredd

nHeight
Fönstrets nya höjd.

COleControlSite::QuickActivate

Snabb aktiverar den inneslutna kontrollen.

virtual BOOL QuickActivate();

Returvärde

Nonzero om kontrollplatsen aktiverades, annars noll.

Anmärkningar

Den här funktionen ska bara anropas om användaren överskrider skapandeprocessen för kontrollen.

Metoderna IPersist*::Load och IPersist*::InitNew bör anropas när snabb aktivering har inträffat. Kontrollen bör upprätta sina anslutningar till containerns mottagare under snabb aktivering. Dessa anslutningar är dock inte aktiva förrän IPersist*::Load eller IPersist*::InitNew har anropats.

COleControlSite::SafeSetProperty

Anger den kontrollegenskap som anges av dwDispID.

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

Parameterar

dwDispID
Identifierar sändnings-ID:t för den egenskap eller metod som ska anges i kontrollens IDispatch gränssnitt.

vtProp
Anger vilken typ av egenskap som ska anges. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

...
En enskild parameter av den typ som anges av vtProp.

Returvärde

Nonzero om det lyckas; annars noll.

Anmärkningar

COleControlSite::SetDefaultButton

Anger kontrollen som standardknapp.

void SetDefaultButton(BOOL bDefault);

Parameterar

bDefault
Nonzero om kontrollen ska bli standardknappen. annars noll.

Anmärkningar

COleControlSite::SetDlgCtrlID

Ändrar värdet för kontrollens dialogobjektidentifierare.

virtual int SetDlgCtrlID(int nID);

Parameterar

Nid
Det nya identifierarvärdet.

Returvärde

Om det lyckas visas fönstrets föregående dialogobjektidentifierare. annars 0.

Anmärkningar

COleControlSite::SetFocus

Ställer in fokus på kontrollen.

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

Parameterar

lpmsg
En pekare till en MSG-struktur. Den här strukturen innehåller Windows-meddelandet som SetFocus utlöser begäran om kontrollen som finns på den aktuella kontrollwebbplatsen.

Returvärde

En pekare till fönstret som tidigare hade fokus.

COleControlSite::SetProperty

Anger den kontrollegenskap som anges av dwDispID.

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

Parameterar

dwDispID
Identifierar sändnings-ID:t för den egenskap eller metod som ska anges i kontrollens IDispatch gränssnitt.

vtProp
Anger vilken typ av egenskap som ska anges. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

...
En enskild parameter av den typ som anges av vtProp.

Anmärkningar

Om SetProperty det uppstår ett fel utlöses ett undantag.

Typen av undantag bestäms av returvärdet för försöket att ange egenskapen eller metoden. Om returvärdet är DISP_E_EXCEPTION, genereras en COleDispatchExcpetion , annars en COleException.

COleControlSite::SetPropertyV

Anger den kontrollegenskap som anges av dwDispID.

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

Parameterar

dwDispID
Identifierar sändnings-ID:t för den egenskap eller metod som ska anges i kontrollens IDispatch gränssnitt.

vtProp
Anger vilken typ av egenskap som ska anges. Möjliga värden finns i avsnittet Anmärkningar för COleDispatchDriver::InvokeHelper.

argList
Pekare till listan med argument.

Anmärkningar

Extra parametrar för den metod eller egenskap som anropas kan skickas med parametern arg_list . Om SetProperty det uppstår ett fel utlöses ett undantag.

Typen av undantag bestäms av returvärdet för försöket att ange egenskapen eller metoden. Om returvärdet är DISP_E_EXCEPTION, genereras en COleDispatchExcpetion , annars en COleException.

COleControlSite::SetWindowPos

Anger storlek, position och Z-ordning för kontrollplatsen.

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

Parameterar

pWndInsertAfter
En pekare till fönstret.

x
Den nya positionen för fönstrets vänstra sida.

y
Den nya positionen överst i fönstret.

cx
Fönstrets nya bredd

Cy
Fönstrets nya höjd.

nFlags
Anger storleks- och placeringsflaggor för fönster. Möjliga värden finns i avsnittet Anmärkningar för SetWindowPos i Windows SDK.

Returvärde

Nonzero om det lyckas, annars noll.

COleControlSite::SetWindowText

Anger texten för kontrollwebbplatsen.

virtual void SetWindowText(LPCTSTR lpszString);

Parameterar

lpszString
Pekare till en null-avslutad sträng som ska användas som ny rubrik eller kontrolltext.

Anmärkningar

Den här funktionen försöker först ange egenskapen Caption stock. Om egenskapen Caption stock inte stöds anges egenskapen Text i stället.

COleControlSite::ShowWindow

Anger fönstrets visningstillstånd.

virtual BOOL ShowWindow(int nCmdShow);

Parameterar

nCmdShow
Anger hur kontrollplatsen ska visas. Det måste vara något av följande värden:

• SW_HIDE Döljer det här fönstret och skickar aktiveringen till ett annat fönster.

• SW_MINIMIZE Minimerar fönstret och aktiverar det översta fönstret i systemets lista.

• SW_RESTORE Aktiverar och visar fönstret. Om fönstret minimeras eller maximeras återställer Windows det till sin ursprungliga storlek och position.

• SW_SHOW Aktiverar fönstret och visar det i sin aktuella storlek och position.

• SW_SHOWMAXIMIZED Aktiverar fönstret och visar det som ett maximerat fönster.

• SW_SHOWMINIMIZED Aktiverar fönstret och visar det som en ikon.

• SW_SHOWMINNOACTIVE Visar fönstret som en ikon. Fönstret som för närvarande är aktivt förblir aktivt.

• SW_SHOWNA Visar fönstret i dess aktuella tillstånd. Fönstret som för närvarande är aktivt förblir aktivt.

• SW_SHOWNOACTIVATE Visar fönstret i sin senaste storlek och position. Fönstret som för närvarande är aktivt förblir aktivt.

• SW_SHOWNORMAL Aktiverar och visar fönstret. Om fönstret minimeras eller maximeras återställer Windows det till sin ursprungliga storlek och position.

Returvärde

Nonzero om fönstret tidigare var synligt; 0 om fönstret tidigare var dolt.

Se även

CCmdTarget-klass
hierarkidiagram
COleControlContainer-klass