nfcData (Variable type)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / NFC functions

Properties specific to nfcData variables
Reinitialization

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

nfcData (Variable type)

In french: nfcDonnée

The nfcData type is used to describe and handle the data of a variable of type nfcTag. You can define and change the characteristics of this data using different WLanguage properties.

Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

// Ecrit une url dans un tag NFC
tag is nfcTag
url is nfcData
url.Type = nfcURI
url.Content = "www.pcsoft.com"
Add(tag, url)
NFCWriteTag(tag)
IF ErrorOccurred = True THEN
	Error("Echec de l'écriture sur le tag NFC.", ErrorInfo())
END

// Sauvegarde une image dans un tag NFC
tag is nfcTag
url is nfcData
url.Type = nfcMedia
url.Content = fLoadBuffer(CompleteDir(SysDirStorageCard()) + "image.png")
url.MIMEType = "image/png"
Add(tag, url)
NFCWriteTag(tag)
IF ErrorOccurred = True THEN
	Error("Echec de l'écriture sur le tag NFC.", ErrorInfo())
END

// Lecture des données d'un tag NFC
tag is nfcTag
tag = NFCReadTag()
IF NOT ErrorOccurred = True THEN
	FOR EACH donnée OF tag.Data
		SWITCH donnée.Type
			CASE nfcText
				sLangue is string = LanguageToName(donnée.Langue)
				sTexte is string = donnée.Contenu
			CASE nfcURI
				IF StringStartsWith(donnée.Contenu, "http") THEN
					BrowserRunApp(donnée.Contenu)
				END
			CASE nfcMedia
				IF donnée.TypeMIME ~= "image/png" THEN
					fSaveBuffer(CompleteDir(SysDirStorageCard()) + ...
						"image.png", donnée.Contenu)
				END
		END
	END
END

Properties

Properties specific to nfcData variables

The following properties can be used to handle data of an NFC tag:

Property name	Type used	Effect

Content	Binary/Buffer	Data content. Its type depends on the value of the Type property. If the Type property corresponds to: the nfcText constant: the Content property can be an Ansi or Unicode string. the Content property is a Unicode string. When writing the NFC tag: if the Content property is an ANSI string, the text will be encoded in UTF-8, if the Content property is a Unicode string, the text will be encoded in UTF-16. the nfcURI constant, the Content property corresponds to an Ansi string. the nfcMedia constant, the Content property corresponds to a buffer. The interpretation of the buffer data depends of MIME type associated with the nfcData variable. the constant nfcVide: A fatal error will be triggered if an attempt is made to modify the property Contenu. the constant nfcInconnu: A fatal error will be triggered if an attempt is made to modify the property Contenu. This property is read-only.
Language	Integer	Language of the text stored in the Content property. This property must be used only when the type of the nfcData variable is nfcText. A fatal error will occur if there is an attempt to read or modify the Language property of a variable of type nfcData or a different type. By default, the Language property is initialized with the current language of the application. To find out: the language name, use LanguageToName. the nation corresponding to the language, use LanguageToNation. This property is read-only.
MIMEType	Character string	MIME type of the resource stored in the Content property. The specified MIME type can correspond to: a standard MIME type. More than 150 types are defined in the MIME communication standard (available on Internet). The most common values are: "application/pdf": PDF file (.pdf) "text/html": HTML page (.htm, .html) "text/plain": text file (.txt) "image/gif": GIF image (.gif) "image/jpeg": JPEG image (.jpg, .jpeg) "video/mpeg": MPEG video (.mpg, .mpeg) "application/msword": Word file. "application/vnd.ms-excel": Excel file. a custom type. The MIMEType* property must be used only when the nfcData variable is of type nfcMedia. A fatal error will occur if there is an attempt to read or modify the MIMEType property of a variable of type nfcData or a different type. This property is read-only.
Type	Integer constant	Type of data, corresponding to one of the following constants: nfcText Text data. nfcURI URI (Uniform Resource Identifier) data type. Can correspond to: the url of a Web page (http://www.windev.com), an FTP address (ftp://ftp.windev.com/), a phone number (tel:0123456789), an email address (mailto:address@mail.com), etc. You have the ability to use ShellExecute with this URI (for example, to open the browser when the URI corresponds to the address of a Web site). nfcMedia Media type data. Can correspond to any resource identified by a MIME type (image, video, document, etc.). nfcVide Empty type. This type is used when creating a variable of type nfcData as long as no data type has been specified. nfcUnknown Type unknown. Important note Changing the type of a variable of type nfcData variable results in a reset of its contents. Therefore, don't forget to specify the type before the content. This property is read-only.

Remarks

Reinitialization

You can use VariableReset to reset the content of a variable of type nfcData.