DataGridHyperlinkColumn Třída

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

DataGrid Představuje sloupec, který hostuje Uri prvky v buňkách.

public ref class DataGridHyperlinkColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridHyperlinkColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridHyperlinkColumn = class
    inherit DataGridBoundColumn

Public Class DataGridHyperlinkColumn
Inherits DataGridBoundColumn

Dědičnost

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridHyperlinkColumn

Příklady

Následující příklad ukazuje DataGridHyperlinkColumn objekt, který nastaví Uri vlastnost s Binding vlastností a text hypertextového odkazu s vlastností ContentBinding . Událost je Hyperlink.Click zpracována automaticky, protože NavigationWindow je nadřazeným objektem DataGrid.

<NavigationWindow x:Class="DataGrid_CustomColumns.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:core="clr-namespace:System;assembly=mscorlib"
    xmlns:local="clr-namespace:DataGrid_CustomColumns"
    Title="Customers" Height="300" Width="300" ShowsNavigationUI="False"  >
    
<NavigationWindow.Resources>

    <!--Create an instance of the converter for Email-->
    <local:EmailConverter x:Key="EmailConverter" />
</NavigationWindow.Resources>
<NavigationWindow.Content>  
    
<Grid>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>

<!--The Email property contains a URI.  For example "mailto:lucy0@adventure-works.com"-->
<DataGridHyperlinkColumn Header="Email" Binding="{Binding Email}"  ContentBinding="{Binding Email, Converter={StaticResource EmailConverter}}" />

            </DataGrid.Columns>
        </DataGrid>
    </Grid>
    </NavigationWindow.Content>
</NavigationWindow>

public partial class Window1 : NavigationWindow
{

Class Window1

public Window1()
{
    InitializeComponent();

    //GetData() creates a collection of Customer data from a database
    ObservableCollection<Customer> custdata = GetData();
    
    //Bind the DataGrid to the customer data
    DG1.DataContext = custdata;
}

Public Sub New()
    ' This call is required by the Windows Form Designer.
    InitializeComponent()
    ' Add any initialization after the InitializeComponent() call.

    'GetData() creates a collection of Customer data from a database
    Dim custdata As ObservableCollection(Of Customer) = GetData()

    'Bind the DataGrid to the customer data
    DG1.DataContext = custdata

End Sub

//Defines the customer object
public class Customer
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public Uri Email { get; set; }
    public bool IsMember { get; set; }
    public OrderStatus Status { get; set; }
}

'Defines the customer object
Public Class Customer
    Public Property FirstName() As String
    Public Property LastName() As String
    Public Property Email() As Uri
    Public Property IsMember() As Boolean
    Public Property Status() As OrderStatus
End Class

}

End Class

//Converts the mailto uri to a string with just the customer alias
public class EmailConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
    {
        if (value != null)
        {
            string email = value.ToString();
            int index = email.IndexOf("@");
            string alias = email.Substring(7, index-7);
            return alias;
        }
        else
        {
            string email = "";
            return email;
        }
    }

    public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
    {
        Uri email = new Uri((string)value);
        return email;
    }
}

'Converts the mailto uri to a string with just the customer alias
Public Class EmailConverter
    Implements IValueConverter

    Public Function Convert(value As Object, targetType As System.Type, parameter As Object, culture As System.Globalization.CultureInfo) As Object Implements System.Windows.Data.IValueConverter.Convert
        If value IsNot Nothing Then
            Dim email As String = value.ToString()
            Dim index As Integer = email.IndexOf("@")
            Dim [alias] As String = email.Substring(7, index - 7)
            Return [alias]
        Else
            Dim email As String = ""
            Return email
        End If
    End Function

    Public Function ConvertBack(value As Object, targetType As System.Type, parameter As Object, culture As System.Globalization.CultureInfo) As Object Implements System.Windows.Data.IValueConverter.ConvertBack
        Dim email As New Uri(DirectCast(value, String))
        Return email
    End Function
End Class

Poznámky

Slouží DataGridHyperlinkColumn k zobrazení dat, která obsahují Uri, například adresu HTTP nebo e-mailovou adresu. Následující obrázek znázorňuje příklad objektu DataGridHyperlinkColumn.

Poznámka

Hyperlink k navigaci může dojít pouze v případě, že je přímý nebo nepřímý nadřazený Hyperlink objekt hostitelem navigace. Mezi příklady hostitelů navigace patří NavigationWindow, Framenebo jakýkoli prohlížeč, který může hostovat XBAP. Další informace najdete v článku "Navigační hostitelé" v přehledu navigace.

Další informace o podpoře XBAP najdete v tématu Nejčastější dotazy k aplikacím WPF hostovaným v prohlížeči (XBAP).

Pokud chcete sloupec naplnit, vytvořte vazbu sloupce s Uri daty pomocí Binding vlastnosti . Pokud chcete zobrazit text hypertextového odkazu, který se liší od řetězce identifikátoru URI, vytvořte vazbu textové hodnoty na ContentBinding vlastnost. Vlastnost Binding se použije na Hyperlink element nebo TextBox vytvořený ve sloupci. Prvek DataContext v každé buňce je datová položka řádku, ve které se buňka nachází. Proto k nastavení vazby stačí nastavit Binding.Pathpouze . Volitelně můžete zadat Binding.Converter , jestli chcete data převést. Další informace o datových vazbách najdete v tématu o datové vazbě (WPF).

Poznámka

DataGridHyperlinkColumn Hyperlink vytvoří prvek v režimu bez úprav a TextBox prvek v režimu úprav.

Pokud chcete zobrazit jiné typy dat, DataGrid poskytuje následující typy sloupců:

Typ sloupce	Zobrazení dat
DataGridCheckBoxColumn	Slouží k zobrazení logických dat.
DataGridComboBoxColumn	Slouží k zobrazení dat výčtu.
DataGridTextColumn	Slouží k zobrazení textu.

Pokud chcete v nástroji DataGridpoužít jiné ovládací prvky, můžete vytvořit vlastní typy sloupců pomocí DataGridTemplateColumn.

Konstruktory

DataGridHyperlinkColumn()

Inicializuje novou instanci DataGridHyperlinkColumn třídy.

Pole

TargetNameProperty

Identifikuje TargetName vlastnost závislosti.

Vlastnosti

ActualWidth	Získá aktuální šířku sloupce v jednotkách nezávislých na zařízení (1/96 palce na jednotku). (Zděděno od DataGridColumn)
Binding	Získá nebo nastaví vazbu, která přidruží sloupec s vlastností ve zdroji dat. (Zděděno od DataGridBoundColumn)
CanUserReorder	Získá nebo nastaví hodnotu, která označuje, zda uživatel může změnit pozici zobrazení sloupce přetažením záhlaví sloupce. (Zděděno od DataGridColumn)
CanUserResize	Získá nebo nastaví hodnotu, která označuje, zda uživatel může upravit šířku sloupce pomocí myši. (Zděděno od DataGridColumn)
CanUserSort	Získá nebo nastaví hodnotu, která označuje, zda uživatel může seřadit sloupec kliknutím na záhlaví sloupce. (Zděděno od DataGridColumn)
CellStyle	Získá nebo nastaví styl, který se používá k vykreslení buněk ve sloupci. (Zděděno od DataGridColumn)
ClipboardContentBinding	Získá nebo nastaví objekt vazby, který se má použít při získávání nebo nastavení obsahu buňky pro schránku. (Zděděno od DataGridBoundColumn)
ContentBinding	Získá nebo nastaví vazbu na text hypertextového odkazu.
DataGridOwner	Získá ovládací prvek DataGrid , který obsahuje tento sloupec. (Zděděno od DataGridColumn)
DefaultEditingElementStyle	Výchozí hodnota EditingElementStyle vlastnosti.
DefaultElementStyle	Výchozí hodnota ElementStyle vlastnosti.
DependencyObjectType	DependencyObjectType Získá, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá přidruženou Dispatcher k tomuto DispatcherObject . (Zděděno od DispatcherObject)
DisplayIndex	Získá nebo nastaví pozici zobrazení sloupce vzhledem k ostatním sloupcům DataGridv . (Zděděno od DataGridColumn)
DragIndicatorStyle	Získá nebo nastaví styl objektu použít na záhlaví sloupce během operace přetažení. (Zděděno od DataGridColumn)
EditingElementStyle	Získá nebo nastaví styl, který se používá při vykreslování elementu, který sloupec zobrazí pro buňku v režimu úprav. (Zděděno od DataGridBoundColumn)
ElementStyle	Získá nebo nastaví styl, který se používá při vykreslování elementu, který sloupec zobrazí pro buňku, která není v režimu úprav. (Zděděno od DataGridBoundColumn)
Header	Získá nebo nastaví obsah záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderStringFormat	Získá nebo nastaví formát vzor použít na obsah záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderStyle	Získá nebo nastaví styl, který se používá při vykreslování záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderTemplate	Získá nebo nastaví šablonu, která definuje vizuální reprezentaci záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderTemplateSelector	Získá nebo nastaví objekt, který vybere šablonu použít pro záhlaví sloupce. (Zděděno od DataGridColumn)
IsAutoGenerated	Získá hodnotu, která označuje, zda je sloupec automaticky vygenerován. (Zděděno od DataGridColumn)
IsFrozen	Získá hodnotu, která označuje, zda sloupec je znemožněno posouvání vodorovně. (Zděděno od DataGridColumn)
IsReadOnly	Získá nebo nastaví hodnotu, která označuje, zda buňky ve sloupci lze upravit. (Zděděno od DataGridColumn)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
MaxWidth	Získá nebo nastaví omezení maximální šířky sloupce. (Zděděno od DataGridColumn)
MinWidth	Získá nebo nastaví omezení minimální šířky sloupce. (Zděděno od DataGridColumn)
SortDirection	Získá nebo nastaví směr řazení (vzestupně nebo sestupně) sloupce. (Zděděno od DataGridColumn)
SortMemberPath	Získá nebo nastaví název vlastnosti nebo hierarchii názvů vlastností oddělených tečkami, která označuje člen, podle kterého se má řadit. (Zděděno od DataGridColumn)
TargetName	Získá nebo nastaví název cílového okna nebo rámce pro hypertextový odkaz.
Visibility	Získá nebo nastaví viditelnost sloupce. (Zděděno od DataGridColumn)
Width	Získá nebo nastaví šířku sloupce nebo režim automatického nastavení velikosti. (Zděděno od DataGridColumn)

Metody

CancelCellEdit(FrameworkElement, Object)	Způsobí, že se upravovaná buňka sloupce vrátí na zadanou hodnotu.
CheckAccess()	Určuje, zda má volající vlákno přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho dosáhnete vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti pro vlastnost závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
CommitCellEdit(FrameworkElement)	Před ukončením režimu úprav provede jakékoli požadované ověření.
Equals(Object)	Určuje, zda je zadaný DependencyObject ekvivalent k aktuálnímu DependencyObject. (Zděděno od DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Získá upravitelný TextBox prvek, který je vázán na hodnotu vlastnosti sloupce ContentBinding .
GenerateElement(DataGridCell, Object)	Získá jen Hyperlink pro čtení element, který je vázán na hodnotu vlastnosti sloupce ContentBinding .
GetCellContent(DataGridRow)	Načte Content hodnotu vlastnosti buňky v průsečíku tohoto sloupce a zadaného řádku. (Zděděno od DataGridColumn)
GetCellContent(Object)	Content Získá hodnotu vlastnosti pro buňku v průsečíku tohoto sloupce a řádku, který představuje zadanou položku dat. (Zděděno od DataGridColumn)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
NotifyPropertyChanged(String)	Upozorní uživatele DataGrid , který obsahuje tento sloupec, že se změnila vlastnost sloupce. (Zděděno od DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Upozorní, DataGrid když se změní hodnota Binding vlastnosti. (Zděděno od DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Určuje hodnotu vlastnosti na IsReadOnly základě pravidel vlastností z datové mřížky, která obsahuje tento sloupec. (Zděděno od DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)	Upozorní na DataGridContentBinding změnu vlastnosti.
OnCopyingCellClipboardContent(Object)	CopyingCellClipboardContent Vyvolá událost. (Zděděno od DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	PastingCellClipboardContent Vyvolá událost. (Zděděno od DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolá se vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Specifická vlastnost závislosti, která se změnila, je hlášena v datech události. (Zděděno od DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Volá se, když buňka ve sloupci přejde do režimu úprav.
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
RefreshCellContent(FrameworkElement, String)	Aktualizuje obsah buňky ve sloupci v reakci na změnu hodnoty vlastnosti sloupce.
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
VerifyAccess()	Vynutí, aby volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)

Událost

CopyingCellClipboardContent	Nastane po přípravě obsahu schránky buňky. (Zděděno od DataGridColumn)
PastingCellClipboardContent	Nastane před přesunutím obsahu schránky do buňky. (Zděděno od DataGridColumn)

Viz také

• Hyperlink