The sequence index of the required tag within the displayed document. It must be a value from 1 to TagCount.
Example





In This Topic
GdPicture14 Namespace / GdViewer Class / TagGetName Method

TagGetName Method (GdViewer)

In This Topic
Returns a string representation of a unique predefined tag name of the required tag, that is embedded within the document displayed in the GdViewer control.
Syntax
'Declaration

 


Public Function TagGetName( _

   ByVal TagNo As Integer _

) As String
public string TagGetName( 

   int TagNo

)
public function TagGetName( 

    TagNo: Integer

): String; 
public function TagGetName( 

   TagNo : int

) : String;
public: string* TagGetName( 

   int TagNo

) 
public:

String^ TagGetName( 

   int TagNo

)

Parameters

TagNo
The sequence index of the required tag within the displayed document. It must be a value from 1 to TagCount.

Return Value

The name of the required tag (without the specific tag's prefix). The GetStat method can be subsequently used to determine if this method has been successful.
Remarks
It is recommend to use the GetStat method to identify the specific reason for the method's failure, if any.

This method handles EXIF tags, IPTC tags, Extra tags (like Adobe Image Information tags etc.), Thumbnail related tags, GPS tags and XML packet metadata.

Example
How to find out the tag's name. 
'We assume that the GdViewer1 control has been properly integrated

'and your document has been properly displayed as well.

Dim count As Integer = GdViewer1.TagCount()

If GdViewer1.GetStat() = GdPictureStatus.OK Then

    Dim message As String = "Tags count: " + count + vbCrLf

    Dim tagID As Tags = Tags.TagUnknown

    Dim tagName As String = "", tagValue As String = ""

    For i As Integer = 1 To count

        tagID = GdViewer1.TagGetID(i)

        If GdViewer1.GetStat() = GdPictureStatus.OK Then tagName = GdViewer1.TagGetName(i)

        If GdViewer1.GetStat() = GdPictureStatus.OK Then tagValue = GdViewer1.TagGetValueString(i)

            

        If GdViewer1.GetStat() = GdPictureStatus.OK Then

            message = message + vbCrLf + tagName + " (" + tagID + "): " + tagValue

        Else

            message = message + vbCrLf + "Tag nr." + i + "  Status: " + GdViewer1.GetStat().ToString()

        End If

    Next

    MessageBox.Show(message, "GdViewer.TagGetName")

Else

    MessageBox.Show("The number of tags can't be found. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.TagGetName")

End If
//We assume that the GdViewer1 control has been properly integrated

//and your document has been properly displayed as well.

int count = GdViewer1.TagCount();

if (GdViewer1.GetStat() == GdPictureStatus.OK)

{

    string message = "Tags count: " + count + "\n";

    Tags tagID = Tags.TagUnknown;

    string tagName = "", tagValue = "";

    for (int i = 1; i <= count; i++)

    {

        tagID = GdViewer1.TagGetID(i);

        if (GdViewer1.GetStat() == GdPictureStatus.OK)

            tagName = GdViewer1.TagGetName(i);

        if (GdViewer1.GetStat() == GdPictureStatus.OK)

            tagValue = GdViewer1.TagGetValueString(i);

        if (GdViewer1.GetStat() == GdPictureStatus.OK)

            message = message + "\n" + tagName + " (" + tagID + "): " + tagValue;

        else

            message = message + "\nTag nr." + i + "  Status: " + GdViewer1.GetStat().ToString();

    }

    MessageBox.Show(message, "GdViewer.TagGetName");

}

else

    MessageBox.Show("The number of tags can't be found. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.TagGetName");
Example
How to find out the tag's name. 'We assume that the GdViewer1 control has been properly integrated 'and your document has been properly displayed as well. Dim count As Integer = GdViewer1.TagCount() If GdViewer1.GetStat() = GdPictureStatus.OK Then Dim message As String = "Tags count: " + count + vbCrLf Dim tagID As Tags = Tags.TagUnknown Dim tagName As String = "", tagValue As String = "" For i As Integer = 1 To count tagID = GdViewer1.TagGetID(i) If GdViewer1.GetStat() = GdPictureStatus.OK Then tagName = GdViewer1.TagGetName(i) If GdViewer1.GetStat() = GdPictureStatus.OK Then tagValue = GdViewer1.TagGetValueString(i) If GdViewer1.GetStat() = GdPictureStatus.OK Then message = message + vbCrLf + tagName + " (" + tagID + "): " + tagValue Else message = message + vbCrLf + "Tag nr." + i + " Status: " + GdViewer1.GetStat().ToString() End If Next MessageBox.Show(message, "GdViewer.TagGetName") Else MessageBox.Show("The number of tags can't be found. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.TagGetName") End If //We assume that the GdViewer1 control has been properly integrated //and your document has been properly displayed as well. int count = GdViewer1.TagCount(); if (GdViewer1.GetStat() == GdPictureStatus.OK) { string message = "Tags count: " + count + "\n"; Tags tagID = Tags.TagUnknown; string tagName = "", tagValue = ""; for (int i = 1; i <= count; i++) { tagID = GdViewer1.TagGetID(i); if (GdViewer1.GetStat() == GdPictureStatus.OK) tagName = GdViewer1.TagGetName(i); if (GdViewer1.GetStat() == GdPictureStatus.OK) tagValue = GdViewer1.TagGetValueString(i); if (GdViewer1.GetStat() == GdPictureStatus.OK) message = message + "\n" + tagName + " (" + tagID + "): " + tagValue; else message = message + "\nTag nr." + i + " Status: " + GdViewer1.GetStat().ToString(); } MessageBox.Show(message, "GdViewer.TagGetName"); } else MessageBox.Show("The number of tags can't be found. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.TagGetName");
See Also

Reference

GdViewer Class
GdViewer Members
TagCount Method
GetStat Method
GetStat Method
TagCount Method
TagGetID Method
TagGetValueString Method
IPTCCount Method