COleServerDoc::UpdateAllItems

Articolo
02/19/2013

Chiamare la funzione per notificare a tutti gli elementi collegati connessi al documento che il documento è stato modificato.

void UpdateAllItems(
   COleServerItem* pSender,
   LPARAM lHint = 0L,
   CObject* pHint = NULL,
   DVASPECT nDrawAspect = DVASPECT_CONTENT 
);

Parametri

pSender
Puntatore all'elemento che ha modificato il documento, o NULL se tutti gli elementi devono essere aggiornati.
lHint
Contiene informazioni sulla modifica.
pHint
Puntatore a un oggetto che archivia informazioni sulla modifica.
nDrawAspect
Determina come elemento deve essere disegnato.Si tratta di un valore dall'enumerazione DVASPECT.Per il parametro è possibile specificare uno dei valori riportati di seguito.
- l'elemento diDVASPECT_CONTENT viene rappresentato in modo che può essere visualizzato come oggetto incorporato nel contenitore.
- l'elemento diDVASPECT_THUMBNAIL viene eseguito il rendering in una rappresentazione "anteprima" in modo da poter visualizzare in uno strumento di esplorazione.
- l'elemento diDVASPECT_ICON è rappresentato da un'icona.
- l'elemento diDVASPECT_DOCPRINT viene rappresentato come se fosse spostato utilizzando il comando di stampa dal menu File.

Note

In genere chiamare questa funzione dopo che l'utente ha modificato il documento server.Se un elemento OLE collegato al documento con un collegamento automatico, l'elemento viene aggiornato per riflettere le modifiche.Nelle applicazioni contenitori scritte con la libreria MFC, la funzione membro OnChangeCOleClientItem è denominata.

Tale funzione chiama la funzione membro OnUpdate per ognuno degli elementi del documento esclusi l'elemento inviando, passando pHint, lHinte nDrawAspect.Utilizzare questi parametri per passare informazioni agli elementi sulle modifiche apportate al documento.È possibile codificare le informazioni mediante lHint oppure definire CObjectclasse derivata per archiviare le informazioni sulle modifiche e passare un oggetto della classe utilizzando pHint.Eseguire l'override della funzione membro nel COleServerItemclasse derivata OnUpdate per ottimizzare l'aggiornamento di ogni elemento in base alla relativa presentazione è stato modificato.