本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文
資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ContainerVisual 類別

管理一堆Visual物件。

命名空間:  System.Windows.Media
組件:  PresentationCore (在 PresentationCore.dll 中)
針對 XAML 的 XMLNS: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class ContainerVisual : Visual
<ContainerVisual .../>

ContainerVisual 類型會公開下列成員。

  名稱描述
公用方法ContainerVisual建立新的執行個體的ContainerVisual類別。
回頁首

  名稱描述
公用屬性BitmapEffect 已過時。取得或設定BitmapEffect的數值ContainerVisual
公用屬性BitmapEffectInput 已過時。取得或設定BitmapEffectInput的數值ContainerVisual
公用屬性CacheMode取得或設定快取的表示法的ContainerVisual
公用屬性Children取得子集合的ContainerVisual
公用屬性Clip取得或設定裁剪區域的ContainerVisual
公用屬性ContentBounds取得的內容中的週框方塊ContainerVisual
公用屬性DependencyObjectType取得DependencyObjectType包裝CLR這個執行個體的型別。  (繼承自 DependencyObject)。
公用屬性DescendantBounds取得 [聯集的所有子代的週框方塊的所有內容的ContainerVisual,但是不包含內容的ContainerVisual
公用屬性Dispatcher取得DispatcherDispatcherObject相關聯。 (繼承自 DispatcherObject)。
公用屬性Effect取得或設定點陣圖效果套用至ContainerVisual
公用屬性IsSealed取得值,指出是否這個執行個體目前密封 (唯讀)。 (繼承自 DependencyObject)。
公用屬性Offset取得或設定的位移的值ContainerVisual從參考點。
公用屬性Opacity取得或設定的不透明度ContainerVisual、 根據在 [0 = 透明,1 = 不透明。
公用屬性OpacityMask取得或設定指定可能的不透明度遮罩的筆刷ContainerVisual
公用屬性Parent取得父VisualContainerVisual
公用屬性Transform取得或設定套用到轉換ContainerVisual
受保護的屬性VisualBitmapEffect 已過時。取得或設定 VisualBitmapEffect 值。 (繼承自 Visual)。
受保護的屬性VisualBitmapEffectInput 已過時。取得或設定 VisualBitmapEffectInput 值。 (繼承自 Visual)。
受保護的屬性VisualBitmapScalingMode取得或設定 VisualBitmapScalingMode (繼承自 Visual)。
受保護的屬性VisualCacheMode取得或設定 Visual 的快取表示。 (繼承自 Visual)。
受保護的屬性VisualChildrenCount取得子項目數目ContainerVisual (覆寫 Visual.VisualChildrenCount。)
受保護的屬性VisualClearTypeHint取得或設定 ClearTypeHint,以決定 Visual 中的 ClearType 呈現方式。 (繼承自 Visual)。
受保護的屬性VisualClip取得或設定 Visual 的裁剪區域做為 Geometry 值。 (繼承自 Visual)。
受保護的屬性VisualEdgeMode取得或設定 Visual 的邊緣模式做為 EdgeMode 值。 (繼承自 Visual)。
受保護的屬性VisualEffect取得或設定套用至 Visual 的點陣圖效果。 (繼承自 Visual)。
受保護的屬性VisualOffset取得或設定視覺物件的位移值。 (繼承自 Visual)。
受保護的屬性VisualOpacity取得或設定這個 Visual 的不透明度。 (繼承自 Visual)。
受保護的屬性VisualOpacityMask取得或設定 Brush 值,這個值表示 Visual 的不透明遮罩。 (繼承自 Visual)。
受保護的屬性VisualParent取得視覺物件的視覺化樹狀結構父物件。 (繼承自 Visual)。
受保護的屬性VisualScrollableAreaClip取得或設定 Visual 的可捲動裁剪區域。 (繼承自 Visual)。
受保護的屬性VisualTextHintingMode取得或設定 VisualTextHintingMode (繼承自 Visual)。
受保護的屬性VisualTextRenderingMode取得或設定 VisualTextRenderingMode (繼承自 Visual)。
受保護的屬性VisualTransform取得或設定 VisualTransform 值。 (繼承自 Visual)。
受保護的屬性VisualXSnappingGuidelines取得或設定 X 座標 (垂直) 導線集合。 (繼承自 Visual)。
受保護的屬性VisualYSnappingGuidelines取得或設定 Y 座標 (水平) 導線集合。 (繼承自 Visual)。
公用屬性XSnappingGuidelines取得或設定 X (水平) 導線,如ContainerVisual
公用屬性YSnappingGuidelines取得或設定 Y (垂直) 導線,如ContainerVisual
回頁首

  名稱描述
受保護的方法AddVisualChild定義兩個視覺項目之間的父-子關係。 (繼承自 Visual)。
公用方法CheckAccess判斷呼叫的執行緒是否有存取此DispatcherObject (繼承自 DispatcherObject)。
公用方法ClearValue(DependencyProperty)清除屬性的區域數值。 清除屬性由指定DependencyProperty識別項。 (繼承自 DependencyObject)。
公用方法ClearValue(DependencyPropertyKey)清除 [唯讀] 屬性的區域數值。 清除屬性由指定DependencyPropertyKey (繼承自 DependencyObject)。
公用方法CoerceValue指定的值強制轉型相依性屬性。 這是藉由叫用任何CoerceValueCallback指定相依性屬性的屬性中繼資料中,為存在於呼叫的函式DependencyObject (繼承自 DependencyObject)。
公用方法Equals決定是否提供DependencyObject相當於目前的DependencyObject (繼承自 DependencyObject)。
受保護的方法Finalize 允許物件在記憶體回收進行回收之前,嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
公用方法FindCommonVisualAncestor傳回兩個視覺物件的共同祖系。 (繼承自 Visual)。
公用方法GetHashCode取得雜湊程式碼的DependencyObject (繼承自 DependencyObject)。
公用方法GetLocalValueEnumerator建立特殊的列舉值,用來判斷哪一個相依性屬性已在本機設定值,這DependencyObject (繼承自 DependencyObject)。
公用方法GetType取得目前執行個體的 Type (繼承自 Object)。
公用方法GetValue傳回目前的有效值的相依性屬性的此執行個體上DependencyObject (繼承自 DependencyObject)。
受保護的方法GetVisualChild傳回指定的子系Visual的父代ContainerVisual (覆寫 Visual.GetVisualChild(Int32)。)
公用方法HitTest(Point)傳回點擊測試的最上層視覺物件藉由指定Point
公用方法HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)啟始進行點擊測試的ContainerVisual藉由使用HitTestFilterCallbackHitTestResultCallback物件。
受保護的方法HitTestCore(GeometryHitTestParameters)判斷幾何值是否在視覺物件的界限中。 (繼承自 Visual)。
受保護的方法HitTestCore(PointHitTestParameters)判斷點座標值是否在視覺物件的界限中。 (繼承自 Visual)。
公用方法InvalidateProperty對其重新評估指定的相依性屬性的有效值 (繼承自 DependencyObject)。
公用方法IsAncestorOf判斷視覺物件是否為子系視覺物件的祖系。 (繼承自 Visual)。
公用方法IsDescendantOf判斷視覺物件是否為祖系視覺物件的子系。 (繼承自 Visual)。
受保護的方法MemberwiseClone建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
受保護的方法OnPropertyChanged每次叫用的任何有效的值相依性屬性這DependencyObject已經更新。 已變更的特定相依性屬性會報告事件資料中。 (繼承自 DependencyObject)。
受保護的方法OnVisualChildrenChanged當視覺物件的 VisualCollection 已修改時呼叫。 (繼承自 Visual)。
受保護的方法OnVisualParentChanged在視覺物件的父代變更時呼叫。 (繼承自 Visual)。
公用方法PointFromScreen將螢幕座標中的 Point 轉換為 Point,表示 Visual 的目前座標系統。 (繼承自 Visual)。
公用方法PointToScreen將表示 Visual 之目前座標系統的 Point 轉換為螢幕座標中的 Point (繼承自 Visual)。
公用方法ReadLocalValue傳回的區域數值相依性屬性,如果有的話。 (繼承自 DependencyObject)。
受保護的方法RemoveVisualChild移除兩個視覺物件之間的父-子關係。 (繼承自 Visual)。
公用方法SetCurrentValue設定的值相依性屬性而不會變更其值的來源。 (繼承自 DependencyObject)。
公用方法SetValue(DependencyProperty, Object)設定的區域數值相依性屬性、 其相依性屬性識別項所指定。 (繼承自 DependencyObject)。
公用方法SetValue(DependencyPropertyKey, Object)設定唯讀屬性的區域數值相依性屬性、 指定的DependencyPropertyKey之相依性屬性識別項。 (繼承自 DependencyObject)。
受保護的方法ShouldSerializeProperty傳回值,指出序列化處理序是否應序列化所提供的值相依性屬性。 (繼承自 DependencyObject)。
公用方法ToString傳回表示目前物件的字串。 (繼承自 Object)。
公用方法TransformToAncestor(Visual)傳回轉換,這個轉換可用來將 Visual 的座標轉換為視覺物件的指定 Visual 祖系。 (繼承自 Visual)。
公用方法TransformToAncestor(Visual3D)傳回轉換,這個轉換可用來將座標從 Visual 轉換為視覺物件之指定的 Visual3D 祖系。 (繼承自 Visual)。
公用方法TransformToDescendant傳回轉換,這個轉換可用來將 Visual 的座標轉換為指定的視覺物件子系。 (繼承自 Visual)。
公用方法TransformToVisual傳回轉換,這個轉換可用來將 Visual 的座標轉換為指定的視覺物件。 (繼承自 Visual)。
公用方法VerifyAccess強制執行呼叫的執行緒都具有存取此DispatcherObject (繼承自 DispatcherObject)。
回頁首

ContainerVisual 類別當做容器使用的一堆Visual物件。 DrawingVisual 類別衍生自ContainerVisual類別,如此DrawingVisual類別也可以包含的視覺物件的集合。

下列範例會示範如何建立ContainerVisual物件做為父代為兩個DrawingVisual物件。 若要新增的物件ContainerVisual物件必須新增反向 z 軸順序 (由下到上) 以確保它們會以正確的繪圖順序呈現。 為了要正確地列舉視覺化樹狀結構,此範例會提供覆寫的實作GetVisualChild方法以及VisualChildrenCount屬性。


// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}


.NET Framework

支援版本:4.5、4、3.5、3.0

.NET Framework Client Profile

支援版本:4、3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (不支援伺服器核心角色), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心角色,不支援 Itanium)

此.NET Framework 並不支援各種平台的所有版本。如需支援版本的清單,請參閱.NET Framework 系統需求.

這個類型的任何 Publicstatic (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

社群新增項目

顯示:
© 2015 Microsoft