COleControl::OnGetNaturalExtent

  • 發行項

呼叫框架回應容器的 IViewObjectEx::GetNaturalExtent 要求。

virtual BOOL OnGetNaturalExtent(
   DWORD dwAspect,
   LONG lindex,
   DVTARGETDEVICE* ptd,
   HDC hicTargetDev,
   DVEXTENTINFO* pExtentInfo,
   LPSIZEL psizel 
);

參數

  • dwAspect
    指定物件要進行表示的方式。表示包含內容、圖示、縮圖、可列印的文件。有效值是從列舉型別 DVASPECT 或 DVASPECT2中取得。

  • lindex
    想要的物件部分。目前只有-1 有效。

  • ptd
    為 DVTARGETDEVICE 的點結構定義物件的大小應該傳回的目標裝置。

  • hicTargetDev
    指定物件可以擷取裝置度量資訊 (Metric) 並測試裝置的功能 ptd 參數表示的目標裝置指定訊息內容。如果是， ptdNULL物件應該忽略在 hicTargetDev 參數的值。

  • pExtentInfo
    為指定的大小資料。 DVEXTENTINFO 結構的點。DVEXTENTINFO 結構如下:

    typedef struct tagExtentInfo

    {

    UINT cb;

    DWORD dwExtentMode;

    SIZEL sizelProposed;

    } DVEXTENTINFO;

    結構成員 dwExtentMode 可以接受兩個值的其中一個:

    • DVEXTENT_CONTENT 查詢控制項多大應清除 (自動調整大小會貼齊至)

    • DVEXTENT_INTEGRAL ，重設大小時，傳遞時如何控制項大小

  • psizel
    將控制項傳回的資料大小的點。傳回的資料大小設定為-1 未調整的所有維度的。

傳回值

如果不是零，則成功傳回或調整其大小，則為 0。

備註

覆寫這個函式會傳回物件的顯示大小最接近 DVEXTENTINFO 結構的建議大小和範圍模式。預設實作會傳回 否 而不進行調整的大小。

需求

Header: afxctl.h

請參閱

參考

COleControl 類別

階層架構圖

COleControl::OnGetViewExtent