Udostępnij za pośrednictwem

Dodaj kontrolkę Dodaj obraz w aplikacjach kanwy

  • Artykuł

Wykonuje zdjęcie lub ładuje obrazy z urządzenia lokalnego.

Opis

Za pomocą tej kontrolki użytkownicy mogą robić zdjęcia lub przekazywać pliki obrazów ze swojego urządzenia oraz aktualizować źródło danych przy użyciu tej zawartości. Na urządzeniu przenośnym użytkownik zobaczy okno dialogowe wyboru urządzenia umożliwiające wybór między zrobieniem zdjęcia a wyborem już dostępnego.

Jest to kontrolka zgrupowana, która zawiera dwie kontrolki: Obraz i Przycisk dodaj obraz. Kontrolka Obraz pokazuje przekazany obraz lub symbol zastępczy, jeśli nie przekazano obrazu. Przycisk Dodaj obraz powoduje wyświetlenie monitu o przekazanie obrazu.

Zobacz Kontrolka obrazu — informacje ogólne, aby sprawdzić właściwości Obraz.

Ograniczenia

Kontrolka obrazu ma następujące ograniczenia:

  • Podczas używania kontrolki Dodaj obraz w systemie iOS obrazy importowane przy użyciu aparatu lub galerii nie zawierają metadanych, takich jak orientacja, informacje o lokalizacji czy ustawienia aparatu.

Właściwości przycisku Dodaj obraz

AccessibleLabel – etykieta dla czytników zawartości ekranu. Powinna opisywać cel dodania zdjęcia.

Align — lokalizacja tekstu w odniesieniu do środka kontrolki w poziomie.

BorderColor – kolor obramowania kontrolki.

BorderStyle – rodzaj obramowania kontrolki: Ciągłe, Kreskowane, Kropkowane lub Brak.

BorderThickness – grubość obramowania kontrolki.

ChangePictureText — tekst wyświetlany na przycisku po przekazaniu obrazu.

Color – kolor tekstu w kontrolce.

DisabledBorderColor – kolor obramowania kontrolki, jeśli właściwość DisplayMode kontrolki jest ustawiona na wartość Wyłączone.

DisabledColor – kolor tekstu w kontrolce, jeśli jej właściwość DisplayMode jest ustawiona na wartość Wyłączone.

DisabledFill – kolor tła kontrolki, jeśli jej właściwość DisplayMode jest ustawiona na wartość Wyłączone.

DisplayMode – czy kontrolka zezwala na wprowadzanie danych wejściowych przez użytkownika (Edytuj), czy tylko wyświetla dane (Wyświetl) lub jest wyłączona (Wyłączone).

Error — w przypadku problemu podczas przekazywania obrazu ta właściwość będzie zawierać odpowiedni ciąg błędu.

Fill – kolor tła kontrolki.

FocusedBorderColor – kolor obramowania kontrolki z fokusem.

FocusedBorderThickness – grubość obramowania kontrolki z fokusem.

Font — nazwa rodziny czcionek używanej do wyświetlania tekstu.

FontWeight — grubość tekstu w kontrolce: Pogrubiony, Półpogrubiony, Normalny lub Cieńszy.

Height – odległość między górną i dolną krawędzią kontrolki.

HoverBorderColor – kolor obramowania kontrolki po umieszczeniu na niej wskaźnika myszy.

HoverColor – kolor tekstu w kontrolce po umieszczeniu na niej wskaźnika myszy.

HoverFill – kolor tła kontrolki po umieszczeniu na niej wskaźnika myszy.

Italic — czy tekst w kontrolce jest pochylony.

Multimedia — identyfikator klipu odtwarzanego przez kontrolkę dźwięku lub wideo.

OnChange — Akcje do wykonania, gdy użytkownik zmieni wartość kontrolki (na przykład przez dostosowanie suwaka).

OnSelect — akcje do wykonania po naciśnięciu lub kliknięciu formantu przez użytkownika.

Padding — odległość między tekstem na przycisku importowania lub eksportowania a krawędziami tego przycisku.

PressedBorderColor — kolor krawędzi kontrolki, gdy użytkownik naciśnie lub kliknie tę kontrolkę.

PressedColor— kolor tekstu w kontrolce, gdy użytkownik naciśnie lub kliknie tę kontrolkę.

PressedFill — kolor tła kontrolki, gdy użytkownik naciśnie lub kliknie tę kontrolkę.

Reset - czy kontrolka wraca do swojej wartości domyślnej.

Size — rozmiar czcionki tekstu wyświetlanego w kontrolce.

Strikethrough — czy przez tekst widoczny na kontrolce przebiega linia.

TabIndex — kolejność nawigacji za pomocą klawiatury w odniesieniu do innych kontrolek.

Text — tekst wyświetlany na przycisku, jeśli obraz nie został przekazany.

Tooltip – tekst objaśnienia wyświetlany po umieszczeniu wskaźnika myszy na kontrolce.

Underline — czy pod tekstem widocznym na kontrolce przebiega linia.

UseMobileCamera — czy bezpośrednio używać aparatu komórkowego, gdy są dostępne. W przypadku urządzeń Android ta właściwość wymaga włączonego ustawienia przechwytywania multimediów (Improved Media Capture).

VerticalAlign — lokalizacja tekstu na kontrolce względem środka kontrolki w pionie.

Visible – czy kontrolka jest widoczna, czy ukryta.

Width – odległość między lewą i prawą krawędzią kontrolki.

X — odległość między lewą krawędzią kontrolki a lewą krawędzią jej kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

Y — odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

Patch( DataSource, BaseRecord, ChangeRecord )

Przykłady

  1. Dodaj kontrolkę Dodaj obraz, a następnie trzykrotnie ją kliknij.

    Nie wiesz, jak dodać, nazwać i skonfigurować kontrolkę?

  2. W oknie dialogowym Otwieranie kliknij lub naciśnij plik obrazu, a następnie kliknij lub naciśnij pozycję Otwórz.

  3. Dodaj kontrolkę Przycisk, przenieś ją poniżej kontrolki Dodaj obraz i ustaw właściwość OnSelect kontrolki Przycisk na następującą formułę:
    Collect(MyPix, AddMediaButton1.Media)

    Potrzebujesz więcej informacji na temat funkcji Collect lub innych funkcji?

  4. Dodaj kontrolkę Vertical gallery i ustaw jej właściwość Items na wartość MyPix.

  5. Wybierz kontrolkę Obraz w galerii i ustaw właściwość Obraz na ThisItem.Value.

  6. Naciśnij klawisz F5, a następnie kliknij lub naciśnij kontrolkę Przycisk.

    Obraz z kontrolki Dodaj obraz będzie widoczny w kontrolce Vertical Galeria. Jeśli Twój obraz nie ma takiego samego współczynnika proporcji jak kontrolka Obraz w kontrolce Vertical gallery, ustaw właściwość ImagePosition kontrolki Obraz na Dopasowane.

  7. Kliknij lub naciśnij kontrolkę Dodaj obraz, kliknij lub naciśnij inny plik obrazu, kliknij lub naciśnij pozycję Otwórz, a następnie kliknij lub naciśnij kontrolkę Przycisk, która została dodana.

    Drugi obraz pojawi się w kontrolce Galeria obrazów.

  8. (opcjonalnie) Powtórz poprzedni krok przynajmniej jeden raz, a następnie wróć do domyślnego obszaru roboczego, naciskając klawisz Esc.

Użyj funkcji SaveData, aby zapisać obrazy lokalnie, lub funkcji Patch, aby zaktualizować źródło danych.

Wytyczne dotyczące ułatwień dostępu

W przypadku kontrolek Przycisk i Obraz obowiązują te same wytyczne. Ponadto należy wziąć pod uwagę następujące kwestie:

Kontrast kolorów

  • Przycisk Dodaj obraz musi mieć odpowiedni kontrast między tłem i tekstem. Ponieważ przekazany obraz może mieć inne kolory, należy użyć nieprzezroczystego Fill Przycisk dodaj obraz, aby zapewnić spójny kontrast.

Obsługa czytników ekranu

  • Przycisk dodaj obraz musi mieć właściwości Text i ChangePictureText, które monitują użytkownika o dodanie lub zmianę obrazu.

Obsługa klawiatury

  • Przycisk dodaj obraz musi mieć właściwość TabIndex o wartości zero lub większej, co umożliwi przejście do niej użytkownikom korzystającym z klawiatury.
  • Przycisk dodaj obraz musi mieć wyraźnie widoczne wskaźniki fokusu. Aby to zapewnić, skorzystaj z właściwości FocusedBorderColor i FocusedBorderThickness.

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).