← Back to branch summary

~carifio/seahorse/seahorse-remove-broken-help-buttons

« back to all changes in this revision

Viewing changes to libcryptui/cryptui-key-store.c

Import upstream version 2.28.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
libcryptui/cryptui-key-store.c
712
712
 * PUBLIC 
713
713
 */
714
714
 
 
715
/**
 
716
 * cryptui_key_store_new:
 
717
 * @keyset: a libcryptui keyset
 
718
 * @use_checks: a gboolean
 
719
 * @none_option: a const gchar string
 
720
 *
 
721
 * Creates a new libcryptui key store setting the keystore, use-checks and none-option
 
722
 * properties
 
723
 *
 
724
 * Returns: the new libcryptui key store
 
725
 */
715
726
CryptUIKeyStore*
716
727
cryptui_key_store_new (CryptUIKeyset *keyset, gboolean use_checks, 
717
728
                       const gchar *none_option)
721
732
    return (CryptUIKeyStore*)obj;
722
733
}
723
734
 
 
735
/**
 
736
 * cryptui_key_store_get_keyset:
 
737
 * @ckstore: a libcryptui key store
 
738
 *
 
739
 * Gets ckstore's internal keyset
 
740
 *
 
741
 * Returns: the internal libcryptui keyset
 
742
 */
724
743
CryptUIKeyset*
725
744
cryptui_key_store_get_keyset (CryptUIKeyStore *ckstore)
726
745
{
727
746
    return ckstore->ckset;
728
747
}
729
748
 
 
749
/**
 
750
 * cryptui_key_store_set_sortable:
 
751
 * @ckstore: a libcryptui key store
 
752
 * @sortable: a gboolean
 
753
 *
 
754
 * Sets whether ckstore is sortable or not
 
755
 */
730
756
void
731
757
cryptui_key_store_set_sortable (CryptUIKeyStore *ckstore, gboolean sortable)
732
758
{
733
759
    g_object_set (ckstore, "sortable", sortable, NULL);
734
760
}
735
761
 
 
762
/**
 
763
 * cryptui_key_store_get_sortable:
 
764
 * @ckstore: a libcryptui key store
 
765
 *
 
766
 * Gets whether ckstore is sortable or not
 
767
 *
 
768
 * Returns: TRUE if ckstore is sortable, FALSE otherwise
 
769
 */
736
770
gboolean 
737
771
cryptui_key_store_get_sortable (CryptUIKeyStore *ckstore)
738
772
{
741
775
    return sortable;
742
776
}
743
777
 
 
778
/**
 
779
 * cryptui_key_store_check_toggled:
 
780
 * @ckstore: a libcryptui key store
 
781
 * @view: a GtkTreeView
 
782
 * @iter: a GtkTreeIter
 
783
 *
 
784
 * Gets whether the check at iter is toggled
 
785
 */
744
786
void
745
787
cryptui_key_store_check_toggled (CryptUIKeyStore *ckstore, GtkTreeView *view, GtkTreeIter *iter)
746
788
{
766
808
    g_signal_emit_by_name (selection, "changed");
767
809
}
768
810
 
 
811
/**
 
812
 * cryptui_key_store_get_iter_from_key:
 
813
 * @ckstore: a libcryptui key store
 
814
 * @key: a libcryptui key
 
815
 * @iter: a GtkTreeIter
 
816
 *
 
817
 * Get the iter that the key is stored at in ckstore
 
818
 *
 
819
 * Returns: TRUE if the key is present in the ckstore and the value of iter
 
820
 *          has been modified to point to it, FALSE otherwise
 
821
 */
769
822
gboolean
770
823
cryptui_key_store_get_iter_from_key (CryptUIKeyStore *ckstore, const gchar *key,
771
824
                                     GtkTreeIter *iter)
803
856
    return ret;
804
857
}
805
858
 
 
859
/**
 
860
 * cryptui_key_store_get_key_from_iter:
 
861
 * @ckstore: a libcryptui key store
 
862
 * @iter: a GtkTreeIter
 
863
 *
 
864
 * Gets the key stored at iter in ckstore
 
865
 *
 
866
 * Returns: a libcryptui key
 
867
 */
806
868
const gchar*
807
869
cryptui_key_store_get_key_from_iter (CryptUIKeyStore *ckstore, GtkTreeIter *iter)
808
870
{
813
875
    return key_from_iterator (GTK_TREE_MODEL (ckstore), iter);
814
876
}
815
877
 
 
878
/**
 
879
 * cryptui_key_store_get_key_from_path:
 
880
 * @ckstore: a libcryptui key store
 
881
 * @path: a GtkTreePath
 
882
 *
 
883
 * Get the key at path in ckstore
 
884
 *
 
885
 * Returns: a libcryptui key
 
886
 */
816
887
const gchar*
817
888
cryptui_key_store_get_key_from_path (CryptUIKeyStore *ckstore, GtkTreePath *path)
818
889
{
826
897
    return key_from_iterator (GTK_TREE_MODEL (ckstore), &iter);
827
898
}
828
899
 
 
900
/**
 
901
 * cryptui_key_store_get_all_keys:
 
902
 * @ckstore: a libcryptui key store
 
903
 *
 
904
 * Get a list of all keys in ckstore
 
905
 *
 
906
 * Returns: a list of libcryptui keys
 
907
 */
829
908
GList*
830
909
cryptui_key_store_get_all_keys (CryptUIKeyStore *ckstore)
831
910
{
833
912
    return cryptui_keyset_get_keys (ckstore->ckset);
834
913
}
835
914
 
 
915
/**
 
916
 * cryptui_key_store_get_count:
 
917
 * @ckstore: a libcryptui key store
 
918
 *
 
919
 * Get the number of keys stored in ckstore
 
920
 *
 
921
 * Returns: the number of keys
 
922
 */
836
923
guint
837
924
cryptui_key_store_get_count (CryptUIKeyStore *ckstore)
838
925
{
840
927
    return cryptui_keyset_get_count (ckstore->ckset);    
841
928
}
842
929
 
 
930
/**
 
931
 * cryptui_key_store_have_selected_keys:
 
932
 * @ckstore: a libcryptui key store
 
933
 * @view: a GtkTreeView
 
934
 *
 
935
 * Determines whether keys are selected or not.
 
936
 *
 
937
 * Returns: TRUE if keys have been selected, FALSE otherwise
 
938
 */
843
939
gboolean            
844
940
cryptui_key_store_have_selected_keys (CryptUIKeyStore *ckstore, GtkTreeView *view)
845
941
{
871
967
    return FALSE;
872
968
}
873
969
 
 
970
/**
 
971
 * cryptui_key_store_get_selected_keys:
 
972
 * @ckstore: a libcryptui key store
 
973
 * @view: a GtkTreeView
 
974
 *
 
975
 * Get the currently selected keys
 
976
 *
 
977
 * Returns: a list of libcryptui keys
 
978
 */
874
979
GList*
875
980
cryptui_key_store_get_selected_keys (CryptUIKeyStore *ckstore, GtkTreeView *view)
876
981
{
921
1026
    return keys;
922
1027
}
923
1028
 
 
1029
/**
 
1030
 * cryptui_key_store_set_selected_keys:
 
1031
 * @ckstore: a libcryptui key store
 
1032
 * @view: a GtkTreeView
 
1033
 * @keys: a list of libcryptui keys
 
1034
 *
 
1035
 * Set the current selection to be the list of keys
 
1036
 */
924
1037
void
925
1038
cryptui_key_store_set_selected_keys (CryptUIKeyStore *ckstore, GtkTreeView *view,
926
1039
                                    GList *keys)
966
1079
    g_hash_table_destroy (keyset);
967
1080
}
968
1081
 
 
1082
/**
 
1083
 * cryptui_key_store_get_selected_key:
 
1084
 * @ckstore: a libcryptui key store
 
1085
 * @view: a GtkTreeView
 
1086
 *
 
1087
 * Get the currently selected key
 
1088
 *
 
1089
 * Returns: a libcryptui key
 
1090
 */
969
1091
const gchar*
970
1092
cryptui_key_store_get_selected_key (CryptUIKeyStore *ckstore, GtkTreeView *view)
971
1093
{
1011
1133
    return key;
1012
1134
}
1013
1135
 
 
1136
/**
 
1137
 * cryptui_key_store_set_selected_key:
 
1138
 * @ckstore: a libcryptui key store
 
1139
 * @view: a GtkTreeView
 
1140
 * @selkey: a libcryptui key
 
1141
 *
 
1142
 * Marks the given key as selected
 
1143
 */
1014
1144
void
1015
1145
cryptui_key_store_set_selected_key (CryptUIKeyStore *ckstore, GtkTreeView *view,
1016
1146
                                    const gchar *selkey)
1051
1181
    }
1052
1182
}
1053
1183
 
 
1184
/**
 
1185
 * cryptui_key_store_set_search_mode:
 
1186
 * @ckstore: a libcryptui key store
 
1187
 * @mode: search mode
 
1188
 *
 
1189
 * Sets whether the keys returned will be all, just those searched for, or
 
1190
 * those selected.
 
1191
 */
1054
1192
void
1055
1193
cryptui_key_store_set_search_mode (CryptUIKeyStore *ckstore, CryptUIKeyStoreMode mode)
1056
1194
{
1060
1198
    }
1061
1199
}
1062
1200
 
 
1201
/**
 
1202
 * cryptui_key_store_set_search_text:
 
1203
 * @ckstore: a libcryptui key store
 
1204
 * @search_text: a string
 
1205
 *
 
1206
 * Filters the keys in the store by the text in search_text.
 
1207
 */
1063
1208
void
1064
1209
cryptui_key_store_set_search_text (CryptUIKeyStore *ckstore, const gchar *search_text)
1065
1210
{
1080
1225
    }
1081
1226
}
1082
1227
 
 
1228
/**
 
1229
 * cryptui_key_store_set_filter:
 
1230
 * @ckstore: a libcryptui key store
 
1231
 * @func: a filter function
 
1232
 * @user_data: a generic pointer
 
1233
 *
 
1234
 * Filters the key store's keys with the given filter function.
 
1235
 */
1083
1236
void
1084
1237
cryptui_key_store_set_filter (CryptUIKeyStore *ckstore, CryptUIKeyStoreFilterFunc func,
1085
1238
                              gpointer user_data)