Premiers pas avec FilePathPicker dans Telerik UI pour WPF

Nous avons créé un moyen simple de transformer instantanément le contrôle de votre éditeur en un fichier ou un sélecteur de dossier. Maintenant, dans Telerik UI pour WPF, vous pouvez profiter d'un autre contrôle puissant – le RadFilePathPicker.

Le RadFilePathPicker est un contrôle qui permet aux utilisateurs de sélectionner un fichier ou un répertoire dans le système de fichiers ou de taper directement le chemin d'accès complet dans l'éditeur. Comme tous les contrôles de Telerik UI for WPF il est livré avec l'ensemble complet de thèmes prédéfinis. Bien sûr, si vous choisissez de le faire, vous pouvez le reconcevoir complètement, en fonction de vos besoins.

Structure du modèle

Le contrôle contient un ensemble d'ingrédients absolument incroyable. Il dispose d'une icône à changement dynamique, qui est entièrement personnalisable via un IconTemplateSelector (voir ci-dessous pour plus d'informations). Un filigrane vient ensuite, qui a une arme très importante appelée bouton d'effacement. Dernier point, mais non des moindres – il a un bouton qui ouvre un RadFileDialog dont le type est entièrement contrôlable via la propriété DialogType. sur les types de boîte de dialogue disponibles? Eh bien, ils sont déterminés par l'énumération DialogType, qui a les options suivantes – OpenFile, OpenFolder et SaveFile. Le contrôle ouvre nos boîtes de dialogue de fichiers impressionnantes par défaut – si c'est la première fois que vous en entendez parler , consultez cet article pour en savoir plus. Vous pouvez toujours ouvrir une autre fenêtre (MS ou personnalisée) si vous voulez – gérer simplement l'événement DialogOpening.

Comment utiliser IconTemplateSelector?

Avec L'icône par défaut est une instance de FilePathPickerIconTemplateSelector. Elle expose les propriétés EmptyTemplate et NonEmptyTemplate. Cela vous a déjà fait penser que ces deux propriétés sont liées au FilePath, n'est-ce pas? Oh, et si vous ne voulez pas du tout d’icône, définissez simplement la propriété IconVisibility sur Réduit. Les icônes sont cool. Créons un rapide FilePathPickerIconTemplateSelector personnalisé:

 < StackPanel   Margin  =  "50" > 
  <[ StackPanel.Resources > 
  < DataTemplate   x: Key  =  "CustomEmptyTemplate" > 
  < Image   Source  =  "emptyIcon.png"   /> 
  </  DataTemplate > 
  < DataTemplate   x: Key  =  "CustomNonEmptyTemplate" > 
  < Image   Source  =  "nonEmptyIcon.png"   /> 
  </  DataTemplate > 
  < telerik: FilePathPickerIconTemplateSelector   x: Key  =  "Custom IconTemplateSelector "
  EmptyTemplate  = " {StaticResource CustomEmptyTemplate} "
  NonEmptyTemplate  = " {StaticResource CustomNonEmptyTemplate} "  /    </  StackPanel.Resources > 
  < telerik: RadFilePathPicker   IconTemplateSelector  =  "{StaticResource CustomIconTemplateSelector}" "> 19659011 
 </  StackPanel > 



  


               

3… 2… 1… Action!

J'ai mentionné masquer l'icône mais n'a pas mentionné que vous pouvez utiliser le sélecteur en mode bouton uniquement en masquant la partie éditeur via la propriété EditorVisibility. Cool hein? Je pense que ce mode correspond parfaitement à une étiquette.

 < StackPanel   Margin  =  "50"   Orientation  =  "Horizontal" [19659012] UseLayoutRounding  =  "True"   HorizontalAlignment  =  "Center"   VerticalAlignment  =  "Center" > 
  < StackPanel.Resources > 
  < local: FilePathPickerLabelContentConverter   x: Key  =  "converter"  /> 
  ] </  StackPanel.Resources > 
  < telerik: Label   Content  =  "{Binding FilePath, ElementName = fpp, Converter = {StaticResource convertisseur}} "  Marge  = " 0 0 10 0 " /> 
  < telerik: RadFilePathPicker   x: Nom  = [19659011] "fpp"   Largeur  = [19659011] "50"   VerticalAlignment  =  "Center"   HorizontalAlignment  =  "Center"   EditorVisibility  =  "Collapsed"   IconVisibility  =  "Collapsed"   /> 
 </  StackPanel > 

Le sélecteur de fichiers est en lecture seul mode par défaut, ce qui signifie que vous recevez une assurance gratuite contre les erreurs! Bien sûr, vous pouvez définir la propriété IsReadOnly sur False et autoriser la saisie de texte. Vérifiez-le, goûtez-le ou même copiez-collez-le. Ici, le bouton d'effacement sera votre gomme à effacer magique. Vous pouvez également le personnaliser en utilisant les propriétés ClearButtonContent et ClearButtonContentTemplate de l'entrée de fichier ?.

Événements en vedette

Les événements que le sélecteur de chemin de fichier expose sont FilePathChanging, FilePathChanged, DialogOpening et DialogClosed. Les deux premiers sont utiles pour les scénarios de validation ou la restriction de répertoire. Pas besoin de parler de leurs arguments, non? Eh bien, s'il y en a, vous êtes plus que bienvenus pour profiter de la documentation détaillée du contrôle .

Rideau de fermeture

J'espère que le RadFilePathPicker méritait ses applaudissements et vous a excité à l'idée d'y plonger tout de suite. Vous recherchez les meilleures options de visite virtuelle? Je ne peux penser à rien d'autre que la superbe interface utilisateur Telerik pour WPF Controls Demo .

P.S. Nous aimerions recevoir de vos nouvelles. Vos commentaires honnêtes et directs sont le moyen le plus efficace pour nous d'améliorer. N'hésitez pas à laisser vos commentaires dans la section des commentaires ci-dessous et à partager vos suggestions à l'aide de notre portail de rétroaction .

Obtenez la dernière version de: Interface utilisateur Telerik pour WPF Interface utilisateur Telerik pour Silverlight