llnamelistctrl.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:5k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llnamelistctrl.h
  3.  * @brief A list of names, automatically refreshing from the name cache.
  4.  *
  5.  * $LicenseInfo:firstyear=2003&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2003-2010, Linden Research, Inc.
  8.  * 
  9.  * Second Life Viewer Source Code
  10.  * The source code in this file ("Source Code") is provided by Linden Lab
  11.  * to you under the terms of the GNU General Public License, version 2.0
  12.  * ("GPL"), unless you have obtained a separate licensing agreement
  13.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  14.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  15.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  16.  * 
  17.  * There are special exceptions to the terms and conditions of the GPL as
  18.  * it is applied to this Source Code. View the full text of the exception
  19.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  20.  * online at
  21.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  22.  * 
  23.  * By copying, modifying or distributing this software, you acknowledge
  24.  * that you have read and understood your obligations described above,
  25.  * and agree to abide by those obligations.
  26.  * 
  27.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  28.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  29.  * COMPLETENESS OR PERFORMANCE.
  30.  * $/LicenseInfo$
  31.  */
  32. #ifndef LL_LLNAMELISTCTRL_H
  33. #define LL_LLNAMELISTCTRL_H
  34. #include <set>
  35. #include "llscrolllistctrl.h"
  36. class LLNameListCtrl
  37. : public LLScrollListCtrl, protected LLInstanceTracker<LLNameListCtrl>
  38. {
  39. public:
  40. typedef enum e_name_type
  41. {
  42. INDIVIDUAL,
  43. GROUP,
  44. SPECIAL
  45. } ENameType;
  46. // provide names for enums
  47. struct NameTypeNames : public LLInitParam::TypeValuesHelper<LLNameListCtrl::ENameType, NameTypeNames>
  48. {
  49. static void declareValues();
  50. };
  51. struct NameItem : public LLInitParam::Block<NameItem, LLScrollListItem::Params>
  52. {
  53. Optional<std::string> name;
  54. Optional<ENameType, NameTypeNames> target;
  55. NameItem()
  56. : name("name"),
  57. target("target", INDIVIDUAL)
  58. {}
  59. };
  60. struct NameColumn : public LLInitParam::Choice<NameColumn>
  61. {
  62. Alternative<S32> column_index;
  63. Alternative<std::string> column_name;
  64. NameColumn()
  65. : column_name("name_column"),
  66. column_index("name_column_index", 0)
  67. {}
  68. };
  69. struct Params : public LLInitParam::Block<Params, LLScrollListCtrl::Params>
  70. {
  71. Optional<NameColumn> name_column;
  72. Optional<bool> allow_calling_card_drop;
  73. Params();
  74. };
  75. protected:
  76. LLNameListCtrl(const Params&);
  77. friend class LLUICtrlFactory;
  78. public:
  79. // Add a user to the list by name.  It will be added, the name 
  80. // requested from the cache, and updated as necessary.
  81. void addNameItem(const LLUUID& agent_id, EAddPosition pos = ADD_BOTTOM,
  82.  BOOL enabled = TRUE, std::string& suffix = LLStringUtil::null);
  83. void addNameItem(NameItem& item, EAddPosition pos = ADD_BOTTOM);
  84. /*virtual*/ LLScrollListItem* addElement(const LLSD& element, EAddPosition pos = ADD_BOTTOM, void* userdata = NULL);
  85. LLScrollListItem* addNameItemRow(const NameItem& value, EAddPosition pos = ADD_BOTTOM, std::string& suffix = LLStringUtil::null);
  86. // Add a user to the list by name.  It will be added, the name 
  87. // requested from the cache, and updated as necessary.
  88. void addGroupNameItem(const LLUUID& group_id, EAddPosition pos = ADD_BOTTOM,
  89.   BOOL enabled = TRUE);
  90. void addGroupNameItem(NameItem& item, EAddPosition pos = ADD_BOTTOM);
  91. void removeNameItem(const LLUUID& agent_id);
  92. void refresh(const LLUUID& id, const std::string& first, const std::string& last, BOOL is_group);
  93. static void refreshAll(const LLUUID& id, const std::string& firstname,
  94.    const std::string& lastname, BOOL is_group);
  95. // LLView interface
  96. /*virtual*/ BOOL handleDragAndDrop(S32 x, S32 y, MASK mask,
  97.   BOOL drop, EDragAndDropType cargo_type, void *cargo_data,
  98.   EAcceptance *accept,
  99.   std::string& tooltip_msg);
  100. /*virtual*/ BOOL handleToolTip(S32 x, S32 y, MASK mask);
  101. void setAllowCallingCardDrop(BOOL b) { mAllowCallingCardDrop = b; }
  102. /*virtual*/ void updateColumns();
  103. private:
  104. void showInspector(const LLUUID& avatar_id, bool is_group);
  105. private:
  106. S32     mNameColumnIndex;
  107. std::string mNameColumn;
  108. BOOL mAllowCallingCardDrop;
  109. };
  110. /**
  111.  * LLNameListCtrl item
  112.  * 
  113.  * We don't use LLScrollListItem to be able to override getUUID(), which is needed
  114.  * because the name list item value is not simply an UUID but a map (uuid, is_group).
  115.  */
  116. class LLNameListItem : public LLScrollListItem
  117. {
  118. public:
  119. LLUUID getUUID() const { return getValue()["uuid"].asUUID(); }
  120. protected:
  121. friend class LLNameListCtrl;
  122. LLNameListItem( const LLScrollListItem::Params& p )
  123. : LLScrollListItem(p)
  124. {
  125. }
  126. };
  127. #endif