在本主题▼

L_AnnGetObjectFromTag

# include“l_bitmap.h”

L_LTANN_APIL_INTL_AnnGetObjectFromTag(hContainer, uFlags, uTag, phTagObject)

检索具有指定标记的对象的句柄。

参数

HANNOBJECThContainer

容器对象的句柄。

L_UINTuFlags

确定要处理哪些对象的标志。大多数标志只应用于容器对象。您可以在适当的时候使用按位OR(|)组合值。以下是有效值:

价值	意义
0	只处理指定的对象。
ANNFLAG_SELECTED	[0x0001]只处理被选属性设置为TRUE的对象。要获取和设置所选属性，请使用L_AnnGetSelected而且L_AnnSetSelected功能。
ANNFLAG_NOTTHIS	[0x0004]只处理指定容器中的一个级别的对象，而不是容器本身如果容器中有容器，它们将被修改，但其中的对象不会被修改。
ANNFLAG_RECURSE	[0x0008]处理容器内的对象，以及任何子容器内的对象，直至任何级别。
ANNFLAG_NOTCONTAINER	[0x0002](与ANNFLAG_RECURSE一起使用)处理容器内的对象，而不是容器本身。
ANNFLAG_NOINVALIDATE	[0x0010]不要使窗口中受影响的矩形无效。使用此选项可避免生成不必要的绘制消息。

L_UINT32uTag

用作对象标记的无符号32位整数。

pHANNOBJECTphTagObject

中指定的标记的注释对象的句柄要更新的变量的地址uTag．如果没有找到带有指定标记的对象，则变量将被更新为NULL。

价值	意义
成功	活动很成功。
＜ 1	发生错误。指返回代码．

有关获取和设置标记的更多信息，请参见L_AnnGetTag而且L_AnnSetTag．

属性的值应用于多个选定对象uFlags参数。

必需的dll和库

LTANN
有关所需dll和库的确切列表(基于工具包版本)，请参见应用程序中包含的文件．

平台

x64 Win32。

另请参阅

功能

主题

例子

静态L_INT TagCount = 0;(HANNOBJECT hContainer，ANNENUMCALLBACK annTagCallback)｛/*这个函数设置标签为所选对象。* /L_AnnEnumerate(hContainer, annTagCallback, NULL, ANNFLAG_SELECTED | ANNFLAG_NOTTHIS, 0);｝L_INT EXT_CALLBACK (HANNOBJECT对象)L_VOID * pUserData)｛UNREFERENCED_PARAMETER (pUserData);L_INT nRet;nRet = L_AnnSetTag(hObject, TagCount, 0);如果(nRet == SUCCESS)｛+ + TagCount;对话框(NULL,文本(“标记集。”),文本(＂＂), MB_OK);｝其他的对话框(NULL,文本(“标签未设置。”),文本(＂＂), MB_OK);返回成功;｝L_INT AnnGetObjectFromTagExample(HANNOBJECT hContainer)｛L_INT nRet;/*这个函数找到带有指定标签的objetc对象。* /L_UINT32 TagNo = 2;nRet = L_AnnSetTag(TagObject,TagNo, 0);nRet = L_AnnGetObjectFromTag(hContainer, ANNFLAG_RECURSE | ANNFLAG_NOTCONTAINER, TagNo， &TagObject);如果(nRet != SUCCESS)返回nRet;如果TagObject != NULL对话框(NULL,文本(“对象检索”。),文本(＂＂), MB_OK);其他的对话框(NULL,文本(“未找到对象。”),文本(＂＂), MB_OK);返回成功;｝