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 , který nastaví Uri vlastnost s Binding vlastností a text hypertextového odkazu s ContentBinding vlastností. Událost Hyperlink.Click se zpracovává automaticky, protože NavigationWindow je nadřazenou 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í například adresu HTTP nebo e-mailovou Uriadresu. 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ým nebo nepřímým nadřazeným Hyperlink hostitelem navigace. Mezi příklady hostitelů navigace patří NavigationWindow, Framenebo jakýkoli prohlížeč, který může hostovat XBAPs. Další informace najdete v článku "Hostitelé navigace" v přehledu navigace.

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

Pokud chcete sloupec naplnit, vytvořte vazbu sloupce na Uri data pomocí Binding vlastnosti. Chcete-li 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 prvek nebo TextBox prvek vytvořený ve sloupci. Prvek DataContext v každé buňce je datová položka řádku, ve které je buňka. Proto pro nastavení vazby musíte nastavit Binding.Pathpouze . Volitelně můžete zadat Binding.Converter , jestli chcete data převést. Další informace o datové vazbě najdete v tématu Datové vazby (WPF).

Poznámka:

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

Pokud chcete zobrazit další typy dat, DataGrid zadejte 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 ve svém DataGridovládacím prvku použít jiné ovládací prvky, můžete vytvořit vlastní typy sloupců pomocí DataGridTemplateColumn.

Konstruktory

Name	Description
DataGridHyperlinkColumn()	Inicializuje novou instanci DataGridHyperlinkColumn třídy.

Pole

Name	Description
TargetNameProperty	Identifikuje TargetName vlastnost závislosti.

Vlastnosti

Name	Description
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 k vlastnosti 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á urč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 ř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	DataGrid Získá ovládací prvek, 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á ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject)
DisplayIndex	Získá nebo nastaví pozici zobrazení sloupce vzhledem k ostatním sloupcům v objektu DataGrid. (Zděděno od DataGridColumn)
DragIndicatorStyle	Získá nebo nastaví objekt stylu, který se použije 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í prvku, 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í prvku, který sloupec zobrazuje 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, která se má použít pro záhlaví sloupce. (Zděděno od DataGridColumn)
IsAutoGenerated	Získá hodnotu, která určuje, zda je sloupec automaticky generován. (Zděděno od DataGridColumn)
IsFrozen	Získá hodnotu, která označuje, zda je sloupec znemožněno posouvání vodorovně. (Zděděno od DataGridColumn)
IsReadOnly	Získá nebo nastaví hodnotu, která urč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 člena, 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 hypertextového odkazu.
Visibility	Získá nebo nastaví viditelnost sloupce. (Zděděno od DataGridColumn)
Width	Získá nebo nastaví šířku sloupce nebo režim automatické velikosti. (Zděděno od DataGridColumn)

Metody

Name	Description
CancelCellEdit(FrameworkElement, Object)	Způsobí, že se upravená buňka sloupce vrátí k zadané hodnotě.
CheckAccess()	Určuje, zda volající vlákno má 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á má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (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 poskytnutá DependencyObject hodnota ekvivalentní 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á prvek jen Hyperlink pro čtení, který je vázán na hodnotu vlastnosti sloupce ContentBinding .
GetCellContent(DataGridRow)	Content Načte hodnotu vlastnosti pro buňku 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 datnou položku. (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í, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject)
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)
NotifyPropertyChanged(String)	Upozorní DataGrid uživatele, 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 IsReadOnly vlastnosti na základě pravidel vlastností z datové mřížky, která obsahuje tento sloupec. (Zděděno od DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)	Upozorní, DataGrid kdy se ContentBinding vlastnost změní.
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ána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní 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 hodnot. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou jeho 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 identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)

Událost

Name	Description
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