PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


Nouveauté WINDEV, WEBDEV, WINDEV Mobile 25 !
  • Annuler l'attachement existant
  • Différence entre les fonctions BinaireCharge et <Source>.AttacheMémo
  • Fonction <Source>.AttacheMémo et Accès distant (RPC)
  • Vignettes HFSQL
  • Gestion des mémos sous SQLite
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Permet d'associer un fichier à une rubrique de type mémo binaire ou d'annuler l'attachement existant entre un fichier et une rubrique binaire.
Le fichier sera lu et ajouté au mémo uniquement lors de l'ajout ou de la modification de l'enregistrement (fonction <Source>.Ajoute, <Source>.Modifie ou <Source>.Ecrit). Si le fichier est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
La fonction <Source>.ExtraitMémo permettra d'extraire le fichier contenu dans le mémo sur le disque dur.
Remarque : Il est également possible d'utiliser l'affectation directe :
  • Pour associer directement une image (contenue dans un champ Image) à un mémo image :
    <NomFichier>.<NomRubriqueMémo> = <NomChampImage>

    Par exemple :
    UnFichier.UneRubriqueMémo = IMG_UnChampImage

    Cette syntaxe peut être utilisée aussi bien avec le moteur HFSQL qu'avec les Connecteurs Natifs.
    <NomFichier>.<NomRubriqueMémo> = <NomBuffer>

    Par exemple :
    bufFichier est un Buffer = fChargeBuffer("MonFichier")
    MonFichier.MonMémo = bufFichier
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Exemple
// Attache une image à l'enregistrement
Produit.AttacheMémo(Image_Produit, "C:\Images\Produit1.gif", hMémoImg)
// Transfère le contenu des champs dans le buffer du fichier
Produit.VersFichier()
// Ajoute l'enregistrement
Produit.Ajoute()
Syntaxe

Associer un fichier à une rubrique de type mémo binaire Masquer les détails

<Résultat> = <Source>.AttacheMémo(<Rubrique> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données (ou de la requête) contenant une rubrique mémo.
Si seuls les paramètres <Source> et <Rubrique> sont précisés, la fonction <Source>.AttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Rubrique> : Chaîne de caractères (avec ou sans guillemets)
Nom de la rubrique mémo du fichier de données dans laquelle le fichier binaire doit être ajouté.
Si seuls les paramètres <Source> et <Rubrique> sont précisés, la fonction <Source>.AttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
    Windows Mobile Il n'est pas possible d'utiliser de chemin relatif.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
AndroidWidget AndroidJava Si un chemin est spécifié, ce chemin doit correspondre à un fichier existant. Dans le cas contraire, une erreur fatale est affichée.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier à attacher et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.

PHPOLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction <Source>.InfoMémo.
PHPOLE DBConnecteurs Natifs (Accès Natifs) Ce paramètre n'est pas pris en compte.
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
Remarques

Annuler l'attachement existant

Si seuls les paramètres <Fichier de données> et <Rubrique> sont précisés, la fonction <Source>.AttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Différence entre les fonctions BinaireCharge et <Source>.AttacheMémo

A la différence de la fonction BinaireCharge, la fonction <Source>.AttacheMémo ne charge pas le fichier binaire en mémoire. Il n'y a donc aucun risque de saturation de la mémoire lors de l'association d'un fichier de taille importante à une rubrique de type mémo.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)Langage ExterneProcédures stockées

Fonction <Source>.AttacheMémo et Accès distant (RPC)

La fonction <Source>.AttacheMémo cherche le fichier à attacher sur le serveur RPC.
Pour insérer dans un mémo un fichier présent en local et non pas sur le serveur RPC, il faut affecter son contenu complet à la rubrique mémo, sans appeler la fonction <Source>.AttacheMémo.
Exemple : Insérer depuis une application WINDEV Mobile une image présente dans le répertoire de l'exécutable :
sImage est une chaîne
sImage = fRepExe() + "\signature.jpg"
BufferFichier est un Buffer
BufferFichier = fChargeTexte(sImage)
FichierSurServeurRPC.RubImage = UnicodeVersAnsi(BufferFichier)
FichierSurServeurRPC.Ajoute()
L'image est envoyée au serveur RPC lors de l'ajout. Le serveur RPC se charge de l'insérer dans le mémo, que la connexion à la base soit en OLE DB ou en accès natif.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadUniversal Windows 10 AppWindows MobileJavaAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockées

Vignettes HFSQL

Si la rubrique manipulée utilise des vignettes HFSQL, les vignettes seront automatiquement générées avec le nouveau fichier lors de l'ajout ou de la modification de l'enregistrement (fonctions <Source>.Ajoute, <Source>.Modifie ou <Source>.Ecrit).
Connecteurs Natifs (Accès Natifs)

Gestion des mémos sous SQLite

Le stockage d'informations sous forme de mémos est conseillé uniquement pour des données de taille peu volumineuse (inférieures à 1 Mo). Il est recommandé d'enregistrer directement les données sous forme de fichier externe sur la mémoire du téléphone (interne ou externe) et de mémoriser dans la base uniquement le chemin d'accès à ces données.
Composante : wd250hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire