DataGridHyperlinkColumn Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.
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) |