Classe di COleControl

Articolo
02/19/2013

Una classe base efficace per i controlli OLE di sviluppo.

class COleControl : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
COleControl::COleControl	Crea un oggetto COleControl.

Metodi pubblici

Nome	Descrizione
COleControl::AmbientAppearance	Recupera l'aspetto del controllo corrente.
COleControl::AmbientBackColor	Restituisce il valore della proprietà di ambiente BackColor.
COleControl::AmbientDisplayName	Restituisce il nome del controllo come specificato dal contenitore.
COleControl::AmbientFont	Restituisce il valore della proprietà predefinite di ambiente.
COleControl::AmbientForeColor	Restituisce il valore della proprietà di ambiente ForeColor.
COleControl::AmbientLocaleID	Restituisce l'id delle impostazioni locali del contenitore
COleControl::AmbientScaleUnits	Restituisce il tipo di unità utilizzate dal contenitore.
COleControl::AmbientShowGrabHandles	Determina se le maniglie visualizzare.
COleControl::AmbientShowHatching	Determina se covare visualizzare.
COleControl::AmbientTextAlign	Restituisce il tipo di allineamento del testo specificato dal contenitore.
COleControl::AmbientUIDead	Determina se il controllo risponde alle azioni dell'interfaccia utente.
COleControl::AmbientUserMode	Determina la modalità del contenitore.
COleControl::BoundPropertyChanged	Notifica al contenitore che una proprietà associata è stata modificata.
COleControl::BoundPropertyRequestEdit	Richiede l'autorizzazione a modificare il valore della proprietà.
COleControl::ClientToParent	Converte un punto all'origine del controllo su un punto all'origine del contenitore.
COleControl::ClipCaretRect	Regola un rettangolo del cursore se è sovrapposto da un controllo.
COleControl::ControlInfoChanged	Chiamare questa funzione dopo l'insieme di tasti gestiti dal controllo è stato modificato.
COleControl::DisplayError	Le visualizzazioni di borsa gli eventi di errore all'utente del controllo.
COleControl::DoClick	Implementazione del metodo predefinito DoClick.
COleControl::DoPropExchange	Serializza le proprietà di un oggetto COleControl.
COleControl::DoSuperclassPaint	Ridisegna un controllo OLE che è stato sottoclassato da un controllo Windows.
COleControl::EnableSimpleFrame	Attiva il supporto semplice frame a un controllo.
COleControl::ExchangeExtent	Serializza la larghezza e l'altezza del controllo.
COleControl::ExchangeStockProps	Serializza le proprietà di azione del controllo.
COleControl::ExchangeVersion	Serializza il numero di versione del controllo.
COleControl::FireClick	Genera l'evento predefinito Click.
COleControl::FireDblClick	Genera l'evento predefinito DblClick.
COleControl::FireError	Genera l'evento predefinito Error.
COleControl::FireEvent	Genera un evento personalizzato.
COleControl::FireKeyDown	Genera l'evento predefinito KeyDown.
COleControl::FireKeyPress	Genera l'evento predefinito KeyPress.
COleControl::FireKeyUp	Genera l'evento predefinito KeyUp.
COleControl::FireMouseDown	Genera l'evento predefinito MouseDown.
COleControl::FireMouseMove	Genera l'evento predefinito MouseMove.
COleControl::FireMouseUp	Genera l'evento predefinito MouseUp.
COleControl::FireReadyStateChange	Genera un evento quando lo stato viene modificato pronti del controllo.
COleControl::GetActivationPolicy	Modifica il comportamento predefinito di attivazione di un controllo che supporta l'interfaccia IPointerInactive.
COleControl::GetAmbientProperty	Restituisce il valore della proprietà di ambiente specificata.
COleControl::GetAppearance	Restituisce il valore della proprietà relative predefinita.
COleControl::GetBackColor	Restituisce il valore della proprietà predefinita di Sfondo.
COleControl::GetBorderStyle	Restituisce il valore della proprietà predefinita di BorderStyle.
COleControl::GetCapture	Determina se un oggetto senza finestra e ha attivato il mouse capture.
COleControl::GetClassID	Recupera l'id di classe OLE del controllo.
COleControl::GetClientOffset	Recupera la differenza tra l'angolo superiore sinistro dell'area rettangolare del controllo e l'angolo superiore sinistro dell'area client.
COleControl::GetClientRect	Recupera la dimensione dell'area client del controllo.
COleControl::GetClientSite	Eseguire una query un oggetto per il puntatore al sito client corrente nel relativo contenitore.
COleControl::GetControlFlags	Recupera le impostazioni di flag di controllo.
COleControl::GetControlSize	Restituisce la posizione e la dimensione del controllo OLE.
COleControl::GetDC	Fornisce i mezzi per un controllo senza finestra di ottenere un contesto di dispositivo dal contenitore.
COleControl::GetEnabled	Restituisce il valore della proprietà attivata predefinita.
COleControl::GetExtendedControl	Recupera un puntatore a un oggetto controllo esteso che appartiene al contenitore.
COleControl::GetFocus	Determina se il controllo ha lo stato attivo.
COleControl::GetFont	Restituisce il valore della proprietà predefinite predefinita.
COleControl::GetFontTextMetrics	Restituisce la metrica di un oggetto CFontHolder.
COleControl::GetForeColor	Restituisce il valore della proprietà predefinita di ForeColor.
COleControl::GetHwnd	Restituisce il valore della proprietà predefinita di HWND.
COleControl::GetMessageString	Fornisce il testo della barra di stato per una voce di menu.
COleControl::GetNotSupported	Impedisce l'accesso al valore della proprietà di un controllo dall'utente.
COleControl::GetReadyState	Restituisce lo stato della conformità del controllo.
COleControl::GetRectInContainer	Restituisce il rettangolo del controllo rispetto al relativo contenitore.
COleControl::GetStockTextMetrics	Restituisce la metrica delle proprietà predefinite predefinita.
COleControl::GetText	Restituisce il valore della proprietà predefinita della barra del titolo o di testo.
COleControl::GetWindowlessDropTarget	Eseguire l'override di per consentire a un controllo senza finestra sia la destinazione delle operazioni di trascinamento.
COleControl::InitializeIIDs	Avvisa la classe base degli IID che il controllo utilizzerà.
COleControl::InternalGetFont	Restituisce un oggetto CFontHolder per la proprietà predefinite predefinita.
COleControl::InternalGetText	Recupera la barra del titolo o la proprietà Text predefinita.
COleControl::InternalSetReadyState	Imposta lo stato della conformità del controllo e genera l'evento della pronto-stato- modifica.
COleControl::InvalidateControl	Invalida un'area di controllo viene visualizzata, causando lo a ridisegnarsi.
COleControl::InvalidateRgn	Invalida l'area client della finestra contenitore interno dell'area specificata.Può essere utilizzato per ridisegnare i controlli privi di finestra nell'area.
COleControl::IsConvertingVBX	A specializzato il caricamento di un controllo OLE.
COleControl::IsModified	Determina se lo stato del controllo è stato modificato.
COleControl::IsOptimizedDraw	Indica se il contenitore supportano il disegno ottimizzato per l'operazione di disegno corrente.
COleControl::IsSubclassedControl	Chiamato per determinare se le sottoclassi del controllo un controllo Windows.
COleControl::Load	Reimposta tutti i dati asincroni precedenti e avvia un nuovo caricamento della proprietà del controllo.
COleControl::LockInPlaceActive	Determina se il controllo può essere disabilitato dal contenitore.
COleControl::OnAmbientPropertyChange	Chiamato quando una proprietà di ambiente viene modificata.
COleControl::OnAppearanceChanged	Chiamato quando la proprietà relative predefinita viene modificata.
COleControl::OnBackColorChanged	Chiamato quando la proprietà BackColor di azione viene modificata.
COleControl::OnBorderStyleChanged	Chiamato quando la proprietà di BorderStyle di azione viene modificata.
COleControl::OnClick	Chiamato per generare l'evento Click predefinito.
COleControl::OnClose	Notifica al controllo che IOleControl::Close è stato chiamato.
COleControl::OnDoVerb	Chiamato dopo che un verbo del controllo è stato eseguito.
COleControl::OnDraw	Chiamato quando un controllo viene richiesto per ridisegnare.
COleControl::OnDrawMetafile	Chiamato dal contenitore quando un controllo viene richiesto per essere ridisegnata utilizzando un contesto di dispositivo metafile.
COleControl::OnEdit	Chiamato dal contenitore all'interfaccia utente attiva un controllo OLE.
COleControl::OnEnabledChanged	Chiamato quando viene attivata la proprietà predefinita viene modificata.
COleControl::OnEnumVerbs	Chiamato dal contenitore per enumerare i verbi di un controllo.
COleControl::OnEventAdvise	Chiamato quando i gestori eventi sono connessi o disconnessi da un controllo.
COleControl::OnFontChanged	Chiamato quando la proprietà predefinite predefinita viene modificata.
COleControl::OnForeColorChanged	Chiamato quando la proprietà di ForeColor di azione viene modificata.
COleControl::OnFreezeEvents	Chiamato quando gli eventi di un controllo sono bloccati o scongelati.
COleControl::OnGetColorSet	Notifica al controllo che IOleObject::GetColorSet è stato chiamato.
COleControl::OnGetControlInfo	Fornisce informazioni quali il contenitore.
COleControl::OnGetDisplayString	Chiamato per ottenere una stringa che rappresenti un valore di proprietà.
COleControl::OnGetInPlaceMenu	Richiede un handle dei menu di controllo che verranno uniti al menu del contenitore.
COleControl::OnGetNaturalExtent	Override per recuperare le dimensioni di visualizzazione del controllo più vicini a quella proposta di ambito e delle dimensioni.
COleControl::OnGetPredefinedStrings	Restituisce le stringhe che rappresentano i valori possibili per una proprietà.
COleControl::OnGetPredefinedValue	Restituisce il valore corrispondente a una stringa predefinita.
COleControl::OnGetViewExtent	Override per recuperare la dimensione delle aree di visualizzazione del controllo (può essere utilizzato per attivare il disegno a due sessione).
COleControl::OnGetViewRect	Override per convertire la dimensione del controllo in un rettangolo che inizia a una posizione specifica.
COleControl::OnGetViewStatus	Override per recuperare lo stato di visualizzazione del controllo.
COleControl::OnHideToolBars	Chiamato dal contenitore quando il controllo è interfaccia utente disabilitato.
COleControl::OnInactiveMouseMove	Override di disporre del contenitore per il controllo inattivo nei messaggi WM_MOUSEMOVE di invio del puntatore del mouse sul controllo.
COleControl::OnInactiveSetCursor	Override di disporre del contenitore per il controllo inattivo nei messaggi WM_SETCURSOR di invio del puntatore del mouse sul controllo.
COleControl::OnKeyDownEvent	Chiamato dopo l'evento KeyDown di azione è stato generato.
COleControl::OnKeyPressEvent	Chiamato dopo l'evento di KeyPress di azione è stato generato.
COleControl::OnKeyUpEvent	Chiamato dopo l'evento KeyUp di azione è stato generato.
COleControl::OnMapPropertyToPage	Indica quale pagina delle proprietà da utilizzare per modificare una proprietà.
COleControl::OnMnemonic	Chiamato quando una chiave se il controllo è stato premuto.
COleControl::OnProperties	Chiamato quando il verbo "proprietà" del controllo è stato richiamato.
COleControl::OnQueryHitPoint	Override da eseguire una query su se si sovrappone alla visualizzazione di un controllo un punto specificato.
COleControl::OnQueryHitRect	Override da eseguire query quando la visualizzazione di un controllo si sovrappone a qualsiasi punto in un rettangolo specificato.
COleControl::OnRenderData	Chiamato dal framework per recuperare i dati nel formato specificato.
COleControl::OnRenderFileData	Chiamato dal framework per recuperare dati da un file nel formato specificato.
COleControl::OnRenderGlobalData	Chiamato dal framework per recuperare i dati dalla memoria globale in formato specificato.
COleControl::OnResetState	Reimposta le proprietà di un controllo ai valori predefiniti.
COleControl::OnSetClientSite	Notifica al controllo che IOleControl::SetClientSite è stato chiamato.
COleControl::OnSetData	Sostituisce i dati del controllo a un altro valore.
COleControl::OnSetExtent	Chiamata dopo l'ambito del controllo è stato modificato.
COleControl::OnSetObjectRects	Chiamato dopo che le dimensioni del controllo sono state modificate.
COleControl::OnShowToolBars	Chiamato quando il controllo è stato interfaccia utente attivata.
COleControl::OnTextChanged	Chiamato quando la proprietà predefinita della barra del titolo o di testo viene modificata.
COleControl::OnWindowlessMessage	Messaggi della finestra processi (eccetto i messaggi di mouse e tastiera) per i controlli privi di finestra.
COleControl::ParentToClient	Converte un punto all'origine contenitore su un punto all'origine del controllo.
COleControl::PostModalDialog	Notifica al contenitore che una finestra di dialogo modale è stata chiusa.
COleControl::PreModalDialog	Notifica al contenitore che una finestra di dialogo modale sta per visualizzare.
COleControl::RecreateControlWindow	Elimina e ricreata la finestra del controllo.
COleControl::Refresh	Forza un aggiornamento dell'aspetto di un controllo.
COleControl::ReleaseCapture	Rilascia il mouse capture.
COleControl::ReleaseDC	Rilascia il contesto dello schermo di un contenitore di un controllo senza finestra.
COleControl::ReparentControlWindow	Reimposta il padre della finestra di controllo.
COleControl::ResetStockProps	Inizializza le proprietà di azione COleControl i valori predefiniti.
COleControl::ResetVersion	Inizializza il numero di versione con un valore specificato.
COleControl::ScrollWindow	Consente a un controllo senza finestra scorrere un'area nella propria immagine attiva sul posto nella visualizzazione.
COleControl::SelectFontObject	Selezionare una proprietà predefinite personalizzata in un contesto di dispositivo.
COleControl::SelectStockFont	Selezionare la proprietà predefinite predefinita in un contesto di dispositivo.
COleControl::SerializeExtent	Serializzazione o inizializza lo spazio di visualizzazione per il controllo.
COleControl::SerializeStockProps	Serializzazione o inizializza le proprietà di azione COleControl.
COleControl::SerializeVersion	Serializzazione o inizializza le informazioni sulla versione del controllo.
COleControl::SetAppearance	Imposta il valore della proprietà relative predefinita.
COleControl::SetBackColor	Imposta il valore della proprietà predefinita di Sfondo.
COleControl::SetBorderStyle	Imposta il valore della proprietà predefinita di BorderStyle.
COleControl::SetCapture	Nella finestra contenitore di controlli a ottenere il possesso del mouse capture per conto del controllo.
COleControl::SetControlSize	Imposta la posizione e la dimensione del controllo OLE.
COleControl::SetEnabled	Imposta il valore della proprietà attivata predefinita.
COleControl::SetFocus	Nella finestra contenitore di controlli a ottenere il possesso dello stato attivo per l'input da parte del controllo.
COleControl::SetFont	Imposta il valore della proprietà predefinite predefinita.
COleControl::SetForeColor	Imposta il valore della proprietà predefinita di ForeColor.
COleControl::SetInitialSize	Imposta la dimensione di un controllo OLE una volta innanzitutto visualizzarla in un contenitore.
COleControl::SetModifiedFlag	Modifica lo stato modificato in un controllo.
COleControl::SetNotPermitted	Indica che una richiesta modifiche non è riuscita.
COleControl::SetNotSupported	Impedisce la modifica il valore della proprietà di un controllo dall'utente.
COleControl::SetRectInContainer	Imposta il rettangolo del controllo rispetto al relativo contenitore.
COleControl::SetText	Imposta il valore della proprietà predefinita della barra del titolo o di testo.
COleControl::ThrowError	Segnala un errore che si è verificato in un controllo OLE.
COleControl::TransformCoords	Le trasformazioni coordinamento i valori tra un contenitore e.
COleControl::TranslateColor	Converte un valore OLE_COLOR a un valore COLORREF.
COleControl::WillAmbientsBeValidDuringLoad	Determina se le proprietà di ambiente risulteranno disponibili alla successiva apertura del controllo verrà caricata.
COleControl::WindowProc	Fornisce una routine di Windows per un oggetto COleControl.

Metodi protetti

Nome	Descrizione
COleControl::DrawContent	Chiamato dal framework quando l'aspetto del controllo deve essere aggiornato.
COleControl::DrawMetafile	Chiamato dal framework quando il contesto di dispositivo metafile in uso.
COleControl::IsInvokeAllowed	Consente la chiamata di metodo di automazione.
COleControl::SetInitialDataFormats	Chiamato dal framework per inizializzare l'elenco dei formati dati supportate dal controllo.

Note

Derivato da CWnd, questa classe eredita tutte le funzionalità di un oggetto finestra di Windows più funzionalità aggiuntiva specifica OLE, ad esempio consentono di evento e la possibilità di supportare i metodi e le proprietà.

I controlli OLE possono essere inseriti nelle applicazioni del contenitore OLE e comunicare con il contenitore tramite un sistema bidirezionale di consentono di evento ed esponendo i metodi e le proprietà del contenitore.Si noti che i contenitori OLE standard supportano solo la funzionalità di base di un controllo OLE.Non è in grado di supportare funzionalità estese di un controllo OLE.Che consentono di evento si verifica quando gli eventi vengono inviati al contenitore come risultato delle azioni che si verificano nel controllo.A sua volta, il contenitore comunica con il controllo utilizzando un insieme di esporre metodi e le proprietà analoghe alle funzioni membro e i membri dati C++ classe.Questo approccio consente agli sviluppatori di controllare l'aspetto del controllo e segnalare al contenitore di alcune azioni si verificano.

Controlli privi di finestra

I controlli OLE possono essere attivo sul posto utilizzato senza una finestra.I controlli privi di finestra presentano vantaggi significativi:

I controlli privi di finestra possono essere trasparenti e non rettangolari
I controlli privi di finestra ridurre la dimensione dell'istanza e l'ora di creazione dell'oggetto

I controlli non necessitano di una finestra.I servizi che una finestra offre possono essere forniti da sola finestra condivisa (in genere il contenitore) e bit di inviare il codice.Disporre di una finestra è principalmente una complicazione all'oggetto.

Quando l'attivazione senza finestra viene utilizzata, il contenitore (con una finestra) è responsabile di fornire servizi che sarebbero altrimenti forniti da una finestra del controllo.Ad esempio, se il controllo deve di eseguire una query sullo stato attivo, di interrogare il mouse capture, o di ottenere un contesto di dispositivo, queste operazioni vengono gestite dal contenitore.Il richiamo COleControlfunzioni membro di un'operazione senza input queste operazioni nel contenitore.

Quando l'attivazione senza finestra è abilitata, i messaggi inviati delegati contenitore su IOleInPlaceObjectWindowless del controllo collegamento (un'estensione IOleInPlaceObject di supporto senza finestra.l'implementazione di COleControl di questa interfaccia invierà questi messaggi tramite la mappa messaggi del controllo, dopo avere modificato le coordinate del mouse in modo appropriato.È possibile elaborare i messaggi quali messaggi comuni della finestra, aggiungendo voci corrispondenti alla mappa messaggi.

In un controllo senza finestra, è sempre opportuno utilizzare le funzioni membro COleControl anziché le funzioni membro corrispondente CWnd o delle funzioni correlate di Windows.

Gli oggetti di controllo OLE possono inoltre creare una finestra solo quando diventano attivi, ma la quantità di lavoro necessaria per la transizione di inattivo- attivo passa su e la velocità della transizione si sposta verso il basso.In alcuni casi questo è un problema: ad esempio, si consideri una griglia delle caselle di testo.In cursoring l'alto e verso il basso fino alla colonna, ogni controllo deve essere attivato sul posto e quindi disabilitato.La velocità transizione inattiva/attiva direttamente sulla velocità di scorrimento.

Per ulteriori informazioni sullo sviluppo di un framework del controllo OLE, vedere gli articoli Controlli ActiveX MFC e cenni preliminari: Creare un programma di controllo ActiveX MFC.Per informazioni su come ottimizzare i controlli OLE, inclusi i controlli privi di finestra e senza sfarfallio, vedere Controlli ActiveX MFC: ottimizzazione.