Condividi tramite


Classe di COleControl

Una classe base efficace per i controlli OLE di sviluppo.

class COleControl : public CWnd

Membri

77hhz71h.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

COleControl::COleControl

Crea un oggetto COleControl.

77hhz71h.collapse_all(it-it,VS.110).gifMetodi 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.

77hhz71h.collapse_all(it-it,VS.110).gifMetodi 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.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

COleControl

Requisiti

Header: afxctl.h

Vedere anche

Riferimenti

Classe di COlePropertyPage

Classe CWnd

Grafico della gerarchia

Classe di CFontHolder

Classe di CPictureHolder

Concetti

Esempi relativi a MFC CIRC3

Esempio TESTHELP MFC