COleIPFrameWndEx-klass

Klassen COleIPFrameWndEx implementerar en OLE-container som stöder MFC. Du måste härleda ramfönsterklassen COleIPFrameWndEx på plats för ditt program från klassen, i stället för att härleda den från klassen COleIPFrameWnd . Mer information finns i källkoden i mappen VC\atlmfc\src\mfc i Visual Studio-installationen.

Syntax

class COleIPFrameWndEx : public COleIPFrameWnd

Medlemmar

Offentliga metoder

Skyddade metoder

Exempel

I följande exempel visas hur du underklassar en instans av COleIPFrameWndEx klassen och kör över dess metoder. Exemplet visar hur du kör OnDestory över metoden, RepositionFrame metoden, RecalcLayout metoden och CalcWindowRect metoden. Det här kodfragmentet är en del av Word Pad-exemplet.

void CInPlaceFrame::OnDestroy()
{
   m_wndToolBar.DestroyWindow();
   m_wndFormatBar.DestroyWindow();
   COleIPFrameWndEx::OnDestroy();
}

void CInPlaceFrame::RepositionFrame(LPCRECT lpPosRect, LPCRECT lpClipRect)
{
   CRect rectNew = lpPosRect;
   rectNew.left -= HORZ_TEXTOFFSET;
   rectNew.top -= VERT_TEXTOFFSET;
   m_wndResizeBar.BringWindowToTop();
   COleIPFrameWndEx::RepositionFrame(&rectNew, lpClipRect);
   CWnd *pWnd = GetActiveView();
   if (pWnd != NULL)
      pWnd->BringWindowToTop();
   m_wndRulerBar.BringWindowToTop();
}

void CInPlaceFrame::RecalcLayout(BOOL bNotify)
{
   if (m_wndResizeBar.m_hWnd != NULL)
      m_wndResizeBar.BringWindowToTop();
   COleIPFrameWndEx::RecalcLayout(bNotify);
   CWnd *pWnd = GetActiveView();
   if (pWnd != NULL)
      pWnd->BringWindowToTop();
   if (m_wndRulerBar.m_hWnd != NULL)
      m_wndRulerBar.BringWindowToTop();

   // at least 12 pt region plus ruler if it exists
   CDisplayIC dc;
   CSize size;
   size.cy = MulDiv(12, dc.GetDeviceCaps(LOGPIXELSY), 72) + 1;
   size.cx = dc.GetDeviceCaps(LOGPIXELSX) / 4; // 1/4"
   size.cx += HORZ_TEXTOFFSET;                 //adjust for offset
   size.cy += VERT_TEXTOFFSET;
   if (m_wndRulerBar.m_hWnd != NULL && m_wndRulerBar.IsVisible())
   {
      CRect rect;
      m_wndRulerBar.GetWindowRect(&rect);
      size.cy += rect.Height();
   }
   m_wndResizeBar.SetMinSize(size);
}

void CInPlaceFrame::CalcWindowRect(LPRECT lpClientRect, UINT nAdjustType)
{
   COleIPFrameWndEx::CalcWindowRect(lpClientRect, nAdjustType);
}

Arvshierarki

CObject

CCmdTarget

CWnd

CFrameWnd

COleIPFrameWnd

COleIPFrameWndEx

Kravspecifikation

Rubrik: afxoleipframewndex.h

COleIPFrameWndEx::AddDockSite

void AddDockSite();

Anmärkningar

COleIPFrameWndEx::AddPane

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail = TRUE);

Parameterar

[i] pControlBar
[i] bTail

Returvärde

Anmärkningar

COleIPFrameWndEx::AdjustDockingLayout

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parameterar

[i] hdwp

Anmärkningar

COleIPFrameWndEx::D ockPane

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Parameterar

[i] pBar
[i] nDockBarID
[i] lpRect

Anmärkningar

COleIPFrameWndEx::D ockPaneLeftOf

Dockar ett fönster till vänster om ett annat fönster.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parameterar

pBar
[i] En pekare till fönstret som ska dockas.

pLeftOf
[i] En pekare till fönstret som fungerar som ursprung.

Returvärde

Returnerar TRUE om åtgärden lyckas. Annars returneras FALSE.

Anmärkningar

Anropa den här metoden för att docka flera fönsterobjekt i en fördefinierad ordning. Den här metoden dockar fönstret som anges av pBar till vänster om fönstret som anges av pLeftOf.

COleIPFrameWndEx::EnableAutoHidePanes

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameterar

[i] dwDockStyle

Returvärde

Anmärkningar

COleIPFrameWndEx::EnableDocking

BOOL EnableDocking(DWORD dwDockStyle);

Parameterar

[i] dwDockStyle

Returvärde

Anmärkningar

COleIPFrameWndEx::EnablePaneMenu

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly = FALSE,
    BOOL bViewMenuShowsToolbarsOnly = FALSE);

Parameterar

[i] bEnable
[i] uiCustomizeCmd
[i] strCustomizeLabel
[i] uiViewToolbarsMenuEntryID
[i] bContextMenuShowsToolbarsOnly
[i] bViewMenuShowsToolbarsOnly

Anmärkningar

COleIPFrameWndEx::GetActivePopup

Returnerar en pekare till popup-menyn som visas just nu.

CMFCPopupMenu* GetActivePopup() const;

Returvärde

En pekare till den aktiva popup-menyn. annars NULL.

Anmärkningar

Använd den här metoden för att hämta en pekare till det CMFCPopupMenu-klassobjekt som visas för närvarande.

COleIPFrameWndEx::GetContainerFrameWindow

COleCntrFrameWndEx* GetContainerFrameWindow();

Returvärde

Anmärkningar

COleIPFrameWndEx::GetDefaultResId

Returnerar det menyresurs-ID som angavs när ramfönstret läste in menyn.

UINT GetDefaultResId() const;

Returvärde

Returnerar resurs-ID för menyn, eller 0 om ramfönstret inte har någon menyrad.

Anmärkningar

Anropa den här funktionen för att hämta resurs-ID:t som angavs när ramfönstret läste in menyresursen genom att anropa COleIPFrameWndEx::LoadFrame.

COleIPFrameWndEx::GetDockFrame

CFrameWnd* GetDockFrame();

Returvärde

Anmärkningar

COleIPFrameWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Returvärde

Anmärkningar

COleIPFrameWndEx::GetMainFrame

CFrameWnd* GetMainFrame();

Returvärde

Anmärkningar

COleIPFrameWndEx::GetMenuBar

Returnerar en pekare till menyradsobjektet som är kopplat till ramfönstret.

const CMFCMenuBar* GetMenuBar() const;

Returvärde

En pekare till menyradsobjektet.

Anmärkningar

Använd den här funktionen för att hämta en pekare till menyradsobjektet COleIPFrameWndEx som tillhör objektet.

COleIPFrameWndEx::GetPane

CBasePane* GetPane(UINT nID);

Parameterar

[i] Nid

Returvärde

Anmärkningar

COleIPFrameWndEx::GetTearOffBars

Returnerar en lista över fönsterobjekt som är i ett avrivningstillstånd.

const CObList& GetTearOffBars() const;

Returvärde

En referens till ett CObList objekt som innehåller en samling pekare till CBasePane Class-härledda objekt.

Anmärkningar

Objektet COleIPFrameWndEx underhåller samlingen avrivningsmenyer som en lista över CBasePane Class-härledda objekt. Använd den här metoden för att hämta en referens till den här listan.

COleIPFrameWndEx::GetToolbarButtonToolTipText

Anropas av ramverket innan knappbeskrivningen för en knapp visas.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Parameterar

pButton
[i] Pekare till knappen.

strTTText
[i] Pekare mot knappbeskrivningstexten.

Returvärde

Standardimplementeringen returnerar 0.

Anmärkningar

Åsidosätt den här funktionen för att anpassa visning av knappbeskrivningar på verktygsfältsknappar.

COleIPFrameWndEx::InitUserToobars

Anger ett intervall med kontroll-ID:t som ramverket tilldelar till de användardefinierade verktygsfälten.

void InitUserToolbars(
    LPCTSTR lpszRegEntry,
    UINT uiUserToolbarFirst,
    UINT uiUserToolbarLast)

Parameterar

lpszRegEntry
[i] Registerposten där biblioteket lagrar inställningar för användarverktygsfältet.

uiUserToolbarFirst
[i] Kontroll-ID som tilldelats det första användardefinierade verktygsfältet.

uiUserToolbarLast
[i] Kontroll-ID som tilldelats det senaste användardefinierade verktygsfältet.

Anmärkningar

Använd den här funktionen för att initiera ett intervall med kontroll-ID:t för tilldelning till verktygsfält som användarna definierar dynamiskt. Parametrarna uiUserToolbarFirst och uiUserToolbarLast definierar ett intervall med tillåtna verktygsfältskontroll-ID:er. Om du vill inaktivera skapandet av användardefinierade verktygsfält anger du uiUserToolbarFirst eller uiUserToolbarLast till -1.

COleIPFrameWndEx::InsertPane

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parameterar

[i] pControlBar
[i] pTarget
[i] bAfter

Returvärde

Anmärkningar

COleIPFrameWndEx::IsMenuBarAvailable

Avgör om pekaren till menyradsobjektet inte är NULL

BOOL IsMenuBarAvailable() const;

Returvärde

Returnerar ett värde som inte är noll om ramfönstret har en menyrad. annars returneras 0.

Anmärkningar

Anropa den här metoden för att avgöra om ramfönstret har en icke-NULL-pekare till menyradsobjektet.

COleIPFrameWndEx::IsPointNearDockSite

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parameterar

[i] punkt
[i] dwBarAlignment
[i] bOuterEdge

Returvärde

Anmärkningar

COleIPFrameWndEx::LoadFrame

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Parameterar

[i] nIDResource
[i] dwDefaultStyle
[i] pParentWnd
[i] pContext

Returvärde

Anmärkningar

COleIPFrameWndEx::OnCloseDockingPane

virtual BOOL OnCloseDockingPane(CDockablePane*);

Parameterar

[i] CDockablePane*

Returvärde

Anmärkningar

COleIPFrameWndEx::OnCloseMiniFrame

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);

Parameterar

[i] CPaneFrameWnd*

Returvärde

Anmärkningar

COleIPFrameWndEx::OnClosePopupMenu

Anropas av ramverket när en aktiv popup-meny bearbetar ett WM_DESTROY meddelande.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parameterar

pMenuPopup
[i] En pekare till popup-menyobjektet.

Anmärkningar

Åsidosätt den här metoden för att ta emot meddelanden från CMFCPopupMenu objekt när de bearbetar WM_DESTROY meddelanden.

COleIPFrameWndEx::OnCmdMsg

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parameterar

[i] Nid
[i] nCode
[i] pExtra
[i] pHandlerInfo

Returvärde

Anmärkningar

COleIPFrameWndEx::OnDrawMenuImage

Anropas av ramverket när den bild som är associerad med ett menyalternativ ritas.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Parameterar

pDC-
[i] Pekare mot enhetskontexten.

pMenuButton
[i] Pekare till menyknappen.

rectImage
[i] Bilden som är associerad med menyalternativet.

Returvärde

Standardimplementeringen gör ingenting och returnerar 0.

Anmärkningar

Åsidosätt den här metoden om du vill anpassa bildritningen för menyobjekten som tillhör menyraden som ägs av COleIPFrameWndEx-derived-objektet.

COleIPFrameWndEx::OnDrawMenuLogo

Anropas av ramverket när ett CMFCPopupMenu-objekt bearbetar ett WM_PAINT meddelande.

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

Parameterar

pDC-
[i] Pekare mot enhetskontexten.

pMenu
[i] Pekare till popup-menyobjektet.

rectLogo
[i] Pekare mot logotypen som ska visas.

Anmärkningar

Åsidosätt den här metoden om du vill visa en logotyp på popup-menyn som är associerad med menyraden som ägs av - COleIPFrameWndExderived-objektet. Standardimplementeringen gör ingenting.

COleIPFrameWndEx::OnMenuButtonToolHitTest

Anropas av ramverket när ett CMFCToolBarButton-objekt bearbetar ett WM_NCHITTEST meddelande.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Parameterar

[in] pButton Pekare till en menyknapp.

[ut] pTI-pekare till en TOOLINFO struktur.

Returvärde

Standardimplementeringen gör ingenting och returnerar 0. Implementeringen bör returnera ett värde som inte är noll om det fyller pTI-parametern .

Anmärkningar

Åsidosätt den här metoden för att ange knappbeskrivningsinformation om ett specifikt menyalternativ.

COleIPFrameWndEx::OnMoveMiniFrame

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameterar

[i] pFrame

Returvärde

Anmärkningar

COleIPFrameWndEx::OnSetPreviewMode

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parameterar

[i] bFörhandsvy
[i] pState

Anmärkningar

COleIPFrameWndEx::OnShowCustomizePane

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Parameterar

[i] pMenuPane
[i] uiToolbarID

Returvärde

Anmärkningar

COleIPFrameWndEx::OnShowPanes

virtual BOOL OnShowPanes(BOOL bShow);

Parameterar

[i] bShow

Returvärde

Anmärkningar

COleIPFrameWndEx::OnShowPopupMenu

Anropas av ramverket när en popup-meny visas.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenuPopup);

Parameterar

pMenuPopup
[i] Pekare till popup-menyn som ska visas.

Returvärde

Standardimplementeringen gör ingenting och returnerar ett värde som inte är noll. Implementeringen bör returnera FALSE om popup-menyn inte kan visas.

Anmärkningar

Åsidosätt den här metoden för att anpassa visningen av en popup-meny. Du kan till exempel ändra menyknapparna till färgmenyknappar eller initiera rivstaplar.

COleIPFrameWndEx::OnTearOffMenu

Anropas av ramverket när användaren väljer en meny som har ett avstängt fält.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Parameterar

pMenuPopup
[i] En pekare till popup-menyn som användaren har valt.

pBar
[i] En pekare till fönstret som är värd för menyn.

Returvärde

SANT om du vill att ramverket ska aktivera popup-menyn. annars FALSKT. Standardvärdet är TRUE.

Anmärkningar

Åsidosätt den här funktionen om du vill anpassa konfigurationen av avrivningsfältet.

COleIPFrameWndEx::P aneFromPoint

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parameterar

[i] punkt
[i] nSensitivity
[i] bExactBar
[i] pRTCBarType
[i] dwAlignment

Returvärde

Anmärkningar

COleIPFrameWndEx::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameterar

[i] pMsg

Returvärde

Anmärkningar

COleIPFrameWndEx::RecalcLayout

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameterar

[i] bNotify

Anmärkningar

COleIPFrameWndEx::RemovePaneFromDockManager

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parameterar

[i] pControlBar
[i] bDestroy
[i] bAdjustLayout
[i] bAutoHide
[i] pBarReplacement

Anmärkningar

COleIPFrameWndEx::SetDockState

Tillämpar det angivna dockningstillståndet på fönster som tillhör ramfönstret.

void SetDockState(const CDockState& state);

Parameterar

tillstånd
[i] Anger dockningstillståndet.

Anmärkningar

Använd den här funktionen för att ange ett nytt dockningstillstånd för fönster som tillhör objektet COleIPFrameWndEx .

COleIPFrameWndEx::SetupToolbarMenu

Ändrar ett verktygsfältsobjekt genom att söka efter dummyobjekt och ersätta dem med de angivna användardefinierade objekten.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Parameterar

meny
[i] En referens till ett CMenu-objekt som ska ändras.

uiViewUserToolbarCmdFirst
[i] Anger det första användardefinierade kommandot.

uiViewUserToolbarCmdLast
[i] Anger det senaste användardefinierade kommandot.

Anmärkningar

COleIPFrameWndEx::ShowPane

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parameterar

[i] pBar
[i] bShow
[i] bDelay
[i] bActivate

Anmärkningar

COleIPFrameWndEx::WinHelpA

Anropas av ramverket för att initiera WinHelp-programmet eller kontexthjälpen.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Parameterar

[in] dwData Anger data som krävs för den typ av hjälp som anges av nCmd.

nCmd
[i] Anger vilken typ av hjälp som begärs. En lista över möjliga värden och hur de påverkar parametern dwData finns i WinHelp-funktionen i Windows SDK.

Anmärkningar

Se även

hierarkidiagram
klasser
CFrameWndEx-klass
CMDIFrameWndEx-klass