Condividi tramite


COleControl::OnGetNaturalExtent

Chiamato dal framework in risposta alla richiesta IViewObjectEx::GetNaturalExtent di un contenitore.

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

Parametri

  • dwAspect
    Consente di specificare la modalità con cui l'oggetto deve essere rappresentato.Le rappresentazioni includono contenuto, l'icona, un'anteprima, o un documento stampato.I valori validi sono eseguite dall'enumerazione DVASPECT o DVASPECT2.

  • lindex
    La parte dell'oggetto a cui si è interessati.Attualmente solo -1 è valido.

  • ptd
    Punta alla struttura DVTARGETDEVICE che definisce il dispositivo di destinazione per cui la dimensione dell'oggetto devono essere restituiti.

  • hicTargetDev
    Specifica il contesto di informazioni per il dispositivo di destinazione indicato dal parametro ptd da cui l'oggetto può estrarre le metriche di dispositivo e testare le funzionalità del dispositivo.Se ptd è NULL, l'oggetto deve ignorare il valore nel parametro hicTargetDev.

  • pExtentInfo
    Punta alla struttura DVEXTENTINFO che specifica i dati di ridimensionamento.La struttura DVEXTENTINFO è:

    typedef struct tagExtentInfo

    {

    UINT cb;

    DWORD dwExtentMode;

    SIZEL sizelProposed;

    } DVEXTENTINFO;

    Il membro della struttura dwExtentMode può assumere uno dei due valori:

    • DVEXTENT_CONTENT domanda l'ampiezza del controllo deve essere esattamente di adattare il contenuto (blocco sul dimensione)

    • DVEXTENT_INTEGRAL quando viene ridimensionata, sessione è proposto la dimensione per controllare

  • psizel
    Punti ai dati di ridimensionamento restituiti dal controllo.I dati di ridimensionamento restituiti sono impostate su -1 per qualsiasi dimensione che non è stata modificata.

Valore restituito

Diverso da zero se restituisce correttamente o modificare la dimensione, in caso contrario 0.

Note

Eseguire l'override di questa funzione restituisce le dimensioni di visualizzazione dell'oggetto più vicini a quella proposta di ambito e delle dimensioni nella struttura DVEXTENTINFO.L'implementazione predefinita restituisce FALSE e non passa a modifiche alla dimensione.

Requisiti

Header: afxctl.h

Vedere anche

Riferimenti

Classe di COleControl

Grafico della gerarchia

COleControl::OnGetViewExtent