ItemPolicy.GetSurrogateItems 方法
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
返回此项的代理项的可选集合。
命名空间： Microsoft.Windows.Design.Policies
程序集： Microsoft.Windows.Design.Interaction（在 Microsoft.Windows.Design.Interaction.dll 中）
语法
声明
Public Overridable Function GetSurrogateItems ( _
item As ModelItem _
) As IEnumerable(Of ModelItem)
public virtual IEnumerable<ModelItem> GetSurrogateItems(
ModelItem item
)
public:
virtual IEnumerable<ModelItem^>^ GetSurrogateItems(
ModelItem^ item
)
abstract GetSurrogateItems :
item:ModelItem -> IEnumerable<ModelItem>
override GetSurrogateItems :
item:ModelItem -> IEnumerable<ModelItem>
public function GetSurrogateItems(
item : ModelItem
) : IEnumerable<ModelItem>
参数
- item
类型：Microsoft.Windows.Design.Model.ModelItem
要为其检索代理项的项。
返回值
类型：System.Collections.Generic.IEnumerable<ModelItem>
要检查的代理项的枚举。默认返回空枚举。
备注
代理项提供指定项的其他功能。 代理项不是向策略使用者公开的项的一部分。 如果需要父对象为子级提供功能，则返回代理项。 若要返回一组代理项，请重写 IsSurrogate 属性，使其返回 true。
备注
请勿从 GetSurrogateItems 实现返回 nulla null reference (Nothing in Visual Basic)。
示例
下面的代码示例演示如何通过实现 IsSurrogate 属性和 GetSurrogateItems 方法来创建自定义代理项策略。 有关完整的代码清单，请参见如何：创建代理项策略。
' The DockPanelPolicy class implements a surrogate policy that
' provides container semantics for a selected item. By using
' this policy, the DemoDockPanel container control offers
' additional tasks and adorners on its children.
Class DockPanelPolicy
Inherits PrimarySelectionPolicy
Public Overrides ReadOnly Property IsSurrogate() As Boolean
Get
Return True
End Get
End Property
Public Overrides Function GetSurrogateItems( _
ByVal item As Microsoft.Windows.Design.Model.ModelItem) _
As System.Collections.Generic.IEnumerable( _
Of Microsoft.Windows.Design.Model.ModelItem)
Dim parent As ModelItem = item.Parent
Dim e As New System.Collections.Generic.List(Of ModelItem)
If (parent IsNot Nothing) Then
e.Add(parent)
End If
Return e
End Function
End Class
// The DockPanelPolicy class implements a surrogate policy that
// provides container semantics for a selected item. By using
// this policy, the DemoDockPanel container control offers
// additional tasks and adorners on its children.
class DockPanelPolicy : PrimarySelectionPolicy
{
public override bool IsSurrogate
{
get
{
return true;
}
}
public override IEnumerable<ModelItem> GetSurrogateItems(ModelItem item)
{
ModelItem parent = item.Parent;
if (parent != null)
{
yield return parent;
}
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。
请参见
参考
Microsoft.Windows.Design.Policies 命名空间