Classe COleControl

Artigo
06/10/2015

Uma classe base poderosa para controladores OLE desenvolvimento.

class COleControl : public CWnd

Membros

Construtores public

Nome	Descrição
COleControl::COleControl	Cria um objeto de COleControl .

Métodos públicos

Nome	Descrição
COleControl::AmbientAppearance	Recupera a aparência do controle atual.
COleControl::AmbientBackColor	Retorna o valor da propriedade de ambiente BackColor.
COleControl::AmbientDisplayName	Retorna o nome do controle como especificado pelo recipiente.
COleControl::AmbientFont	Retorna o valor da propriedade de ambiente de fonte.
COleControl::AmbientForeColor	Retorna o valor da propriedade de ambiente de ForeColor.
COleControl::AmbientLocaleID	Retorna a identificação da localidade de contêiner
COleControl::AmbientScaleUnits	Retorna o tipo de unidades usadas pelo recipiente.
COleControl::AmbientShowGrabHandles	Determina se a captura alças são exibidas.
COleControl::AmbientShowHatching	Determina se chocar é exibido.
COleControl::AmbientTextAlign	Retorna o tipo de alinhamento de texto especificado pelo recipiente.
COleControl::AmbientUIDead	Determina se o controle responder às ações da interface do usuário.
COleControl::AmbientUserMode	Determina o modo de contêiner.
COleControl::BoundPropertyChanged	Notifica o contêiner que uma propriedade que foi alterada.
COleControl::BoundPropertyRequestEdit	Solicitar permissão para editar o valor da propriedade.
COleControl::ClientToParent	Converte um ponto em relação à origem do controle a um ponto em relação à fonte do seu contêiner.
COleControl::ClipCaretRect	Ajustar um retângulo caret se é sobreposta por um controle.
COleControl::ControlInfoChanged	Chamar essa função após o conjunto de mnemônicos tratadas pelo controle foi alterado.
COleControl::DisplayError	Exibe os eventos de erro para o usuário do controle.
COleControl::DoClick	Implementação do método de stock de DoClick .
COleControl::DoPropExchange	Serializa as propriedades de um objeto de COleControl .
COleControl::DoSuperclassPaint	Redesenho do OLE um controlador que tenha sido derivado de um controle do windows.
COleControl::EnableSimpleFrame	Permite suporte simples de quadro chave para um controle.
COleControl::ExchangeExtent	Serializa a largura e a altura do controle.
COleControl::ExchangeStockProps	Serializa as propriedades do estoque de controle.
COleControl::ExchangeVersion	Serializa o número de versão do controle.
COleControl::FireClick	O evento é acionado de stock de Click .
COleControl::FireDblClick	O evento é acionado de stock de DblClick .
COleControl::FireError	O evento é acionado de stock de Error .
COleControl::FireEvent	Aciona um evento personalizado.
COleControl::FireKeyDown	O evento é acionado de stock de KeyDown .
COleControl::FireKeyPress	O evento é acionado de stock de KeyPress .
COleControl::FireKeyUp	O evento é acionado de stock de KeyUp .
COleControl::FireMouseDown	O evento é acionado de stock de MouseDown .
COleControl::FireMouseMove	O evento é acionado de stock de MouseMove .
COleControl::FireMouseUp	O evento é acionado de stock de MouseUp .
COleControl::FireReadyStateChange	Acionar um evento quando as alterações de estado pronto do controle.
COleControl::GetActivationPolicy	Altera o comportamento padrão de ativação de um controle que oferece suporte a interface de IPointerInactive .
COleControl::GetAmbientProperty	Retorna o valor da propriedade de ambiente especificada.
COleControl::GetAppearance	Retorna o valor da propriedade conservada em estoque de aparência.
COleControl::GetBackColor	Retorna o valor da propriedade conservada em estoque BackColor.
COleControl::GetBorderStyle	Retorna o valor da propriedade conservada em estoque de BorderStyle.
COleControl::GetCapture	Determina se um objeto sem janelas, ativada de controle tem a captura do mouse.
COleControl::GetClassID	Recupera o OLE identificação de classe do controle.
COleControl::GetClientOffset	Recupera a diferença entre o canto superior esquerdo da área retangular do controle e o canto superior esquerdo da área cliente.
COleControl::GetClientRect	Retorna o tamanho da área cliente do controle.
COleControl::GetClientSite	Consulta a um objeto para o ponteiro ao seu site atual do cliente dentro de seu recipiente.
COleControl::GetControlFlags	Recupera as configurações de sinalizador de controle.
COleControl::GetControlSize	Retorna a posição e tamanho do controlador o OLE.
COleControl::GetDC	Fornece um meio para que um controle sem janelas obtém um contexto de dispositivo de seu recipiente.
COleControl::GetEnabled	Retorna o valor da propriedade ativado conservada estoque.
COleControl::GetExtendedControl	Recupera um ponteiro para um objeto estendido de controle que pertence ao contêiner.
COleControl::GetFocus	Determina se o controle tem o foco.
COleControl::GetFont	Retorna o valor da propriedade conservada em estoque da fonte.
COleControl::GetFontTextMetrics	Retorna métricas de um objeto de CFontHolder .
COleControl::GetForeColor	Retorna o valor da propriedade conservada em estoque. de ForeColor
COleControl::GetHwnd	Retorna o valor da propriedade conservada em estoque do hWnd.
COleControl::GetMessageString	Fornece o texto da barra de status para um item de menu.
COleControl::GetNotSupported	Impede o acesso ao valor da propriedade de um controle pelo usuário.
COleControl::GetReadyState	Retorna o estado de prontidão do controle.
COleControl::GetRectInContainer	Retorna o retângulo de controle em relação ao recipiente.
COleControl::GetStockTextMetrics	Retorna métricas de propriedade conservada em estoque da fonte.
COleControl::GetText	Retorna o valor da propriedade conservada em estoque de texto ou da legenda.
COleControl::GetWindowlessDropTarget	Substituição para permitir que um controle sem o windows é o destino de arrastar e solte operações.
COleControl::InitializeIIDs	Informa a classe base de IIDs que o controle usará.
COleControl::InternalGetFont	Retorna um objeto de CFontHolder para a propriedade conservada em estoque da fonte.
COleControl::InternalGetText	Recupera a propriedade conservada em estoque de legenda ou de texto.
COleControl::InternalSetReadyState	Define o estado de prontidão do controle e aciona o evento de pronto-estado- alteração.
COleControl::InvalidateControl	Invalida uma área do controle exibido, causando o a ser redesenhado.
COleControl::InvalidateRgn	Invalida a área cliente da janela contêiner dentro da região determinada. Pode ser usado para redesenhar controles sem janelas na região.
COleControl::IsConvertingVBX	Allows especializou a carga de um controlador do OLE.
COleControl::IsModified	Determina se o estado de controle for alterado.
COleControl::IsOptimizedDraw	Indica se o contêiner suporta o desenho otimizado para a operação atual de desenho.
COleControl::IsSubclassedControl	Chamado para determinar se as subclasses de controle do windows.
COleControl::Load	Reinicializa todos os dados assíncronas anteriores e iniciar uma nova de carregamento assíncrono propriedade do controle.
COleControl::LockInPlaceActive	Determina se o controle pode ser desativado pelo recipiente.
COleControl::OnAmbientPropertyChange	Chamado quando uma propriedade de ambiente é alterada.
COleControl::OnAppearanceChanged	Chamado quando a propriedade conservada em estoque de aparência é alterada.
COleControl::OnBackColorChanged	Chamado quando a propriedade BackColor de estoque é alterada.
COleControl::OnBorderStyleChanged	Chamado quando a propriedade de BorderStyle de estoque é alterada.
COleControl::OnClick	Chamado para acionar o evento de stock de clique.
COleControl::OnClose	Notifica o controle que IOleControl::Close foi chamado.
COleControl::OnDoVerb	Chamado após um verbo do controle foi executado.
COleControl::OnDraw	Chamado quando um controle é solicitado para se redesenho.
COleControl::OnDrawMetafile	Chamado pelo contêiner quando um controle é solicitado para se redesenho que usa um contexto do dispositivo de metarquivo.
COleControl::OnEdit	Chamado pelo recipiente a interface do usuário ativar um controlador do OLE.
COleControl::OnEnabledChanged	Chamado quando a propriedade ativado conservada em estoque é alterada.
COleControl::OnEnumVerbs	Chamado pelo recipiente para enumerar os verbos de um controle.
COleControl::OnEventAdvise	Chamado quando os manipuladores de eventos estejam conectados ou desconectados de um controle.
COleControl::OnFontChanged	Chamado quando a propriedade conservada em estoque da fonte é alterada.
COleControl::OnForeColorChanged	Chamado quando a propriedade de ForeColor de estoque é alterada.
COleControl::OnFreezeEvents	Chamado quando os eventos de um controle são congelados ou descongelados.
COleControl::OnGetColorSet	Notifica o controle que IOleObject::GetColorSet foi chamado.
COleControl::OnGetControlInfo	Fornece informações mnemônicos para o contêiner.
COleControl::OnGetDisplayString	Chamado para obter uma cadeia de caracteres para representar um valor de propriedade.
COleControl::OnGetInPlaceMenu	Solicitar a alça de menu de controle que será mesclado com o menu do recipiente.
COleControl::OnGetNaturalExtent	Substituição para recuperar o tamanho de exibição de controle mais próximo do modo proposta de tamanho e a extensão.
COleControl::OnGetPredefinedStrings	Retorna o qual a representação de valores possíveis para uma propriedade.
COleControl::OnGetPredefinedValue	Retorna o valor que corresponde a uma cadeia de caracteres pré-definida.
COleControl::OnGetViewExtent	Substituição para recuperar o tamanho das áreas de exibição do controle (pode ser usado para habilitar o desenho de duas passagem.)
COleControl::OnGetViewRect	Substituição para converter o tamanho do controle em um retângulo que começa em uma posição específica.
COleControl::OnGetViewStatus	Substituição para recuperar o status de exibição de controle.
COleControl::OnHideToolBars	Chamado pelo contêiner quando o controle é interface do usuário desativou.
COleControl::OnInactiveMouseMove	Substituição para o contêiner para o controle inativo nas mensagens de WM_MOUSEMOVE de distribuição do ponteiro do mouse no controle.
COleControl::OnInactiveSetCursor	Substituição para o contêiner para o controle inativo nas mensagens de WM_SETCURSOR de distribuição do ponteiro do mouse no controle.
COleControl::OnKeyDownEvent	Chamado depois que o evento KeyDown de estoque foi acionado.
COleControl::OnKeyPressEvent	Chamado depois que o evento KeyPress de estoque foi acionado.
COleControl::OnKeyUpEvent	Chamado depois que o evento de KeyUp de estoque foi acionado.
COleControl::OnMapPropertyToPage	Indica que a página de propriedades para usar para editar uma propriedade.
COleControl::OnMnemonic	Chamado quando uma chave mnemônicos do controle é pressionada.
COleControl::OnProperties	Chamado quando o verbo de “” propriedades do controle é chamado.
COleControl::OnQueryHitPoint	Substituição para ver se a exibição de um controle sobrepõem um determinado ponto.
COleControl::OnQueryHitRect	Substituição para ver se a exibição de um controle sobrepostos qualquer ponto em um retângulo especificado.
COleControl::OnRenderData	Chamado pela estrutura para recuperar dados no formato especificado.
COleControl::OnRenderFileData	Chamado pela estrutura para recuperar dados de um arquivo no formato especificado.
COleControl::OnRenderGlobalData	Chamado pela estrutura para recuperar dados de memória global no formato especificado.
COleControl::OnResetState	Redefinir as propriedades de um controle para valores padrão.
COleControl::OnSetClientSite	Notifica o controle que IOleControl::SetClientSite foi chamado.
COleControl::OnSetData	Substitui os dados de controle com outro valor.
COleControl::OnSetExtent	Chamado após a extensão do controle foi alterado.
COleControl::OnSetObjectRects	Chamado depois que as dimensões do controle foram alteradas.
COleControl::OnShowToolBars	Quando o controle foi interface do usuário ativou chamado.
COleControl::OnTextChanged	Chamado quando a propriedade conservada em estoque de texto ou de legenda é alterada.
COleControl::OnWindowlessMessage	Mensagens de janela dos processos (diferente de mensagens de mouse e teclado) para controles sem janelas.
COleControl::ParentToClient	Converte um ponto em relação à fonte do recipiente para um ponto em relação à origem do controle.
COleControl::PostModalDialog	Notifica o contêiner que uma caixa de diálogo modal foi fechada.
COleControl::PreModalDialog	Notifica o contêiner que uma caixa de diálogo modal está prestes a ser exibida.
COleControl::RecreateControlWindow	Destrói e recria a janela do controle.
COleControl::Refresh	Força redesenhar a aparência de um controle.
COleControl::ReleaseCapture	Captura do mouse versões.
COleControl::ReleaseDC	Libera o contexto do dispositivo de vídeo de um contêiner de um controle sem janelas.
COleControl::ReparentControlWindow	Redefine o pai da janela de controle.
COleControl::ResetStockProps	Inicializa as propriedades do estoque de COleControl para seus valores padrão.
COleControl::ResetVersion	Inicializa o número de versão para um determinado valor.
COleControl::ScrollWindow	Permite que um controle sem janelas role uma área dentro da imagem ativo no lugar na exibição.
COleControl::SelectFontObject	Seleciona uma propriedade de fonte personalizado em um contexto de dispositivo.
COleControl::SelectStockFont	Selecione a propriedade conservada em estoque da fonte em um contexto de dispositivo.
COleControl::SerializeExtent	Serializa ou inicializa o espaço de exibição para o controle.
COleControl::SerializeStockProps	Serializa ou inicializa as propriedades do estoque de COleControl .
COleControl::SerializeVersion	Serializa ou inicializa as informações de versão do controle.
COleControl::SetAppearance	Defina o valor da propriedade conservada em estoque de aparência.
COleControl::SetBackColor	Defina o valor da propriedade conservada em estoque BackColor.
COleControl::SetBorderStyle	Defina o valor da propriedade conservada em estoque de BorderStyle.
COleControl::SetCapture	Faz com que a janela do contêiner do controle utiliza um possessão de captura do mouse no nome do controle.
COleControl::SetControlSize	Define a posição e tamanho do controlador o OLE.
COleControl::SetEnabled	Defina o valor da propriedade ativado conservada estoque.
COleControl::SetFocus	Faz com que a janela do contêiner do controle utiliza um possessão de foco de entrada em favor do controle.
COleControl::SetFont	Defina o valor da propriedade conservada em estoque da fonte.
COleControl::SetForeColor	Defina o valor da propriedade conservada em estoque. de ForeColor
COleControl::SetInitialSize	Defina o tamanho de um controlador do OLE quando exibido pela primeira vez em um contêiner.
COleControl::SetModifiedFlag	Altera o estado modificado de um controle.
COleControl::SetNotPermitted	Indica que uma solicitação de edição falhou.
COleControl::SetNotSupported	Impede a alteração no valor da propriedade de um controle pelo usuário.
COleControl::SetRectInContainer	Define o retângulo de controle em relação ao recipiente.
COleControl::SetText	Defina o valor da propriedade conservada em estoque de texto ou da legenda.
COleControl::ThrowError	Sinais que ocorreu um erro em um controlador do OLE.
COleControl::TransformCoords	Transforma valores de coordenadas entre um contêiner e o controle.
COleControl::TranslateColor	Converter um valor de OLE_COLOR a um valor de COLORREF .
COleControl::WillAmbientsBeValidDuringLoad	Determina se as propriedades de ambiente estarão disponíveis o controle são carregadas na próxima vez.
COleControl::WindowProc	Fornece um procedimento do windows para um objeto de COleControl .

Métodos protegidos

Nome	Descrição
COleControl::DrawContent	Chamado pela estrutura quando a aparência de controle precisa ser atualizada.
COleControl::DrawMetafile	Chamado pela estrutura quando o contexto do dispositivo de metarquivo é usado.
COleControl::IsInvokeAllowed	Permite que a chamada ao método de automação.
COleControl::SetInitialDataFormats	Chamado pela estrutura para inicializar a lista de formatos de dados suportados pelo controle.

Comentários

Derivado de CWnd, essa classe herda todas as funcionalidades de um objeto da janela do windows mais específico do OLE funcionalidades adicionais, como o acionamento do evento e a capacidade suportar métodos e propriedades.

Controladores OLE podem ser inseridos em aplicativos de contêiner VELHOS e se comunicar com o recipiente usando um sistema bidirecional do acionamento do evento e expõe métodos e propriedades para o contêiner. Observe que o recipiente VELHOS padrão oferecem suporte somente a funcionalidade básica de um controlador do OLE. Não são de suportar recursos estendidos um controlador do OLE. O evento ocorre quando o acionamento dos eventos são enviados para o contêiner resultado de certas ações que ocorrem no controle. Por sua vez, o contêiner se comunica com o controle usando expõe um conjunto de métodos e propriedades análogas a membros de funções de membro e dados de C++ classe. Essa abordagem permite que o desenvolvedor para controlar a aparência do controle e notifique o contêiner quando certas ações ocorrem.

Controles sem o windows

Controladores OLE podem ser ativos no lugar usado sem uma janela. Os controles sem o windows têm vantagens significativa:

Os controles sem o windows podem ser transparentes e não retangulares
Os controles sem janelas reduzem o tamanho da instância e a hora de criação do objeto

Os controles não precisam uma janela. Os serviços que oferece uma janela podem ser facilmente fornecidos por uma única janela compartilhada (geralmente o contêiner) e um bit de distribuir o código. Ter uma janela é basicamente uma complicação desnecessárias no objeto.

Quando a ativação sem janelas for usada, o recipiente (que tem uma janela) é responsável para fornecer serviços que devem ser fornecidos de outra forma por própria janela do controle. Por exemplo, se seu controle precisa consulte o foco do teclado, consulte da captura do mouse, ou de obter um contexto de dispositivo, essas operações são gerenciadas pelo recipiente. COleControlfunções de membro de janelas- operação sem chama essas operações no recipiente.

Quando a ativação sem o windows estiver ativada, as mensagens de entrada de representantes do recipiente para IOleInPlaceObjectWindowless de controle interfaces (uma extensão de IOleInPlaceObject para suporte sem janelas). A implementação de COleControl de esta interface despachará essas mensagens através do mapa de mensagem do seu controle, após definir as coordenadas do mouse adequadamente. Você pode processar mensagens como essas mensagens comuns da janela, adicionando entradas correspondentes no mapa de mensagem.

Em um controle sem janelas, você sempre deve usar as funções de membro de COleControl em vez das funções de membro correspondentes de CWnd ou de suas funções da API do windows relacionadas.

Os objetos do controlador OLE também podem criar uma janela somente quando se tornam ativos, mas a quantidade de trabalho necessária para a transição inativo- ativa sobe e a velocidade de transição vá para baixo. Há casos quando isso é um problema: como exemplo, considere uma grade das caixas de texto. A o cursoring para cima e para baixo através de coluna, cada controle no lugar deve ser ativada e desativada em. A velocidade transição inativo ativa/afetará diretamente a velocidade de rolagem.

Para obter mais informações sobre como desenvolver uma estrutura do controlador OLE, consulte os artigos Controles ActiveX MFC e visão geral: Criando um programa do controle ActiveX MFC. Para obter informações sobre como otimizar controladores OLE, incluindo controles sem janelas e cintilação- livre, consulte Controles ActiveX MFC: Otimização.