COM组件的接口类添加Event

最新推荐文章于 2025-09-15 14:56:42 发布
原创 最新推荐文章于 2025-09-15 14:56:42 发布 · 1.7k 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文介绍了在COM组件中如何实现连接点与事件接口。详细讲述了如何定义与实现调度接口，以及如何通过向导和手动方式添加连接点，实现自定义事件输出。此外，还涉及了如何重用其他类型库中的连接点接口。

自己获取有无event的区别是，在向导中是否勾选：连接点。

红色为添加部分：

import "oaidl.idl";
import "ocidl.idl";
 
[
     object,
     uuid(C74F7F62-D315-4BF6-9422-9B80D68DB4FA),
     dual,
     nonextensible,
     helpstring("ISample 接口"),
     pointer_default(unique)
]
interface ISample : IDispatch{
};
[
     uuid(48D59498-7F95-4C2B-B3C3-B5DA3B407025),
     version(1.0),
     helpstring("EventSource 1.0 类型库")
]
library EventSourceLib
{
     importlib("stdole2.tlb");
     [
         uuid(87A653F3-F08F-4C1F-B091-5F8FAA894E3C),
         
     ]
     [
 uuid(def121c4-a87e-484c-bb84-48404e74e490)
helpstring("_ISampleEvents 的 UUID")
     ]
     dispinterface _ISampleEvents
     {
         properties:
         methods:
     };
     [
         uuid(6CC7B493-5F8E-4C08-B66D-D9E5FD2342E0),
         helpstring("Sample Class")
     ]
     coclass Sample
     {
         [default] interface ISample;
         [default, source] dispinterface _ISampleEvents;
     };
};
红色的就是本组件首选的事件接口。ISampleEvents接口目前没有提供方法和属性。
 
类的声明如下：
class ATL_NO_VTABLE CSample :
     public CComObjectRootEx<CComSingleThreadModel>,
     public CComCoClass<CSample, &CLSID_Sample>,
     public ISupportErrorInfo,
     public IConnectionPointContainerImpl<CSample>,
     public CProxy_ISampleEvents<CSample>,
public IDispatchImpl<ISample, &IID_ISample, &LIBID_EventSourceLib, /*wMajor =*/ 1, /*wMinor =*/ 0>
 
 
IConnectionPointContainerImpl和CProxy_ISampleEvents<CSample>两个父类是关键。
 
BEGIN_COM_MAP(CSample)
     COM_INTERFACE_ENTRY(ISample)
     COM_INTERFACE_ENTRY(IDispatch)
     COM_INTERFACE_ENTRY(ISupportErrorInfo)
     COM_INTERFACE_ENTRY(IConnectionPointContainer)
END_COM_MAP()
 
COM MAP宏表明了对象支持IConnectionPointContainer接口
 
BEGIN_CONNECTION_POINT_MAP(CSample)
     CONNECTION_POINT_ENTRY(__uuidof(_ISampleEvents))
END_CONNECTION_POINT_MAP()
 
上面这个宏将_ISampleEvents接口的IID保存到连接点映射表中。


编译IDL即可

------------------------------------------------------------------------------------------

为对象添加连接点

Visual Studio .NET 2003

ATL 教程说明了如何创建支持连接点的控件、如何添加事件，然后是如何实现连接点。ATL 用 IConnectionPointImpl 类实现连接点。

若要实现连接点，有两种选择：

  • 通过为控件或对象添加连接点，实现自己的输出事件源。
  • 重用其他类型库中定义的连接点接口。

在上述任何一种情况下，“实现连接点向导”都使用类型库来做这项工作。

为控件或对象添加连接点

  1. 在 .idl 文件的库块中定义调度接口。当您用“ATL 控件向导”创建控件时，如果启用了连接点支持，则已经创建了调度接口。如果在创建控件时没有启用连接点支持，则必须将调度接口手动添加到 .idl 文件中。以下是一个调度接口的示例。输出接口不需要是调度接口，但是许多脚本语言（如 VBScript 和 JScript）都要求这一点，因此该示例使用了两个调度接口： 
    library DProjLib
{
   importlib("stdole32.tlb");
   importlib("stdole2.tlb");
   [
      uuid(57BC50F0-780B-11d1-8C44-0060083E866C),
      helpstring("Buddy Events")
   ]
dispinterface DBuddyEvents
   properties:
   methods:
};

    使用 uuidgen.exe 或 guidgen.exe 实用工具生成 GUID。

  2. 在项目的 .idl 文件中，将调度接口作为 [default,source] 接口添加到对象的 coclass 中。同样，如果在创建控件时启用了连接点支持，则“ATL 控件向导”将创建 [default,source] 项。若要手动添加此项，请添加下面以粗体显示的行： 
    coclass Buddy
{
   [default] interface IBuddy;
   [default,source] dispinterface DBuddyEvents;
};

    有关示例请参见 Circ ATL 示例中的 .idl 文件。

  3. 使用“类视图”将方法和属性添加到事件接口。右击“类视图”中的类，指向快捷菜单上的“添加”，然后单击“添加连接点”。
  4. 在“实现连接点向导”的“源接口”列表框中，选择“项目的接口”。如果为控件选择接口并按“确定”，您将：
    • 生成一个头文件，其中包含一个事件委托类，该类实现将为事件进行输出调用的代码。
    • 将一项添加到连接点映射。

    您还会看到计算机上的所有类型库的列表。仅当希望实现这些其他类型库之一中的完全相同的输出接口时，才应使用该类型库来定义连接点。

重用其他类型库中定义的连接点接口

  1. 在“类视图”中，右击实现 BEGIN_COM_MAP 宏的类，指向快捷菜单上的“添加”，然后单击“添加连接点”。
  2. 在“实现连接点向导”中，选择一个类型库和该类型库中的一个接口，然后单击“添加”。
  3. 编辑 .idl 文件，执行下列任一操作：
    • 从 .idl 文件中复制其事件源正被使用的对象的调度接口。
    • 对该类型库使用 importlib 指令，如下所示。此示例摘自一个使用 Circ 控件中的连接点的 .idl 文件。 
      [
   uuid(38BBFD91-7575-11D1-8C3C-0060083E866C),
   version(1.0),
   helpstring("16190 1.0 Type Library")
]
library MY16190Lib
{
   importlib("stdole32.tlb");
   importlib("stdole2.tlb");
   importlib("D:\\ATL25\\samples\\circ\\circ.tlb");   //**** add this line 

   [
      uuid(38BBFD9E-7575-11D1-8C3C-0060083E866C),
      helpstring("Atl16190Ctl Class")
   ]
   coclass Atl16190Ctl
   {
      [default] interface IAtl16190Ctl;
      [default,source] dispinterface _CircEvents;      //**** and this one
   };
};

【unity游戏开发入门到精通——UGUI】EventTrigger事件触发器组件
向宇
04-29 1527
前面我们介绍了【unity游戏开发入门到精通——UGUI】UI事件监听接口，可以监听自定义事件，实现一些特殊功能，如长按、双击、拖拽等。虽然这已经可以满足我们的需求，但管理不够方便，需要自己编写脚本并挂载到对应控件上。所以本文来介绍另一种方式——事件触发器组件。可以让我们写更少的代码，可以在面板类中处理面板控件的事件逻辑，更加面向对象且便于管理。EventTrigger是事件触发器组件，集成了上节课中学习的所有事件接口的脚本。它可以让我们更方便地为控件添加事件监听。
【Unity3D小技巧】Unity3D中使用EventTrigger对3D物体的响应
优快云博客专家，Unity3D高级软件工程师，《Unity 3D从入门到实战》作者。
09-18 1809
是Unity中用于处理UI事件的一个组件。它允许我们为UI元素（如按钮、图像等）添加事件监听器，从而响应各种交互事件，如鼠标点击、悬停、拖拽等。使用可以避免手动编写复杂的事件处理代码，使UI事件的响应更加简洁和易于管理。比手写UI的Event快很多,方便很多。这篇文章不探究组件与UI事件的交互，主要对焦与与3D物体的响应。
OLE技术专题——第四讲：COM的连接点事件（上）
feijj2002_的专栏
09-02 3219
作者：杨老师一、前言　　我的 COM 组件运行时产生一个窗口，当用户双击该窗口的时候，我需要通知调用者；　　我的 COM 组件用线程方式下载网络上的一个文件，当我完成任务后，需要通知调用者；　　我的 COM 组件完成一个钟表的功能，当预定时间到达的时候，我需要通知调用者；　　... ... ... ...　　本回书开始话说 COM 的事件、通知、连接点......这些内容比较多，我分两次（共四回）
VC6 COM控件增加事件支持
windshome的博客
02-17 354
  前一阵子写一个控件，感觉接口有些地方使用返回值控制不大方便使用，所以打算给控件增加上几个事件，结果在网上搜了很久，也看不到合适的方法，网上说的一些东西，在我的VC环境中看的时候，根本就没有办法那么操作（包括VC6和VC2010）。于是找了一个示例程序，反反复复试验了好多次，终于自己的控件能够通过事件回调了，现在把我的试验方法记录下来。（网上说的更多是在建立控件工程时增加事件，如果对于一个...
从入门到精通：COM接口基础规范与版本升级兼容性问题全解析
最新发布
kuyxerp的博客
09-15 2458
文章从IUnknown接口、IID标识和方法定义三大核心模块出发，详细阐述了COM接口的二进制契约规范；通过版本兼容性案例展示了违反规范的严重后果；提出"新增接口而非修改旧接口"的四步解决方案；最后总结了组件复用与版本管理的实用技巧。全文强调COM接口设计的五大核心原则，帮助开发者既掌握基础规范又避免实际开发中的常见陷阱，在Windows系统开发中实现稳定可靠的组件复用。
嘘！异步事件这样用真的好么？
u010889990的专栏
06-29 671
故事背景 今年年初的时候写了一篇文章 《围观：基于事件机制的内部解耦之心路历程》。这篇文章主要讲的是用 ES 数据异构的场景。程序订阅 Mysql Binlog 的变更，然后程序内部使用 Spring Event 来分发具体的事件，因为一个表的数据变更可能会需要更新多个 ES 索引。 为了方便大家理解我把之前方案的图片复制过来了，如下： 上图的方案存在一个问题，就是我们今天文章要聊的内容。 这个问题就是当 MQ Consumer 收到消息后，就直接发布 Event 了，如果是同步的，没有问题。如果某个 E
2020-09-29
weixin_46064684的博客
10-03 173
创建一个元素 <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title></title> <style> div{ width: 300px; height: 300px; background-color: aquamarine; } </style> <script src="comm
COM组件设计与应用（十三）——事件和通知(VC6.0)
tangyanzhi1111的专栏
07-10 2572
首页视频教程新闻文章代码在线杂志 会员登陆   注册   文章  代码          视频教程  更多精彩VC知识，请关注微博： 当前位置：首页 > 文章列表 > COM组件设计与应用（十三）——事件和通知(VC6.0) COM组
Unity UI添加监听三种方式（IpointxxxHandler实现接口，添加组件，EventTrigger脚本动态添加）
lala_lzw 的代码时间
12-09 2241
我们以点击事件为例，就是做出最常用也是通用的类似按钮的点击事件（因为基本差不多） 首先我们看实现接口：（最常用） 先看代码 using System; using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.EventSystems; using UnityEngine.UI; public class S2Test : MonoBehaviour,IPointerCl
java动态添加组件_有关Java Swing动态增加组件
weixin_39838829的博客
02-16 1930
展开全部效果图参考代码importjava.awt.*;importjava.awt.event.*;importjavax.swing.*;//本类继承自JFrame实现了ActionListener接口publicclassDemoFrame1extendsJFrameimplementsActionListener{JPaneljpc;//存放组件的面板JScr...
Android组件化方案及组件消息总线modular-event实战
2501_90404911的博客
01-26 984
其实这个问题还是比较好解决的，实现的方式就是采用两级HashMap的方式解决。第一级HashMap的构建以ModuleName作为Key，第二级HashMap作为Value；第二级HashMap以消息名称EventName作为Key，LiveData作为Value。查找的时候先用组件名称ModuleName在第一级HashMap中查找，如果找到则用消息名EventName在第二级HashName中查找。整个结构如下图所示：消息总线结构。
COM组件接口基本知识
12-28
COM组件，讲述基本的COM接口知识。COM接口的基本使用。。。
com接口查看工具-COMRaider
03-07
COMRaider是开源的com接口查看工具，通过该工具可以查看已编写的ocx或com组件dll库中详细的导出接口定义。
C#的COM事件在C++和JAVA中触发和响应的实现
学而时习之
12-13 2945
在C++中调用C#开发COM组件时，一般的接口调用都比较容易实现，但是对于COM组件中的事件，C++中要去响应却不好实现。因为C#中事件是采用委托机制，而C++中却没有委托的机制，这样就无法实现对应。那要怎么办呢？ 在C++中虽然没有委托的类型来对应，不过C++却可以开发ATL组件，同时里面有用到事件的映射，那么我们是不是可以应用这种机制去实现呢？进过不断的查找资料和一番努力，总算是达成了目标，
COM连接点事件event
丸子头的专栏
04-21 4532
COM 中的典型方案是让客户端对象实例化服务器对象，然后调用这些对象。然而，没有一种特殊机制的话，这些服务器对象将很难转向并回调到客户端对象。COM 连接点便提供了这种特殊机制，实现了服务器和客户端之间的双向通信。使用连接点，服务器能够在服务器上发生某些事件时调用客户端。 有了连接点，服务器可通过定义一个接口来指定它能够引发的事件。服务器上引发事件时，要采取操作的客户端会向服务器
开发IE下js使用的com组件，包含事件处理
huyinhou
01-06 3362
很简单，将事件做成属性，并设置属性的bindable, displaybind标记。 在js下面直接将function传给这个属性，com组件里面调用这个IDispatch的函数即可。 idl文件，注意onevent1这里。 import "oaidl.idl"; import "ocidl.idl"; [ object, uuid(6A6140E8-9356-4FBD-B0F
COM接口
热门推荐
Blueware多媒体之窗
01-27 1万+
COM 接口什么是 COM？接口的结构与描述使用 C++/C/Delphi 描述接口IDL接口的标识COM 数据类型MIDL 编译器IUnknown 接口接口继承接口查询规则 什么是 COM？ COM 全称为 Component Object Model，是微软为了计算机工业的软件生产更加符合人类的行为方式开发的一种新的软件开发技术。在 COM 构架下，人们可以开发出各种各样的功能专一的组件，然后...
组件接口定义
08-09
<think>根据用户查询，用户想了解如何定义组件接口的方法或规范。结合之前的引用内容，特别是引用[2]中提到的文件组织结构和命名规范，以及引用[1]中的API设计规范，我们可以总结出组件接口定义的一些关键点。 组件接口定义通常包括以下几个方面： 1. 组件命名规范 2. 组件的输入（props）和输出（events）定义 3. 组件的插槽（slots）定义 4. 组件的类型定义（使用TypeScript时） 5. 组件的文档注释 具体规范如下： 1. **组件命名规范**： - 全局组件：使用PascalCase命名，例如：`MyButton`。 - 业务组件：同样使用PascalCase命名，并且建议放在对应的业务目录下，如`views/user/components/UserProfile.vue`。 2. **组件的props定义规范**： - 使用TypeScript接口定义props的类型。 - 为每个prop指定类型、默认值和验证规则。 - 使用驼峰式命名（camelCase）定义props，但在模板中使用时推荐使用kebab-case（短横线分隔）。 3. **组件的events定义规范**： - 使用自定义事件（`emits`）来声明组件可以触发的事件。 - 事件名使用kebab-case命名（因为HTML属性是大小写不敏感的，所以推荐使用短横线分隔）。 4. **组件的slots定义规范**： - 使用具名插槽，并为其提供说明文档。 - 作用域插槽应定义清楚其作用域属性。 5. **类型定义**： - 在TypeScript项目中，将组件的props、emits和插槽的类型定义放在单独的类型文件中（如`types/ComponentTypes.ts`）或在组件文件中使用`interface`定义。 6. **文档注释**： - 为组件、props、emits、slots等添加详细的注释，便于其他开发者使用。 示例（使用Vue 3的Composition API和TypeScript）： ```vue <script setup lang="ts"> import { defineProps, defineEmits } from 'vue'; // 定义Props接口 interface Props { // 用户姓名 name: string; // 用户年龄，可选 age?: number; // 是否激活 isActive?: boolean; } const props = defineProps<Props>(); // 定义Emits const emit = defineEmits<{ // 当用户被选中时触发 (e: 'select', id: number): void; // 当用户信息更新时触发 (e: 'update:name', value: string): void; }>(); </script> <template> <!-- 组件模板 --> </template> ``` 对于大型项目，建议将组件的类型定义抽取到单独的文件中，例如： 在`types/UserCard.ts`中定义： ```typescript export interface UserCardProps { name: string; age?: number; isActive?: boolean; } ``` 然后在组件中引入： ```vue <script setup lang="ts"> import { defineProps } from 'vue'; import type { UserCardProps } from '@/types/UserCard'; defineProps<UserCardProps>(); </script> ``` 此外，参考引用[1]中的接口设计规范，组件接口也应该考虑： - 避免精度丢失（如对于大整数，使用字符串传递） - 敏感数据脱敏（如密码等敏感信息不应通过props传递） - 拓展性（预留一些扩展属性，如使用`$attrs`传递额外的属性） 总结：组件接口定义需要遵循命名规范、类型安全、文档清晰等原则，同时考虑可维护性和扩展性。 §§相关问题§§ 1. 如何为Vue组件编写单元测试以确保接口的稳定性？ 2. 在大型项目中如何管理组件接口的版本兼容性？ 3. 如何设计组件的插槽以提供最大的灵活性？</think>### 组件接口定义方法与规范 组件接口定义是前端工程化的核心环节，需遵循以下规范（基于引用[1][2]的最佳实践）： #### 一、基础规范 1. **命名规范** - 组件文件使用 `PascalCase`（如 `UserProfile.vue`） - 接口方法使用 `camelCase`（如 `getUserInfo()`） - 事件命名采用 `kebab-case`（如 `@update:user-data`）[^2] 2. **类型定义** 在 `types/` 目录定义接口类型（TypeScript）： ```typescript // types/UserType.ts export interface UserProfile { id: string; // 避免大整数精度丢失[^1] name: string; age?: number; // 可选属性 avatar: string; } ``` #### 二、Props 定义规范 ```vue <script setup lang="ts"> import type { UserProfile } from '@/types/UserType' defineProps({ // 必填属性 userId: { type: String, required: true }, // 带默认值的可选属性 theme: { type: String as () => 'light' | 'dark', default: 'light' }, // 复杂对象类型 profile: { type: Object as PropType<UserProfile>, default: () => ({ name: 'Guest' }) } }) </script> ``` #### 三、事件接口规范 1. **自定义事件** ```typescript const emit = defineEmits<{ (e: 'update:name', value: string): void (e: 'delete', id: string, confirm: boolean): void }>() ``` 2. **事件命名原则** - 数据更新事件：`update:<propName>` - 动作事件：`confirm` / `cancel` / `submit` - 避免原生事件名（如 `click`） #### 四、API 通信规范 1. **独立 API 层** 在 `api/` 目录封装接口（参考引用[2]）： ```typescript // api/user.ts import axios from '@/utils/axios' import type { UserProfile } from '@/types/UserType' export const fetchUser = async (id: string): Promise<UserProfile> => { const { data } = await axios.get(`/users/${id}`, { headers: { 'X-Client-IP': 'xxx' } // IP白名单校验[^1] }) return data } ``` 2. **安全规范** - 敏感数据脱敏（如银行卡号显示为 `**** **** **** 1234`）[^1] - 接口限流（单个IP每分钟不超过60次）[^1] - 请求日志记录（关键操作存日志）[^1] #### 五、组件扩展性设计 1. **插槽扩展** ```vue <template> <div class="card"> <slot name="header" :user="userData" /> <slot :profile="userProfile" /> </div> </template> ``` 2. **属性继承** 使用 `useAttrs()` 继承未声明属性： ```vue <template> <div v-bind="attrs"> <!-- 内容 --> </div> </template> ``` #### 六、文档规范 1. **类型注释** ```typescript /** * 用户卡片组件 * @prop {String} userId - 用户ID (必填) * @event update:name - 更新用户名事件 * @slot default - 主内容区域插槽 */ ``` 2. **版本记录** 使用 `CHANGELOG.md` 记录接口变更： ```markdown ## [1.2.0] - 2023-10-15 ### Added - 新增 `theme` 属性支持暗色模式 ### Changed - `profile` 对象结构变更（兼容旧版本） ``` ### 最佳实践总结 | 分类 | 规范要点 | 示例 | |------------|-----------------------------|--------------------------| | 命名 | PascalCase 组件名 | `UserProfile.vue` | | Props | 类型声明 + 默认值 | `type: String, default: ''` | | 事件 | kebab-case + 作用域参数 | `@update:user-data` | | API | 独立封装 + 错误处理 | `api/user.ts` | | 类型定义 | 集中管理 | `types/UserType.ts` | | 文档 | JSDoc 注释 | `@prop {String} userId` |
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值