EventTargetArray 类

支持 WRL 基础结构,不应在代码中直接使用。

语法

class EventTargetArray :
    public Microsoft::WRL::RuntimeClass<
        Microsoft::WRL::RuntimeClassFlags<ClassicCom>,
        IUnknown
    >;

备注

表示事件处理程序的数组。

EventSource 对象关联的事件处理程序存储在受保护的 EventTargetArray 数据成员中。

成员

公共构造函数

名称 描述
EventTargetArray::EventTargetArray 初始化 EventTargetArray 类的新实例。
EventTargetArray::~EventTargetArray 取消初始化当前的 EventTargetArray 类。

公共方法

名称 描述
EventTargetArray::AddTail 将指定事件处理程序追加到事件处理程序内部数组的末尾。
EventTargetArray::Begin 获取事件处理程序内部数组中第一个元素的地址。
EventTargetArray::End 获取事件处理程序内部数组中最后一个元素的地址。
EventTargetArray::Length 获取事件处理程序内部数组中的当前元素数。

继承层次结构

EventTargetArray

要求

标头:event.h

命名空间:Microsoft::WRL::Details

EventTargetArray::~EventTargetArray

支持 WRL 基础结构,不应在代码中直接使用。

~EventTargetArray();

备注

取消初始化当前的 EventTargetArray 类。

EventTargetArray::AddTail

支持 WRL 基础结构,不应在代码中直接使用。

void AddTail(
   _In_ IUnknown* element
);

参数

element
指向要追加的事件处理程序的指针。

备注

将指定事件处理程序追加到事件处理程序内部数组的末尾。

AddTail() 仅供 EventSource 类在内部使用。

EventTargetArray::Begin

支持 WRL 基础结构,不应在代码中直接使用。

ComPtr<IUnknown>* Begin();

返回值

事件处理程序内部数组中第一个元素的地址。

备注

获取事件处理程序内部数组中第一个元素的地址。

EventTargetArray::End

支持 WRL 基础结构,不应在代码中直接使用。

ComPtr<IUnknown>* End();

返回值

事件处理程序内部数组中最后一个元素的地址。

备注

获取事件处理程序内部数组中最后一个元素的地址。

EventTargetArray::EventTargetArray

支持 WRL 基础结构,不应在代码中直接使用。

EventTargetArray(
   _Out_ HRESULT* hr,
   size_t items
);

参数

hr
在此构造函数操作之后,参数 hr 指示数组分配是成功还是失败。 下面列出了可能的 hr 值。

  • S_OK
    操作成功。

  • E_OUTOFMEMORY
    无法为数组分配内存。

  • S_FALSE
    参数 items 小于或等于零。

项目
要分配的数组元素的数目。

备注

初始化 EventTargetArray 类的新实例。

EventTargetArray 用于在 EventSource 对象中保留事件处理程序数组。

EventTargetArray::Length

支持 WRL 基础结构,不应在代码中直接使用。

size_t Length();

返回值

事件处理程序内部数组中的当前元素数。

备注

获取事件处理程序内部数组中的当前元素数。