Syndication

rdf/textinput.h
1/*
2 This file is part of the syndication library
3 SPDX-FileCopyrightText: 2006 Frank Osterfeld <osterfeld@kde.org>
4
5 SPDX-License-Identifier: LGPL-2.0-or-later
6*/
7
8#ifndef SYNDICATION_RDF_TEXTINPUT_H
9#define SYNDICATION_RDF_TEXTINPUT_H
10
11#include <QString>
12#include <syndication/rdf/resourcewrapper.h>
13
14namespace Syndication
15{
16namespace RDF
17{
18/**
19 * "The textinput element affords a method for submitting form data to an
20 * arbitrary URL - usually located at the parent website.
21 * The field is typically used as a search box or subscription form"
22 *
23 * @author Frank Osterfeld
24 */
25class TextInput : public ResourceWrapper
26{
27public:
28 /**
29 * creates an object wrapping a null resource.
30 * isNull() is @p true.
31 */
32 TextInput();
33
34 /**
35 * creates a text input object wrapping a rss:textinput resource
36 *
37 * @param resource resource to wrap, must be of type
38 * rss:textinput, otherwise this object will not return
39 * useful information.
40 */
41 explicit TextInput(ResourcePtr resource);
42
43 /**
44 * destructor
45 */
46 ~TextInput() override;
47
48 /**
49 * A descriptive title for the textinput field. For example: "Subscribe"
50 * or "Search!"
51 *
52 * @return title of the text input, or a null string if not specified
53 */
54 QString title() const;
55
56 /**
57 * A brief description of the textinput field's purpose. For example:
58 * "Subscribe to our newsletter for..." or "Search our site's archive
59 * of..."
60 *
61 *
62 * @return description TODO: specify format (HTML/plain text), or
63 * a null string if not specified.
64 */
65 QString description() const;
66
67 /**
68 * The URL to which a textinput submission will be directed (using GET).
69 *
70 * @return URL, or a null string if not specified
71 */
72 QString link() const;
73
74 /**
75 * The text input field's (variable) name.
76 *
77 * @return name, or a null string if not specified
78 */
79 QString name() const;
80
81 /**
82 * Returns a description of the text input for debugging purposes.
83 *
84 * @return debug string
85 */
86 QString debugInfo() const;
87};
88
89} // namespace RDF
90} // namespace Syndication
91
92#endif // SYNDICATION_RDF_TEXTINPUT_H
"The textinput element affords a method for submitting form data to an arbitrary URL - usually locate...
QString link() const
The URL to which a textinput submission will be directed (using GET).
QString title() const
A descriptive title for the textinput field.
~TextInput() override
destructor
QString name() const
The text input field's (variable) name.
QString description() const
A brief description of the textinput field's purpose.
TextInput()
creates an object wrapping a null resource.
QString debugInfo() const
Returns a description of the text input for debugging purposes.
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Tue Mar 26 2024 11:14:15 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.