DataGridHyperlinkColumn Třída

Definice

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

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.

DataGridHyperlinkColumn s e-mailovými adresami

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.

CancelCellEdit(FrameworkElement, Object)

Způsobí, že se upravovaná buňka vrátí k původní neupravené hodnotě.

(Zděděno od DataGridColumn)
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í.

CommitCellEdit(FrameworkElement)

Před ukončením režimu úprav buněk provede jakékoli požadované ověření.

(Zděděno od DataGridColumn)
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)

Platí pro

Viz také